wonbe.txt 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226
  1. ワンべぇ: WONBE, WonderWitch BASIC Environment
  2. 暫定マニュアル Ver 0.01
  3. 2000年11月6日
  4. 株式会社ピーデー
  5. 川俣 晶
  6. Copyright 2000 (c) by Pie Dey Co.Ltd.
  7. ●これは何か?
  8.  ワンべぇは、WonderWitch上で使用できる小型BASICインタプリタです。
  9.  WonderWitch上ですべての機能が稼働し、シリアルケーブル経由で接続された一般の通信ソフトで操作します。デバッグ済みのプログラムを実行する場合は、シリアルケーブルも通信ソフトも必要ありません。
  10.  WonderWitchのテキスト画面を扱う最小限度のステートメント(cls,locate,print)と、最小限度のボタン入力機能(wait,scan)を持ち、簡易なミニゲームが書けます。
  11.  動作テスト用にWin32上で動くバイナリーもありますが、これは、BASIC本体の動作確認用と割り切ってください。
  12. ●必要なもの
  13. ・開発時
  14.  WonderWitchのカートリッジとシリアルケーブル。38400bpsの無手順通信が可能な通信ソフトを持つパソコン等。
  15. ・実行時
  16.  ワンべぇと実行したプログラムを入れてあるWonderWitchのカートリッジのみ
  17. ●準備
  18. ・TransMagicなどでワンべぇ(fonbe.fx)をWonderWitchに転送します。
  19. ・TransMagicなどの接続を切り、通信ソフトから38400bpsの無手順通信を開始します
  20. ・WonderWitch上でワンべぇを実行します
  21. ・エントランスメニュー画面でY2を押します
  22. ・通信ソフトに、ワンべぇの名前が表示され、"*Ready"と出ます
  23. ・これで準備完了です
  24. ・print "hello!"リターンと打ってWonderWitchの画面を見てください。文字が出ていれば正常です。
  25. ●開発済みプログラムの実行
  26. ・WonderWitch上でワンべぇを実行します
  27. ・エントランスメニュー画面で実行したいファイルを選んでAボタンを押します
  28. ●開発環境の概要
  29.  通常の行番号ベースのエディタが使えます。
  30.  行番号に引き続いて1行を入力してリターンを押すと、プログラムに記録されます。
  31.  行番号だけを入力してリターンを押すとその行は削除されます。
  32.  行番号無しで命令を入力すると即座に実行されます。
  33.  編集はバックスペースによる1文字削除しか使えません。通信ソフトからホスト上のエディタにCOPY&PASTEして、エディタ上で編集してから、通信ソフトに貼り付けてワンべぇに送ると便利です。ただし、フロー制御が無いので、複数行まとめて貼り付けると文字落ちが生じます。張り付けは1行単位で行ってください。プログラムはホスト上で編集してあらかじめTransMagicなどで送信しておくのも有効な手段です。
  34.  現状では2Kバイト以上のプログラムを作成してもsaveコマンドで保存できません。listコマンドを実行してから通信ソフト上でCOPY&PASTEしてホスト上に保存してください。
  35.  実行中は、STARTボタンを押すといつでも対話モードに戻れます。その後、contステートメントで実行を継続できます。
  36.  中間言語に翻訳してから処理するため、中間言語に翻訳できない場合は、入力直後にエラーが出ます。
  37. ●言語の概要
  38.  ごく軽いBASIC言語です。
  39.  昔あったTiny BASICに近い構文を持っています。
  40.  データ型は、符号付き16bit整数だけです。
  41.  定数は、-32768~32767の10進数か、0x0000~0xffffの16進数で記述できます。
  42.  変数は、グローバル変数として、A~Zのアルファベット大文字1文字のものが26個あります。
  43.  ローカル変数として、a~zのアルファベット子文字1文字のものが26個あります。ローカル変数はgosubステートメントを実行したときに新しい領域が割り当てられ、returnステートメントを実行したときにgosubする前の領域が戻ってきます。
  44.  配列変数は@(インデックス)という形式の1次元配列だけが使用できます。使用可能なサイズは、プログラム記憶領域(48Kバイト)の残りサイズに等しくなります。インデックスは0から始まります。(例: for i=0 to 9:print @(i):next)
  45.  演算子の優先順位はありません。(1+2*3は9になります)
  46.  計算順序は、括弧()を使って明示的にコントロールしてください。
  47.  オーバーフロー、アンダーフローのチェックはありません。溢れは無視されます。ただしゼロ除算はエラーになります。
  48.  ステートメントなどのキーワードはすべてアルファベット小文字で入力します。大文字を使っても小文字になります。
  49. ● ステートメント一覧
  50. 変数 = 式
  51.  式を計算して変数に代入します。letキーワードはサポートしていません。
  52. 例: a=b+c
  53. if 式 then ステートメント列
  54.  式が0でなければステートメント列を実行します。0なら次の行から実行を継続します。elseはありません。
  55. 例: if (a=0) and (b=1) then goto 200
  56. print [文字列|式|chr(式)][,|;]...
  57.  WonderWitchのテキスト画面の現在のカーソル位置から文字を表示します。
  58.  式の前後に空白文字が入ることはありません。
  59.  chr(式)は、式の値を文字コードと見なして表示します。
  60.  制御コードは扱いませんので、WonderWitchのキャラクタージェネレータにあるすべての文字が表示できます。
  61.  区切り文字の;は何もしません。,はタブストップ位置までカーソルを進めます。
  62.  print文の最後は;または,で終わった場合は改行しません。
  63. 例: print "計算結果=",chr(34);1+2;chr(34)
  64. locate 式,式
  65.  WonderWitchのテキスト画面の現在のカーソル位置を設定します。引数はx,yの順番です。
  66. 例: locate 10,10
  67. cls
  68.  WonderWitchのテキスト画面を消去します。
  69. 例: cls
  70. goto 式
  71.  式の行番号に飛びます。計算型goto文が可能です。つまり、goto A*100とすると、Aが1のきは100行目に。2のときは200行目に飛びます。
  72. 例: goto 100
  73. gosub 式
  74.  スタックに現在位置とローカル変数を積んで、式の行番号に飛びます。gotoと同じく計算型gosubが可能です。
  75.  スタックはforと合わせて8レベルまでです。
  76. 例: gosub 100
  77. return
  78.  gosubがスタックに積んだ情報を取り出して、そこに処理を戻す。ローカル変数も戻る。
  79. 例: return
  80. for 変数=式 to 式
  81. for 変数=式 to 式 step 式
  82.  変数の値を変化させながらnextまで繰り返します。
  83.  終了値は厳密であることに注意が必要です。for i=1 to 2 step 2:nextは、無限ループになります。なぜなら変数iは永遠に2にならないからです。このような仕様にしておかないと、終了値を超えたら終わるという判定だと、ループの終値が32767のときに機能しないためです。
  84. 例: for i=0 to 10 step 2
  85. next
  86.  forステートメントの位置に戻って動作を繰り返します。forステートメントで示した条件が満たされた場合は、nextの次に動作が進みます。nextの後に変数名を書くとエラーになります。
  87. 例: next
  88. end
  89.  プログラムの実行を終了します。
  90. break
  91.  その位置で一時的に実行を中断します。contステートメントで実行を継続できます。
  92. rem 文字列
  93. '文字列
  94.  コメントを記述します。後ろに:を置いてステートメントを続けることはできません。
  95. 例: rem これはテストプログラムです。
  96. 例: 'この式が座標を計算します
  97. new
  98.  メモリ上のプログラムを消去します。
  99. list [行番号][-][行番号]
  100.  指定範囲の行番号のプログラムをリストします。すべて省略すると全行をリストします。
  101. run
  102. run 式
  103. run 文字列
  104.  プログラムを実行します。それに先だって変数やスタックがクリアされます。
  105.  runはメモリ上のプログラムを先頭から。run 式は、式の行番号から。run 文字列は文字列のファイルを読み込んでそれを実行します。
  106. 例: run
  107. 例: run 100
  108. 例: run "test.wb"
  109. cont
  110.  breakステートメントやSTARTボタンによるブレークによって停止した位置から実行を再開します。
  111. save 文字列
  112.  文字列をファイル名としてメモリ上のプログラムを保存します。保存されるのは内部表現ではなくテキスト形式です。
  113.  現在はWonderWitchのファイルシステムの制約上、2Kバイトを超えるファイルを保存できません。listコマンドで端末にリストを送ってそれをCOPY&PASTEして保存してください。
  114. 例: save "hello.wb"
  115. load 文字列
  116.  文字列をファイル名としてファイルからプログラムを読み込みます。読み込むのはテキスト形式で、改行はCRLFとLFのどちらでも可です。中間言語に翻訳できない行がある場合はそこで読み込みが中断されます。プログラムの実行中に使用した場合は実行は中断されます。
  117. 例: load "hello.wb"
  118. merge 文字列
  119.  メモリ上のプログラムにファイル上のプログラムを混ぜ合わせます。同じ行番号の行は読み込まれる方が優先されます。中間言語に翻訳できない行がある場合はそこで読み込みが中断されます。プログラムの実行中に使用した場合は実行は中断されます。
  120. 例: load "merge.wb"
  121. randomize 式
  122.  乱数の初期値を指定します。これを使わないと必ず同じ順序で乱数が発生します。引数には、システム変数tickを指定すると最適です。
  123. 例: randomize tick
  124. exit
  125.  ワンべぇを抜けてOSに戻ります。
  126. debug [文字列|式|chr(式)][,|;]...
  127.  printステートメントと同等ですが、WonderWitchの画面ではなく、シリアルポートに送ります。単体で実行する場合には使えないデバッグ専用の機能です。
  128. waitvb 式
  129.  式の回数だけVBLANKを待ちます。待っている間はSTARTボタンによるブレークを受け付けなくなるので、指定できる値は750までと制限されています。750を超える値を指定するとエラーになります。
  130. 例: waitvb 75
  131. files
  132.  カレントディレクトリのファイル一覧をシリアルポートに送ります。単体で実行する場合には使えないデバッグ専用の機能です。
  133. ● 2項演算子
  134.  + - * / < > = <= >= <> and or xor
  135. ● 単項演算子
  136.  - not
  137. ● 関数
  138. rnd(式)
  139.  0から式-1までの範囲の乱数を返します。
  140. abs(式)
  141.  式の絶対値を返します。
  142. ● システム変数 (読み出しのみ)
  143. scan
  144.  WonderSwanのボタンの状態を調べ、1個の整数値として返します。SCAN_で始まるシステム変数とandを取ることで、どのボタンが押されているかどうか判定できます。STARTボタンは実行中断になるので、これは扱えません。
  145. wait
  146.  WonderSwanのボタンが押されるまで待ち、その状態を1個の整数値として返します。SCAN_で始まるシステム変数とandを取ることで、どのボタンが押されたか判定できます。STARTボタンは実行中断になるので、これは扱えません。
  147. scan_a
  148. scan_b
  149. scan_x1
  150. scan_x2
  151. scan_x3
  152. scan_x4
  153. scan_y1
  154. scan_y2
  155. scan_y3
  156. scan_y4
  157.  それぞれのボタンのマスク値を示す定数を返します。
  158.  Aボタンが押されているかどうかを調べるには、下記の例のように記述します。
  159. 例: if scan and scna_a then print "Aボタンが押さている"
  160. tick
  161.  システムタイマーのtickを返します。ただし、本来のtick値は符号無し32bit整数であり、ここで得られるのは16bit符号あり整数であることに注意が必要です。はみ出たbitは捨てられます。
  162. ● ファイル保存時の拡張子
  163.  一応、ワンべぇのソースフィルは、".wb"で終わるファイル名にしておいて下さい。現在エントランスメニューには全ファイルが見えていますが、".wb"で終わるファイル名だけに限定しようかと考えています。
  164. ● 配布規則
  165.  現バージョンは品質が不明のテスト版です。
  166.  ですので、以下のように扱ってください。
  167.  (正規版でどうするかは未定です)
  168. ・転載
  169.  未完成品ですので、Internetやパソコン通信などへの転載は不可です。必ずhttp://www.piedey.co.jp/のサイトから入手するようにしてください。
  170. ・雑誌掲載等
  171.  ご相談下さい。
  172. ・商業利用
  173.  ご相談下さい。
  174. ・自作ソフトの実行手段としてのワンべぇの添付
  175.  自作ソフトを配布するためにwonbe.fxを一緒に渡すことを許可します。アーカイブへの同梱、CD-Rメディアなどへの焼き込み、通信ケーブルによる転送、どれも可です。ただし、ワンべぇの動作に関しては何も保証はできませんので、リスクは自分で負ってください。利用にあたっては、ロイヤリティなどはありませんので、報告も送金も必要ありません。
  176. ● 問い合わせ先
  177. 株式会社ピーデー http://www.piedey.co.jp/
  178. 川俣 晶 autumn@piedey.co.jp
  179. 以上