descript.txt

概要

shell的基本設定文件。
用於shell名和作者情報、對話框的顯示位置設定、主菜單(右鍵菜單)的画像設定,衣物的所屬菜單顯示設定。

記述例和基本用法

charset,Shift_JIS
type,shell
name,master

craftman,ukadog
craftmanw,うか犬
craftmanurl,http://ssp.shillest.net/ukadoc/manual/index.html

menu.background.bitmap.filename,menu_background.png
menu.foreground.bitmap.filename,menu_foreground.png
menu.sidebar.bitmap.filename,menu_sidebar.png

sakura.balloon.offsetx,0
sakura.balloon.offsety,80
kero.balloon.offsetx,-20
kero.balloon.offsety,10
sakura.balloon.alignment,none
kero.balloon.alignment,none

sakura.bindgroup0.name,服,エプロンドレス,apron
sakura.bindgroup1.name,リボン,白リボン,ribbonwhite
sakura.bindgroup2.name,服,黒服,black
sakura.bindgroup3.name,リボン,黒リボン,ribbonblack
sakura.bindgroup0.default,1
sakura.bindgroup1.default,1

kero.bindgroup0.name,ネクタイ,ネクタイ
kero.bindgroup1.name,腕章,黒腕章
kero.bindgroup2.name,腕,ドリル
kero.bindgroup0.default,1
kero.bindgroup1.default,1

sakura.menuitem0,2
sakura.menuitem1,3
sakura.menuitem2,-
sakura.menuitem3,0
sakura.menuitem4,1

kero.menuitem0,0
kero.menuitem1,1
kero.menuitem2,-
kero.menuitem3,2

type、name必恬。
SSP通過對shell的homeurl的設定,可以用資源管理器進行網路更新。
衣物的設定各項目参照後述各節。
基本結構在surfaces.txt定義,定時bind的animationID,衣物名和衣物類別名設定(sakura(kero).bindgroup*.name,~)、需要指定主菜單配置(sakura(kero).menuitem*,~)。
另外,從安全的角度出發,\或%開始的字符串因為可以作為sakura script或環境變量的標誌,所以會被拋棄。如果需要含有這些字符的情況下,請使用\\或\%這樣的跳脫符。
seriko的設定優先級為:人格descript.txt 全体指定<人格Scope個別指定<shell的descript.txt全体指定<shell的Scope個別指定


