surfaces.txt または surfaces**.txt(SSPのみ)

charset,文字コード

表示する文字コード。旧い環境との互換性を考慮する場合はShift_JIS、それ以外はUTF-8を推奨。

SSPにおいて複数のsurfaces***.txtを用意した場合はそれぞれのファイルに設定する必要がある（逆に言うとそれぞれのファイルで異なる設定が可能）。

(OSの標準設定またはSSP->国際化->省略時の文字コード->テキスト定義)

• 
• 

descriptブレス

descript
{
version,1
collision-sort,ascend
animation-sort,ascend
}

version,*

使用するSERIKO定義の書式のバージョン指定。0でSERIKO/1.x系書式（旧定義）、1でSERIKO/2.0書式。

0

• 
• 
• 

maxwidth,ピクセル

※SSPでは自動的に検出されるためこの情報は利用されない。
サーフェスの最大幅。単位はピクセル。重なり判定などで利用される。

定義なし/SSPでは実際のsurface定義における最大横幅

• 
• 
• 

collision-sort,ソート順序

当たり判定の判定順ソート。手前から奥にどの順で表示するか。
ascendで昇順(1,2,3...) descendで降順(10,9,8...)

none（IDによらず先に書かれている方が手前）

• 

animation-sort,ソート順序

アニメーションID表示順ソート。手前から奥にどの順で表示するか。
ascendで昇順(1,2,3...) descendで降順(10,9,8...)

descend

• 

surfaceブレス

surface1
{
element0,overlay,body0.png,0,0
element1,overlay,face0.png,0,0

collision0,188,25,252,63,Head
collision1,190,92,236,118,Face
collision2,180,191,220,222,Bust
collision3,154,311,248,362,Skirt

animation0.interval,sometimes
animation0.pattern0,overlay,101,100,168,67
animation0.pattern1,overlay,100,100,168,67
animation0.pattern2,overlay,101,100,168,67
animation0.pattern3,overlay,-1,100,168,67
}

surface.append1-9,20-29
{
// 略（ふつうのsurfaceブレスと同様）
}

surface0
{
// 瞬き
animation0.interval,rarely
animation0.pattern0,overlay,101,700,200,100
animation0.pattern1,overlay,102,700,200,100
animation0.pattern2,overlay,101,700,200,100
animation0.pattern3,overlay,-1,700,0,0

// トークに合わせて口を動かす
animation10.interval,talk,2
animation10.pattern0,overlay,200,700,200,120
animation10.pattern1,overlay,201,700,200,120
animation10.pattern2,overlay,202,700,200,120
animation10.pattern3,overlay,-1,700,0,0
}

surface0
{
// 服1の定義　アニメーションIDは0
animation0.interval,bind
animation0.pattern0,add,500,0,50,100

// 服2の定義　アニメーションIDは1
animation1.interval,bind
animation1.pattern0,add,501,0,50,100
}

//--- 以下着せ替えパーツ定義 ---
// 服1
surface500
{
element0,overlay,dress1.png,0,0
}

// 服2
surface501
{
element0,overlay,dress2.png,0,0
}

// 旧定義
surface1
{
0interval,rarely
0pattern0,0,0,alternativestart,[1,2]

1interval,never
1pattern0,101,70,overlay,200,100
1pattern1,102,70,overlay,200,100
1pattern2,101,70,overlay,200,100
1pattern3,-1,70,overlay,0,0

2interval,never
2pattern0,101,70,overlay,200,100
2pattern1,102,70,overlay,200,100
2pattern2,101,70,overlay,200,100
2pattern3,-1,70,overlay,0,0
2pattern4,101,70,overlay,200,100
2pattern5,102,70,overlay,200,100
2pattern6,101,70,overlay,0,0
2pattern7,-1,70,overlay,0,0
}

// 新定義
surface1
{
animation0.interval,rarely
animation0.pattern0,alternativestart,(1,2)

animation1.interval,never
animation1.pattern0,overlay,101,700,200,100
animation1.pattern1,overlay,102,700,200,100
animation1.pattern2,overlay,101,700,200,100
animation1.pattern3,overlay,-1,700,0,0

animation2.interval,never
animation2.pattern0,overlay,101,700,200,100
animation2.pattern1,overlay,102,700,200,100
animation2.pattern2,overlay,101,700,200,100
animation2.pattern3,overlay,-1,700,0,0
animation2.pattern4,overlay,101,700,200,100
animation2.pattern5,overlay,102,700,200,100
animation2.pattern6,overlay,101,700,200,100
animation2.pattern7,overlay,-1,700,0,0
}

