VERIFICATION

目的：同梱の自作フォントで使える文字と、その表示方法を確認します。

処理の流れ：m_initで画面とフォントを準備し、m_textで文字列を行ごとに表示します。二重引用符は文字コード34をm_putへ渡して描きます。

操作と期待する結果：大文字26字、小文字26字、数字10字、記号30字が並びます。各文字が欠けずに表示されるか確認してください。操作は不要です。

目的：ROMを起動し、文字列と数値を背景に表示する最小の流れを学びます。

処理の流れ：m_initの後にm_textで挨拶を描き、m_numberに42を渡します。最後のループは画面を保ったままフレームを待ちます。

操作と期待する結果：HELLO WORLDと042が表示されます。042は3桁にそろえた十進数42です。

目的：8ビットに収まらない途中結果を16ビットで扱う方法を学びます。

処理の流れ：(u16)200 + 100で300を作り、10で割ってから表示用にu8へ変換します。足し算の前の型変換に注目してください。

操作と期待する結果：030、つまり計算結果30が表示されます。

目的：for、continue、while、do/while、switchを小さな計算で試します。

処理の流れ：0～7を加算しますが3はcontinueで飛ばすため合計は25です。whileで30、do/whileで32まで増やし、switchのcase 32で42に置き換えます。

操作と期待する結果：042が表示されます。各ループと分岐を順番に通った計算結果です。

目的：複数の値をまとめ、関数やポインタを通して扱う方法を学びます。

処理の流れ：Pointの(10,20)を別の構造体へコピーし、ポインタから配列に1～4を書きます。addの戻り値30に配列の1、2、4と定数5を加えます。

操作と期待する結果：合計42が042と表示されます。構造体コピー、ptr[i]による書き込み、関数の戻り値を順に追ってください。

目的：複数のフラグを1バイトにまとめ、バッファを別の領域へコピーします。

処理の流れ：__memsetで4バイトを0にし、ビット3を立て、ビット1を反転します。__memcpyで4バイトすべてを別配列にコピーします。

操作と期待する結果：コピー先の先頭バイトが010になります。ビット3の8とビット1の2を合わせた十進数10です。

目的：ボタンを押し続ける状態と、新しく押した瞬間を区別します。

処理の流れ：毎フレームinput_updateを呼び、input_pressed(BTN_A)が真のときだけカウンターを増やします。

操作と期待する結果：最初は000です。Aを押すと001になり、押し続けても増えません。離して押し直すと002になります。255の次は000に戻ります。

目的：整数とQ8.8固定小数点の相互変換、および掛け算の基本を学びます。

処理の流れ：3と4をfix_from_intでQ8.8へ変換し、fix_mulで掛け、fix_to_intで整数へ戻します。

操作と期待する結果：3×4の結果12が012と表示されます。画面に出るのは内部の256倍された値ではなく、整数へ戻した値です。

目的：動的メモリ確保を使わず、決まった個数の領域からオブジェクトを作ります。

処理の流れ：entity_initで初期化し、種類1のオブジェクトを(20,30)に作ります。IDが失敗値0xFFでないことを確認してvxへ2を設定します。

操作と期待する結果：001は使用中オブジェクトの個数です。IDや座標ではありません。この例は更新・描画を行わないので、動くキャラクターは表示されません。

目的：画面表示とは別に、ゲーム中の変数を診断用バッファへ残します。

処理の流れ：debug_initで初期化し、フレームタグ1を設定してHPという名前で42を記録します。

操作と期待する結果：画面の001は記録件数です。HP=42という値そのものは画面ではなく診断バッファにあります。画面だけでは記録内容までは確認できません。

目的：キャラクターの軌跡などに使う座標履歴の格納方法を学びます。

処理の流れ：4点分の配列をchain_initに渡し、chain_push_headで(20,30)を1点追加します。

操作と期待する結果：042は処理後に表示する固定の目印です。保存した座標や件数を表していません。履歴の内容を確かめるにはtrailとpointsを観察します。追従する胴体の描画例ではありません。

目的：フレーム待機とライブラリが管理する経過フレーム数の関係を確認します。

処理の流れ：system_initの後にsystem_wait_vblankを2回呼び、system_get_frame8の値を表示します。

操作と期待する結果：002が表示されます。その後のループは本書のm_waitを使うため、この表示値は増え続けません。

