SECL Reference Manual

構文仕様

いいかげんな表記ですが、一応。

{} は任意の回数の繰り返し、 | は論理和(or)、εは空集合

関数 (命令)

関数: <関数名/命令> '(' <引数リスト> ')' ';'

引数リスト: ε | <値> { ',' { <値> } }

関数名/命令: { <アルファベット or '@' or '_'> }

テキスト表示

テキスト表示: '$' { <改行以外の任意文字列> } (';'|ε) <改行>

ウェイト

ウェイト: '&' { '&' }

コメント

コメント: '//' { <改行以外の任意文字列> } <改行>

命令一覧

SECL独自の用語(?)がある場合があります。

用語一覧

グラフィックページ

線、画像などが格納されているページです。
AllocatePage()を使ってページを作ります。ページは最大256個作る事が出来ます。

テキストページ

文字が格納されているページです。画面の一番手前側に表示されます。SECLでは、唯一１枚のテキストページが準備されます。また、グラフィックページをテキストページとして使用することも出来ます。(TextPage)

パレット

256個の色が集まった組です。パレットは、AllocatePalette()で作成し、SetPalette()でパレットの中身をセットします。また、LoadPicture()/DrawPicture()実行時に、PNGファイルのパレットを読み込む事が出来ます。ChangePalette()で実際の画面に反映させます。

ティック (tick)

時間の単位。1tickは192分音符となります。また、192=全音符 96=２分音符 48=４分音符...となります。

透明色

透明色は特別な色です。画面を重ねあわせる場合、透過色の領域は描画されず、背景がそのまま残ります。通常、透明色は０です。LoadPicture()で確保したページはPNGファイルの透明色が適用されます。

制限

グラフィック座標

(0,0)-(65535,65535)まで。

テキスト座標

(0,0)-(79,29)まで。

パレット番号

0-255まで

ページ番号

0-32767まで

色番号

0-255まで

制御命令

時間の制御などをします。

SherryWRD(ver,offset)

SherryWRDのであることを宣言します。

verは２を指定してください。

offsetは、時間軸をティック単位でずらすものです。シーケンサでST+値を使った場合、補正してください。(現在未実装) 省略した場合は０、つまり補正無しです。

例

SherryWRD(2,10);

Start()

演奏開始に合わせます。(WRD中には必ず１つ必要です)

例

SherryWRD(1);
AllocatePage(1);
AllocatePage(2);
Start();

SetTime(measure, tick)

指定した時間にタイミングを合わせます。measure:tickです。tickの分解能は、４分音符=48 です。

別名

TIME(measure, tick)

例

Delta(0)
SetTime(10,0)
Locate(0,0)
あいうえお
SetTime(11,0);
Locate(0,1)
かきくけこ

SetDelta(step)

行と行の間のウェイトを指定したステップ数にします。デフォルトは、４分音符(=48)となります。

別名

Delta(step)

Wait(step)

指定したステップ数だけウェイトを置きます。

グラフィックページ描画命令

グラフィック画面に対する、操作