基本資料
charset,文字編碼此文檔的文字編碼,默認Shift_JIS
nameshell名稱
id,ID名ID名稱(半形英數)
type,shell種別(這裡是外表,不用更改),SSP將shell文件夾下descript.txt自動識別為shell
craftman,作者名半角英數作者名
craftmanw,作者名作者名
craftmanurl,URL作者URL
homeurl網路更新的網址
readme,檔案名稱安裝或從菜單打開時的shell說明文件,默認readme.txt
menu,hidden不顯示人格的shell切換菜單
名稱
sakura.name\0名稱,省略時按ghost的descript設置
sakura.name2,名稱\0的另一個名稱,省略時按ghost的descript設置
kero.name\1名稱,省略時按ghost的descript設置
char*.name,名稱\p[*]名稱,省略時按ghost的descript設置
SERIKO
seriko.zorder,ScopeID,ScopeID,...\![set,zorder,ScopeID,ScopeID,...]的descript版(SSP2.4起)
seriko.sticky-window,ScopeID,ScopeID,...\![set,sticky-window,ScopeID,ScopeID,...]的descript版(SSP2.4起)
seriko.alignmenttodesktop,位置所有surface默認顯示位置,top=貼上部,bottom=貼下部,free=自由移動,省略時按ghost的descript設置
sakura.seriko.alignmenttodesktop,位置\0的surface默認顯示位置,top=貼上部,bottom=貼下部,free=自由移動,省略時按ghost的descript設置
kero.seriko.alignmenttodesktop,位置\1的surface默認顯示位置,top=貼上部,bottom=貼下部,free=自由移動,省略時按ghost的descript設置
char*.seriko.alignmenttodesktop,位置\p[*]的surface默認顯示位置,top=貼上部,bottom=貼下部,free=自由移動,省略時按ghost的descript設置
sakura.defaultx,X座標\0相對圖像X座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
kero.defaultx,X座標\1相對圖像X座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
char*.defaultx,X座標\p[*]相對圖像X座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
sakura.defaulty,Y座標\0相對圖像Y座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
kero.defaulty,Y座標\1相對圖像Y座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
char*.defaulty,Y座標\p[*]相對圖像Y座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
sakura.defaultleft,X座標\0默認X座標位置,省略時按ghost的descript設置
kero.defaultleft,X座標\1默認X座標位置,省略時按ghost的descript設置
char*.defaultleft,X座標\p[*]默認X座標位置,省略時按ghost的descript設置
sakura.defaulttop,Y座標\0默認Y座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
kero.defaulttop,Y座標\1默認Y座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
char*.defaulttop,Y座標\p[*]默認Y座標位置(SSP/2.01.16以後),省略時按ghost的descript設置
對話框配置
sakura.balloon.offsetx,座標\0側對話框位置X座標,省略時按ghost的descript設置
sakura.balloon.offsety,座標\0側對話框位置Y座標,省略時按ghost的descript設置
kero.balloon.offsetx,座標\1側對話框位置X座標,省略時按ghost的descript設置
kero.balloon.offsety,座標\1側對話框位置Y座標,省略時按ghost的descript設置
sakura.balloon.alignment,位置資料\0側對話框配置(none=自動調整 left=永遠在shell左邊 right=永遠在shell右邊)
kero.balloon.alignment,位置資料\1側對話框配置,省略時按ghost的descript設置
右鍵選單配置
menu.font.name,字體名右鍵菜單字體名稱,省略時按OS的UI標準字體設定
menu.font.height,字體尺寸右鍵菜單字體大小,省略時按OS的UI標準字體設定
menu.background.bitmap.filename,檔案名稱右鍵選單背景圖像檔案名稱
menu.foreground.bitmap.filename,檔案名稱右鍵選單前景圖像檔案名稱
menu.sidebar.bitmap.filename,檔案名稱右鍵選單側欄圖像檔案名稱
menu.background.font.color.r,數字背景文字色紅值(0~255)
menu.background.font.color.g,數字背景文字色綠值(0~255)
menu.background.font.color.b,數字背景文字色藍值(0~255)
menu.foreground.font.color.r,數字前景文字色紅值(0~255)
menu.foreground.font.color.g,數字前景文字色綠值(0~255)
menu.foreground.font.color.b,數字前景文字色藍值(0~255)
menu.separator.color.r,數字分隔行色紅值(0~255),默認為menu.background.font.color.r
menu.separator.color.g,數字分隔行色綠值(0~255),默認為menu.background.font.color.g
menu.separator.color.b,數字分隔行色藍值(0~255),默認為menu.background.font.color.b
menu.disable.color.r,數字不可選欄色紅值(0~255),默認為(background画像0,0的顏色 + menu.background.font.color * 2 ) / 3
menu.disable.color.g,數字不可選欄色綠值(0~255),默認為(background画像0,0的顏色 + menu.background.font.color * 2 ) / 3
menu.disable.color.b,數字不可選欄色藍值(0~255),默認為(background画像0,0的顏色 + menu.background.font.color * 2 ) / 3
menu.background.alignment,位置背景圖像配置,lefttop=左對齊,righttop=右對齊,centertop=中間對齊,預設為lefttop
menu.foreground.alignment,位置前景圖像配置,lefttop=左對齊,righttop=右對齊,centertop=中間對齊,預設為lefttop
menu.sidebar.alignment,位置側欄圖像配置,top=上對齊,bottom=下對齊,預設為bottom
衣物設定(如有)
sakura.bindgroup*.name,種類名,部件名,縮圖名\0側衣物選單設定
sakura.bindgroup*.default,數字\0側該部件是否從最初就顯示(0=否,1=是),默認0
sakura.bindgroup*.addid,ID\0側該ID的部件從最初就顯示,多個ID時可用逗號分隔
sakura.bindoption*.group,組名,設定\0側對该衣物種類進行設定,mustselect為必選,multiple為可多選,mustselect+multiple為必選且多選,省略時為可不選且不可多選
sakura.menuitem*,數字\0側衣物基本選單設定
sakura.menu,auto/hidden\0側衣物選單顯示,auto自動顯示,hidden不顯示
kero.bindgroup*.name,種類名,部件名,縮圖名\1側衣物選單設定
kero.bindgroup*.default,數字\1側該部件是否從最初就顯示(0=否,1=是),默認0
kero.bindgroup*.addid,ID\1側該ID的部件從最初就顯示,多個ID時可用逗號分隔
kero.bindoption*.group,組名,設定\1側對该衣物種類進行設定,mustselect為必選,multiple為可多選,mustselect+multiple為必選且多選,省略時為可不選且不可多選
kero.menuitem*,數字\1側衣物基本選單設定
kero.menu,auto/hidden\1側衣物選單顯示,auto自動顯示,hidden不顯示
char*.bindgroup*.name,種類名,部件名,縮圖名\p[*]側衣物選單設定
char*.bindgroup*.default,數字\p[*]側該部件是否從最初就顯示(0=否,1=是),默認0
char*.bindgroup*.addid,ID\p[*]側該ID的部件從最初就顯示,多個ID時可用逗號分隔
char*.bindoption*.group,組名,設定\p[*]側對该衣物種類進行設定,mustselect為必選,multiple為可多選,mustselect+multiple為必選且多選,省略時為可不選且不可多選
char*.menuitem*,數字\p[*]側衣物基本選單設定
char*.menu,auto/hidden\p[*]側衣物選單顯示,auto自動顯示,hidden不顯示
其他
seriko.paint_transparent_region_black,0/1透明處塗黑(SSP/2.01.41以後),默認0
seriko.use_self_alpha,0/1使用PNG自帶的透明通道(SSP/2.01.41以後),默認0


