ラベル 機能紹介 の投稿を表示しています。 すべての投稿を表示
ラベル 機能紹介 の投稿を表示しています。 すべての投稿を表示

2011/03/30

ノートPCのAC電源復旧時にWoLでデスクトップPCを起動

停電時でもPCに稼働し続けて欲しければ、バッテリを搭載しているノートPCを使用するのが無難ですが、PCI接続の機器などを使う必要がある場合、デスクトップPCを選択せざるを得ません。
デスクトップPCでは、バッテリによる予備電源を提供するUPS(無停電電源装置)を利用しても、長時間に及ぶ停電を無停止で乗り切ることは出来ません。
また、USB接続などでPCと連動して停電時に自動で安全なシャットダウンを行う機能は多くのUPSに用意されていますが、電源復旧時にPCを自動で起動する機能は用意されていないことがあり、外出などで手動での電源投入が行なえない状況では、長時間シャットダウンされたままになってしまうことがあります。

どうしてもデスクトップPCの停止時間を最小限にとどめたければ、別途ノートPCを起動しておき、そこからデスクトップPCを自動起動させるとよいでしょう。

NILScriptでは「System.hasAC」で電源が供給されているかどうかを取得できる他、System.observe()で「powerStatusChange」イベントにコールバック関数を登録することで、電源の状態が変化したときに任意の処理を実行させられます。
また、LAN上にマジックパケットをブロードキャストして指定のコンピュータを起動させるWOL(WakeOnLAN)の機能も最近追加されました。
これらの機能を利用して以下のようなスクリプトを作成し、AC電源に接続したノートPC上で実行しておけば、AC電源が断たれた状態から復旧したときに自動で指定のPCを起動してくれるはずです。

var mac="00 01 02 03 04 05";//起動対象PCのMACアドレス
var dest="192.168.1.255"; //パケット送信先のブロードキャストアドレス

Main.createNotifyIcon();
var power=System.hasAC;

System.observe('powerStatusChange',function(){
 if(!power && System.hasAC){
  require('WOL').WOL.send(mac,dest);
 }
 power=System.hasAC;
});

なお、WOLでPCを遠隔起動するには、対象のPCがWOLに対応したLANカードでルーターに有線接続されていて、BIOSの設定でWOLが有効になっている必要があります。
また、停電でルーターが停止してしまう場合、powerStatusChangeイベントで電源復旧を検出した直後にWOL.send()を行ってもパケットが到達しない可能性があるため、適宜sleep()などを挿入して下さい。

2010/10/27

設定ファイルにウィンドウ位置などの情報を保存する

ウィンドウを表示して入力の受け付けや情報の表示を行うタイプのプログラムでは、ウィンドウを表示する際、前回のウィンドウの位置・サイズを記憶して再現してくれるようにすると便利です。

このような設定情報の保存を行う際には、pref()関数を使います。
この関数は、適切なユーザー設定ディレクトリを自動認識して、設定ファイルを表すFile/Directoryオブジェクトを返してくれます。

設定ファイルの形式は、JavaScriptのオブジェクトリテラルの表記と同じ書式のテキストで保存するJSONという形式を使うと良いでしょう。
FileオブジェクトのloadJSON()やsaveJSON()というメソッドを使えば、簡単にオブジェクトとして読み込んだり保存できます。

下記の例は、ウィンドウを閉じようとしたときに位置とサイズを記憶して次回実行時に再現するだけのスクリプトです。
var config=(pref("windowPosTest.json")||{loadJSON:function()({})}).loadJSON();
var w=require('Window').Window.create({
 title:"test",
 width:100,height:100,
 x:config.windowX||0, y:config.windowY||0,
 events:{
  close:function(){
   config.windowX=this.x;
   config.windowY=this.y;
   pref("windowPosTest.json",true).saveJSON(config);
  },
 },
}).show();;

最初のpref()では、既に存在している設定ファイルを表すFileオブジェクトを取得しています。
この時、ファイルが存在していなくてnullが返された場合でもエラーにならずにデフォルトのオブジェクトがセットされるようにしておく必要があります。

Windowオブジェクトのcloseイベントでは、設定オブジェクトにウィンドウの現在位置をセットして保存を行っています。
保存時のpref()の呼び出しでは、第2引数をtrueにする必要があります。

スクリプトが不要になったらプログラムのディレクトリを削除するだけで完全に削除できるように、通常はスクリプトのあるディレクトリ内の「users」ディレクトリにユーザー名のディレクトリを作って保存されます。
しかし、スクリプトのあるディレクトリが書き込み禁止になっていたりする場合は、Application Dataディレクトリ内のスクリプトファイル名を名前にしたディレクトリが保存先として選択されます。
また、スクリプトと同じディレクトリに「config」というディレクトリがあれば、そちらが保存先になります。これはプログラムをリムーバブルメディアに入れて持ち出して複数の環境で利用したい場合などのための機能です。

