关于nes开发资料收集

发表于： 2020年11月26日 2020年12月22日
分类： C/C++

一个精灵占16字节
16*16由4个精灵组成
nes为8像素宽一个精灵，横向32个纵向30个

pal_col(0,0×16); //将背景设置为红色

pal_bg(palette); //设置调色板

ppu_wait_nmi();//等待绘制完成

oam_clear(); //清除所有精灵缓冲区

oam_meta_spr(BoxGuy2.x, BoxGuy2.y, BlueSpr);//绘制精灵

附录，neslib库

Shiru为NES开发编写了neslib代码。这些都是我所有工作方式的详细注释。我将在稍后添加示例代码。我主要使用的是neslib的略微修改版本

http://shiru.untergrund.net/files/nes/chase.zip

而且，这里还是示例代码

http://shiru.untergrund.net/files/src/cc65_nes_examples.zip

并且此链接具有neslib版本，可与cc65的最新版本（截至2016年）一起使用2.15版

http://forums.nesdev.com/viewtopic.php?p=154078#p154078

调色板

pal_all（const char * data）;

const unsigned char game_palette [] = {…} //定义一个32字节的字符数组
pal_all（game_palette）;

-传递指向32字节完整调色板的指针
-它将32字节的调色板复制到缓冲区
-可以随时执行，仅在v-blank期间更新

pal_bg（bg_palette）; //仅16个字节，背景

pal_spr（sprite_palette）; //仅16个字节，
sprites-与pal_all相同，但16个字节

pal_col（unsigned char index，unsigned char color）;
-在任何调色板，BG或Sprite中仅设置1种颜色
-可以随时进行，仅在v-blank期间更新
-index = 0 – 31（0-15 bg，16-31 sprite）

＃定义红色0x16
pal_col（0，红色）; //将背景色设置为红色
pal_col（0，0x30）; //将背景色设置为white = 0x30

pal_col（）对于旋转颜色（SMB硬币）或使精灵闪烁可能很有用。
注意：在示例代码
PAL_BUF = $ 01c0中，在示例代码PAL_BUF = $ 01c0中将调色板缓冲区设置为0x1c0-0x1df-在
硬件堆栈中。如果子例程调用的深度超过16，它将开始覆盖缓冲区，可能导致颜色错误或游戏崩溃

pal_clear（void）; //只需将所有颜色设置为黑色，即可随时进行

pal_bright（unsigned char bright）; //使所有颜色变亮或变暗
– 0-8，4 =正常，3 2 1变深，5 6 7变亮
– 0为黑色，4为正常，8为白色
pal_bright（4）; //正常

注意：在初始化期间必须至少调用一次pal_bright（）（在crt0.s中）。它设置了一个指针，该指针需要设置颜色才能使调色板更新生效。

Shiru在Chase源代码game.c中具有淡入淡出功能。

void pal_fade_to(unsigned to)
{
  if(!to) music_stop();
  while(bright!=to)
  {
    delay(4);
    if(bright<to) ++bright; 
    else --bright;
    pal_bright(bright);
  }
  if(!bright)
  {
    ppu_off();
    set_vram_update(NULL);
    scroll(0,0);
  }
}

**pal_spr_bright（unsigned char bright）;

**-仅设置精灵亮度

pal_bg_bright（unsigned char bright）; 设置BG亮度，使用0-8，与pal_bright（）相同

ppu_wait_nmi（void）;
-等待下一帧

ppu_wait_frame（void）;
-对于NTSC电视，它每5帧等待一个额外的帧-
请勿使用，我将其删除-可能存在
屏幕分割问题

ppu_off（void）; //关闭萤幕

ppu_on_all（void）; //重新打开精灵和BG

ppu_on_bg（void）; //仅打开BG，不影响子
画面ppu_on_spr（void）; //仅打开精灵，不影响背景

ppu_mask（unsigned char mask）; //手动设置2001寄存器，请参见nesdev
wiki-可用于设置颜色强调或灰度模式

ppu_mask（0x1e）; //正常，在
ppu_mask（0x1f）上显示；//灰度模式，在
ppu_mask（0xfe）上显示；//屏幕打开，所有颜色强调位都已设置，使屏幕变暗

ppu_system（void）; //对于PAL返回0，对于NTSC返回！0

-在初始化期间，它会执行一些定时代码，并确定正在运行哪种电视系统。如果您希望针对每种类型的电视对节目进行不同的编程，则这是一种访问该信息的方法
–
用法类似于…… a = ppu_system（）;

精灵

oam_clear（void）; //清除OAM缓冲区，使所有精灵消失

OAM_BUF = $ 0200，在crt0.s中定义

