ONScripter のページ

雑多なこと

キーボードショートカットについて

ONScripter は全ての操作をキーボードで行うことができます。下にショートカット一覧を書きます。ただし、スクリプトの方でショートカットキーを設定している場合は、そちらが優先されます。

キー	説明
space	マウスの左クリックと同じだが、下にボタンがあってもボタン外を押したことになる
return	マウスの左クリックと同じ
escape	マウスの右クリックと同じ
p, ↑	ボタン・文章選択時にマウスカーソルを前の選択肢に動かす
n, ↓	ボタン・文章選択時にマウスカーソルを次の選択肢に動かす
s, ←	次の選択肢まで飛ばすモードに切り替え
o, →	１ページ表示をするかしないかの切り替え
f	Full screen mode と Window mode の切り替え
a	automode もしくは mode_ext が設定されている場合に、読み上げモードに入る
z	--edit オプションを指定して起動したときに、音量及び変数変更モードに入る
1, 2, 3	文字の描画速度を変更
Shift + q	終了（end コマンドを発行）

ただし、s 以外のキーは入力待ちの時しか受け付けません（文字を描画している最中は受け付けません）。次の選択肢まで飛ばしている最中に限り、任意のタイミングで s キーにより通常の状態に戻すことができます。

また、コンソール画面で Ctl-c することで ONScripter を終了できます。その場合、グローバル変数等は保存されるので、終了する場合はゲームのメニューから終了するか、これで強制終了するかしてください。

起動オプションについて

以下に示すオプションを指定できます。ただし、オプション無しがデフォルト動作です。

オプション	説明
-h,--help	へルプを表示して終了します。
-v,--version	バージョンを表示して終了します。
--cdaudio	CD Audio 演奏モードに変更します。CD Audio が使えなかったとしても MP3 ファイルは使用しません。
-f,--font file	使用するフォントの path を指定します。
--registry file	使用する registry file を指定します。
--dll file	使用する dll file を指定します。
-r,--root path	使用するゲームファイルのあるディレクトリを指定します。
--force-button-shortcut	getenter と useescspc のコマンドを無視します。つまり、マウスのクリックを強制的に esc, space, return キーに割り付けます。
--disable-rescale	-DPDA を付けてコンパイルした ONScripter で、画像の解像度を PDA 用に落としたアーカイブを使用する場合は、このオプションを設定してください。ONScripter 内で解像度を 320x240 用に変換することを抑制します。
--edit	z キーを押したときに、音量及び変数の編集モードに入れるようになります。

異なるプラットフォーム上で同時に遊ぶ方法

例えば家では Windows、通勤中は Zaurus、職場では Linux といったように、同じゲームを別々のプラットフォーム上で同時に進行させるための方法を書きます。基本的には、それぞれの環境にゲームのアーカイブをセットアップし、プラットフォームを移る度に ONScripter(もしくは NScripter) の書き出すファイルを全てコピーすれば良いのですが、注意点があります。

NScripter もしくは ONScripter が書き出すファイルには次のものがあります。この内一部のファイルはゲームによっては書き出されませんので、無い場合もあります。

ファイル	説明
archive_path/gloval.sav	グローバル変数の格納
archive_path/envdata	環境変数の格納
archive_path/kidoku.dat	既読テキスト情報の格納
archive_path/NScrflog.dat	既読ファイル情報の格納
archive_path/NScrllog.dat	既読ラベル情報の格納
archive_path/save*.dat	セーブファイル(ONScripter の出力したものは ONScripter 専用です、NScripter が出力したものは NScripter でも ONScripter でも読み込めます)
archive_path/sav/save*.dat	上段の NScripter が出力するものと互換性のあるもの（無保証）で、ONScripter が出力します
archive_path/その他画像ファイル	スクリーンショットを画像ファイルとして保存している場合があります。これはゲームによって場所や名前が異なるので、ゲーム毎に対応してください。

ONScripter 環境から ONScripter 環境へ

上記のファイルを全てのそのままコピーしてください。
別途 NScripter も併用する場合には、sav/ 以下も忘れずにコピーしてください。

NScripter 環境から ONScripter 環境へ