なお、プログラム用のドライブに頻繁な書き込みをしたくないとか、まとめてバックアップ出来た方がいいなどの理由で、設定がApplication Dataディレクトリに保存されることを好むユーザーは、あらかじめApplication Dataディレクトリ内に該当するディレクトリを作成しておくことで、そちらに保存させることも出来ます。

これらの仕様により、pref()関数を使用すれば、簡単にユーザーの好みや実行環境に合った最適な場所にデータを保存できるようになっています。

2010/10/21

一定時間キー・マウス操作がなかったときに処理を実行

NILScriptのSystemMonitorユニットには、最後にキーボードやマウスの操作が確認されてから経過した時間を取得する「InputIdle」クラスが用意されています。
これを使用すれば、ユーザーが退席している間に何らかの処理を行ったり、作業状況のログを記録したりするツールを作成できます。

InputIdleクラスの基本的な使い方は、以下のようになります。
Main.createNotifyIcon();
var mon=new (require('SystemMonitor').InputIdle)();
Thread.create(function(){
 var idle;
 while(true){
  if(mon.get(true)<5000){ //規定時間
   if(idle){
    idle=false;
    //↓一定時間以上振りに操作を行ったときに実行される処理
    println("wake");
   }
  }else if(!idle){
   idle=true;
   //↓一定時間操作がなかったときに実行される処理
   println("idle");
  }
  sleep(100);//監視間隔
 }
});

無操作時間を取得するには、InputIdleオブジェクトのget()メソッドを呼び出します。
引数がtrueの場合は、プログラムによって生成された操作を除き、実際にユーザーが行った操作のみを考慮した無操作時間が取得されます。
idle変数は、既に無操作時間が規定値を超えているかどうかのフラグです。
最初に無操作時間が規定値を超えた時にtrueにし、無操作時間が規定値以下の時にtrueになっていたらfalseにすることで、一定時間以上の放置と放置からの復帰を検出しています。
上記の例でprintln()関数を呼び出している部分に、放置や復帰を検出したときの処理を記述します。

2010/09/26

HTTPでファイルのアップロードを行う

NILScriptには、HTTPでリクエストを送信してレスポンスを得る機能も用意されています。
一発でレスポンスボディを得られる手軽なメソッドや、レスポンスボディをストリームとして逐次読み込みするオブジェクトを返すメソッドなどが用意されている他、リクエストヘッダの指定やプロキシの使用など、柔軟な動作設定も可能です。
WSHなどでは実現が面倒なファイルのアップロードも、下記の例のように簡単に実現できます。
require('HTTP').HTTP.post(url,{
 upfile:new File(filePath),
 pass:"test",
 com:"this is test of file upload",
});
ファイルのアップロードを行うには、POSTによるリクエストを行うpost()メソッドを使用します。
第1引数はリクエストするURL(HTMLのform要素のaction属性で指定される物)を、第2引数にはフォームの項目名と項目内容のペアを列挙したオブジェクトを指定します。
ここで項目内容としてFileオブジェクトが指定されていると、そのファイルの内容がアップロードされます。
上記の例では、変数に格納されたフルパスを元にFileコンストラクタを呼び出していますが、実行時にファイルの指定を受け付ける様々な方法の記事で紹介したような方法で得たFileオブジェクトを指定してもよいでしょう。
post()メソッドは、アップロード完了後に表示されるページの内容などのレスポンスボディ文字列を返します。アップロードされたファイルのURLを得たい場合などは、返り値の内容を正規表現マッチングで調べたりするとよいでしょう。

なお、NILScriptのHTTPには、非同期的な処理を行う機能は用意されていないません。
リクエストを開始したら即座に次の処理に進みたい場合には、「Thread.create()」で生成したスレッド内でリクエストを実行することで非同期化してください。

2010/09/24

省電力状態からの自動復帰も可能なタイマー機能

NILScriptに用意されている「Timer」クラスには、コンピュータがサスペンドやハイバネート状態になっても指定時間経過後に自動復帰させる機能が用意されています。
この機能を利用すれば、サーバが空いている時間帯を利用してのダウンロードなどの待ち時間の長い自動処理を行う際に、予定時刻を待っている間コンピュータを起動したままにしておく必要が無くなり、電力を節約できます。
この機能を利用するには、Timerオブジェクトのコンストラクタで第4引数にtrueを指定します。Timerの使用方法については、同梱のdoc\base_task.txtを参照してください。

復帰とは逆に、スクリプト上からサスペンドやハイバネートを実行するためのメソッドも用意されています。これらは「System.suspend()」や「System.hibernate()」というSystemクラスのメソッドとなっています。
また、サスペンドやハイバネート状態に移行し、指定時間後に自動復帰するという処理を行う「System.suspendFor()」や「System.hibernateFor()」というメソッドも用意されています。これらの機能の説明は、doc\base_main.txtにあります。

