驗證紀錄

目的： 了解提供的原創字型包含哪些字母、數字與標點符號，以及如何繪製。

運作方式： m_init 準備顯示與字型。m_text 繪製各列，m_put 則以字元碼 34 繪製雙引號。

操作方式與預期結果： 請確認有 26 個大寫字母、26 個小寫字母、10 個數字及 30 個標點符號，並檢查每個字形是否清晰可辨。無須輸入操作。

目的： 學習啟動 ROM 並在背景繪製文字與數字的基本步驟。

運作方式： m_init 後，m_text 繪製問候文字，m_number 格式化 42。最後的迴圈等待影格並保持畫面顯示。

操作方式與預期結果： 畫面顯示 HELLO WORLD 與 042。前面的零來自三位數十進位格式。

目的： 學習如何保留超出八位元範圍的中間結果。

運作方式： (u16)200 + 100 的結果為 300。程式先除以 10，再轉為 u8 顯示。請注意，擴大型別的轉型發生在加法之前。

操作方式與預期結果： 030 表示計算結果 30。

目的： 在簡單計算中試用 for、continue、while、do/while 與 switch。

運作方式： 將 0 到 7 相加但略過 3，得到 25。while 迴圈推進至 30，do/while 推進至 32，switch 再選擇 case 32 並指定 42。

操作方式與預期結果： 042 是這些迴圈與分支的最終結果。

目的： 學習如何將值分組，並透過函式與指標存取。

運作方式： 程式複製包含 (10,20) 的 Point，再透過指標將 1 至 4 寫入陣列。它將函式結果 30 加上陣列值 1、2、4 與常數 5。

操作方式與預期結果： 總和顯示為 042。請追蹤結構複製、ptr[i] 寫入與函式傳回值。

目的： 將旗標打包成一個位元組，並將緩衝區複製至另一個儲存區。

運作方式： __memset 清除四個位元組。程式設定位元 3、切換位元 1，再以 __memcpy 複製全部四個位元組。

操作方式與預期結果： 目的緩衝區的第一個位元組顯示為 010，其中位元 3 貢獻 8，位元 1 貢獻 2。

目的： 區分按鈕剛按下與持續按住的狀態。

運作方式： 每個影格都會呼叫 input_update。只有 input_pressed(BTN_A) 為真時，計數器才會增加。

操作方式與預期結果： 初始值為 000。按 A 後變成 001，持續按住不會累加。放開後再按一次便變成 002。此位元組計數器會從 255 回繞至 000。

目的： 學習將整數轉為 Q8.8、相乘，再轉回整數。

運作方式： fix_from_int 將 3、4 轉成 Q8.8，fix_mul 將兩者相乘，fix_to_int 再將乘積轉回整數。

操作方式與預期結果： 012 表示 3 × 4 = 12，是轉換後的整數，不是內部放大 256 倍的值。

目的： 從固定的一組槽位建立物件，無須動態配置記憶體。

運作方式： entity_init 重設物件池。entity_create 在 (20,30) 建立型別 1；程式先檢查失敗 ID 0xFF，再將 vx 設為 2。

操作方式與預期結果： 001 是啟用中的物件數，不是 ID 或座標。此範例不更新或繪製物件，因此不會出現移動角色。

目的： 將具名遊戲值保存在診斷緩衝區，與畫面顯示分開處理。

運作方式： 程式初始化除錯功能，將影格標記設為 1，並以 HP 為名稱記錄值 42。

操作方式與預期結果： 001 是追蹤項目數。HP=42 存於診斷緩衝區，僅靠畫面無法顯示或驗證該內容。

目的： 學習如何將位置軌跡儲存在環形緩衝區中。

運作方式： chain_init 掛接可容納四個點的陣列，接著 chain_push_head 記錄 (20,30)。

操作方式與預期結果： 042 是固定完成標記，不是座標或數量。請檢查 trail 與 points 以確認儲存的歷史。此程式不繪製跟隨的身體。

目的： 觀察以影格計數的等待如何影響函式庫影格計數器。