oam_size（unsigned char size）; //将精灵大小设置为8×8或8×16模式

oam_size（0）; // 8×8模式
oam_size（1）; // 8×16模式

注意：在每个循环的开始，将sprid设置为0

sprid = 0;

然后每当您将一个精灵推送到OAM缓冲区时，它将返回下一个索引值（sprid）

oam_spr（unsigned char x，unsigned char y，unsigned char chrnum，unsigned char attr，unsigned char sprid）;
-返回sprid（OAM缓冲区的当前索引）
-sprid是缓冲区中的精灵数量乘以4（每个精灵4个字节）

sprid = oam_spr（1,2,3,0，sprid）;
-这会将一个精灵放置在X = 1，Y = 2，使用图块＃3，调色板＃0，我们使用sprid来跟踪进入缓冲区的索引

sprid = oam_spr（1,2,3,0 | OAM_FLIP_H，sprid）; //相同，但水平翻转精灵
sprid = oam_spr（1,2,3,0 | OAM_FLIP_V，sprid）; //相同，但垂直翻转精灵
sprid = oam_spr（1,2,3,0 | OAM_FLIP_H | OAM_FLIP_V，sprid）; //相同，但水平和垂直翻转精灵
sprid = oam_spr（1,2,3,0 | OAM_BEHIND，sprid）; //精灵将在背景之后，但在通用背景色之前（第一个bg调色板条目）

oam_meta_spr（unsigned char x，unsigned char y，unsigned char sprid，const unsigned char * data）;
-返回sprid（OAM缓冲区的当前索引）
-sprid是缓冲区中的精灵数量乘以4（每个精灵4个字节）

sprid = oam_meta_spr（1,2，sprid，metasprite1）

const unsigned char metasprite1 [] =…; //定义元角色，字符数组

这会将元精灵放置在x = 1，y = 2的相对位置

metasprite是sprite的集合
-您不能如此轻松地翻转它
-您可以使用nes屏幕工具制作metasprite-
它是每个瓦片4个字节的数组=
-x偏移量，y偏移量，瓦片，属性（每个瓦片调色板/ flip）
-您必须将指针传递到该数据数组
-数据集需要以128（0x80）终止-在
每个循环（帧）中，您将将精灵推入OAM缓冲区
-它们将自动转到OAM在v-blank期间（nmi代码的一部分）

oam_hide_rest（unsigned char sprid）;
-将其余的精灵从屏幕上
弹出-在每个循环结束时执行

-必要时，如果您没有在每个循环的开始时清除精灵
-如果屏幕上的精灵数量恰好为64，则sprid值将环绕为0，并且此函数会意外地将所有精灵推离屏幕（通过0会将所有子画面推离屏幕）
-如果由于某种原因您传递了一个不能被4整除的值（例如3），则此函数将使游戏无限循环崩溃
-因此，使用oam_clear（）可能更安全在每个循环的开始，不要调用oam_hide_rest（）

音乐

注意，在crt0.s中，音乐数据包含在music_data：之后，并且初始化代码初始化音乐系统。

music_play（unsigned char song）；**//向其发送一个歌曲编号，它设置指向歌曲开头的指针，将自动播放，并在v-blank音乐播放
（0）期间更新；//播放歌曲＃0

music_stop（void）; //停止播放歌曲，必须执行music_play（）才能重新开始播放，这将开始播放歌曲

music_pause（unsigned char pause）；//暂停一首歌曲，并在您暂停它的那一点取消暂停它

music_pause（1）; //暂停
music_pause（0）; //取消暂停

sfx_play（unsigned char sound，unsigned char channel）; //将指针设置为声音fx的开始，它将自动播放

sfx_play（0，0）; //播放声音效果＃0，优先级＃0

通道3的优先级高于2 、、、、、、 3> 2> 1>0。如果2种音效发生冲突，则会播放更高的优先级。

sample_play（unsigned char sample）; //播放DMC音效

sample_play（0）; //播放DMC样本＃0

控制器

pad_poll（unsigned char pad）;
-读取控制器
-必须向其发送0或1，每个控制器发送一个-
每帧执行一次

pad1 = pad_poll（0）; //读取控制器＃1，存储在pad1中
pad2 = pad_poll（1）; //读取contoller＃2，存储在pad2中

pad_trigger（unsigned char pad）; //仅获得新的按钮按下，而没有按下

a = pad_trigger（0）; //读取控制器＃1，仅在新按下此帧时返回
b = pad_trigger（1）; //读取控制器2，仅在新按下此帧时返回

-这实际上调用了pad_poll（），但仅返回新的按动，不返回保持的按钮