なお、タイマーによる復帰機能では、タイマーで指定した時間に復帰処理が始まるため、復帰が完了して予約された処理が実行されるまでには数秒~数十秒のタイムラグがあることに注意しなければなりません。
テレビの自動録画のように遅れることが許されない処理では、予約実行のタイマーとは別に、予定時刻の1~2分前に自動復帰させるためのタイマーをセットしておくとよいでしょう。
この場合、「System.awake()」というメソッドを使用すれば、単にサスペンド・ハイバネートから復帰するだけのタイマーを生成できます。

2010/08/17

文字列の全角・半角を変換する

NILScriptではJavaScript標準の型である文字列や数値にも拡張メソッドが用意されています。
文字列の拡張メソッド「format()」では、引数で指定した条件に従って文字列の全角・半角などの変換を行なえます。
引数には、今の所以下のアルファベットの組み合わせを指定できます。
a 全角→半角(アルファベットと数字)
A 半角→全角(アルファベットと数字)
r 全角→半角(アルファベット)
R 半角→全角(アルファベット)
n 全角→半角(数字)
N 半角→全角(数字)
s 全角→半角(空白文字)
S 半角→全角(空白文字)
m 全角→半角(対応する半角文字がある全ての記号)
M 半角→全角(全ての記号)
E 半角→全角(ファイル名に使用できない記号)
f 全角→半角(ファイル名に使用可能な記号)
Y MもしくはEと共に指定すると、\を/でなく¥に置換
k 全角→半角(カタカナ)
K 半角→全角(カタカナ)
V 半角→全角(カタカナ。濁点・半濁点の合成を行う)

これを利用すれば、何故か英数字が全角になっているサイトから抽出した文字列を半角に修正するなどの処理が簡単に行なえます。
例えば、「title」という変数に入っている文字列の全角文字を半角文字に置き換えるには、以下のようにします。
title=title.format('asm');
これだけで、「NILScript」のような忌々しい全角文字列を「NILScript」のように半角に変換できます。
全角英数字は、検索で見つけにくくなるなどの害がありますので、是非この機能を活用して撲滅してください。

ファイル名に使用できない文字だけを全角に変換する機能も便利です。
下記のようにすれば、ファイル名に使用可能な記号は半角に、使用不可能な記号は全角に変換してくれます。
var filename=title.format('asfE');
Webページのタイトル等から取得した文字列には、ファイル名に使用できない文字が含まれている可能性があるので、保存ファイル名などとして使う場合には、このようにして変換すると良いでしょう。

2010/08/15

ファイルの作成・更新・削除を監視

2010/08/15版以降のNILScriptには、ファイルの変更を監視してイベントハンドラ関数を実行する機能が用意されています。定期的にファイル情報を取得するのではなく、OSのファイル更新イベント通知機能を使用しているので、システムへの負荷は少なくて済みます。
この機能を利用すれば、ファイルの作成などでしか処理の完了を検出できないソフトを含む作業の自動化などを簡単に実現できます。

特定のファイルの作成・変更・削除を監視するには、Fileクラスのインスタンスオブジェクトの「observe()」メソッドを使います。
Main.createNotifyIcon();
var f=new File("E:\\work\\_devel\\ng\\test\\test");
f.observe(['create','remove','modify','renameTo','renameFrom'],function(o){
 Main.notifyIcon.showInfo(o.event+":"+(o.file||""));
});
「Main.createNotifyIcon()」は、NILScript標準のタスクトレイアイコンを作成するメソッドです。Fileオブジェクトのobserve()を使うとスクリプトが常駐状態になるので、スクリプトを手動で終了させるためにトレイアイコンを用意しておく必要があります。
2行目では、パスを指定してFileオブジェクトを生成しています。
3行目が、イベントハンドラの登録処理です、observe()の第1引数には監視するイベント名を指定しますが、配列を指定すれば複数のイベントに対していっぺんにイベントハンドラを登録できます。ここでは、用意されている全てのイベント名を指定しています。
イベントハンドラ関数の中では、第1引数に与えられるオブジェクトの「event」メンバでイベント名を、「file」メンバで「renameTo」「renameFrom」のリネーム後・前のファイルのFileオブジェクトを参照できます。
「Main.notifyIcon.showInfo()」は、タスクトレイアイコンのバルーンでテキストを表示するメソッドです。

ディレクトリ内の不特定多数のファイル・ディレクトリの作成・変更・削除を監視するには、Directoryオブジェクトの「observe()」メソッドを使用します。
var d=new Directory("E:\\work\\_devel\\ng\\test");
d.observe(['add','remove','modify','rename'],function(o){
 Main.notifyIcon.showInfo(o.event+' '+(o.old||"")+' => '+o.file);
});
使い方はほとんどFileオブジェクトのobserve()と同じですが、用意されているイベント名が一部異なります。
また、作成・変更・削除されたファイルが、引数オブジェクトの「file」メンバで、renameイベントでのリネーム前のファイルが「old」メンバで取得できます。

