X-BASIC/68との違い

• テキスト座標
• グラフィック座標(float)
• スプライト枚数(定義/表示)、座標
• BG画面サイズ、座標
• 色コード
• ファイル名規則
• メモリの格納順はL→H(リトルエンディアン)

関数名	circle
X68版書式	circle(cx;int ,cy;int ,r;int ,col;int[,startAngle;int] [,endAngle;int] [,hv;int])
iOS版書式	circle(cx;float,cy;float,r;float [,startAngle;float][,endAngle;float][,clockwise;int][,ffill;int][,style;int]) および ellipse(cx;float,cy;float,r;float[,hv;float][,ffill;int][,style;int])
相違点	座標の他、色コードの指定方法が違います（iOS版ではgColor()で別途設定します）。 startAngle/endAngleの単位が異なります。X68は度、iOSはラジアンです。 また、X68は反時計回りの角度指定なのに対し、iOSは時計回りの角度指定になります。 X68での描画結果は以下の通りです。 iOSではclockwise,ffill指定が追加されています。 また、styleの設定値に制約があります。詳しくは取説を参照のこと。 扁平率指定hvがiOSにはありません。逆に扁平率を指定して楕円を描画するときはellipse()を使います。 ビットマップにもbitmapCircle()および扁平率を指定できるbitmapEllipse()/bitmapEllipse2()があります。 circleX68()/circle16X68()が互換関数になります。

screen〔<表示画面サイズ>〕,<グラフィック画面の実画面サイズ及び色モード>〕,<ディスプレイ解像度>〔,<グラフィック画面の表示ON/OFF>〕
    
画面全体(テキスト画面、グラフィック画面､スプライト画面)のスクリーンモードを設定します。

<表示画面サイズ>
    O………256×256
    1………512×512
    2………768×512 (<ディスプレイ解像度>が1(高解像度モード)のときのみ使用可能)
            
ただし、<表示画面サイズ>が768×512以外のときにのみ、スプライト画面は使用できます。
また、<表示画面サイズ>が768×512のときは、<グラフィック画面の実画面サイズ及び色モード>は、0しか設定できません。
                    
<グラフィック画面の実画面サイズ及び色モード>(使用可能なグラフィックページ)
    O………1024×1024、16色(グラフィックページ0)
    1………512×512、16色(グラフィックページ0～3)
    2………512×512、256色(グラフィックページ0,1)
    3………512×512、65536色(グラフィックページ0)
    ただし、<グラフィック画面の実画面サイズ及び色モード>が0以外のときは、<表示画面サイズ>は0または1しか設定できません。
        
<ディスプレイ解像度>
    O………Low(標準解像度)
    1………High(高解像度)
ただし、screen ,,0は<ディスプレイ解像度>のみをLowに設定し、screen ,,1は<ディスプレイ解像度>のみをHighに設定します。
この場合、グラフィックRAMのデータは保存されたままます。<ディスプレイ解像度>がLowのときは<表示画面サイズ>で768×512は使用できません。
            
<グラフィック画面の表示ON/OFF>
    0………表示OFF(グラフィック関数使用不可)
        グラフィックRAMをグラフィック以外の目的で使用する場合に設定してください。
    1………表示ON(グラフィック関数使用可)
        グラフィックRAMをグラフィック関数などで使用する場合に設定してください。(グラフィックRAM初期化)
        
なお、一旦<グラフィック画面の表示ON/OFF>を1に設定するとすべてのグラフィックRAMのデータは消去されます｡
特にグラフィックRAMをRAMディスクとして使用している場合は、RAMディスクが破壊されますので､あらかじめRAMディスク
のデータをディスクなどにセーブしてください。

screen命令実行後、window関数(グラフィック画面のクリッピングエリア)は表示画面サイズに、home関数
(グラフィック画面の実画面における表示画面の左上座標)は(0,0)に再設定されます。
また、テキスト画面は、通常表示ON、スプライト画面及びグラフィック画面は表示OFFです。
グラフィック関数を使用する場合は、必ず最初にscreen命令で初期化を行ってください。

X-BASIC'は、ぺけ-BASICの持つ拡張機能の多くを標準で動作するようにしています。

ぺけ-BASICの拡張配列については、元の説明書きが不十分な上に、具体的なサンプルが1つも見当たりませんでしたので、
同じ動作が出来ているかどうかわかりません。実動結果が全てです。

ぺけ-BASICもX-BASIC/68互換ですが、バグもしくは仕様の違いによりに一部動作が異なります。
その部分は基本的にX-BASIC/68に合わせてあります。

X-BASIC/68では変数の初期化時には定数のみ可能で式を使うことは出来ませんが、
iOS版(とぺけ-BASIC)では他の変数を参照した式も記述できます。

外部関数の実装はX-BASIC/68のそれにきわめて近い形式にしており、拡張が容易です。
外部関数がどんどん増えるのはその恩恵です。

X-BASIC/68と同じ外部関数を作ることが出来れば、より多くのX-BASIC/68上の資産が使えるようになる、かもしれません。

今回の開発に際しては、中谷秀洋氏の「ぺけ-BASIC」を大いに参考にさせていただきました。
中間コードにコンパイルしてから実行するという構造もそこからいただきました。
ぺけ-BASICではエディタは省略されましたが、iOS版では省略できないので実装しています。
実はこの部分の開発もかなり大変でした。

物理的に速くないX68000上で、出来るだけ速くX-BASICを動かそうとする優秀なプログラムですが、
いかんせんオールアセンブラな上にメンテナンス性が考慮されてない記述だったため、解析はきわめて難しいものでした。
68000というMPUやアセンブラHASに強く依存する記述や、定数化しない即値記述が非常に多いなどです。