pad_state（unsigned char pad）;
-获取上一次轮询而无需再次轮询 –
首先对每一帧执行pad_poll（）
-这样一来，您可以在所有帧中获得一致的值
-可以每帧多次执行此操作，并且仍然会获得相同的信息

pad1 = pad_state（0）; //控制器＃1，获取最后的轮询
pad2 = pad_state（1）; //控制器＃2，获取上次轮询

卷动

预计您将定义2个int（每个2个字节），即ScrollX和ScrollY。
您需要手动将它们设置为0到0x01ff（y为0x01df，只有240条扫描线，而不是256条）
在示例代码9中，shiru这样做了

– -y;

if（y <0）y = 240 * 2-1; //将Y保持在两个命名表的总高度之内

scroll(unsigned int x,unsigned int y);
-设置x和y滚动。可以随时执行，直到下一个v-blank之前，数字不会进入2005寄存器
-高位更改基本名称表，寄存器2000（在下一个v-blank中）-
假设您正确设置了镜像，它将滚动进入下一个名称表。

滚动（scroll_X，scroll_Y）;

*请注意，我不使用此滚动功能，但使用我自己的类似功能，无需将Y保持在0到$ 1df之间。

split（unsigned int x，unsigned int y）;
-等待精灵零命中，然后更改x滚动
-仅当您当前在OAM中的精灵位于零位置且屏幕上某个地方的非透明部分与a的非透明部分重叠时才起作用BG瓷砖。

-我不确定为什么要输入y，因为它不会更改y滚动
-实际上很难在屏幕中间进行y滚动更改，所以这可能是最好的-
警告：所有CPU时间之间函数调用和实际的分割点将被浪费！
-请勿与此一起使用ppu_wait_frame（），否则可能会出现故障

瓷砖银行

-将2组256个图块加载到ppu，ppu地址为0-0x1fff
-sprites和bg可以自由选择要使用的图块集，甚至都可以使用同一组图块

bank_spr（unsigned char n）; //精灵集

bank_spr（0）; //使用第一组拼贴
bank_spr（1）; //使用第二组图块

bank_bg（unsigned char n）; //哪一组背景瓷砖

bank_bg（0）; //使用第一
组图块bank_bg（1）; //使用第二组图块

rand8（void）; //获得一个随机数0-255
a = rand8（）; // a是char

rand16（void）; //得到一个随机数0-65535
a = rand16（）; // a是int

set_rand（unsigned int seed）; //发送一个int（2个字节）作为rng的种子

-请注意，crt0初始化代码会自动将种子设置为0xfdfd-
如果随机性很重要，您可能想使用另一种种子方法，例如在标题屏幕上按下START时检查FRAME_CNT1

写入屏幕

set_vram_update（unsigned char * buf）;
-设置指向数组的指针（RAM中某个地方的VRAM更新缓冲区）
-渲染为ON时，这就是进行BG更新的方式

用法…
set_vram_update（Some_ROM_Array）; //设置指向ROM中数据的指针

还…
set_vram_update（NULL）;
-要禁用更新，请使用NULL指针调用此函数

vram缓冲区应这样填充…

非顺序：
–非顺序表示将设置PPU地址，然后写入1字节
-MSB，LSB，1字节数据，重复-
顺序以0xff（NT_UPD_EOF）结尾

MSB = PPU地址的高字节
LSB = PPU地址的低字节

顺序：
-sequential表示它将设置一个PPU地址，然后向ppu写1个以上的字节
-从左到右（或）从上到下
-MSB | NT_UPD_HORZ，LSB，字节数，字节列表，重复
或
-MSB | NT_UPD_VERT，LSB，字节数，字节列表，重复
-NT_UPD_HORZ，表示它将从左到右写入，环绕到下一行
-NT_UPD_VERT，表示将从上到下写入，但是有一个新地址到达屏幕底部后，需要进行设置，因为它永远不会包装到
以0xff（NT_UPD_EOF）结尾的序列上的下一列

#define NT_UPD_HORZ 0x40 =顺序
#define NT_UPD_VERT 0x80 =顺序
#define NT_UPD_EOF 0xff

从屏幕位置x = 1，y = 2开始从左到右的4个连续写入的示例，
图块编号为5,6,7,8
{
MSB（NTADR_A（1,2））| NT_UPD_HORZ，
LSB（NTADR_A（ 1,2）），
4，4，// 4写
5,6,7,8，// tile＃的
NT_UPD_EOF
};

