![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
|
SAORI関連文書。 さおりとは †ゴーストに関数・機能追加を行うSIORIから利用するプラグインで、dllやexe形式で提供されます。 さおりを使う †里々で使う手順は以下のとおり。
使用例 †MIYさんのmciaudio.dllを組み込む例。
tips †
ちなみに「＠SAORI」であらかじめ引数付きで設定しておくと、 曲読み込み,saori/mciaudio.dll,load 演奏,saori/mciaudio.dll,play 文中で下記のように呼び出しできるようになる。 （曲読み込み,鳥の詩.mp3）（演奏） 補足 †配布されているさおり同梱の説明は里々以外の栞に向けて書かれている事が多いので、ちょっと説明。
これはさおりの引数です。（「第○パラメータ」と書かれてる事もあります） （[使うさおりの適当な短縮名],[Argument0],[Argument1],…）
これはさおりからの返り値です。 「相対パス」はそのSAORIの置いてある位置から辿ったパスです。(※違う場合もあるかもしれません) 引数にウィンドウハンドル（HWND）を入れるよう指示するさおりもあります。それは下記の「ウィンドウハンドルのつかいかた」を参考にして入れてください。大抵の場合（本体ハンドル０）を使えばOK。 SAORI-basicのタイムアウト †里々ではSAORI-basicも標準でuniversalと区別無く使用できる様になっていますが、タイムアウトが設定されている為スグに値を返さない物はタイムアウトエラーになります。回避する方法としてはClearBrain Systemsさんの、SAORI "Basic" Proxy DLLを使用して下さい。 さおりを意図したタイミングで使う（同期呼び出し） †例えば１回のトーク中でfill_desktopを複数回呼んでも、期待するような動作はしないでしょう。 以下サンプル。 ＊ ：いくよー。\w9\w9\w9 まず赤。\![raise,塗りつぶし,255,0,0]\w8\w8 次は青。\![raise,塗りつぶし,0,0,255]\w8\w8 でもって黄色。\![raise,塗りつぶし,255,255,0]\w8\w8 おしまいっと。\![raise,塗りつぶし解除] ＊塗りつぶし （fill_desktop,（Ｒ０）,（Ｒ１）,（Ｒ２）） ＊塗りつぶし解除 （fill_desktop） ちなみに「さとりて」経由だと\![raise]は効かない模様。多分セキュリティ上の理由なんでしょうけど、でもlocalだしな。想定された動作なのか微妙。 新くて簡単な方法 †（sync,fill_desktop,255,255,0） とすると「しゃべり途中に同期して」黄色く塗りつぶされます。 よく使うものであれば、replace.txtに filldt【タブ】sync,fill_desktop と書いた上で（filldt,255,255,0）とかすると楽。 使いどころは http://www10.plala.or.jp/sryu/nanika/tips/#saori_raise 辺りを読むとわかりやすいかと。
ウィンドウハンドルのつかいかた †ウィンドウハンドルの通知時に ＊hwnd が呼ばれる。 例） ＊hwnd （split,（Ｒ０）,（sprintf,%c,1）） ＄本体ハンドル０＝（Ｓ０） ＄本体ハンドル１＝（Ｓ１） （split,（Ｒ１）,（sprintf,%c,1）） ＄バルーンハンドル０＝（Ｓ０） ＄バルーンハンドル１＝（Ｓ１） ＃\0・\1の本体・バルーンのハンドルを変数に保存する。~ ＃この変数をハンドルを必要とするさおり呼び出しに使用する。~ ＃（Ｓ２）以降を参照することで\2以降のハンドルも取得できるが、~ ＃ウィンドウが初期化されていない場合無効なハンドルが~ ＃渡されてくるかもしれない。（未検証）~ 「カッコずらずら → \nずらずら」を回避する †連続してSAORIを使うときなど、改行していくと\nが連なってしまう問題を回避する。 （nop, （あれ） （これ） （それ） （どれ） ） 内部関数nopは「何もしない」。引数も無視される。 nop関数はset_wall_paper.exeなど使うと必ず返り値が返ってきてしまうさおりでトーク中に返り値を表示したくない時にも使います。 ＊ ：（nop、（set_wall_paper、img.bmp、1））壁紙貼りつけたよー。 ただし以下のように記述するとさおりが動作しなくなるので注意。 ＊ ：（nop、（sync、set_wall_paper、img.bmp、1））壁紙貼りつけたよー。 （そもそもsyncを使うと返り値が返らなくなるのでnopを使う必要はありません） バイト値1のつくりかた †（sprintf,%c,1） でバイト値1が返る(satori_conf.txtにsprintf,saori/ssu.dll,sprintfの登録が必要)。 hwndの分割にはこれを使う。 里々134-901以降次の書式で作れるようになりました。 （バイト値,１） ssu.dllを使おう †里々で文字列操作を行う場合、必須となるSAORI。 参考：外部関数/ssu 以下里々の履歴より抜粋。 条件分岐 if,真偽,真結果[,偽結果] unless,真偽,偽結果[,真結果] 条件並列分岐 switch,左辺,右辺1,結果1,右辺2,結果2,... 数値による分岐 nswitch,数値,結果1,結果2,... 部分文字列の抜き出し substr,文字列,位置,文字数 文字列の分割（返値は個数、複数返値に分割結果を格納） split,文字列[,分割文字[,最大分割数]] 文字列中の「前」を「後」に置換 replace,文字列,前,後 replace_first,文字列,前,後 文字列中の「対象」を消去 erase,文字列,対象 erase_first,文字列,対象 文字列中に「対象」がいくつあるか数えて個数を返す count,文字列,対象 ２つの文字列が等しければ1,さもなくば0を返す compare,文字列1,文字列2 文字列の先頭が頭文字列であれば1,さもなくば0を返す compare_head,文字列,頭文字列 文字列の末尾が尾文字列であれば1,さもなくば0を返す compare_tail,文字列,尾文字列 文字数を返す length,文字列 「数字、アルファベット、一部の記号」を半角全角変換。 zen2han,文字列 han2zen,文字列 計算式を計算して結果を返す。ifやswitch等の引数は、暗黙のうちにこれを実行しています。 calc,計算式 計算式を計算して結果を返す。少数も扱える。 calc_float,計算式 引数が空文字列であれば 1 、さもなくば 0 を返す。 is_empty 引数が数値であれば 1 、さもなくば 0 を返す。 is_digit 引数が英字列であれば 1 、さもなくば 0 を返す。 is_alpha 一つの左辺に対し、複数の右辺を順番に比較していきます。 iflist ＊OnBoot ：（iflist、（現在時）、 ＜６、こんばんは。、 ＜１１、おはようございます。、 ＜１８、こんにちは。、 ＜２４、こんばんは。） カタカナとひらがなの相互変換。文字列比較用かな。 kata2hira hira2kata sprintf 書式指定出力。printfとしてはかなりサブセットですが。 具体的には（sprintf,d:d,（現在時）,（現在分））で時刻の二桁出力ができます。 詳しく知りたい場合は「printf 書式」とかで検索すると……出てはくるでしょうけど。 引数がSAORIで処理する前に計算されてしまうのを防ぐ †例えばこう記述して「1+1+1」内の「+」を消そうとすると （erase、1+1+1、+） 「1+1+1」がerase処理前に計算され、「111」ではなく「3」という結果が出てしまう。 計算されなくても全角数字にが勝手に半角になってしまい困る場合もある。 対処法・1 †（erase、"1+1+1"、+） このように「"」で囲めば「1+1+1」が計算されるのを防ぎ、「"111"」と出る （ダブルクオーテーションに限らず、数字/算術記号でなければなんでも可） ただしこの場合「"」が邪魔になってしまうので （erase、（erase、"1+1+1"、+）、"） こうやって「"」も消しておく。 対処法・2 †上記の方法が面倒な場合はこちらを。 ＄SAORI引数の計算【タブ】無効 SAORIを使う前にこう記述すると引数の計算を防ぐ事ができる。 ただこの状態のままだとtime_check.dllなどのSAORIが正常に動かなくなるという弊害もあるので、用が済んだら「＄SAORI引数の計算【タブ】自動」に戻しておいた方が良い。 ＄SAORI引数の計算【タブ】有効 計算する。 ＄SAORI引数の計算【タブ】無効 計算しない。 ＄SAORI引数の計算【タブ】自動 各引数の先頭文字が数値または＋、−記号のいずれかであれば計算する。 何も指定しなければこれ。今までと同じ動作。 easyballoonを使った、起動／終了／交代トーク †もどきで質問があったeasyballoonを使った起動／終了／交代トーク。
栞をさおりとして使う †栞の中には、さおりとしても使えるようになっているものもありますが、各栞の配布サイトでダウンロードしてきた初期状態ではさおりとして動作しないものもあります。
|