surfaces.txt或surfaces**.txt

surface的具體定義記錄在surfaces**.txt(**為0~2個任意字符)中。除charset外都以大括弧範圍的域表示,例如:

charset,UTF-8

descript
{
version,1
}
 
Surface0
{
...
}

sakura.surface.alias
{
...
}

sakura.cursor
{
...
}

sakura.tooltips
{
...
}


域內描述動畫效果使用的格式為SERIKO格式。
其中,SERIKO/2.0 和 SERIKO/1.x 不同點如下。

  1. 項名開頭帶 animation
  2. pattern 項參數的順序變更
  3. interval 參數從10ms 單位變為1ms 單位
  4. alternativestart 方法的ID 指定的括號從[ ] 變更為( )

    每個域具體如下:
    charset,文字編碼此文檔顯示編碼,繁體中文Big5, 簡體中文GB2312, 日文Shift-JIS或其他(UTF-8)
    descript域
    version,*使用的SERIKO格式的版本,0為SERIKO/1.x版,1為SERIKO/2.0版,省略時為0
    maxwidth,像素surface最大寬度。SSP由於會自動檢測,所以不需要使用這項信息
    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域/surface.append域
    surface*定義對應id的surface,surface.append*為對已定義的id進行追加定義。
    其中*對應的id可以是多個,如 0,1,5 的形式,或 1-9 範圍選擇的形式,也可以是混合的1-9,20-29形式
    element*,效果參數,檔案名,X座標,Y座標基礎surface的定義,之後該surface的動畫效果都是在這個基礎surface上進行處理的
    animation*.interval,時間間隔定義動畫效果開始發生的時間間隔,時間間隔定義後述,
    SERIKO/1.x版:*interval
    animation*.pattern*,效果參數,surface編號,等待時間,X座標,Y座標動畫效果的每一幀設定,參數定義後述,等待時間部份處數值外還可以用 最小時間-最大時間 的形式表示時間範圍內的隨機選擇
    SERIKO/1.x版:*pattern*
    animation*.option,exclusive該定義使此動畫效果不受其他動畫效果的影響,像animation*.option,exclusive,(1,3,5)的寫法,將限定在指定的動畫效果ID內
    animation*.option,background該定義使此動畫效果在基礎surface後方顯示
    animation*.option,exclusive+background同時混合上面2種效果,如animation*.option,exclusive+background,(1,3,5),僅exclusive受影響
    animation*.collision*,觸碰判定定義
    animation*.collisionex*,觸碰判定定義(ex)
    觸碰判定定義和下面相同時,僅動畫效果運行時有效觸碰判定。bind時也有效。
    collision*,始点X,始点Y,終点X,終点Y,觸碰判定名定義觸碰判定範圍及名稱
    collisionex*,觸碰判定名,類型,座標1,座標2...定義不規則觸碰判定範圍及名稱,類型為:
    rect 長方形。座標為始点XY和終点XY這4個。
    ellipse 橢圓。座標為包圍楕円的長方形的始点XY和終点XY這4個。
    polygon 多角形。座標各頂点,可交差。
    sakura.balloon.offsetx,座標/0側僅該surface的balloon位置X座標
    sakura.balloon.offsety,座標/0側僅該surface的balloon位置Y座標
    kero.balloon.offsetx,座標/1側僅該surface的balloon位置X座標
    kero.balloon.offsety,座標/1側僅該surface的balloon位置Y座標
    balloon.offsetx,座標僅該surface的balloon位置X座標(無論哪一側)
    balloon.offsety,座標僅該surface的balloon位置Y座標(無論哪一側)
    point.centerx,座標surface中心X座標。默認surface中心(寬÷2)
    point.centery,座標surface中心Y座標。默認surface中心(高÷2)
    point.kinoko.centerx,座標kinoko產生處的X座標。默認surface中心(寬÷2)
    point.kinoko.centery,座標kinoko產生處的Y座標。默認surface上端+20像素向下
    point.basepos.x,座標shell中心X座標。默認surface中心(寬÷2)
    point.basepos.y,座標shell中心Y座標。默認surface下端
    sakura.surface.alias域/kero.surface.alias域/char*.surface.alias域
    *,[*]aliasID對任意surfaceID的設定。
    例如:驚訝,[2] ,\s[驚訝]和\s[2]同義。
    又如,1,[1,11,21]時,\s[1]隨機等同於\s[1],\s[11],\s[21]。
    sakura.cursor域/kero.cursor域/char*.cursor域
    mouseup*,觸碰判定名,檔案名觸碰判定上方時遊標文件設定
    mousedown*,觸碰判定名,檔案名觸碰判定點擊時遊標文件設定
    mousewheel*,觸碰判定名,檔案名觸碰判定滾動時遊標文件設定
    mousehover*,觸碰判定名,檔案名觸碰判定懸停時遊標文件設定
    sakura.tooltips域/kero.tooltips域/char*.tooltips域
    觸碰判定名,顯示文本觸碰判定的tooltips的顯示文本設定