これらの監視機能を使用する上で注意すべきなのは、ファイルの作成イベントが発生した時点では、まだファイルへの書き込みが行われている可能性があると言うことです。書き込み途中のファイルを操作しようとしても、ファイルを開けず失敗してしまったり、中途半端な内容しか読み取られなかったりするでしょう。
これを回避するには、ファイルのパスと最後に更新イベントが発生した時間をオブジェクトに格納しておいて、一定時間更新が発生していないファイルを書き込み完了とみなして操作するなどの工夫をするといいでしょう。

コマンドラインでのスクリプト指定が不要なEXEを作成

NILScriptでは通常、コマンドライン引数で実行させたいスクリプトファイル名を指定しなければならないため、Mozilla Firefoxの設定の「プログラム」の項での「他のプログラムを選択」のように、EXEファイルパスしか指定できない外部プログラム呼び出し機能からは、スクリプトを実行させられません。
この問題を解決するために、コマンドラインでスクリプトファイル名を渡さずに一定のスクリプトを実行するというEXEファイルを作成する機能が用意されています。

この機能を利用するには、NILScriptに同梱の「mkexe_c.bat」か「mkexe_w.bat」を実行し、表示されるプロンプトで生成したい実行ファイルの名前を指定してください。「_c」の方はコンソール版、「_w」は非コンソール版の実行ファイルが作成されます。

すると、NILScriptのディレクトリ内に、入力した名前で拡張子「.exe」のファイルと「.js」のファイルが作成され、拡張子「.js」のスクリプトファイルがメモ帳で開かれます。(使用するエディタはmkexe.ngを編集すれば変更できます。)

スクリプトファイルの内容は以下のようになっており、「/* script body */」と書かれている箇所に実行させたいスクリプトを記述します。
__NG__EvalFile(__NG__HostPath().replace(/([^\\]+)$/,"lib\\Base.ng"));
Main.main=function(){
 /* script body */
 
}
Main.execute();
後は、EXEファイルの方を実行すれば、記述したスクリプトが実行されます。
なお、実行ファイルに渡されたコマンドライン引数は、スクリプト中で「Main.params」というプロパティで配列として参照できます。

実は実行ファイルの部分はng.exe/ngw.exeと全く同じなのですが、コマンドラインの第1引数のスクリプトを読み込んで実行するという処理が定義されている「Main.main()」を上書きすることで、コマンドライン引数を使用せずに任意の処理を実行させられるのです。

2010/08/14

HTTPDのプロキシサーバ機能

NILScriptのHTTPDには、プロキシサーバとして動作してブラウザからのリクエストに応答し、コンテンツを書き換えたりするという機能も用意されています。
プロキシ機能を使用するには、HTTPD初期化時の引数オブジェクトに、以下のようなメンバを指定します。
後は、ブラウザで「プロキシ自動設定スクリプト」などの欄に「http://localhost/__proxy__/conf.pac」を指定すれば、「useProxy」の条件に一致し「noProxy」に一致しないURLへのアクセス時に、NILScriptのHTTPDのプロキシ機能を経由してアクセスされます。
実際の例はNILScriptに同梱の「sample\HTTPD.ng」を参照してください。また、メソッドなどの詳細はNILScriptに同梱の「doc\HTTPD.txt」で説明されています。
 useProxy:"http://",
 noProxy:"http://localhost/",
 proxyRequest:function(c){
  println(c.method+' '+c.url);
  if(c.url.host=='lukewarm.s151.xrea.com'){
   c.addScripts(function(){
    TestPlugin.serverSideTest(['proxy @ '+location.href])
   });
   if(c.url.path.match(/\.png$/)){
    c.cache=Main.scriptDirectory.directory('cache');
   }
  }
 },
 proxyResponse:function(c,r){
  if((c.url.host=='lukewarm.s151.xrea.com')
      &&(c.url.path.match(/\.dat$/))){
   r.lines.invoke('split',/<>/).addIndex()
    .execute(function([i,[name,mail,date,message,title]]){
    if(i==0){
     c.beginHTML(title);
    }
    c.write('<h3>'+(i+1)+': '+name+'('+mail+') - '+date
      +'</h3><p>'+message+'</p>');
   });
   c.endHTML();
  }
 },
プロキシとしての動作を指定しているのは、「proxyRequest」と「proxyResponse」の2つのメンバです。

proxyRequestの関数は、プロキシのリクエストを受取った時点で呼ばれます。
第1引数には通常のコンテンツ生成関数と同じようにConnectionオブジェクトが与えられ、その機能でリクエスト情報の取得やレスポンスの送信などを行えます。
また、HTML中に任意のスクリプトを挿入する「c.addScript()」や、テキストやHTMLノードに対するフィルタリングを行うメソッド群など、プロキシハンドラ専用の機能もいくつか用意されています。
addScript()で埋め込めるスクリプトでは、HTTPD上に定義したサーバ側関数なども利用できます。