運作方式： system_init 後，程式呼叫兩次 system_wait_vblank，再顯示 system_get_frame8。

操作方式與預期結果： 結果為 002。閒置迴圈使用手冊輔助函式 m_wait，因此顯示值不會持續增加。

目的： 學習如何選取 ID，以區分標題畫面、遊戲進行等場景。

運作方式： 程式登錄兩個以零初始化的 SceneDef 項目，再以 scene_change 選取 ID 1。

操作方式與預期結果： 001 是 scene_get_current 傳回的目前 ID。此範例未註冊場景回呼或轉場繪製。

目的： 了解提供的原創字型包含哪些字母、數字與標點符號，以及如何繪製。

運作方式： m_init 準備顯示與字型。m_text 繪製各列，m_put 則以字元碼 34 繪製雙引號。

操作方式與預期結果： 請確認有 26 個大寫字母、26 個小寫字母、10 個數字及 30 個標點符號，並檢查每個字形是否清晰可辨。無須輸入操作。

目的： 學習啟動 ROM 並在背景繪製文字與數字的基本步驟。

運作方式： m_init 後，m_text 繪製問候文字，m_number 格式化 42。最後的迴圈等待影格並保持畫面顯示。

操作方式與預期結果： 畫面顯示 HELLO WORLD 與 042。前面的零來自三位數十進位格式。

目的： 學習如何保留超出八位元範圍的中間結果。

運作方式： (u16)200 + 100 的結果為 300。程式先除以 10，再轉為 u8 顯示。請注意，擴大型別的轉型發生在加法之前。

操作方式與預期結果： 030 表示計算結果 30。

目的： 在簡單計算中試用 for、continue、while 與 if/else。

運作方式： for 迴圈累加 0 至 7，但跳過 3，得到 25。while 迴圈將值增加至 32；接著的 if 在值相符時指定為 42。

操作方式與預期結果： 042 是最終結果。此程式使用 if/else 分支。

目的： 學習如何將值分組，並透過函式與指標存取。

運作方式： 程式複製包含 (10,20) 的 Point，再透過指標將 1 至 4 寫入陣列。它將函式結果 30 加上陣列值 1、2、4 與常數 5。

操作方式與預期結果： 總和顯示為 042。請追蹤結構複製、ptr[i] 寫入與函式傳回值。

目的： 將旗標打包成一個位元組，並將緩衝區複製至另一個儲存區。

運作方式： __memset 清除四個位元組。程式設定位元 3、切換位元 1，再以 __memcpy 複製全部四個位元組。

操作方式與預期結果： 目的緩衝區的第一個位元組顯示為 010，其中位元 3 貢獻 8，位元 1 貢獻 2。

目的： 區分按鈕剛按下與持續按住的狀態。

運作方式： 每個影格都會呼叫 input_update。只有 input_pressed(BTN_A) 為真時，計數器才會增加。

操作方式與預期結果： 初始值為 000。按 A 後變成 001，持續按住不會累加。放開後再按一次便變成 002。此位元組計數器會從 255 回繞至 000。

目的： 學習將整數轉為 Q8.8、相乘，再轉回整數。

運作方式： fix_from_int 將 3、4 轉成 Q8.8，fix_mul 將兩者相乘，fix_to_int 再將乘積轉回整數。

操作方式與預期結果： 012 表示 3 × 4 = 12，是轉換後的整數，不是內部放大 256 倍的值。

目的： 從固定的一組槽位建立物件，無須動態配置記憶體。

運作方式： entity_init 重設物件池。entity_create 在 (20,30) 建立型別 1；程式先檢查失敗 ID 0xFF，再將 vx 設為 2。

操作方式與預期結果： 001 是啟用中的物件數，不是 ID 或座標。此範例不更新或繪製物件，因此不會出現移動角色。

目的： 將具名遊戲值保存在診斷緩衝區，與畫面顯示分開處理。

運作方式： 程式初始化除錯功能，將影格標記設為 1，並以 HP 為名稱記錄值 42。

