验证记录

用途： 查看所提供原创字体包含哪些字母、数字和标点，以及如何绘制。

工作原理： 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 之后回绕。

操作与预期结果： SCROLL 一词向左移动。请观察随时间变化的位置；单张截图不能展示移动。

用途： 将绘图请求与实际应用它的 VRAM 传送分离。

工作原理： vram_queue_bg_tile 将图块坐标 (3,8) 处的图块 52 加入队列，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。该数值是固定标记，不是音量或播放位置。请通过音频输出或录音判断声音。