上記のファイルを全て（save*.datを含む）そのままコピーしてください。
さらに save*.dat については、sav というディレクトリ以下にもファイルをコピーしてください。この作業は、後で ONScripter 環境から NScripter 環境にデータを移す場合に必要になります。
NScripter_dir/save*.dat -> ONScripter_dir/sav/save*.dat

ONScripter 環境から NScripter 環境へ

save*.dat を除く上記のファイルを全てのそのままコピーしてください。
save*.dat については、sav というディレクトリ以下に生成されたファイルをコピーしてください。
ONScripter_dir/sav/save*.dat -> NScripter_dir/save*.dat

注意点

NScripter は、現時点(2003/11/29)で配布されているものを使用してください。これより古いものとは、セーブデータの互換性がありません。
NScripter と ONScripter のデータ互換性は保証しませんが、私が試した限りは問題は生じておりません。
過去のほぼ全ての NScripter 用のゲームは、上記の最新 NScripter で問題なく遊ぶことができます。したがって、Windows 以外で同時に ONScripter を使用したい方は、Windows 上では最初から上記の NScripter に差し換えて使ってください。ただし、現時点(2003/10/16)でごく最近出たゲームのスクリプトについては、上記 NScripter が対応してない場合もあります。その場合は、もしかしたらゲーム付属の実行ファイルが ONScripter と互換性があるかもしれません。互換性が無い場合は、ONScripter の Windows バイナリをご使用下さい。
NScripterと併用する場合は、ONScripter 環境のアーカイブのある場所に sav というディレクトリを作成しておいてください。

レジストリ読み込みについて

getreg コマンドは Windows の registry から指定されたデータを取得します。ONScripter では、テキストファイル registry.txt にデータを記述し、これを読み込むことでこの機能を実現します。

registry.txt の書式は次の通りです。大文字・小文字は区別されます。また余計なスペース等を入れないようにして下さい。漢字が使われている場合、文字コードが Shift JIS になることに注意してください。

[getreg の２番目の引数（ただし前後の""は除く）]
getreg の３番目の引数（前後の""は必要です）=比較対象文字列（前後の""は必要です）

registry.txt の例

[software\StudioOGA\ONScripter]
"INSTALL"="FULL"

[software\StudioOGA\のまど]
"Download log file"="c:\nomad_down.log"
"Upload log file"="c:\nomad_up.log"

ONScripter 起動時に --registry オプションを指定することで、 registry.txt を一カ所にまとめておくことができます。--registry を指定しない場合は、現在のディレクトリの registry.txt を読みにいきます。

DLL 読み込みについて

exec_dll コマンドは Windows 上で実行可能な DLL (Dynamic Link Library) を実行します。ONScripter では、テキストファイル dll.txt に DLL 名とその戻値の対応を記述し、これを読み込むことでこの機能を実現します。従って、実際に DLL が実行されるわけではなく、また戻値は固定になります。

dll.txt の書式は次の通りです。大文字・小文字は区別されます。また余計なスペース等を入れないようにして下さい。漢字が使われている場合、文字コードが Shift JIS になることに注意してください。

[dll 名]
str = "文字列(getret で受け取ることのできる文字列戻値))" 
ret = 整数(getret で受け取ることのできる数字戻値)

dll.txt の例

[test.dll]
str = "山田/太郎/やまだ/たろう"
ret = 1

[test2.dll]
str = "StudioOGA"
ret = 2

ONScripter 起動時に --dll オプションを指定することで、dll.txt を一カ所にまとめておくことができます。--dll を指定しない場合は、現在のディレクトリの dll.txt を読みにいきます。

音量及び変数編集モードについて

これは暫定的なおまけ機能であり、今後変更されたり無くなったりする可能性があります。

ONScripter 起動時に --edit オプションを指定することで有効になります。

任意のキー入力待ち状態時に z キーを押すことで、編集モードに入ります。この時、title bar に

[EDIT MODE]  MP3 vol (m)  SE vol (s)  Voice vol (v)  Numeric variable (n)