「c.cache=」のようにすれば、レスポンスボディを保存するキャッシュファイルを指定できます。この場合、キャッシュファイルがあれば本来のリクエストを行わずにそれを返し、無ければ受信しながらキャッシュファイルとして保存するという動作になります。
また、「c.error(404)」のようにして、本来のリクエストを行わずにエラーを返したり、「c.write()」などで自前のコンテンツに差し替えてしまうことも可能です。

proxyRequestの中で送信が行われなかった場合、リクエストに従ってアクセスを行いレスポンスヘッダの取得までが行われ、proxyResponseで指定した関数が呼ばれます。
この時、第1引数にはConnectionオブジェクトが、第2引数にはリクエストにしたがって行ったHTTPリクエストのResponseオブジェクトが与えられます。Responseオブジェクトの機能の詳細については、「doc\HTTP.ng」の方で説明されています。

ここでは、レスポンスヘッダを書き換えたり、エラー時に代替コンテンツを生成して返すなどの処理を行うといいでしょう。
また、第2引数のレスポンスオブジェクトからレスポンスボディを読み込んで、そこから抜き出した情報を元にレスポンスを生成することも出来ます。


プロキシ機能を利用すれば、ブラウザを問わずに利用できる様々なブラウジング補助機能を実現できます。
ただし、ブラウザの設定を変更してプロキシを設定しなければならないという難点があるので、できるだけ通常のコンテンツ生成関数を利用した方がいいかもしれません。
例えば、あるWeb掲示板の表示を見やすくする機能を作りたい場合は、ページを取得して見易いHTMLに加工して返すというコンテンツ生成関数をHTTPD上のURLに割り当て、プロキシ機能では掲示板のURLから用意したURLへのリダイレクトのみを行うようにしておくのです。
こうすれば、プロキシ機能を利用できなくても、HTTPD上のURLへ直接アクセスすれば、用意された機能を利用できます。

2010/08/12

ウィンドウへのファイルドロップを生成するdropFiles()

NILScriptのWindowユニットには、他プロセスの所有するウィンドウ上の入力欄の内容を操作したり、ボタンを押したりして自動操作を行う機能も用意されていますが、世の中にはエクスプローラなどからのドラッグ&ドロップでしかファイルの指定を受け付けてくれないソフトがあったりします。
そこで、ウィンドウへのファイルドロップをエミュレートする「dropFiles()」というメソッドが用意されています。
以下は、その使用例です。

var w=require("Window").Window.find("Notepad");
if(w){
 w.dropFiles(Main.script).activate(true);
}else{
 run('notepad "'+Main.script+'"');
}

最初の行で、ウィンドウクラス名が「Notepad」であるウィンドウを検索して、見つかればそのWindowオブジェクトを「w」変数に代入しています。
次のif文で、ウィンドウが見つかったかどうかに応じて分岐しており、見つからなかった場合は新規にnotepadにスクリプトファイルを与えて起動し、見つかった場合はスクリプトファイルのドロップをエミュレートした後ウィンドウをアクティブ化しています。
Main.scriptというのは、自プロセスで実行されているスクリプトファイルを表すFileオブジェクトです。

なお、dropFiles()には、配列で複数のファイルを渡したり、第2,第3引数でドロップされるX/Y座標も指定することも出来ます。また、ドロップするファイルはFile/Directoryオブジェクトではなく単なるフルパス文字列で指定しても構いません。

「開く」メニューなどによるファイル指定方法が用意されているソフトでも、ドロップで指定した方が1ステップで済んで便利ですので、自動化ツールを作成する時には是非dropFiles()を活用してください。

他プロセスのコマンドラインを取得

NILScriptのProcessオブジェクトには、他のプロセスのコマンドライン文字列を取得する「commandline」プロパティが用意されています。
これを使用すれば、特定のファイルを開いているプロセスを強制終了するなどの機能も簡単に実現できるでしょう。

Windowsには、他プロセスのコマンドラインを取得するAPIが用意されていないため、commandlineの取得は特殊な方法で実現されています。
自プロセスのコマンドライン文字列を取得するのに使う「GetCommandLine」というAPIの関数アドレスが、同一環境上の全てのプロセスで一定であることを利用して、「ReadProcessMemory」というAPIで対象プロセスのメモリ内容を取得し、そこからコマンドライン文字列が格納されているアドレスを辿って読み取るのです。
ただし、UAC環境下で別の権限で実行されているプロセスなどのコマンドライン文字列は取得できません。これはWindowsVista以降のタスクマネージャに追加されたコマンドライン文字列表示機能でも同様のようです。