有趣的是，除非您发送这样的NULL指针，否则它将连续写入每个v-blank相同的数据……
set_vram_update（NULL）;
…尽管如此，可能并没有太大的不同。
数据集（又名vram缓冲区）不得大于256个字节，包括数据末尾的ff，并且不应超过…，我不知道，也许*个字节的数据到ppu，因为这种情况会发生在v空白期间而不是在渲染期间，时间非常有限。

*在发生不良事件之前，每帧最大v-ram变化（包括渲染）…

连续最大值= 97（无调色板更改此帧），
74（w调色板更改此帧）

非顺序最大值= 40（无调色板更改此帧），
31（w调色板更改此帧）

缓冲区只需要是…
3 * 40 + 1 = 121字节大小
…因为在v-blank期间它不能推入更多的字节。

（这尚未在硬件上进行过测试，仅在FCEUX上进行过测试）

//以下所有vram函数仅在禁用显示时有效

vram_adr（unsigned int adr）;
-设置PPU地址
（在后台设置用于写入图块的起点）

vram_adr（NAMETABLE_A）; //从屏幕的
左上方开始vram_adr（NTADR_A（x，y））;
vram_adr（NTADR_A（5,6））; //设置开始位置x = 5，y = 6

vram_put（unsigned char n）; //在其中放1个字节
-use vram_adr（）; 第一

vram_put（6）; //将图块＃6推到屏幕上

vram_fill（unsigned char n，unsigned int len）; //重复相同的图块*
LEN-使用vram_adr（）; 首先-
可能必须使用vram_inc（）; 首先（见下文）

vram_fill（1，0x200）; // 1号图块被推送512次

vram_inc（unsigned char n）; // ppu模式
vram_inc（0）; //数据从左到右（绕到下一行）被推入vram
vram_inc（1）; //数据从上到下推入vram（仅适用于1列（30字节），然后您必须设置另一个地址）。
-如果需要更改方向，请在写入屏幕之前进行此操作

vram_read（unsigned char * dst，unsigned int size）; –
从vram读取一个字节
-use vram_adr（）; first
-dst是您将在RAM中存储来自ppu的数据的位置，大小是多少字节

vram_read（0x300，2）; //从vram读取2个字节，写入RAM 0x300

注意，不要从调色板中读取，只需在0x1c0使用调色板缓冲区

vram_write（unsigned char * src，unsigned int size）;
-将一些字节写入
vram-使用vram_adr（）; first
-src是指向要写入ppu的数据的指针
-size是要写入的字节数

vram_write（0x300，2）; //从RAM 0x300向
vram写入2个字节vram_write（TEXT，sizeof（TEXT））; // TEXT []是要写入vram的字节数组。
（由于某种原因，这给了我一个错误，只传递一个数组名，必须转换为char 指针）
vram_write（（unsigned char ）TEXT，sizeof（TEXT））;

vram_unrle（const unsigned char * data）;
-将其传递给RLE数据的指针，它将全部推送到PPU。
-将压缩数据解压缩到vram-
这是您实际上最应该使用的方法-这是NES屏幕工具输出最好的方法。
vram_unrle（titleRLE）;

用法：
-首先，禁用渲染，ppu_off（）;
-设置vram_inc（0）并设置起始地址vram_adr（）-
调用vram_unrle（）;
-然后重新打开渲染，ppu_on_all（）
-每帧仅加载1个名称表中的数据

注意：
-nmi是在init中打开的，永远不会关闭

memcpy（void * dst，void * src，unsigned int len）;
-将数据从一个位置移动到另一位置…通常是从ROM到RAM

memcpy（update_list，updateListData，sizeof（updateListData））;

memfill（void * dst，unsigned char value，unsigned int len）;
用值填充内存

memfill（0x200，1，0x100）;
-使用图块＃1填充0x200-0x2ff…即0x100字节的填充值

延迟（无符号字符帧）；//等待＃帧

delay（5）; //等待5帧

在NESLIB.S中的ASM BITS上的技术说明：

-vram（位于调色板之外）仅在设置了VRAM_UPDATE + NAME_UPD_ENABLE时更新…
-ppu_wait_frame（或）ppu_wait_nmi，设置为“ UPDATE”
-set_vram_update，设置为“ ENABLE”
-set_vram_update（0 ）; 禁用vram'UPDATE'-
我想您不能将指针设置为零页面地址0x0000，否则它将永远不会更新。
-music仅在设置FT_SONG_SPEED的情况下播放，播放将其设置，停止将其重置，暂停将其设置为负数（ORA＃$ 80），取消暂停将其清除

风的影子

411

附录，neslib库

调色板

精灵

音乐

控制器

卷动

瓷砖银行

写入屏幕

风的影子

发表评论 取消回复

发表评论取消回复