と表示されるはずです。この状態で、m, s, v, n のいずれかのキーを押すことで、それぞれの値を変更するサブモードに入ります。また、Esc キーを押すことによってモードを抜けることができます。

数字変数の場合は、値変更の前にどの変数を変更するのかを選択します。

値変更サブモードでは、0 から 9 までの数字と -, BackSpace, Esc, リターンキーが使えます。- キーは、対象が数字変数でかつ数字が0の時のみ有効になります。既に数字が入力されている場合には、一旦 BackSpace で数字を全部消してから - キーを押してください。

TrueType font による漢字表示について

漢字を表示するためには、TrueType font を用意する必要があります。例えば Windows 2000 では \WinNT\Fonts の下に msgothic.ttc があり、またフリーの TreuType font として、kochi-gothic.ttf や wadalab-gothic.ttf があります。
ここで注意しなければいけないのは、TrueType font によっては正常に漢字表示ができないということです。この原因は FreeType library か SDL_ttf の制約だと思いますが、以下に私が試した５つのフォントについて書きます。

ＭＳゴシック (msgothic.ttc): embedded bitmap を使っており、ゲームで 22pt 以下のフォントを要求すると正常に表示できません。
東風ゴシックフォント (kochi-gothic.ttf): embedded bitmap を使っており、ゲームで 17pt 以下のフォントを要求すると正常に表示できません。
和田研ゴシック (wadalab-gothic.ttf): embedded bitmap は使っていませんが、UNICODE で記述されていないため使えません。
HG ゴシック (hgrsmp.ttf): embedded bitmap は使っておらず、全てのサイズのフォントを正常に表示できます。
みかちゃんフォント(みかちゃん-pb.ttf): embedded bitmap は使っておらず、全てのサイズのフォントを正常に表示できます。

まとめると、UNICODE で記述されておりかつ embedded bitmap を使っていないフォント(上の例では HG ゴシックやみかちゃんフォント)が一番問題がなく、大きなフォントしか使わないゲームでは embedded bitmap が使用されていても使える(上の例ではＭＳゴシックや東風ゴシック)といったところです。

ONScripter を起動する前に、使用する TreuType font ファイルを、default.ttf という名前にしてゲームのスクリプトがある場所のコピーしておいてください。

CD audio 演奏の振り替えについて

ゲームのスクリプトがある場所に cd というディレクトリを作り、そこに
cd/track01.mp3
cd/track02.mp3
cd/track03.mp3
...
cd/track14.mp3
...
という名前で MP3 ファイルを置きます。

すると、スクリプトで CD audio の１曲目を演奏するコマンドがあった場合に、対応する track01.mp3 を演奏するようになります。

MP3 を必ず用意する必要はなく、その場合は音が鳴らないだけです。

MIDI 演奏機能について

MIDI は SDL_mixer の機能を使って演奏します。
この時、現在のディレクトリに tmp.mid という一時ファイルを作ります。美しくないですが、SDL_mixer の MIDI 読み込み部がファイルからの読み込みしかサポートしていないためやむをえません。

Unix系(動作確認は Linux と Zaurus)でソフトウェア音源で演奏する場合（デフォルト）。: SDL_mixer に取り込まれている timidity を使用してソフトウェア音源で演奏します。この場合、MIDIの音色データtimidity.tar.gzをダウンロードして /usr/local/lib/ 以下に展開してください。
Windows の場合。: timidity.tar.gzをダウンロードして c:\ 以下に展開してください。これをしなくても MIDI が鳴ったと思っていたのですが、こうしないと落ちるようです。
Mac OS X の場合。: ONScripter for Mac OS X（かつらさん）のバイナリに添付されている外部プログラムを利用して演奏が可能です。（当方未確認）
Unix系(動作確認は Linux)で外部 MIDI 音源を利用して演奏する場合。: playmidi 等の外部音源を使用できる MIDI player をインストールし、環境変数 MUSIC_CMD を設定してください。（例 MUSIC_CMD=/usr/bin/playmidi）
当方では、シリアル接続で外部音源を繋ぎ、MUSIC_CMD に '/usr/bin/midiplay -q -o /dev/ttyS0' を設定して動作確認をしています。
playmidiは、カーネルで認識される MIDI ポートに対してしか演奏できませんが、midiplayはシリアルに直接出せます。
シリアルポートをMIDIポートにする patchを使えば、playmidi でもシリアル接続音源を使えそうですが、未確認です。