Window.observe()でウィンドウの表示などに応答

NILScriptでは、「Window」ユニットに用意されている機能を使って、自前のGUIウィンドウを表示したり、他のプログラムの持つウィンドウを操作したり出来ます。

多くの機能が用意されているWindowクラスですが、中でも特徴的なのはウィンドウの生成や表示を監視してコールバック関数を実行してくれる「Window.observe()」でしょう。
この機能では、イベントの発生をシステムから通知してもらうシェルフックという仕組みを使用しているため、ループやタイマーでウィンドウの状態を監視するのに比べて低負荷で素早い応答が可能になっています。

次のスクリプトは、Window.observe()を使用したスクリプトの例です。
ここでは、ウィンドウの表示を監視し、条件に一致するウィンドウだったらそのウィンドウを閉じるという処理を行っています。
==の後の文字列は、それぞれ実行ファイル名とウィンドウタイトルの条件を指定しています。これを変更すれば、不要なダイアログなどを自動で閉じるツールとして使えるでしょう。

Main.createNotifyIcon();
var Window=require('Window').Window;
Window.observe('show',function(e){
 if((e.window.ownerProcess.name=='notepad.exe')&&(e.window.title=='行へ移動')){
  e.window.close();
 }
});

Window.observe()の第1引数はイベント名で、以下の物を指定できます。

activate
新たなウィンドウがアクティブになったとき。
create
ウィンドウが生成されたとき。
destroy
ウィンドウが破棄されたとき。
show
表示されたとき。なお、ツールチップなどのウィンドウでも発生する。
hide
非表示になったとき。
redraw
タイトルバーの内容が変更されたときなど。変更前と同じ内容の時もある。

第2引数には、イベントが発生した時に実行されるコールバック関数を指定します。
この関数の第1引数には、「window」メンバにイベント発生元のウィンドウを表すWindowオブジェクト、「event」メンバに発生したイベント名が格納されたオブジェクトが渡されます。
Windowオブジェクトに用意されている機能については、NILScriptに同梱の「doc\Window.txt」を参照してください。

2010/08/11

ClipboardでHTML形式を読み書きする

NILScriptには、クリップボードの読み書きを行うClipboardユニットが用意されています。
Clipboardユニットでは、単なるテキスト形式以外にも、ブラウザ上のWebページをコピーした時に格納されるHTML形式や、エクスプローラなどでファイルをコピーした時の形式なども操作できます。
これらの中でも特に役に立つのが、HTML形式の読み書きでしょう。

Webページの内容をコピーしてテキストエディタに貼り付けた場合、テキストとして表示されていなかったリンク先のURLなどは失われてしまいますが、ClipboardユニットのHTML形式読み取り機能を利用すれば、コピーされたHTMLを文字列として読み取ることが出来ます。
例えば、Webページ上のリンク集などをコピーした状態で以下のような式を使用すれば、コピーされたHTMLからリンクされていたURLを配列として抽出できます。

require("Clipboard").Clipboard.html.html.grep(/<a [^>]*href="([^"]*)"/i).map("1").toArray()

これを応用すれば「コピーした範囲にあるリンクを全て開く」などの機能を実現できます。
なお、grep()やmap()などは、SpiderMonkeyの「ジェネレータ」の拡張機能としてNILScriptで用意されているものです。詳細はNILScriptに同梱の「doc\base_stdex.txt」を参照してください。

また、以下のようにすれば、指定したHTMLをHTML形式としてクリップボードにコピーすることも出来ます。


require("Clipboard").Clipboard.html="<b>NILScript</b>"

これをブログの投稿画面などのWYSIWYG編集欄や、一部のワープロソフトなどに貼り付ければ、HTML内の文字装飾やレイアウト、リンクなどが反映されます。

これらの機能をHotstrokesなどと組み合わせて利用すれば、Webブラウジングや文書の編集などを効率化させられるでしょう。


真のマルチスレッド

NILScriptでは、HTTPDの応答処理やキー・マウスのフックなど、様々な処理がマルチスレッドで並列実行されるようになっています。
また、Thread.create()というメソッドを使用すれば、任意の関数を新規スレッドで実行させられます。
これにより、HTTPの通信など時間のかかる処理を行っている間に、その処理の完了を待つ必要がない他の処理を進めたりできます。

スクリプト実行環境のマルチスレッドというと、スクリプトエンジンが独自に複数の処理を切り替えながら少しずつ実行することで並列実行されているように見せる疑似マルチスレッドと、OSのスレッドの仕組みを利用して並列実行を行う真のマルチスレッドなど、いくつかの方式がありますが、NILScriptでは真のマルチスレッドが使用されています。
これは、NILScriptで利用しているJavaScriptエンジンのSpiderMonkeyが、いくつかの点に注意するだけで簡単に真のマルチスレッドでの利用が出来るようになっているおかげです。