原作者の方が「バグ取り以外はしない」とおっしゃられていましたが、
実際のところ「それ以外出来ない」状況にあったというのが真実でしょう。
少しでもいじろうもんなら他の部分に影響を与える、そんな、ある意味｢絶妙なバランス｣でした。
（iOS版発表後オリジナルの作者さんとメイルのやりとりをする機会を得ましたが、
「usingやfloatは使わないからデバッグし切れてなかった」とのことでした。)

今回の開発ではX-BASIC/68だけでなくぺけ-BASIC上でも動作確認をしましたが、
いろいろとバグを発見しました。今更ではありますが、ここに公開しておきます。
もちろん、iOS版ではすべて解消しています。

• floatの変数初期化サイズが足りていない。
  要するに宣言しただけでは0.0にならないと言うことです。
  float変数を使う場合、明示的に初期化しないと正しくない結果をもたらします。 (ただし、そのときの作業ワーク内容によるので、発現しないこともあります。)
  
  
• float定数のみ f1 * -f2で「無効な命令が発生する」
  ｢例｣4.321*-5.01
  X-BASIC/68はOK
  int/charはOK
  
  
• 単項演算子が連続すると式エラーが出る
  not -/-notなど
  float/int/charすべて
  X-BASIC/68はOK
  ()を付ければ回避できる
  
  
• usingの結果および書式指定の方法がX-BASIC/68と異なる
  "+##"の結果
  "\.#"の結果(整数部なしで\をつける)
  ^^^^^指定時に,を付けたらエラーになる
  

  X-BASIC/68	ぺけ
  -^^^^^	^^^^^-
  +**	**+

  iOS版は/68に合わせています。
  
  
• printの数値表示時の桁位置が違う

  X-BASIC/68	符号(＋の時は空白)＋数値＋空白1文字
  ぺけ	空白＋符号付き数値＋空白

  	/68	iOS	ぺけ
  "A";100;"B"	A 100 B	←	←←
  "A";-100;"B"	A-100 B	←	A -100 B
  "A";3.14;"B"	A 3.14 B	←	←←
  "A";-3.14;"B"	A-3.14 B	←	A -3.14 B

  iOS版は/68に合わせています。
  
  
• e表現floatが使えない
  3.14e10など
  
  
• then {またはelse {の後に:/*と書くとエラーになる
  コメントを書く場合、:なしで/*と書かなければならない
  内部的にはマルチステートメントの処理に問題がある
  X-BASIC/68でもelse {で発生する。
  
  
• tan(pi(1.0/2.0))の計算結果がおかしい
  6.2184311638237E+015となってしまう。
  正解は1.6331239353195E+016
  X-BASIC/68も同じなので、XM6 typeG/xm6i、もしくはfloat2.xのバグかもしれない。
  ちなみに、sin()/cos()で計算すると正しい。
  

  sin(pi/2)/cos(pi/2)=1.6331239353195E+016
  

  以下も正しい。
  

  tan(pi/4)=1
  tan(pi/8)=0.4142...
  

  
  
• 配列を引数に持つ関数の中で、子関数にその配列を渡すときエラーが発生する
  

  func testFunc(n;int,s(4,1);str)
  ～
  subFunc(s) :// ここでエラーが発生する
  endfunc
  func subFunc(s(4,1);str)
  ～
  endfunc
  

  引数配列の要素数は省略が可能=呼び出し時に確定されるため、コンパイル時には未定のままになっています。
  ところが、その確定処理が抜けているためエラーが発生しています。
  なお、要素数を省略してない場合もエラーになります。
  
  
• 関数の引数名が関数名と同じだったとき、func文で変数二重宣言エラーが発生する
  関数の引数名を関数名と同じにしないこと。
  なおこれはX-BASIC/68では発生しないが、ぺけ-BASICで発生する。
  バグというより仕様。両者の数少ない非互換部分の１つ。
  
  
• func message(n; int , rt; int)のように、引数型を示す;の後にスペースを入れると内部エラーが発生する。
  スペースを取るとOK。X-BASIC/68では発生しない。
  
  
• using "～"の後ろにスペースを置くとエラーが発生する
  

  using "###";a /* OK
  using "###" ;a /* エラー

  X-BASIC/68では発生しない。
  
  

• 以下の物が32767個を超えると異常動作を起こす
  変数の個数(グローバル/ローカル別)
  ラベル最大数
  行番号の実利用数
  
  
• 行番号に65535を使うと異常動作する
  
  
• func で配列引数を取った時、dim(n,m の後に)以外の文字があると其の分ワークが無駄に消費される
  たぶん暴走はしないけど、おかしい
  
  
• 配列の初期化
  {}内の初期値要素の個数が宣言した要素数より多い時、中間コードエリアを破壊する
  一応後でエラーを出す処理は入っているが、そこまで行くまでに(メモリ内容を破壊して)異常動作を起こす可能性がある
  
  
• 関数で配列引数のとき、3次元以上の配列を与えてもエラーが発生しない
  次元判定に使うレジスタを間違っている
  
  
• 配列への代入がおかしい
  レジスタの参照を間違っているので。
  たぶん ぺけ-BASIC はたまたま動いてるだけ。
  
  
• 文字列定数加算をしたとき、その合計サイズが256バイトを超えるとワークを破壊する
  その領域を別の文字列変数がすでに使っている場合、その内容が化ける
  加算を繰り返すと其の都度新しいワークを割り付けるため、メモリ不足に陥りやすい
  
  
• 拡張配列を関数の引数にしたとき、要素数テーブルを過剰にクリアしてしまう
  
  
• 配列宣言で、閉じ括弧がなくソースが終わったときにハングアップする。
  多次元配列で,の後がなくソースが終わったときも同様。