surface1,surface3,surface4
{
// 略
}

surface1,3
{
collision0,188,25,252,63,Head
collision1,180,191,220,222,Bust
}

surface1-3
{
animation0.interval,sometimes
animation0.pattern0,overlay,101,100,168,67
animation0.pattern1,overlay,100,100,168,67
animation0.pattern2,overlay,101,100,168,67
animation0.pattern3,overlay,-1,100,168,67
}

surface.append1-3
{
// 略
}

element*,描画メソッド,ファイル名,X座標,Y座標

ベースサーフェスの合成。
複数の画像を合成し、その合成結果をベースサーフェスとして一枚の画像のように扱う仕組み。
サーフェスに対応するsurface*.pngという画像がある場合、element0が定義されていると元のsurface*.pngの内容が破棄されて、element0で置き換えられる
element1以降は、その上に順次合成されていく。
SSP2.3.53からは、element定義されたサーフェスをアニメーションパーツとして用いた場合も、一枚の画像のように振る舞う（以前は未定義）。
*の部分（elementID）は同じsurface内で一貫した、0から始まる通し番号。
描画メソッドは下記の描画メソッド参照。

挙動なし

• 
• 
• 

animation*.interval,インターバル

アニメーションが開始するタイミング（周期）の定義。
インターバルは下記のアニメーションインターバル参照。SSPのみ+区切りで列挙する事で組み合わせ指定が可能。
*の部分（animationID）は任意の数字。そのスコープ内（\0、\1、...）の全surfaceで、共通して同じIDのアニメーションが同じ意味（例えば「瞬き」「口パク」「同じ服の着せ替え」など）を持つようにする。
interval定義はそのIDのアニメーション定義全体の始点を示し、一連のanimation定義の中で必ず最初に記述されなければならない。
アニメーションの重なり方とIDの順序の関係はanimation-sort参照。
旧定義：*interval,インターバル

挙動なし

• 
• 
• 

animation*.pattern*,描画メソッド,サーフェスID,ウェイト,X座標,Y座標

アニメーションの各コマの定義。各コマは通常それ以前のコマをリセットして新たにベースサーフェスに合成される形で描画される（厳密には描画メソッドによる）。
animationに続く*の部分はanimationID（animation*.intervalの*と同一）。
patternに次ぐ*の部分（パターンID）は、一連のanimation*.pattern定義において0から始まる通し番号。materiaでは127が上限。番号の小さい方から積み重なる形で描画される。
描画メソッドは下記の描画メソッド参照。
ウェイトはそのコマを描画するまでの待ち時間。単位はミリ秒。SSPのみ「最小ウェイト-最大ウェイト」とマイナス文字で区切った書き方もでき、その場合は最小～最大間でランダムに選択される。
X座標、Y座標はそのコマをベース（そのコマまでの描画結果）に対してどれだけずらして表示するかの指定。
サーフェスIDに-1でそのアニメーションの停止、-2で現在実行中の他の全てのアニメーションを停止する事ができる。いずれの場合も描画メソッドやX座標、Y座標は無視される。
旧定義：*pattern*,サーフェスID,ウェイト,描画メソッド,X座標,Y座標

挙動なし

• 
• 
• 

animation*.option,exclusive

アニメーションの排他的実行オプション。
即ちexclusiveオプションが指定されたアニメーションが実行された時点で、他のすべてのアニメーションが停止し、またexclusiveオプションのアニメーションの終了まで、他のいかなるアニメーションも新たに開始されない。
animationに続く*の部分はanimationID（animation*.intervalの*と同一）。
なおintervalがbindのアニメーションについてはこの指定は未定義である。
SSPのみ、animation*.option,exclusive,(1,3,5)のようにすると、指定IDのアニメーションに対してのみ限定的に排他制御することができる。
旧定義：*option,exclusive

挙動なし

• 
• 
• 

animation*.option,background

アニメーションの背面実行オプション。
backgroundオプションが指定されたアニメーションはベースサーフェスの後ろ（画面奥側）で実行される。
animationに続く*の部分はanimationID（animation*.intervalの*と同一）。

挙動なし

• 

animation*.option,shared-index