操作方式與預期結果： 001 是追蹤項目數。HP=42 存於診斷緩衝區，僅靠畫面無法顯示或驗證該內容。

目的： 學習如何將位置軌跡儲存在環形緩衝區中。

運作方式： chain_init 掛接可容納四個點的陣列，接著 chain_push_head 記錄 (20,30)。

操作方式與預期結果： 042 是固定完成標記，不是座標或數量。請檢查 trail 與 points 以確認儲存的歷史。此程式不繪製跟隨的身體。

目的： 觀察以影格計數的等待如何影響函式庫影格計數器。

運作方式： system_init 後，程式呼叫兩次 system_wait_vblank，再顯示 system_get_frame8。

操作方式與預期結果： 結果為 002。閒置迴圈使用手冊輔助函式 m_wait，因此顯示值不會持續增加。

目的： 學習如何選取 ID，以區分標題畫面、遊戲進行等場景。

運作方式： 程式登錄兩個以零初始化的 SceneDef 項目，再以 scene_change 選取 ID 1。

操作方式與預期結果： 001 是 scene_get_current 傳回的目前 ID。此範例未註冊場景回呼或轉場繪製。

目的： 從世界位置減去攝影機位置，求得畫面位置。

運作方式： Camera_Set 接收 Q8.8 值 2560，也就是 X=10 像素。接著 Camera_WorldToScreenX 轉換世界座標 X=52。

操作方式與預期結果： 052 減去 010 得到畫面上的 042。這是座標計算，不會捲動背景。

目的： 嘗試以次數與數值，精簡表示重複的位元組。

運作方式： 壓縮位元組 {3,42,0} 代表重複三次 42，再以零次數結束標記收尾。rle_decode 寫入三位元組目的緩衝區。

操作方式與預期結果： 最後一個位元組 out[2] 顯示為 042。解壓縮後的三個位元組應全部為 42。

目的： 了解棋盤遊戲的格子座標如何對應到儲存位置。

運作方式： 以 16 位元組陣列儲存 4×4 棋盤。程式清空棋盤、在格子 (2,1) 寫入 42，再讀回同一格。

操作方式與預期結果： 042 是讀回的值。程式不繪製 4×4 棋盤本身。

目的： 初始化世界與方盒剛體，再根據速度更新位置。

運作方式： 剛體從位置 (40,40)、速度 (2,0)、零重力開始。程式呼叫 kq2d_step 一次。

操作方式與預期結果： 042 是算出的 X 座標，此範例以整數像素為單位。不繪製方盒或連續動畫。

目的： 區分已完成的傳輸與未在等待上限內完成的傳輸。

運作方式： 主端送出 42 並以 Link_WaitByte 等待。完成時顯示收到的位元組；逾時則取消傳輸並顯示零。

操作方式與預期結果： 未連線時若傳輸完成，可能傳回 255。逾時顯示 000；連接對端時顯示收到的位元組。結果不一定是 042。

目的： 學習將 ROM 資料複製到 RAM 所需的引數。

運作方式： far_data_read 使用記憶體庫引數 0 與長度 2，將位元組 7、42 複製到 copied。

操作方式與預期結果： 目的緩衝區的第二個位元組顯示為 042。此範例讀取固定 ROM，不示範不同可切換記憶體庫之間的傳輸。

目的： 登錄素材的位置與長度，再依 ID 取得位元組資料。

運作方式： 素材 0 的型別為 RAW、記憶體庫為 0，包含指向 {7,42} 的指標及長度 2。asset_load_raw 將其複製到兩位元組 RAM 緩衝區。

操作方式與預期結果： 第二個位元組顯示為 042。這示範素材查找與複製，不是影像繪製。

目的： 初始化子彈池，並在生成子彈後檢查使用狀況。

運作方式： danmaku_reset 後，程式呼叫 danmaku_spawn(40,40,16,0) 並顯示 dm_count。

操作方式與預期結果： 001 是已配置的子彈數。此處沒有子彈更新迴圈或背景合成器，因此不繪製移動子彈。