アーカイブ圧縮について

Zaurus ( SL-5500, SL-A300, SL-B500, SL-C700 ) でプレイする場合は、画面の大きさが 320x240 になります。（SL-C700の場合は、VGA表示可能）。そこで、あらかじめアーカイブ中の画像ファイルを 320x240 に合うように小さくしておくことで、アーカイブサイズの減少を図ることができ、少ない記憶デバイスを有効活用することができます。なお、SPB 圧縮の画像は、後述の -e オプションを指定しない場合、BMP として格納されます。

画面のサイズが 640x480 で、拡張子が sar のアーカイブを 320x240 にする場合は、

> sarconv 640 arc.sar zaurus_dir/arc.sar
...

画面のサイズが 800x600 で、拡張子が nsa のアーカイブ（バージョン１）を 320x240 にする場合は、

> nsaconv [-e] 800 arc.nsa zaurus_dir/arc.nsa
> nsaconv [-e] 800 arc1.nsa zaurus_dir/arc1.nsa
...

画面のサイズが 800x600 で、拡張子が nsa のアーカイブ（バージョン２）を 640x480 にする場合は、

> nsaconv [-e] -vga -ns2 800 arc.nsa zaurus_dir/arc.nsa
> nsaconv [-e] -vga -ns2 800 arc1.nsa zaurus_dir/arc1.nsa
...

として変換してください。

最後の例は、-e オプション（後述）を指定したときに意味を持ちます。

NSA アーカイブのバージョン１と２と３の区別は手動です。スクリプトで ns2 コマンドが使われていればバージョン２、ns3 コマンドが使われていればバージョン３です。スクリプトが確認できない場合は、まず -ns2 を付けずに試し、うまくいかなかったら -ns2 もしくは -ns3 を付けて試してください。

-e オプションを付けると、wav と bmp ファイルを nbz 圧縮します。これを行うと、NSA アーカイブの圧縮の種類を示すフラグに ONScripter 独自の値を設定します。この独自拡張については、本家が将来アーカイブの仕様を拡張したときにバッティングする可能性がありますが、その時はそれを回避するようにコンバータを修正し、再コンバートすることで解決できます。その場合でも、save file 等には一切影響がありませんので、Zaurus で使用される方はこのオプションを付けてコンバートすることをお勧めします。wav を bzip2 で圧縮するので、wav を多用するゲームではかなりアーカイブが小さくなります。デメリットとしては、bzip2 の復号を行うため若干遅くなりますが、気がづかない程度です。

-vga オプションをつけると、640x480(VGA)サイズに圧縮します。SL-C700用です。-e オプションと組み合わせると効果的です。

さらに、サイズを小さくしたアーカイブを使うときは、onscripter に --disable-rescale オプションを指定してください。
なお、Linux 等でも、-DPDA をつけてコンパイルすることにより、320x240 画面でゲームをすることができます。

Windows 上で MP3 の音がぶつぶつとぎれる問題について

Windows でコンパイル済の SMPEG のバイナリを持ってくると、MP3 によっては音がぶつぶつとぎれて演奏されます。これは、SMPEG を MSVC でコンパイルする時の最適化の問題で、下記の通りに MSVC の global optimization を一部抑制する指定をし、自分でコンパイルすることで解決できます。

修正するファイル: audio/mpeglayer3.cpp
関数 layer3reorderandantialias の前後に、下のように #pragma 指定を追加する。

#pragma optimize( "g", off )
void MPEGaudio::layer3reorderandantialias(int ch,int gr,
                                          REAL  in[SBLIMIT][SSLIMIT],
                                          REAL out[SBLIMIT][SSLIMIT]){
  ......
}
#pragma optimize( "g", on )

ONScripter のページ

はじめに

特徴

NScripter と比較した特徴

実行環境としての特徴

実行方法

動作環境

コンパイル

実行

TODO

リンク