時間間隔定義

sometimes有時(眨眼程度,和random,2 等價)
rarely偶爾(和 random,4 等價)
random,數值每秒 1/n 次的概率
periodic,數值n秒間隔發生
always永久循環
runonce只有該基礎Surface切換瞬間1次
never不自動發動
yen-e只有SakuraScript直到\e 出現瞬間1次
talk,數值顯示n個文字時(每當有對話時)
bind定義衣物
bind+時間間隔定義定義衣物且發生上述其他時間間隔定義

效果參數

base顯示基礎Surface
overlay在基礎Surface上覆蓋合成
overlayfast在基礎Surface上覆蓋合成,且僅基礎Surface區域有效
replace含透過部份在基礎Surface上替換合成
interpolate含透過部份在基礎Surface上疊加合成
asis不適應去除色或PNA,原樣顯示
move使基礎Surface在指定XY座標處顯示
bind基礎Surface衣物定義
add在基礎Surface衣物上增加
reduce在基礎Surface衣物上去除
insert,ID其他衣物組插入
start,[參數ID]起動指定ID動畫效果
stop,[參數ID]停止指定ID動畫效果
alternativestart,[參數ID1,參數ID2...]多個動畫效果ID中的某個起動
alternativestop,[參數ID1,參數ID2...]多個動畫效果ID中的某個停止

參數ID-1該動畫效果停止,-2所有動畫效果停止


系統遊標 遊標檔案名可指定系統遊標

system:arrow箭頭
system:cross十字
system:no禁止
system:hand手型
system:grip手抓
system:finger手指
system:wait沙漏
system:textI
system:move移動
system:help

surfacetable.txt

概要

SSP開發面板的Surface Test功能內容定義用文件。

基本用法

charset,Shift_JIS
version,1
option,DisableNoDefineSurfaces

//==========パーツ==========
group,__disabled
{
	19,__parts
}

//==========クー==========
group,[空]平日
{
	scope,0
	
	0,素
	1,照れ
	3,不安
	4,はぅー
	5,笑
}

從//開始為注釋

charset,文字編碼設定文字編碼,默認Shifi_JIS
version,數值srufacetable.txt語法的版本,目前固定為1
option,選項1,選項2,...設置選項,目前只有DisableNoDefineSurfaces,文件沒有定義的surface無視
group,組名surface定義的組。組名為__disabled時表示Surface Test不顯示
scope,数值組內所屬域,主菜0、使魔1等
[surfaceID],名稱識別的surface名稱。名字為__parts時表示用於衣物組件

外部連結


首頁   編輯 封鎖 差異 備份 上傳檔案 複製 變更名稱 重新載入   新建條目 一覽 搜索 最近的變更   幫助   最近更新的RSS
Last-modified: 2017-06-25 (日) 06:54:30 (358d)