目的：タイトル画面やゲーム本編などを区別するシーン番号の選択方法を学びます。

処理の流れ：0で初期化された2件のSceneDefを登録し、scene_change(1)でID 1を選択します。

操作と期待する結果：001はscene_get_currentが返す現在のIDです。この例にはシーンのコールバックや画面切り替えの描画は登録していません。

目的：同梱の自作フォントで使える文字と、その表示方法を確認します。

処理の流れ：m_initで画面とフォントを準備し、m_textで文字列を行ごとに表示します。二重引用符は文字コード34をm_putへ渡して描きます。

操作と期待する結果：大文字26字、小文字26字、数字10字、記号30字が並びます。各文字が欠けずに表示されるか確認してください。操作は不要です。

目的：ROMを起動し、文字列と数値を背景に表示する最小の流れを学びます。

処理の流れ：m_initの後にm_textで挨拶を描き、m_numberに42を渡します。最後のループは画面を保ったままフレームを待ちます。

操作と期待する結果：HELLO WORLDと042が表示されます。042は3桁にそろえた十進数42です。

目的：8ビットに収まらない途中結果を16ビットで扱う方法を学びます。

処理の流れ：(u16)200 + 100で300を作り、10で割ってから表示用にu8へ変換します。足し算の前の型変換に注目してください。

操作と期待する結果：030、つまり計算結果30が表示されます。

目的：for、continue、while、if/elseを小さな計算で試します。

処理の流れ：0～7のうち3を飛ばして合計25を作り、whileで32まで増やします。ifで32との一致を判定し、成功側で42を代入します。

操作と期待する結果：042が表示されます。このプログラムで使う分岐はif/elseです。

目的：複数の値をまとめ、関数やポインタを通して扱う方法を学びます。

処理の流れ：Pointの(10,20)を別の構造体へコピーし、ポインタから配列に1～4を書きます。addの戻り値30に配列の1、2、4と定数5を加えます。

操作と期待する結果：合計42が042と表示されます。構造体コピー、ptr[i]による書き込み、関数の戻り値を順に追ってください。

目的：複数のフラグを1バイトにまとめ、バッファを別の領域へコピーします。

処理の流れ：__memsetで4バイトを0にし、ビット3を立て、ビット1を反転します。__memcpyで4バイトすべてを別配列にコピーします。

操作と期待する結果：コピー先の先頭バイトが010になります。ビット3の8とビット1の2を合わせた十進数10です。

目的：ボタンを押し続ける状態と、新しく押した瞬間を区別します。

処理の流れ：毎フレームinput_updateを呼び、input_pressed(BTN_A)が真のときだけカウンターを増やします。

操作と期待する結果：最初は000です。Aを押すと001になり、押し続けても増えません。離して押し直すと002になります。255の次は000に戻ります。

目的：整数とQ8.8固定小数点の相互変換、および掛け算の基本を学びます。

処理の流れ：3と4をfix_from_intでQ8.8へ変換し、fix_mulで掛け、fix_to_intで整数へ戻します。

操作と期待する結果：3×4の結果12が012と表示されます。画面に出るのは内部の256倍された値ではなく、整数へ戻した値です。

目的：動的メモリ確保を使わず、決まった個数の領域からオブジェクトを作ります。

処理の流れ：entity_initで初期化し、種類1のオブジェクトを(20,30)に作ります。IDが失敗値0xFFでないことを確認してvxへ2を設定します。

操作と期待する結果：001は使用中オブジェクトの個数です。IDや座標ではありません。この例は更新・描画を行わないので、動くキャラクターは表示されません。

目的：画面表示とは別に、ゲーム中の変数を診断用バッファへ残します。

処理の流れ：debug_initで初期化し、フレームタグ1を設定してHPという名前で42を記録します。

操作と期待する結果：画面の001は記録件数です。HP=42という値そのものは画面ではなく診断バッファにあります。画面だけでは記録内容までは確認できません。

目的：キャラクターの軌跡などに使う座標履歴の格納方法を学びます。

処理の流れ：4点分の配列をchain_initに渡し、chain_push_headで(20,30)を1点追加します。

操作と期待する結果：042は処理後に表示する固定の目印です。保存した座標や件数を表していません。履歴の内容を確かめるにはtrailとpointsを観察します。追従する胴体の描画例ではありません。

目的：フレーム待機とライブラリが管理する経過フレーム数の関係を確認します。