目的： 將次像素移動量保留為餘數，並把整數像素部分累加至位置。

運作方式： 從 X=40 開始，迴圈將 2/8 像素累加八次。右移運算取出整數像素，遮罩則保留餘數。

操作方式與預期結果： 總位移為兩像素，因此畫面將 X=42 顯示為 042。此手動積分範例處理正向移動；負向移動須搭配借位處理。

目的： 使用 Game Boy Color 的 RGB 分量選擇背景與文字顏色。

運作方式： 程式在 VBlank 期間關閉 LCD，將調色盤 0 的顏色 0 設為白色 (31,31,31)、顏色 3 設為紫色 (12,0,22)，再啟用顯示。

操作方式與預期結果： 以 CGB 模式執行，可看到白底上的紫色文字與 042。DMG 單色輸出無法呈現這些顏色。

目的： 移動觀景位置，無須重新繪製背景內容。

運作方式： 每個影格都會遞增 phase，並將其傳給 Scroll_SetBg。八位元位置值超過 255 後會回繞至 0。

操作方式與預期結果： SCROLL 字樣會向左移動。請觀察它隨時間改變的位置；單張螢幕擷取畫面無法呈現動作。

目的： 將繪圖請求與套用該請求的 VRAM 傳輸分開。

運作方式： vram_queue_bg_tile 將圖塊 52 排入圖塊座標 (3,8)，vram_flush 再執行傳輸。提供的字型中，圖塊 52 是數字 4。

操作方式與預期結果： 請確認背景圖塊座標 (3,8) 出現一個 4。這是圖塊更新，不是數字計數器。

目的： 獨立於背景配置並顯示精靈。

運作方式： 新初始化的池提供槽位 0。程式選取圖塊 65、設定位置 (70,80)、啟用 OBJ 顯示，並在每個影格傳輸影子 OAM。

操作方式與預期結果： 指定的精靈位置出現靜止字母 A。遊戲中須先檢查配置是否失敗，再使用傳回的 ID。

目的： 使用種子重現偽亂數序列。

運作方式： rng_seed(1234) 初始化產生器後，呼叫 rng_range(10) 一次。上限 10 不包含在結果中。

操作方式與預期結果： 畫面顯示 000 至 009 之間的一個值。以相同種子重新啟動同一程式，會重現相同結果；此值不會每個影格改變。

目的： 使用旗標編號表示布林狀態，例如事件是否完成。

運作方式： 程式先清除旗標 12、再設定它，最後以 flag_get 讀回。

操作方式與預期結果： 001 表示旗標 12 為真。此範例操作 RAM 旗標，關機再開機後不會保留。

目的： 設定圓形剛體，並根據速度更新位置。

運作方式： 啟用中的圓形半徑為 4、位置為 (40,40)、速度為 (2,0)。重力為零，linear_damping_q8 為 255；kq2dc_step 執行一次。

操作方式與預期結果： 042 是算出的整數 X 座標。此範例不繪製圓形外框或碰撞動畫。

目的： 更新 PPU 捲動位置以移動背景。

運作方式： 從 __scroll_set(0,0) 開始，程式每個影格將 phase 遞增一次，並用作水平位置。

操作方式與預期結果： SCROLL 字樣的水平位置會改變。phase 從 255 回繞至 0。這不是跨越多個名稱表的寬幅地圖範例。

目的： 由主程式提交 PPU 更新，再由 NMI 處理流程套用。

運作方式： __vramq_put 將圖塊 52 排入名稱表位址 0x2103，__vramq_commit 再提交。該位址對應圖塊座標 (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 可停止。僅靠畫面標記無法驗證聲音輸出。

目的： 啟動音效串流，並透過規律的影格更新推進播放。

運作方式： Audio_Init 後，Audio_PlaySFX 在通道 ID 1 啟動 tone。主迴圈每影格呼叫一次 Audio_Update。

操作方式與預期結果： 顯示 042 的同時播放短促脈波音效。數字是固定標記，不是音量或播放位置。請透過音訊輸出或錄音判斷聲音。