\sタグでのベースサーフェスの切り替えをまたいで、同じIDのアニメーションを途中から継続して実行する。
具体的には、\s実行前にpattern4までアニメーションが実行されていたとして、\s実行後もpattern4から再スタートする。
\s切り替え元・切り替え先の両方に指定が必要で、どちらか片方だけだとリセットされる。
また、切り替え先のアニメーションでpattern IDが見つからない場合もリセットされる。

挙動なし

• 2.6.02

animation*.option,オプション

exclusive・background・shared-indexオプションは同時指定可能で、+区切りで複数オプション可。例：exclusive+background
animationに続く*の部分はanimationID（animation*.intervalの*と同一）。
animation*.option,exclusive+background,(1,3,5) のようにすると、exclusiveのみ影響を受ける。
なおintervalがbindのアニメーションについてはexclusive指定はそもそも未定義である。

挙動なし

• 

animation*.collision*,当たり判定定義
animation*.collisionex*,当たり判定定義(ex)

通常のcollisionやcollisionexのアニメーション動作中限定の定義。インターバルbindにも有効。
animationに続く*の部分はanimationID（animation*.intervalの*と同一）。
collisionに次ぐ*の部分は、一連のanimation*.collision定義内で重複しない番号。

挙動なし

• 

collision*,始点X,始点Y,終点X,終点Y,ID

当たり判定。囲まれた範囲がIDの領域となる。
*の部分（collisionID）は、同じsurface内で重複しない通し番号。
当たり判定の重なり方とIDの順序の関係はcollision-sort参照。

挙動なし

• 
• 
• 

collisionex*,ID,タイプ,座標1,座標2...

不定形当たり判定。
*の部分（collisionID）は、同じsurface内で重複しない通し番号。
タイプは以下の通り。

rect

長方形。座標は始点XYと終点XYの4つ。
例：collisionex0,Head,rect,100,100,200,300

ellipse

楕円。座標は楕円を囲む長方形、始点XYと終点XYの4つ。
例：collisionex0,Head,ellipse,100,100,200,300

circle

真円。中心点のXYの値、半径の順で記述する。
例：collisionex0,Head,circle,100,200,20

polygon

多角形。座標は各頂点、交差可。
例：collisionex0,Head,polygon,100,100,200,300,50,200

region

[SSP 2.5.19～]指定した画像ファイルの指定色の領域を当たり判定として扱う。
大量に(100～)使用すると全体的に動作が重くなるので注意。
「領域反転」をtrueにすると「指定色でない領域」の意味になる。省略可能。
指定フォーマット：ファイル名,R,G,B,領域反転(falseかtrue)
例1: collisionex0,Head,region,atari.png,255,0,0
例2: collisionex1,Head,region,atari.png,0,255,0,true

挙動なし

• 

sakura.balloon.offsetx,座標

そのサーフェスでのみの本体側バルーン位置X座標。

通常：バルーンの左右端と、サーフェスの右左端が揃う位置
align=top/bottom：サーフェスの中央

• 
• 
• 

sakura.balloon.offsety,座標

そのサーフェスでのみの本体側バルーン位置Y座標。

通常：バルーンの上端と、サーフェスの上端が揃う位置
align=top/bottom：バルーンの上下端と、サーフェスの下上端が揃う位置

• 
• 
• 

kero.balloon.offsetx,座標

そのサーフェスでのみの相方側バルーン位置X座標。

通常：バルーンの左右端と、サーフェスの右左端が揃う位置
align=top/bottom：サーフェスの中央

• 
• 
• 

kero.balloon.offsety,座標

そのサーフェスでのみの相方側バルーン位置Y座標。

通常：バルーンの上端と、サーフェスの上端が揃う位置
align=top/bottom：バルーンの上下端と、サーフェスの下上端が揃う位置

• 
• 
• 

balloon.offsetx,座標

そのサーフェスでのみのバルーン位置X座標(本体・相方問わず)。
offset.xとも記述可能。

通常：バルーンの左右端と、サーフェスの右左端が揃う位置
align=top/bottom：サーフェスの中央

• 

balloon.offsety,座標

そのサーフェスでのみのバルーン位置Y座標(本体・相方問わず)。
offset.yとも記述可能。

通常：バルーンの上端と、サーフェスの上端が揃う位置
align=top/bottom：バルーンの上下端と、サーフェスの下上端が揃う位置