処理の流れ：system_initの後にsystem_wait_vblankを2回呼び、system_get_frame8の値を表示します。

操作と期待する結果：002が表示されます。その後のループは本書のm_waitを使うため、この表示値は増え続けません。

目的：タイトル画面やゲーム本編などを区別するシーン番号の選択方法を学びます。

処理の流れ：0で初期化された2件のSceneDefを登録し、scene_change(1)でID 1を選択します。

操作と期待する結果：001はscene_get_currentが返す現在のIDです。この例にはシーンのコールバックや画面切り替えの描画は登録していません。

目的：カメラ位置を引いて、ゲーム世界の位置を画面内の位置へ変換します。

処理の流れ：Camera_SetにQ8.8の2560、つまりX=10ピクセルを渡します。世界座標X=52をCamera_WorldToScreenXで変換します。

操作と期待する結果：52−10=42なので042と表示されます。このプログラムは座標変換の例で、背景を動かすものではありません。

目的：同じ値の繰り返しを、個数と値の組で保存する簡単な圧縮形式を試します。

処理の流れ：packedの{3,42,0}は「42を3回、0の個数で終了」です。rle_decodeへ3バイトの展開先を渡します。

操作と期待する結果：最後のバイトout[2]が042と表示されます。展開先の3バイトはすべて42になる想定です。

目的：マス目のゲームで使う2次元座標と、保存用配列の関係を学びます。

処理の流れ：16バイトの配列を4×4の盤面として登録し、0でクリアしてからセル(2,1)へ42を書きます。同じ座標を読み返します。

操作と期待する結果：読み出した42が042と表示されます。4×4の盤面そのものを描画する例ではありません。

目的：ワールドと矩形ボディを初期化し、速度から位置を更新する最小の例です。

処理の流れ：X=40、Y=40にボディを作り、速度を(2,0)、重力を0にしてkq2d_stepを1回呼びます。

操作と期待する結果：更新後のX=42が042と表示されます。この例の位置は整数ピクセルです。箱の形や連続したアニメーションを描く例ではありません。

目的：シリアル転送が完了した場合と、制限時間内に完了しない場合を分けて扱います。

処理の流れ：マスターとして42を送信し、Link_WaitByteで待ちます。成功すれば受信値、タイムアウトならLink_Cancelの後に0を表示します。

操作と期待する結果：未接続で転送が完了すれば255、待機がタイムアウトすれば000、相手が接続されていれば受信した値が表示されます。042固定の例ではありません。

目的：ROMのデータをRAMへコピーするAPIの引数を学びます。

処理の流れ：値7と42の2バイトをfar_data_readでcopiedへ読み込みます。バンク引数は0、コピー長は2です。

操作と期待する結果：コピー先の2バイト目が042と表示されます。この例は固定ROMの読み出しで、異なる切替バンク間の転送を実証するものではありません。

目的：素材の位置と長さを表へ登録し、IDで参照する仕組みを学びます。

処理の流れ：ID 0に種類RAW、バンク0、{7,42}のポインタ、長さ2を登録します。asset_load_rawで2バイトのRAMへ読み込みます。

操作と期待する結果：コピー先の2バイト目が042と表示されます。画像表示ではなく、生のバイト列を素材IDで取得する例です。

目的：弾の管理領域を初期化し、発射後の使用数を調べます。

処理の流れ：danmaku_resetの後にdanmaku_spawn(40,40,16,0)を呼び、dm_countを表示します。

操作と期待する結果：001は登録された弾の個数です。この例には更新ループや背景への弾描画処理がないため、画面に弾が飛ぶ様子は表示されません。

目的：1ピクセル未満の移動を端数として保持し、整数座標へ繰り上げる方法を学びます。

処理の流れ：X=40から、2/8ピクセルの移動を8回加算します。右シフトで整数部分を取り出し、マスクで端数を残します。

操作と期待する結果：合計2ピクセル進み、X=42が042と表示されます。これは正方向の手動積算例です。負方向には対応する繰り下げ処理が必要です。

目的：Game Boy ColorのRGB値で、背景と文字の色を指定します。

処理の流れ：VBlank中にLCDを止め、パレット0の色0を白(31,31,31)、色3を紫(12,0,22)へ設定してから表示を再開します。

操作と期待する結果：CGBモードで実行すると白い背景に紫色の文字と042が表示されます。DMGの白黒表示では色の結果を確認できません。

