GBA 开发简单入门
by Xkin
一. GBA开发包--DevKitAdv 简介
DevKitAdv 主要包括两部分,一是GCC++编译器,二是 GBA库.
GCC++编译器功能和我们常用的VC差不多,只不过少了个编辑源代码的文本编辑器(至少我没发现,我用的是EditPlus,UltraEdit也可以),还有就是--不支持类(class),真是让人头痛,只能用struct来替代.它的作用是把我们写的代码编译成二进制的可执行文件,当然这个可执行文件是相对GBA和GBA模拟器而言的.就象Windows里的EXE文件无法在Mac机上使用是一样的道理;
GBA库提供了图像,控制及声音一系列的函数,和GCC++配合使用.
下载地址: http://occultforces.mine.nu/~darkfader/gba/files/devkitadv.zip
二. DevKitAdv 的安装
没啥好说的,解压后就可以直接使用,编译时设置DevKitAdv的路径就可以了,建议做一个批处理文件,比如 go.bat
set PATH=d:\devkitadv\bin;%PATH%
cmd (win98是command)
三. 最简单的 GBA 程序 (t1)
// main.c
// 一些基本数据类型
typedef unsigned char u8;
typedef unsigned short u16;
typedef unsigned long u32;
#define REG_DISPCNT *(u16*)0x04000000 // 显示寄存器地址
#define VRAM 0x06000000 // 图像缓冲区地址
#define M5_VRAM 0x0600A000 // M5缓冲区地址
#define BACKBUFFER 0x010 // 双缓冲/背缓冲地址
#define PALETTE 0x5000000 // 调色板地址
#define MODE_3 0x03 // 240*160 15bits/单缓冲区
#define MODE_4 0x04 // 240*160 8bits/双缓冲区
#define MODE_5 0x05 // 160*128 15bits/双缓冲区
#define BG2_ENABLE 0x0400 // BG_2
#define SetMode(Mode) REG_DISPCNT=(Mode) // 设置显示模式的宏定义
// ----------- 主程序 ------------
int main()
{
//设置屏幕模式,这里使用MODE_4
SetMode (MODE_4 | BG2_ENABLE);
}
1.MODE_5和MODE_3都是16bits,但MODE_3只有单缓冲,制作动画效果肯定没双缓冲好,因此排除MODE_3;
2.MODE_4是8bits,理论上256色对于掌机够用了,虽然16bits真彩的诱惑没有人想抗拒,可MODE_5只有160*128咧,在实际应用中建议还是使用MODE_4.
很简单吧--的确是的,现在要用GCC编译它:
gcc -lm -o main.elf main.c
objcopy -v -O binary main.elf main.bin
你会看目录下多了个"main.bin",这个就是能在GBA模拟器上执行的二进制文件!
教程中t1-t7目录为源程序目录,里面有个make.bat,修改代码后直接执行它就可以编译,但要注意我的devkitadv是装在D:,你要是装在别的盘就得改一下make.bat的path参数.
四. 在MODE_4背景层画图的 GBA 程序 (t2)
在GBA的MODE_4里画一幅图要经过3个步骤:
1. 把原始256色图像文件转换成 *.h / *.c 的数据文件,我们用的是 < BMP2GBA > ,这里以"image.bmp"为例,转换后我们就得到了一个"image.h"文件;
2. 在程序开头#include "image.h",这样就能在程序中使用"image.h"定义的调色板和图像数据;
3. 在程序中把"image.h"定义的调色板和图像数据写入MODE_4背景层的调色板和图像缓冲区.
另外,GBA还有专为精灵设置的物体层,它的用法和背景层一样,只是功能有点不一样,地址是0x06000000.有关用这里就不详细说了,大家可以把精灵数据直接输出到物体缓冲区就可以了.
下面是源程序:
... ...
// 包含图像调色板和数据的头文件
#include "gfx/image.h"
// ----------- 全局变量 --------
// 系统调色板
u16* palette_mem=(u16*)PALETTE;
// 图像缓冲区
u16* video_buffer=(u16*)VRAM;
// ----------- 函数定义 ---------
// MODE_4绘图函数
void Draw(u16* src_palette,u16* src_data,u16* dst_palette,u16* dst_data);
// ----------- 主程序 ------------
int main()
{
// 设置屏幕模式,这里使用MODE_4
SetMode (MODE_4 | BG2_ENABLE);
// 在背景层画图,Palette和Data是在"image.h"定义的调色板和图像数据数组名
Draw(Palette,Data,palette_mem,video_buffer);
}
// MODE_4绘图函数
void Draw(u16* src_palette,u16* src_data,u16* dst_palette,u16* dst_data)
{
int loop,x,y;
// 写入目的调色板
for(loop = 0; loop < 256; loop++)
dst_palette[loop] = src_palette[loop];
// 写入图像缓冲区
for(x = 0; x < 120; x++)
{
for(y = 0; y < 160; y++)
{
dst_data[(y) *120 + (x)]=src_data[(y) *120 + (x)];
}
}
}
编译后得到main.bin,然后在GBA模拟器里运行,就可以得到这样的结果:
大家看了可能有点失望~是啊,256色用来看PPMM实在... ...下一步我们就使用MODE_5来画16bits真彩的MM!
五. 在MODE_5画图的 GBA 程序 (t3)
在GBA的MODE_5里画一幅图也要经过相似3个步骤,只不过不需要调色板数据:
1. 把原始真彩图像文件转换成 *.h / *.c 的数据文件,我们用的是 < Targa2GBA > ,这里以"image.bmp"(240*160)为例,DOS窗口下进Targa2GBA目录,输入"t2g mode5 image.bmp image.h",转换后我们就得到了一个"image.h"文件;
2. 在程序开头#include "image.h",这样就能在程序中使用"image.h"定义的图像数据;
3. 在程序中把"image.h"定义的图像数据写入图像缓冲区.
下面就是源程序:
// 包含图像数据的头文件
#include "gfx/image.h"
// ----------- 全局变量 --------
// 图像缓冲区
u16* video_buffer=(u16*)VRAM;
// ----------- 函数定义 ---------
// MODE_5绘图函数
void Draw(int x,int y,int w,int h,u16 *src_data,u16 *dst_data);
// ----------- 主程序 ------------
int main()
{
// 设置屏幕模式,这里使用MODE_5
SetMode (MODE_5 | BG2_ENABLE);
// 在背景层画图,image是在"image.h"定义的图像数据数组名
Draw(0,0,240,160,image,video_buffer);
}
// MODE_5绘图函数
void Draw(int x,int y,int w,int h,u16 *src_data,u16 *dst_data)
{
int i,o,idst;
// 把源图像数据复制到图像缓冲区的指定地方
idst =(y*160)+x;
for (i=0;i<h;i++)
{
for (o=0;o<w;o++)
{
if (*src_data != 0)
{
dst_data[idst] = *src_data;
}
idst++;
src_data++;
}
idst += (160-w);
}
}
编译后运行结果:
呵呵,是不是很棒?这是24bits "image.bmp"(240*160) 在MODE_5 16bits下的显示结果,240*160的图像到了MODE_5下的160*128,也就是MODE_5的满屏显示画面只有这么大.
六. 全屏显示的 MODE_5 GBA 程序 (t4)
由于GBA不支持线性的图像变换,因此得到的结果会产生一些马赛克的现象,现在还是附上这个变换函数和最终结果,其实质量还是可以接受的,大家可以试试使用这个新的MODE_5.
// 切换到新MODE_5全屏模式,page为缓冲区,原理是把显示寄存器数据X,Y交换,得到128*160的显示,GBA就会全屏显示.
void SetFlipMode(int page)
{
u16 *ioreg=(u16*)0x4000000;
*ioreg=5+((page&1)>>4)+(1>>10);
ioreg[0x10]=0;
ioreg[0x11]=256;
ioreg[0x12]=128;
ioreg[0x13]=0;
}
int main()
{
// 设置屏幕模式,这里使用MODE_5
SetMode (MODE_5 | BG2_ENABLE);
// 切换模式
SetFlipMode(0);
// 在背景层画图,image是在"image.h"定义的图像数据数组名
Draw(0,0,240,160,image,video_buffer);
return(0);
}
Come on,来看看结果:
此时就是新MODE_5下的全屏模式,图像被翻转并放大,因为MODEL_5的分辨率是160*128,而上面的程序画的是240*160的图像,所以有部分就看不到了.
如果要象MODEL_4那样正常显示我们的图像,那么只有对原图像文件做点手脚才行了,下面就是处理新MODEL_5下图像文件的步骤:
1.把原图像顺时针旋转90度;
2.再将图像水平翻转;
3.调整图像大小至 160*128.
这里是示意图:
原图
1
2
3
OK,把步骤3后的图像编译进bin就可以得到:
大家可以看到有轻微的马赛克,但比起256色的效果还是要好一些,到底使用什么模式还得看做的游戏类型,如果是一些经典RPG/ACT/SLG等还是建议用MODE_4.
七. GBA的双缓冲显示(t5)
大家在做上面MODEL_5的程序时一定会发现图像在闪动(第六节的240*160的MM象被破了相...),而MODEL_4下却比较稳定--这是因为MODEL_5下要处理16bits(实质上是15bits)的图像,数据量比MODEL_4下的8bits大很多,在没使用双缓冲的情况下,图像填充时就会造成闪烁,这就是为什么我们抛弃了MODEL_3的原因...
原理也很简单,图像在背缓冲区里填充好之后再直接输出到前缓冲区显示,程序里就是一个 "等待同步-> 交换缓冲" 的过程:
... ...
// ----------- 全局变量 --------
// 图像缓冲区
u16* video_buffer=(u16*)M5_VRAM;
// ----------- 函数定义 ---------
... ...
// 等待缓冲区数据同步
void WaitSync ();
// 交换缓冲区内容
void SwapScreen ();
// ----------- 主程序 ------------
int main()
{
// 设置屏幕模式,这里使用MODE_5
SetMode (MODE_5 | BG2_ENABLE);
while(1)
{
// 在背景层画图,image是在"image.h"定义的图像数据数组名
Draw(0,0,240,160,image,video_buffer);
WaitSync();
SwapScreen();
}
}
// 等待缓冲区数据同步
void WaitSync ()
{
while (*(volatile u16*)0x4000006<160) {};
}
// 交换缓冲区
void SwapScreen ()
{
if (REG_DISPCNT & BACKBUFFER)
{
REG_DISPCNT &= ~BACKBUFFER;
video_buffer = (u16*) M5_VRAM;
}
else
{
REG_DISPCNT |= BACKBUFFER;
video_buffer = (u16*) VRAM;
}
}
八. GBA 的按键输入(t6)
讲了老半天的图像,虽说是对着MM,但大家一定也有点烦了,我们现在就换个方向,来看看GBA的控制.
... ...
// 按键控制
#define KEY_A 1
#define KEY_B 2
#define KEY_SELECT 4
#define KEY_START 8
#define KEY_RIGHT 16
#define KEY_LEFT 32
#define KEY_UP 64
#define KEY_DOWN 128
#define KEY_R 256
#define KEY_L 512
volatile u32* KEYS = (volatile u32*)0x04000130;
// 包含图像调色板和数据的头文件
#include "gfx/image.h"
// ----------- 全局变量 --------
// 图像缓冲区
u16* video_buffer=(u16*)M5_VRAM;
// 图像显示坐标
int img_x,img_y;
// ----------- 函数定义 ---------
// 按键控制
void KeyAction();
... ...
// ----------- 主程序 ------------
int main()
{
// 设置屏幕模式,这里使用MODE_5
SetMode (MODE_5 | BG2_ENABLE);
while(1)
{
// 处理按键事件
KeyAction();
// 在背景层画图,image是在"image.h"定义的图像数据数组名
Draw(img_x,img_y,96,64,image,video_buffer);
WaitSync();
SwapScreen();
}
}
// 处理按键事件
void KeyAction()
{
// 上方向键
if(! ( (*KEYS) & KEY_UP) )
{
img_y+=5;
}
// 下方向键
if(! ( (*KEYS) & KEY_DOWN) )
{
img_y-=5;
}
}
简单吧,这个例子响应上下按键来控制图像上下移动.我们没有先清除背缓冲就在里面填充图像数据,所以你可以看到图像移动后,原来位置上的图像仍在背缓冲里,这样可以很清楚的看到双缓冲的工作过程.
什么?太丑了,那好,加一个背景就OK了嘛... ...后一幅是带ALPHA.
#include "bg.h"
... ...
// 先画背景
Draw(0,0,160,128,bg,video_buffer);
// 再画MM
Draw(img_x,img_y,96,64,image,video_buffer);
... ...
九. 简单声音输出(t7)
Simple is the Best(简洁至上),这里我们使用一个现成的声音模块(Troff Player,by Vova & Serge).这里还要用到一个转换工具< MOD2GBA >,用来把MOD音乐文件转换成GBA的 *.c / *.h 声音数据文件.MOD和MIDI差不多,但支持更多更强的效果.
// MOD数据文件
#include "song_data.h"
// MOD播放函数文件
#include "modplayer.h"
// ----------- 主程序 ------------
int main()
{
//设置屏幕模式,这里使用MODE_4
SetMode (MODE_4 | BG2_ENABLE);
// 初始化声音(声道数,音量)
InitSound(2, 7);
// 初始化音乐(节拍,循环)
InitSong(20000, 0);
while(1)
{
// 更新音乐播放状态
UpdateSong();
}
}
OK,就这么EZ.
十. 用图块建立可滚动/缩放/旋转的背景(t8)
这一节主要是源程序中注释为主,这里就不详细说明了."gba.h"包含基本宏定义,"maths.h"是sin/cos乘256后的值数组,"main.h"包括了我们定义背景结构及操作背景的函数.
程序中的地图背景是由不同的图块所构成,而这些图块统一紧挨着放在一个图像文件,这样每个图块就会有一个索引号;地图信息只要记录这张地图里共有多少个 单位(图块)以及每个单位对应的图块索引号就OK了,在例子中"gfx/tiles.h"就是图块大本营,而"gfx/level1.h"则是图块索引排列表.地图工具为"map editor beta 4".
背景的滚动/缩放/旋转是通过一系列的简单数学计算,修改GBA系统提供的一些背景属性来完成,因为是由硬件来完成背景的操作(MODE_1),所以速度很快,我还有个MODE_5下直接修改像素点位置来完成旋转的例程,待会儿大家可以比较一下.
十一. MODE_5下的背景旋转(t9)
这个例子通过计算旋转后像素的新位置来完成旋转,原理很简单,可以直接应用到精灵上.
// ----------- 主程序 ------------
int main()
{
// 角度
int i=0;
// 设置屏幕模式,这里使用MODE_5
SetMode (MODE_5 | BG2_ENABLE);
while(1)
{
// 在背景层画图,image是在"image.h"定义的图像数据数组名
Draw(0,0,128,128,bg,video_buffer);
// 将旋转后的背景数据写入图像缓冲
RotateBG(bg,video_buffer,i++);
if (i==360) i=0;
}
}
// 旋转背景
void RotateBG(u16 *src,u16 *dst,int angle)
{
int x,y,ys,yc,tx,ty;
unsigned int srcptr=0,dstptr =0;
// 计算旋转后像素的指针
for (y=-80;y<80;y++)
{
ys = y * Sin [angle];
yc = y * Cos [angle];
for (x=-80;x<80;x++)
{
tx =(((x*Cos [angle]) - ys))>>7;
ty =(((x*Sin [angle]) + yc))>>7;
srcptr = (((ty<<7)+tx+(160*80+80)) & 16383);
dst [dstptr] = src [srcptr];
dstptr++;
}
}
}
十二. GBA下的中文显示
呵呵,英文的还没来得及写就先把中文搞掂了~~~~
这里所做的程序核心技术来自于DOS下的中文显示技术.其实和老外用位图来显示26个英文字母原理大同小异,我们使用16*16点阵字库来完成中文的显示.
大家一定知道在输入法里有一个从没用过区位(内码)输入法,这个输入法使用4个数字来完成中文输入----估计没有谁会用它来和MM聊天.中文字库其实也就可以看成一张很大的位图,上面按一定顺序画满了常用的汉字,而区位(内码)输入法的4个数字代表了一个汉字在字库里所在的区和具体位置.
举个例子,"说"字的区位码是"4321",当我们选择区位输入而且在记事本里输入"4321",输入法程序就会马上到字库里4321区域,然后把4321区域的点阵(位图)数据传给系统显示出来,这样"说"字就出来了.
在GBA里显示中文是一样的原理,但由于GBA没有文件输入/输出函数,我们不得不先把二进制的点阵字库转换成数组存储数据,包括区位码和点阵(位图)数组.这里就不详细说明原理了,我为大家做好了一个
转换工具----" HZK2GBA "(汉字库->GBA).附带源程序^_^.
你首先得把你所有的文字做成一个文本文件,比如" zk.txt ",然后执行" hzk2gba zk.txt "来得到" GBAZK.h "文件,这就是GBA可用的字库数组头文件.
这样做的目的是不用把字库里所有的汉字送入GBA,只留下我们用到的汉字,可以很大的节省空间和内存.
接下来的工作就是利用得到的" GBAZK.h "在GBA里写下你想写的话.
... ...
#define RGB(r,g,b) ((r)+(g<<5)+(b<<10)) // 设置GBA的色彩
#define MAX 10240 // 最大字符数
// 包含中文字库数据的头文件
#include "gfx/GBAZK.h"
// ----------- 全局变量 --------
// 图像缓冲区
u16* video_buffer=(u16*)VRAM;
// ----------- 主程序 ------------
int main()
{
// 设置屏幕模式,这里使用MODE_5
SetMode (MODE_5 | BG2_ENABLE);
// 写入字符
DrawText("水银教程",20,20,255,0,0);
}
//- 写中文字符函数 ----------------
void DrawText(unsigned char *str,int x,int y,int r,int g,int b)
{
int i,j,k,n;
// 字符所在区,位,实际位置
int qu, wei, location;
while(*str)
{
// 得到单字的区位码
qu = *(str++)-0xa0;
wei = *(str++)-0xa0;
location = qu*94+wei;
// 在字库里查找
for(n=0 ;n<NUM_STR;n++)
{
if(ZKQW[n]==location)
{
// 根据字符数据画出字符
for(i=0;i<16;i++)
for(j=0;j<2;j++)
for(k=0;k<8;k++)
if(convert(ZKDATA[n*32+i*2+j],7-k))
DrawPixel(x+j*8+k,y+i,r,g,b);
x+=16;
}
}
}
}
int convert(u16 str,int n)
{
return((str>>n)&0x1);
}
//- 画点函数 ---------------------
void DrawPixel(int x, int y, int r, int g, int b)
{
video_buffer[x+y*160] = RGB(r,g,b);
}
就这么多了,字体样式的问题得等下一步解决TrueType字体显示才行,字体大小嘛,大家自己用背景/物体层的缩放或是直接缩放像素的方法试试.至于英文的显示~~~~~ ^_* ,好困噢~~~~ 下回见!!!!!
到这里先告一个段落了,大家可以到www.gbadev.com上了解更多的东西,我这里就不累赘了.