• 

point.centerx,座標

サーフェスの中心X座標。
通常は使用されないが、Sakura APIなど外部から取得可能。

サーフィスの中心(幅÷2)

• 
• 
• 

point.centery,座標

サーフェスの中心Y座標。
通常は使用されないが、Sakura APIなど外部から取得可能。

サーフェスの中心(高さ÷2)

• 
• 
• 

point.kinoko.centerx,座標

きのこの生えるX座標。

サーフェスの中心(幅÷2)

• 
• 
• 

point.kinoko.centery,座標

きのこの生えるY座標。

サーフェスの上端＋20ピクセル下(SSP)

• 
• 
• 

point.basepos.x,座標

ウインドウを初期配置・位置保存する際の基準位置のX座標。
異なるサーフェスサイズの画像に切り替えた際の位置ずれなどを調整することができる。

サーフェスの中心(幅÷2)

• 

point.basepos.y,座標

ウインドウを初期配置・位置保存する際の基準位置のY座標です。
異なるサーフェスサイズの画像に切り替えた際の位置ずれなどを調整することができる。

サーフェスの下端

• 

animation0.interval,random,5+bind

animation1.interval,bind+random,5

surface.aliasブレス

sakura.surface.alias
{
素,[0]
照れ,[1,101,201]
驚き,[2]
}

*,[*]

サーフェスIDに対して任意のエイリアスIDを設定する。
例えば驚き,[2]とすれば、\s[驚き]で\s[2]と同じ意味となる。
また、1,[1,11,21]などとカンマ区切りで複数のサーフェスを指定することもでき、
この場合\s[1]で1,11,21からランダムで選ばれる。

挙動なし

• 
• 
• 

cursorブレス

sakura.cursor
{
mouseup0,Head,system:hand
mousedown0,Head,system:finger

mouseup1,Bust,system:hand
mousedown1,Bust,system:grip
}

mouseup*,当たり判定ID,ファイル名

当たり判定の上に乗った時表示するカーソルファイルを設定。
*部分は同じスコープのmouseup定義で重複しない番号。
当り判定名はcollision定義で設定した名前。
ファイル名にはカーソルファイル名(cur/ani)を指定。ファイル名の変わりに、後述のシステムカーソル指定が使用可能。

system:finger（当たり判定名がbustの場合のみsystem:hand）

• 

mousedown*,当たり判定ID,ファイル名

当たり判定の上でマウスボタンを押した時に表示するカーソルファイルを設定。
*部分は同じスコープのmousedown定義で重複しない番号。
当り判定名はcollision定義で設定した名前。
ファイル名にはカーソルファイル名(cur/ani)を指定。ファイル名の変わりに、後述のシステムカーソル指定が使用可能。

system:finger（当たり判定名がbustの場合のみsystem:grip）

• 

mouserightdown*,当たり判定ID,ファイル名

当たり判定の上でマウス右ボタンを押した時に表示するカーソルファイルを設定。
*部分は同じスコープのmouserightdown定義で重複しない番号。
当り判定名はcollision定義で設定した名前。
ファイル名にはカーソルファイル名(cur/ani)を指定。ファイル名の変わりに、後述のシステムカーソル指定が使用可能。

system:finger

• 2.6.14

mousewheel*,当たり判定ID,ファイル名

当たり判定の上でマウスホイールを回した時に表示するカーソルファイルを設定。
*部分は同じスコープのmousewheel定義で重複しない番号。
当り判定名はcollision定義で設定した名前。
ファイル名にはカーソルファイル名(cur/ani)を指定。ファイル名の変わりに、後述のシステムカーソル指定が使用可能。

system:arrow

• 

mousehover*,当たり判定ID,ファイル名

当たり判定の上でマウスをしばらく動かさない時に表示するカーソルファイルを設定。
*部分は同じスコープのmousehover定義で重複しない番号。
当り判定名はcollision定義で設定した名前。
ファイル名にはカーソルファイル名(cur/ani)を指定。ファイル名の変わりに、後述のシステムカーソル指定が使用可能。

system:arrow

• 

tooltipブレス

sakura.tooltips
{
Bust,怒ります。
Head,つつかれると痛いです。
Shoulder,つつくとコミュニケートボックスを表示します。
}

当たり判定名,表示内容

当たり判定の上に来た時に表示するツールチップのテキストを設定。

挙動なし

•