NILScriptでは、多くの処理を外部のDLLが提供する関数を利用して実現していますが、そんな関数の中には処理に時間のかかる物も少なくありません。もし疑似マルチスレッドしか用意されていなかったら、データの読み込みなどを行っている間にキーボードフックの応答処理が実行できずに操作不能になるなど、様々な問題に見舞われることでしょう。
こうした問題に悩まされることなく様々な機能を実現するためには、真のマルチスレッドで実行できることが非常に重要なのです。

真のマルチスレッドには、マルチコアCPUなどの性能を引き出せるという利点もあります。実際のスレッドが一つしかない疑似マルチスレッドでは、一度に使われるコアは一つだけになっていまうので、デュアルコアCPUであれば50%までの性能しか引き出せませんが、各スレッドを別のコアで並列実行できる真のマルチスレッドでは、100%の性能を引き出せる場合もあるのです。
SpiderMonkeyでは、使われなくなったデータを解放するGCの際に他のスレッドを一時停止してしまうので、スクリプト部分での処理が多いとあまり高速化できない場合がありますが、外部DLLに画像処理などの時間がかかる処理をさせる場合は、CPUのコアの数だけスレッドを生成して並列実行させることで、CPUの性能の限界まで高速実行させられるでしょう。

キーボード・マウスのフック

Hotstrokesの内部処理の内、キーボードやマウスを扱う部分は「Keyboard」「Mouse」というユニットで定義されており、それぞれ単独で利用することも可能です。

これらのユニットでは、ユーザーの操作がシステムに受理される前に特定の処理を呼び出して、何らかの処理を行ったり操作の受理をブロックすることなどが出来る「フック」という仕組みを利用する機能が提供されています。
これらの機能を利用すれば、あらゆるキー操作に一括してある処理を割り当てたり、マウスの移動が発生するごとに処理を実行させるなど、Hotstrokesでは出来ないようなスクリプトも実現可能です。

このようなキー・マウスフックの機能を標準で利用できるスクリプト実行環境はあまり多くありませんので、フックを用いたツールを手軽に自作したい人などは、NILScriptを試してみるといいでしょう。
NILScriptに同梱の「sample」ディレクトリには、全てのキー操作の情報をコンソールに逐次出力する「keyboard_hook.ng」や、マウスが移動した時にその操作を無効にして上下左右が逆の操作を発生させる「sample/mouse_hook.ng」などのスクリプト例が用意されているので、参照してみてください。

なお、これらの機能を利用したスクリプトでは、あらゆる操作が不能になってしまうような危険なバグが発生する可能性があることに注意してください。
仮想PCやテスト用のPCなど、再起動する羽目になっても良いような環境で十分にテストをすることが望ましいでしょう。

2010/08/10

Hotstrokesのプラグイン機構

Hotstrokesでは、プラグイン機構によりキー名の定義などを追加することも可能になっています。
標準では、マウスのボタン操作やカーソル移動をストロークとして扱うプラグインなどが用意されており、マウスジェスチャ的な操作への動作割り当ても可能です。
その他、プラグインを作成すれば、タブレットやジョイスティックなどのデバイスの操作を独自のキーとして扱うことも可能になるでしょう。

更に、プラグイン機構では、条件別割り当てで使用する条件や、動作割り当ての動作として定義する処理なども定義できるようになっています。
特定のソフトに関する条件や動作の定義をまとめたプラグインを作成して公開しておけば、他の人はそれを導入して操作・条件・動作の組み合わせを記述するだけで簡単に望みの機能を利用できるはずです。
Hotstrokesでは、難しい定義をなるべく簡単に記述できるようにするような配慮は特に行われていませんが、これは条件や動作の定義は十分にスキルのある人がプラグインとして公開することを想定しているからです。

マルチストローク対応ホットキー定義機能「Hotstrokes」

NILScriptの機能の中でも比較的初期に実装され、代表的な機能であると思われている感があるのが「Hotstrokes」ですが、実はドラゴンボールの技に例えると「太陽拳」くらいの、たまに活躍するけどそれほど重要ではないという感じのポジションにあったりします。
しかし、せっかく作ったのですから、主な特徴について紹介しようと思います。
実際の使用例や詳細な仕様については、NILScriptのアーカイブに同梱されている「sample\Hotstrokes.ng」や「doc\Hotstrokes.txt」を参照してください。

Hotstrokesの基本的な機能は、特定のキー操作が行われた時にスクリプトで定義された処理を実行する「ホットキー」的なものですが、複数のキー操作からなるストローク列に対する動作割り当てを簡単に記述できるようになっているのが特徴です。
複数のキー操作というのは、例えばEmacsなどで見られる「C-x C-c」のような2ストロークキーや、「Ctrlキーの2連打」などのようなものです。また、あるキーを押してから他のキーを押さずに放すタップ操作なども、「押す」と「放す」の2つの操作からなる複数ストローク操作と言えます。(通常のホットキーは、押し下げた瞬間に発動するのが一般的です。)
その他、各ストロークを一定時間内に行ったり、「長押し」など一定時間待機してから続きの操作を行うなどの操作も、"Ctrl+C"のような基本的なホットキー定義と同じように、一つの定義文字列で指定できます。