AllocatePage(page# [, width, height])

指定したグラフィックページを確保します。width,heightは省略可能で、省略した場合は640x480となります。

サイズが、640x480以外のページを確保した場合、そのページはDisplayPage()で表示画面にする事が出来なくなります。

この命令で確保したグラフィックページの透過色は０になります。

ページ０は確保済みの状態になっています。サイズは、640x480となっています。

別名

AllocPage(page#, width, height);

例

AllocatePage(1, 640, 480);
DisplayPage(1);

FreePage(page#)

指定したグラフィックページを解放します。メモリ消費量を抑えるために、不要なページは解放することを推奨します。。

LoadPicture(page#, pal#, filename)

新たにグラフィックページとパレットを確保し、指定したファイル名のPNGファイルを読み込みます。パレットは指定したパレットへ転送されます。

この命令で確保したグラフィックページの透過色はPNGファイルで指定されている透過色になります。透過色の指定の無いPNGファイルは、透過色が０になります。

例

LoadPicture(1, 1, "TEST.PNG");
DisplayPage(1, 0);
ChangePalette(1);

DrawPicture(filename, x1, y1, x2, y2, x, y, pal#)

描画ページの指定した座標に、画像ファイルを描画します。PNG画像の(x1,y1)-(x2,y2)領域を、描画ページの(x,y)に転送します。PNGのパレットは、pal#で指定したパレットを作成して、そこに格納されます。pal#は省略可能です。省略した場合は、パレットは切り捨てられます。

例

AllocatePage(1);
ActivePage(1);
DrawPicture("TEST.PNG", 0, 0, 320, 200, 100, 200);

DrawPictureTransparent(filename, x1, y1, x2, y2, x, y, pal#)

透過色付きの画像ファイルを描画します。透明色の部分は描画しません。PNGのパレットは、pal#で指定したパレットに格納されます。pal#は省略可能です。省略した場合は、パレットは切り捨てられます。

例

AllocatePage(1);
ActivePage(1);
DrawPictureTransparent("TEST.PNG", 0, 0, 320, 200, 100, 200);

Line(x1, y1, x2, y2, color)

線を描画します。

例

AllocatePage(1);
ActivePage(1);
Line(0, 0, 639, 479, 10);

Box(x1, y1, x2, y2, color)

四辺形を描画します。

例

AllocatePage(1);
ActivePage(1);
Box(0, 0, 639, 479, 10);

BoxFill(x1, y1, x2, y2, color)

四辺形を描画し、塗りつぶします。

例

AllocatePage(1);
ActivePage(1);
BoxFill(0, 0, 639, 479, 10);

DisplayPage(page1# <<<, page2#>, page3#>, page#4>)

表示ページを指定します。

指定するページのサイズは640x480でなければなりません。また、複数のページを指定する事により、透過色を利用して画面の重ねあわせをする事が出来ます。透明色の部分はそれより後ろのページが見えるようになります。

また、テキスト画面は一番手前側(一番上)に表示されます。ただし、TextPage()でテキスト画面を指定した場合は、自分でDisplayPage()にテキスト画面を指定しなければなりません。

別名

DPAGE();

例

AllocatePage(1);
AllocatePage(2);
AllocatePage(3);
TextPage(3);
DisplayPage(0, 1, 2, 3);

ActivePage(page#)

描画ページを指定します。

グラフィック画面への描画はすべて、このコマンドで指定したページに行われます。

別名

APAGE();

例

ActivePage(1);
Line(0, 0, 50, 50,1);

MaskPattern(maskbit)

ビットマスク指定。値は、8bitです。デフォルトは255(=0xFF)です。

グラフィック画面への描画にはすべて適用されます。

このコマンドは、ラインスタイルではありません。

別名

MASK

例

MaskPattern(15);
Line(0, 0, 50, 50, 200);

Move(x1, y1, x2, y2, xd, yd, src#, dest#)

領域移動。src#ページの(x1,y1)-(x2,y2)の領域を、dest#ページの(xd,yd)に転送します。

例

// page0 (0,0)-(10,10) から page1 (100,100) にコピー
Move(0, 0, 10, 10, 100, 100, 0, 1);

MoveTransparent(x1, y1, x2, y2, xd, yd, src#, dest#)

別名

透過色付き領域移動。

透過色の部分はコピーされません。透過色は、src#ページの透過色が適用されます。

TMOVE

例

// page0 (0,0)-(10,10) から page1 (100,100) に透過色付きコピー
TMove(0, 0, 10, 10, 100, 100, 0, 1);

MoveEffect(effecttype, time, interval, x1, y1, x2, y2, xd, yd, source page#, destination page#, transparent)

特殊効果付領域移動。src#ページの(x1,y1)-(x2,y2)の領域を、dest#ページの(xd,yd)に転送します。

transparent=1のとき、透過色が有効になります。0のときは無視します。

timeだけの時間をかけて徐々にコピーします。

intervalは、動作間隔です。小さいほど滑らかになりますが、処理が重くなります。デフォルトは４です。一部の特殊効果では無効となります。

次のような効果が用意されています。

0-6は、マスクパターンコピーを使います。そのため動作がのろいです。16以降は単なるコピーを組み合わせています。そこそこの速度は出ます。また、intervalの値は無視され、interval=time/stepとなります。

40-42番のランダム転送と、43番のMSX2+もどきは、出力ファイルのサイズが激増する要因になるので、ご注意下さい。

ほかにこのような効果が欲しい、というのがあればぜひご意見下さい。前向きに検討したいと思います。

例

// page0 (0,0)-(10,10) から page1 (100,100) にコピー １小節かけてGIFインターレース風に
MoveEffect(0, 5, 192, 0, 0, 10, 10, 100, 100, 0, 0);

DrawText(x, y, color, string)

グラフィックページに、文字列を描画します。

x,y,colorはそれぞれ省略可能です。省略した場合は前回使用した値を使用します。この命令はグラフィック画面へ描画します。テキスト画面とは関係がありません。

例

AllocatePage(1);
ActivePage(1);
DrawText(0, 0, 20, "あいうえお");

DrawLyrics(x, y, color, string)

歌詞を表示する。

string中には、次のような書式の文字列を指定します。

[歌詞１] | [歌詞１の時間指定] | [歌詞２] | [歌詞２の時間指定]

時間指定の書式

{}n は有限回の繰り返し []内はオプション

<時間指定> := <音符長> { "^" <音符長> }n [ { "," <時間指定> }n ]

<音符長> := <数値> "." ...

音符長を省略すると、Delta()で指定した音符長になります。

時間指定をカンマで区切って複数個記述すると、指定した歌詞をその時間指定の個数で等分割します。

例

|4|あ|4|い|8.|う||漢|8,8|え|16|お|2

上記を解釈すると、次のように表示されます。

コマンドは並列に動作します。つまり、実行後の時間ポインタは変わりません。

この命令はグラフィック画面へ描画します。テキスト画面とは関係がありません。

例

// 'あいうえお\' と表示します。
Delta(48);
DrawLyrics(0, 0, 20, "あい|4|abc|2|う|2|え|4|お|2\\")

DrawLyrics(0, 0, 21, "あい|4|abc|2|う|2|え|4|お|2\\")

DrawLyrics(0, 0, 22, "あい|4|abc|2|う|2|え|4|お|2\\")

DrawLyrics(0, 0, 23, "あい|4|abc|2|う|2|え|4|お|2\\")

DrawLyricsRainbow(x, y, color1, color2, time, string)

歌詞を表示する。色番号をcolor1〜color2へ変化させて描画します。timeで示した時間かけて描画します。

TextPattern(page#, x, y)

page#にある、(x,y)-(x+15,y+15)にあるパターンを文字パターンとして指定します。

このコマンドを使用すると、文字色の指定が無視されます。

テキスト画面、グラフィック画面の双方に影響します。

注：この命令で設定された値はコンパイラ側で保持され使用されます。したがって、Time命令などによって影響されません。ご注意下さい。

例

// グラフィカル文字のパターン作成
APAGE(3);
BOXFILL(0, 0, 15, 2, 210);
BOXFILL(0, 3, 15, 5, 211);
BOXFILL(0, 6, 15, 9, 212);
BOXFILL(0, 10, 15, 12, 211);
BOXFILL(0, 13, 15, 15, 210);
TextPattern(3, 0, 0);

// 表示
DrawText(0, 0, 0, "あいうえお");

TextPatternOFF()

TextPatternの指定をキャンセルします。

注：この命令で設定された値はコンパイラ側で保持され使用されます。したがって、Time命令などによって影響されません。ご注意下さい。

例

TextPattern();

パレット制御命令

パレットに対する操作

AllocatePalette(pal#, pal#, pal#....)

パレットを作成します。作成後のパレットの中身はすべて黒に設定されます。

パレット＃０は確保済みの状態となっているので、改めて確保する必要はありません。

例

AllocatePalette(1,2,3,4,5,6,7);

FreePalette(pal#, pal#, pal#....)

確保されているパレットを解放します。

例

FreePalette(1,2,3,4,5,6,7);

Fade(Pal1#, pal2#, tick [,step])

フェードアウト／インをします。pal1# => pal2#へ滑らかに色を変化させます。

フェードは、tickで指定した時間内に終了します。

stepは、パレットを変更するインターバルを指定します。stepを省略した場合は10段階変化します。(step=tick/10)

例

Fade(0, 1, 192, 5); // pal#0 〜 pal#1 へ変化させます。１小節だけ、時間がかかります。

ChangePalette(pal#)

パレット切り替え。指定したパレットを適用させます。

別名

PALCHG

例

ChangePalette(1);

SetPalette(pal#, index#, color....)

パレットの内容を変更します。

colorの値は、HTMLと同じで、16進数で0xRRGGBBとなります。

例

// pal#20に、#0=赤, #1=紫 に設定します。
SetPalette(20, 0, 0xFF0000, 0xFF00FF);

SetPaletteAll(pal#, color)

指定したパレットの中身を全部同じ色に設定します。

主に、フェードイン／アウトの時に使うパレットで使用します。

SetPaletteAll(0, 0xFFFFFF); // 全部 白
Fade(0, 1, 192); // 白からのフェードイン

CopyPalette(dest#, src#)

パレットsrc#の内容ををパレットdest#に転送します。

PaletteMix(dest#, src1#, src2#, percent)

パレットsrc1#とsrc2#をpercentで指定した比でミックスして、dest#に格納します。

// 明るさを半分にします。
LoadPicture(2, 1, "TEST.PNG");
SetPaletteAll(2, 0x000000);
PaletteContrast(1, 2, 0, 50);
PALCHG(0);

テキスト画面操作

これらのコマンドを使用する事により、文字列をそのまま描画する事が出来ます。

テキスト画面の座標の範囲は、(0,0)-(79,29)です。TextPage()を使わなかった場合は自動的に画面を確保します。

テキスト画面でも、グラフィック操作を行いたい場合は、TextPage()を使う必要があります。

TextMode(mode)

テキスト表示モードを指定します。

• mode=0 1と同じ意味 (SECL ver.1.1との互換性のため存在)
• mode=1 テキスト表示あり
• mode=2 テキスト表示あり (DrawLyricsのように１文字ずつ表示する)
• mode=3 テキスト表示あり (MIMPIの1文字表示モードと同じフォーマット)

このコマンドは、"画面に表示するかしないか"ではなくて、テキスト画面への描画を許可するか、しないかです。mode=0のときにテキスト画面に描画しようとすると、エラーとなります。デフォルトは１です。

WRDソースを空行を使ってきれいに整形したい場合は、TextMode(0)を使います。

別名

TMODE

例

SherryWRD(1);
TextMode(0); // 初期化なのでテキスト画面への描画はない

AllocatePage(..)
...
...

Start();
TextMode(1); // テキスト画面への描画開始
あいうえお
かきくけこ
TextMode(2);
あ___|いうえお|

TextWindow(x1, y1, x2, y2)

テキスト画面のスクロール領域を定義します。デフォルトは、(0,0)-(79,29)です。

TextHome()

ホームポジションにカーソルを移動します。

別名

THome

TextLocate(x, y, fcolor, bcolor)

カーソル位置、テキストの色を設定します。

fcolorは文字色、bcolorは背景色です。文字色のデフォルトは７、背景色のデフォルトは、０(透明) です。

省略した場合は、以前の値が引き継がれます。

別名

LOCATE

TextClear(x1, y1, x2, y2)

テキスト画面クリア。指定した範囲を背景色(デフォルト0)で塗りつぶします。

別名

TCLS

例

TextClear(0, 0, 79, 29);

TextColor(color、backcolor)

テキスト表示色／背景色指定。TextPattern()を指定中は無視されます。デフォルトは文字色＝７、背景色＝０です。

注：この命令で設定された値はコンパイラ側で保持され使用されます。したがって、Time命令などによって影響されません。ご注意下さい。

別名

COLOR

その他

'&' を置くと、SetDelta()で指定されたウェイトが入ります。この文字に限り、文末の';'はいりません。

MIMPIのように、直接表示文字列を書いても描画されず、エラーとなります。このような使い方をしたい場合は、行頭に '$'の文字を置いて下さい。

'//' 以降は、行末までコメント扱いになります。

例

$あいうえお
Locate(0,0); // コメント

画像ファイルについて

Sherry WRDでは、画像ファイルとして、PNG形式を使用する事が出来ます。PNG形式は、GIFのLZW特許問題を回避するために、CompuServe, W3Cが開発した画像ファイルフォーマットです。W3Cのお墨付きがあるファイルフォーマットなので、普及は時間の問題だと言われています。

PNG形式には、以下のフォーマットが用意されています。

このうち、SherryWRDで扱う事が出来るのは、タイプ３のパレット付きのフォーマットです。ビット数は問いません。

画像ファイルには、複数の透明色を指定する事が出来ますが、SherryWRDで使用できるのは、最初の１つのみです。残りは無視されます。

また、bmp2png.exeを用意すると、SECL.EXEでBMPファイルを使用することが出来ます。SECL.EXEは、BMPファイルが指定されると、自動的にBMP2PNG.EXEを呼び出して、PNGファイルに変換します。

bmp2png.exeはBMP Toolsの中に入っています。ツール入手方法のページをご覧ください。

Sherry Easy Compiler入門

Sherry Easy Compilerは、Sherry WRDのために作られた簡易コンパイラです。以下のようなコンセプトで開発しています。

• 簡単である
• なるべく指定するパラメータの数を少なくする
• 複数ページ重ねあわせを自動でやる

WRDソースの記述方法

SECLのソースには、最低限次のような記述が必要です。テンプレートとして活用してみてください。次に示すソースは、とりあえず"BACK.PNG"という画像ファイルを背景として表示し、歌詞を表示するものです。"BACK.PNG"は、640x480でなければなりません。

SherryWRD(1);
TextMode(0);

// パレットの確保
AllocatePalette(1);	// #1 真っ白
SetPaletteAll(1, 0xFFFFFF);

// PNG読み込み
// #2ページに、"BACK.PNG"を読み込み。パレットは#0に格納
LoadPicture(2, 0, "BACK.PNG");
MOVE(0, 0, 639, 479, 0, 0, 2, 0);	// #2ページから #0ページへ転送

// テキスト文字用パレット
SetPalette(0, 255, 0xFFFFFF);

// 表示ページ指定
DisplayPage(0);

// 描画ページ指定
ActivePage(0);

// 演奏開始
Start();
TextMode(1);
Time(1,0);
Fade(1, 0, 192);  // #1〜#0にフェード
Time(2);
ChangePalette(0);
TIME(14,78)
TextMode(2);
delta(8);
Locate(10, 5, 255);
$あ||い|4|う||え|4|お|8..|か|2^8|き|8|く|4.|け|2,2|こ|4|;
&&&&
$あ||い|4|う||え|4|お|8..|か|2^8|き|8|く|4.|け|2,2|こ|4|;

まず、必要なだけ画面、パレットを確保します。パレットはChangePaletteとするとはじめて適用されます。画面ページも、DisplayPage()を使用してから表示されます。

表示ページの意味

SECLでは、表示ページに最大４枚のページを指定する事が出来ます。これは４枚の画像を重ねあわせが出来るという事を意味します。

表示する際は、一番後ろにあたる背景ページから順番に上に重ねあわせていきます。このとき、透明色の概念が重要となります。

透明色というのは、その名のとおり、透き通った色です。この色で描画された部分は後ろ側のページが見えるようになります。透明色は通常、０となります。

透明色付きPNGファイルを利用する場合、透明色部分が０である保証がありませんので、次のような方法を取る必要があります。

まず、LoadPictureであるページに画像をロードします。LoadPicture()で確保したページの透明色は、PNGファイルで指定したいる透明色に自動的にセットされます。よってMoveTransparent()を使用する事が出来ます。そこで、MoveTransparent()を使用して目的のページに描画します。

例

LoadPicture(200, 0, "CHARACTER.PNG");		// #200に読み込み
DisplayPage(0, 1, 2);					// #0,#1,#2を表示ページに設定
MoveTransparent(0, 0, 32, 32, 100, 150, 200, 2);
		// PNGファイルの(0,0)-(32,32)の領域を #2ページの(100,150)に転送

256色画像の利用方法

Sherry WRDでは、256色の色を使用する事が出来ます。しかし、256色の画像を使用してしまっては、文字を表示するための色が無くなってしまいます。そこで、Sherry WRDで使用する画像は、減色して使用する事になります。

たとえば、256色画像を任意のツールを使用して、200色に減色します。そうすると、あまった、色番号 #200-#255は文字や、その他のオブジェクトのために使用する事が出来ます。

また、16色画像を複数表示する、といった利用方法もあります。

その他

現在、このSRYファイルを再生できるプレイヤーは、

• TMIDI Player ver 2.4 以降

があります。

曲データの配布は必ず、SRYファイルで行ってください。再生側がこのコンパイラを持っているとは限らないからです。また、SherryWRD仕様は、バイナリレベル(SRYファイル)での互換性を保証しています。

関連ツール／入手方法

SECL.EXEの入手方法

私が直接アップロードしているのは、以下のとおりです。

• ふみぃのページ
• ゆいＮＥＴ ファイルボード 0066: WIN_1 Ｗｉｎｄｏｗｓ９５／ＮＴ −１−

関連ツール

Sherry Compiler

もっと高度なＷＲＤを作りたい方は、沢渡みかげさんのSherry Compilerが便利です。現在制作中だそうです。

入手場所は、Sherry WRDのページへどうぞ。

T-Bcnv

tosさんが作成された、減色ツールです。

入手場所は、以下のとおりです。

• ふみぃのページ
• ゆいＮＥＴ ファイルボード にあるかも。(^^;

制限事項

現在、次の機能が未実装です。いずれ実装したいと思います。

• ミックスフェード
• マスクパターン付きコピー

Copyright(c)1997,98 by Fummy. All rights reserved.