Event規格SHIORI/3.1SAORI/1.0(外部サイト)PLUGIN/2.0HEADLINE/2.0DLLShelldescript.txtdescript.txt(Shellの)charset,文字コードname,シェル名id,ID名type,種別craftman,作者名craftmanw,作者名craftmanurl,URLhomeurl,URLreadme,ファイル名menu,hiddensakura.name,名前sakura.name2,名前kero.name,名前char*.name,名前seriko.zorder,スコープID,スコープID,...seriko.sticky-window,スコープID,スコープID,...seriko.alignmenttodesktop,位置情報sakura.seriko.alignmenttodesktop,位置情報kero.seriko.alignmenttodesktop,位置情報char*.seriko.alignmenttodesktop,位置情報sakura.defaultx,X座標kero.defaultx,X座標char*.defaultx,X座標sakura.defaulty,Y座標kero.defaulty,Y座標char*.defaulty,Y座標sakura.defaultleft,X座標kero.defaultleft,X座標char*.defaultleft,X座標sakura.defaulttop,Y座標kero.defaulttop,Y座標char*.defaulttop,Y座標sakura.balloon.offsetx,座標sakura.balloon.offsety,座標kero.balloon.offsetx,座標kero.balloon.offsety,座標sakura.balloon.alignment,位置情報kero.balloon.alignment,位置情報menu.font.name,フォント名menu.font.height,フォントサイズmenu.background.bitmap.filename,ファイル名menu.foreground.bitmap.filename,ファイル名menu.sidebar.bitmap.filename,ファイル名menu.background.font.color.r,数値menu.background.font.color.g,数値menu.background.font.color.b,数値menu.foreground.font.color.r,数値menu.foreground.font.color.g,数値menu.foreground.font.color.b,数値menu.separator.color.r,数値menu.separator.color.g,数値menu.separator.color.b,数値menu.disable.font.color.rmenu.disable.font.color.gmenu.disable.font.color.bmenu.background.alignment,位置menu.foreground.alignment,位置menu.sidebar.alignment,位置sakura.bindgroup*.name,カテゴリ名,パーツ名,サムネイル名sakura.bindgroup*.default,数値sakura.bindgroup*.addid,IDsakura.bindoption*.group,カテゴリ名,オプションsakura.menuitem*,IDsakura.menu,autoまたはhiddenkero.bindgroup*.name,カテゴリ名,パーツ名,サムネイル名kero.bindgroup*.default,数値kero.bindgroup*.addid,IDkero.bindoption*.group,カテゴリ名,オプションkero.menuitem*,IDkero.menu,autoまたはhiddenchar*.bindgroup*.name,カテゴリ名,パーツ名,サムネイル名char*.bindgroup*.default,数値char*.bindgroup*.addid,IDchar*.bindoption*.group,カテゴリ名,オプションchar*.menuitem*,IDchar*.menu,autoまたはhiddenseriko.paint_transparent_region_black,数値seriko.use_self_alpha,数値サーフェスの位置情報バルーンの位置情報descript.txtdescript.txt(Shellの)概要シェルの基本設定ファイル。シェル名や作者情報の他、バルーンの表示位置設定や、オーナードローメニュー(右クリックメニュー)の画像設定、着せ替えのオーナードローメニューでの表示設定などもここで行う。記述例と基本の書き方charset,Shift_JIStype,shellname,mastercraftman,ukadogcraftmanw,うか犬craftmanurl,http://ssp.shillest.net/ukadoc/manual/index.htmlmenu.background.bitmap.filename,menu_background.pngmenu.foreground.bitmap.filename,menu_foreground.pngmenu.sidebar.bitmap.filename,menu_sidebar.pngsakura.balloon.offsetx,0sakura.balloon.offsety,80kero.balloon.offsetx,-20kero.balloon.offsety,10sakura.balloon.alignment,nonekero.balloon.alignment,nonesakura.bindgroup0.name,服,エプロンドレス,apronsakura.bindgroup1.name,リボン,白リボン,ribbonwhitesakura.bindgroup2.name,服,黒服,blacksakura.bindgroup3.name,リボン,黒リボン,ribbonblacksakura.bindgroup0.default,1sakura.bindgroup1.default,1kero.bindgroup0.name,ネクタイ,ネクタイkero.bindgroup1.name,腕章,黒腕章kero.bindgroup2.name,腕,ドリルkero.bindgroup0.default,1kero.bindgroup1.default,1sakura.menuitem0,2sakura.menuitem1,3sakura.menuitem2,-sakura.menuitem3,0sakura.menuitem4,1kero.menuitem0,0kero.menuitem1,1kero.menuitem2,-kero.menuitem3,2type、nameは必須。SSPでは、シェルに対してもhomeurlを設定しておくことで、エクスプローラなどからネットワーク更新が可能になる。着せ替え設定の各項目については後述のそれぞれの節を参照。基本的な仕組みは、surfaces.txtで定義した、タイミングbindのanimationIDに対して、着せ替え名と着せ替えカテゴリ名を与え(sakura(kero).bindgroup*.name,~)、またオーナードローメニュー上での配置を指定する必要がある(sakura(kero).menuitem*,~)。\や%で始まる文字列はさくらスクリプトや環境変数のタグと見なされ、セキュリティ上のリスクから破棄される。単なる文字としてそれらを含めたい場合は、\\や\%などとしてエスケープする必要がある。charset,文字コード表示する文字コード。Shift_JIS推奨。不明/SSPはShift_JISname,シェル名そのシェルの名前。省略不可id,ID名そのシェルのID名。値なしtype,種別ファイルセットの種別。シェルの場合はshell。省略不可/SSPの場合はシェルフォルダ内にあるものはshellと自動識別されるcraftman,作者名そのシェルの作者名。値なしcraftmanw,作者名そのシェルの作者名。値なしcraftmanurl,URL作者のURL。値なしhomeurl,URLネットワーク更新用のURL。値なしreadme,ファイル名インストール時やメニューから開かれるシェルの説明テキストファイル名。readme.txtmenu,hiddenシェルをゴーストのシェル切り替えメニューに表示しなくなる。本題側のゴーストの名前。本題側のゴーストの名前。相方側のゴーストの名前。ghostのdescript設定char*.name,名前\p[*]の名前。ghostのdescript設定seriko.zorder,スコープID,スコープID,...\![set,zorder,スコープID,スコープID,...]のdescript版。タグを実行しなくてもあらかじめ設定できる。値なし2.4seriko.sticky-window,スコープID,スコープID,...\![set,sticky-window,スコープID,スコープID,...]のdescript版。タグを実行しなくてもあらかじめ設定できる。全体のサーフェスのデフォルト※表示位置情報。ゴースト側指定より優先度が高く、シェル側個別指定(sakura.seriko.alignmenttodesktopなど)より優先度が低い。本体側のデフォルト※表示位置情報。シェル側全体指定(seriko.alignmenttodesktop)より優先度が高い。全てのalignmenttodesktop系指定で一番優先度が高い。相方側のデフォルト※表示位置情報。シェル側全体指定(seriko.alignmenttodesktop)より優先度が高い。全てのalignmenttodesktop系指定で一番優先度が高い。※ゴースト側全体指定<ゴースト側スコープ個別指定<シェル側全体指定<これ値なしchar*.seriko.alignmenttodesktop,位置情報2人目以降の相方側のデフォルト※表示位置情報。シェル側全体指定(seriko.alignmenttodesktop)より優先度が高い。全てのalignmenttodesktop系指定で一番優先度が高い。本体側の画像ベースX座標。相方側の画像ベースX座標。ghostのdescript設定(無ければ画像中央)char*.defaultx,X座標2人目以降の相方側の画像ベースX座標。本体側の画像ベースY座標。相方側の画像ベースY座標。ghostのdescript設定(無ければ画像下端)char*.defaulty,Y座標2人目以降の相方側の画像ベースY座標。本体側のディスプレイ上でのデフォルトX座標。相方側のディスプレイ上でのデフォルトX座標。ghostのdescript設定char*.defaultleft,X座標2人目以降の相方側のディスプレイ上でのデフォルトX座標。本体側のディスプレイ上でのデフォルトY座標。相方側のディスプレイ上でのデフォルトY座標。ghostのdescript設定char*.defaulttop,Y座標2人目以降の相方側のディスプレイ上でのデフォルトY座標。本体側バルーン位置X座標。本体側バルーン位置Y座標。相方側バルーン位置X座標。相方側バルーン位置Y座標。本体側の吹き出しの※位置情報。相方側の吹き出しの※位置情報。ghostのdescript設定menu.font.name,フォント名オーナードローメニューに使用するフォント。OSで設定されたUI標準フォントmenu.font.height,フォントサイズオーナードローメニューに使用する文字の大きさ。OSで設定されたUI標準フォントの高さmenu.background.bitmap.filename,ファイル名バックグラウンド表示画像ファイル名。ベースウェア標準の画像menu.foreground.bitmap.filename,ファイル名フォアグラウンド表示画像ファイル名。ベースウェア標準の画像menu.sidebar.bitmap.filename,ファイル名サイドバー表示画像ファイル名。3menu.background.alignment,位置バックグラウンド画像をrighttopで右寄せ、lefttopで左寄せ、centertopで中央寄せ。SSPのみrightbottom、leftbottom、centerbottomのような下方向固定も可。lefttopmenu.foreground.alignment,位置フォアグラウンド画像をrighttopで右寄せ、lefttopで左寄せ、centertopで中央寄せ。SSPのみrightbottom、leftbottom、centerbottomのような下方向固定も可。lefttopmenu.sidebar.alignment,位置サイドバー画像をtopで上寄せ、bottomで下寄せ。bottomsakura.bindgroup*.name,カテゴリ名,パーツ名,サムネイル名アニメーションID*番のパーツにカテゴリ名とパーツ名を定義。(本体側)アニメーションIDはsurfaces.txtにおけるアニメーション定義の「animation*.interval,bind」の*にあたる数字。オーナードローメニューの着せ替えに表示するために必要。Scriptの\![bind,カテゴリ名,パーツ名,数値]で操作するためにも必要。(SSPのみ)動作なしsakura.bindgroup*.default,数値アニメーションID*番の着せ替えを最初から表示するか否か。1で表示、0で非表示。(本体側)0sakura.bindgroup*.addid,ID着せ替えの同時実行設定。アニメーションID*番の着せ替えが有効になった(表示された)時に、addidとして指定した着せ替えも同時に有効にする。着せ替えは、元となった着せ替えが無効になった時点で無効になる。複数の着せ替えのaddidとして同一の着せ替えが同時実行指定されている場合、元となったすべての着せ替えが無効になるまで同時実行指定の着せ替えも無効にならない。(本体側)動作なしsakura.bindoption*.group,カテゴリ名,オプションその着せ替えカテゴリにオプションを設定。*は単に0から始まる通し番号(本体側)。mustselectでパーツを必ず1つ選択、multipleで複数のパーツを選択可能。sakura.menuitem*,ID着せ替えメニュー上の*の位置にそのアニメーションIDの着せ替えを表示。*は0から始まる通し番号。(本体側)IDの代わりに「-」を指定すると、その位置に仕切り線表示。動作なしsakura.menu,autoまたはhiddenシェルの本体側の着せ替えメニューの表示。autoで自動表示、hiddenで非表示。動作なし(手動設定)kero.bindgroup*.name,カテゴリ名,パーツ名,サムネイル名アニメーションID*番のパーツにカテゴリ名とパーツ名を定義。(相方側)アニメーションIDはsurfaces.txtにおけるアニメーション定義の「animation*.interval,bind」の*にあたる数字。オーナードローメニューの着せ替えに表示するために必要。Scriptの\![bind,カテゴリ名,パーツ名,数値]で操作するためにも必要。(SSPのみ)動作なしkero.bindgroup*.default,数値アニメーションID*番の着せ替えを最初から表示するか否か。1で表示、0で非表示。(相方側)0kero.bindgroup*.addid,ID着せ替えの同時実行設定。アニメーションID*番の着せ替えが有効になった(表示された)時に、addidとして指定した着せ替えも同時に有効にする。着せ替えは、元となった着せ替えが無効になった時点で無効になる。複数の着せ替えのaddidとして同一の着せ替えが同時実行指定されている場合、元となったすべての着せ替えが無効になるまで同時実行指定の着せ替えも無効にならない。(相方側)動作なしkero.bindoption*.group,カテゴリ名,オプションその着せ替えカテゴリにオプションを設定。*は単に0から始まる通し番号(相方側)。mustselectでパーツを必ず1つ選択、multipleで複数のパーツを選択可能。kero.menuitem*,ID着せ替えメニュー上の*の位置にそのアニメーションIDの着せ替えを表示。*は0から始まる通し番号。(相方側)IDの代わりに「-」を指定すると、その位置に仕切り線表示。動作なしkero.menu,autoまたはhiddenシェルの相方側の着せ替えメニューの表示。autoで自動表示、hiddenで非表示。動作なし(手動設定)char*.bindgroup*.name,カテゴリ名,パーツ名,サムネイル名アニメーションID*番のパーツにカテゴリ名とパーツ名を定義。(3人目以降)アニメーションIDはsurfaces.txtにおけるアニメーション定義の「animation*.interval,bind」の*にあたる数字。オーナードローメニューの着せ替えに表示するために必要。Scriptの\![bind,カテゴリ名,パーツ名,数値]で操作するためにも必要。(SSPのみ)動作なしchar*.bindgroup*.default,数値アニメーションID*番の着せ替えを最初から表示するか否か。1で表示、0で非表示。(3人目以降)0char*.bindgroup*.addid,ID着せ替えの同時実行設定。アニメーションID*番の着せ替えが有効になった(表示された)時に、addidとして指定した着せ替えも同時に有効にする。着せ替えは、元となった着せ替えが無効になった時点で無効になる。複数の着せ替えのaddidとして同一の着せ替えが同時実行指定されている場合、元となったすべての着せ替えが無効になるまで同時実行指定の着せ替えも無効にならない。(3人目以降)動作なしchar*.bindoption*.group,カテゴリ名,オプションその着せ替えカテゴリにオプションを設定。*は単に0から始まる通し番号(3人目以降)。mustselectでパーツを必ず1つ選択、multipleで複数のパーツを選択可能。char*.menuitem*,ID着せ替えメニュー上の*の位置にそのアニメーションIDの着せ替えを表示。*は0から始まる通し番号。(3人目以降)IDの代わりに「-」を指定すると、その位置に仕切り線表示。動作なしchar*.menu,autoまたはhiddenシェルの3人目以降の着せ替えメニューの表示。autoで自動表示、hiddenで非表示。画像の透過色(画像左上の色)になっているにも関わらず、透明度の値では透明でない領域の表示設定。0の場合は画像本来の色(透過色)を指定の透明度で表示する。1の場合は画像の色の替わりに黒で塗りつぶされてから指定の透明度で表示する。0を指定した上で全面真っ白のpnaを用意した画像は、透過色なしで画像のまま表示される。数値が1だった場合はpnaでなく画像自体(32bitPNG)のアルファチャンネルを透明度として使用する。1の場合でもアルファチャンネルを持たない画像についてはpnaが有効。0サーフェスの位置情報top上部に貼り付き表示。bottom下部に貼り付き表示。バルーンの位置情報none自動調整、shellのY座標が画面中央より左なら右、右なら左に表示。left常に左に表示。