また、既存のキーをCtrlやShiftのようなモディファイアキーとして再定義することも可能です。「mod1」のような同名のキーをいくつでも定義できる他、単に押してからすぐ放した時は本来のキーの動作を発生させる「ワンショットモディファイア」などと呼ばれる機能も簡単に定義可能です。

操作が行われた時に実行される動作の定義には、NILScriptの関数を指定できるので、ウィンドウを閉じるなどの操作をしたり別のキー操作を発生させるだけでなく、様々な動作を定義可能です。
また、アクティブウィンドウの種類などの条件に応じて動作を変える条件別割り当ても可能です。条件もNILScriptの関数で柔軟に定義可能です。

「谺の隠れ家(http://echokoda.y0r.net/archives/category/soft/nilscript)」というサイトでは、Hotstrokesを利用して「下駄配列」や「月配列」などの仮名入力を定義するスクリプトが公開されているので、Hotstrokesの応用例に興味がある人は是非参照してみてください。

HTTPD


NILScriptに用意されている機能の中で最も特徴的なのが、Webサーバ機能を実現する「HTTPD」です。
単にローカルにあるファイルを公開するだけでなく、リクエスト内容に応じて動的にWebページを生成して返すことも可能です。
また、ブラウザ上のJavaScriptからNILScript側の機能を呼び出すための機能も用意されており、HTMLによる自由度の高い画面表示とNILScriptの多彩な機能を連携させたアプリケーションを作成可能です。
ブラウザからアクセスして利用するため、設定画面などをブックマークしておいて素早く呼び出せるなど、通常のGUIアプリケーションでは出来ない使い方も可能です。

HTTPDの機能を試すには、NILScriptのアーカイブに含まれる「start_httpd.ng」を実行してください。サンプルのWebサーバスクリプトが起動し、ブラウザでドキュメントの検索・閲覧ページが表示されるはずです。
このスクリプトには、将来的には自作スクリプトの管理やアップデート情報の閲覧などの機能も追加され、NILScriptに関するポータルサイト的な物となる予定です。
HTTPDを利用したプログラムを作ってみたい場合は、アーカイブ内の「sample\HTTPD.ng」にあるサンプルスクリプト本体や、HTTPDのドキュメントを参考にしてください。
HTTPDによって公開されたドキュメント閲覧ページ
「Script console」のリンクからは、NILScriptのスクリプトを簡単に実行するためのコンソールページを表示できます。下部の入力欄にスクリプトを入力してボタンを押すと、入力されたスクリプトがHTTPDに送信され、実行結果(最後に評価された式の値)やエラーが返信され、ログとして表示されます。
スクリプトは専用のスレッド上で実行され、定義した変数などは次回実行時に引き継がれるので、対話型インタプリタのような感覚で利用できます。
簡単なコードを試してみたい場合などに役立つでしょう。
スクリプトコンソールのページ

このコンソールはHTTPDのプラグイン機構で実装されており、処理の本体は「plugins\HTTPD\ScriptEvaluator\ScriptEvaluator.ng」内に記述されています。スクリプト内容を見れば、NILScriptによってサーバ側関数の呼び出しがラップされて、HTTPのリクエストなどを意識することなく連携処理を記述できているのが分かるはずです。
また、スクリプト実行環境の部分はライブラリ化されており、「lib\ScriptEvaluator._test\ScriptEvaluator.ng」にあります。こちらでは、マルチスレッドでの同期処理機能などの使用例が見られます。

なお、NILScriptのHTTPDは、ローカルネットワーク上から1人もしくは小数のユーザーがアクセスして利用することのみを想定しているため、インターネット上に公開して不特定多数のユーザーに利用してもらう用途には向いていません。
これは、NILScriptではネットサービス上から必要な情報を収集して様々に活用するプログラム群の作成を優先的な目標としているためです。
わざわざネットサービス型のプログラムを作成するのは、不特定多数のユーザーの投稿を利用した集合知的な機能を実現したい場合か、広告を掲載して収入を得たい場合などが主だと思われますが、広告を無視して情報を抽出するツールを使用してアクセスする人が増えれば、サーバ負荷ばかり増えて収入は減ってしまいます。
そうなると、NILScriptのHTTPDに不特定多数からのアクセスを捌くための機能を充実させたとしても、大した使い道が無く無駄になってしまうでしょう。
そのような理由から、今後も大規模ネットサービス公開向けの機能が積極的に実装される予定はありません。どうしても欲しいという人は、自分で拡張ライブラリを作成してください。