目的：背景の内容を書き換えず、表示開始位置を動かす方法を学びます。

処理の流れ：毎フレームphaseを1増やし、Scroll_SetBgへ渡します。8ビット値なので255の次は0になります。

操作と期待する結果：SCROLLという文字が左へ動きます。画面の数字ではなく、時間を追って文字の位置が変わることを確認してください。

目的：描画の要求と、VRAMへ実際に書き込むタイミングを分けます。

処理の流れ：vram_queue_bg_tileでタイル座標(3,8)へ番号52を予約し、vram_flushで転送します。同梱フォントの番号52は数字4です。

操作と期待する結果：背景のタイル座標(3,8)に数字4が表示されます。全画面の数値カウンターではなく、1マスへの描画結果です。

目的：背景とは別に動かせるスプライトの割り当てと表示を学びます。

処理の流れ：空のプールから最初のスロット0を確保し、タイル65と位置(70,80)を設定します。OBJ表示を有効にして、毎フレームシャドーOAMを転送します。

操作と期待する結果：指定位置に文字Aのスプライトが表示されます。位置は固定です。実際のゲームでは割り当て失敗値を確認してからIDを使います。

目的：同じ初期値から同じ乱数列を再現する方法を学びます。

処理の流れ：rng_seed(1234)で初期化し、rng_range(10)を1回呼びます。上限10は結果に含まれません。

操作と期待する結果：000～009のいずれかが表示されます。同じプログラムを同じシードで起動すれば同じ値になります。毎フレーム変化する例ではありません。

目的：イベントを達成したかなどの真偽値を、フラグ番号で管理します。

処理の流れ：フラグ12をクリアしてから立て、flag_getで読み返します。

操作と期待する結果：001はフラグ12が真であることを示します。この例はRAM上のフラグ操作で、電源を切っても残るセーブ処理は行いません。

目的：円の物理ワールドへボディを登録し、速度による位置更新を試します。

処理の流れ：半径4、位置(40,40)、速度(2,0)の円を有効にします。重力0、linear_damping_q8=255でkq2dc_stepを1回呼びます。

操作と期待する結果：更新後のX=42が042と表示されます。円の輪郭や衝突アニメーションを描画する例ではなく、整数座標の更新例です。

目的：PPUのスクロール位置を更新して背景を動かします。

処理の流れ：__scroll_set(0,0)で開始し、フレームごとにphaseを1増やして横位置へ設定します。

操作と期待する結果：SCROLLという文字の横位置が変わります。phaseは255から0へ戻ります。複数のネームテーブルを使う広いマップの例ではありません。

目的：メイン処理からPPU更新をキューへ送り、NMI側で反映する流れを学びます。

処理の流れ：__vramq_putでネームテーブルの0x2103へタイル52を予約し、__vramq_commitで送信します。0x2103はタイル座標(3,8)です。

操作と期待する結果：背景の(3,8)に数字4が表示されます。番号52は同梱フォントの数字4に対応します。

目的：スプライト用の色とOAM情報を準備して、背景とは別の画像を表示します。

処理の流れ：スプライトパレットを読み込み、スロット0へ位置(70,80)、タイル65、属性0を設定します。表示を有効にしてOAM DMAを繰り返します。

操作と期待する結果：文字Aのスプライトが固定位置に表示されます。動く画像ではなく、OAM設定と転送の基本例です。

目的：NES本体のパルスチャンネルへ音量・タイマー・長さを設定します。

処理の流れ：nes_apu_initの後にnes_sfx_square1(0xBF,400,20)を呼びます。0xBFは一定音量と長さカウンター停止を指定するため、音は持続します。20は長さテーブルの番号で、20フレームという意味ではありません。

操作と期待する結果：042を表示しながらパルス音が鳴り続けます。音を止めるにはnes_apu_silence_allを呼びます。042自体は発音確認の結果ではありません。

目的：効果音データを開始し、毎フレームの更新で最後まで進める方法を学びます。

処理の流れ：Audio_Initの後、Audio_PlaySFXへtoneとチャンネルID 1を渡します。メインループからAudio_Updateを1フレームに1回呼びます。

操作と期待する結果：042を表示しながら短いパルス波の効果音が鳴ります。042は固定の目印で、音量や再生位置ではありません。音の確認には音声出力または録音を使ってください。