陈轶的盛夏厅

概览

首先，什么是文件系统？为什么你需要它？

好吧，文件系统没什么东西，它提供了另外向你的ROM增加文件的新方法。你现在已经知道了一种基本的简单的方法：编译期增加文件。。。。（译：这一点不会翻译了。。。略过。）实际上，还有另外一种方法，编译后增加文件。是的，这是可能的，而且有不小的便利：

• 你能够突破4M空间的限制，因为这些文件并不存储在RAM中，而是在gba闪存卡的ROM中。。。。这同时也意味着这些文件只有在你使用gba闪存卡的时候才正常工作，而且不能在WMB和CF上工作（尽管我做了一个可以在上面正常工作的版本，但是有4MB大小的限制）（译：谁能告诉我gba闪存是什么？WMB和CF是什么？只能拿乔布斯的话安慰自己了：StayHungry，StayFoolish）
• 因为你可以在编译后加入文件，这意味着最终用户可以加入文件。。。很多应用都会用到这个功能，举例来说，音乐播放器，图像浏览器。。。nDoS（译：nDoS应该是个使用PAlib开发出来的程序）使用文件系统来存储和读取OutLook/ThunderBird的通讯录。。。。我甚至在我现在的工程中使用文件系统来增加皮肤功能。你看到了，文件系统功能给予了最终用户定制你的软件的机会。

凡事都有坏处。。。

• 不能工作于WMB和其他（前面提到过了，有4MB的限制）
• 它的函数用起来真的比较痛苦，虽然我已经尽力简化他们了。

PAlib的文件系统被称为PAFS。。。。你也可以使用GBFS，这是PAlib早期版本中带的文件系统功能，目前的版本为了前向兼容还保留着。

需要的文件

好的，准备好了。。。开始！如你所猜，你需要一些文件让文件系统跑起来。。。我们看一下PAFS/PAFS这个例子，这是最简单的。。。打开目录，你就会看到你需要的文件。。。

• PAFS.exe 是主文件。他的作用是将需要的文件加入你的ROM中，所以你需要他。。。
• PAFS.log 是主文件生成的日志，记录生成过程中一些情况和数据…
• PAFS.bat 是个重要的文件。用写字板打开这个文件，你会看到它包含了PAFS PAFS.ds.gba. 这些是什么？
  • PAFS是可执行文件，实际上就是指PAFS.exe…
  • PAFS.ds.gba 是指你的ROM，运行期可以动态加入文件的那个。。。你也可以命名为.nds文件。
  • 在这些的后面，你可以加入更多的参数，比如你文件存放的目录。如果你没有给定目录名称（就像这个例子一样），它将使用File/目录下的所有文件。

现在，你看到了Files目录了吗？在里面有很多文件文件。他们没有什么用，只是用来检查增加文件是否正常工作。如果正常，你应该能够在你的DS上看到这些文件（就像文本阅览器）。我们看看代码吧！

你同样可以在PAlibTools目录下发现一个PAFS.exe和.bat文件。

简单文件加载

在同一个例子里面，打开模板。。。这里是主函数里面应该包含的代码（除了经典的初始化函数以外）

PA_InitText(0, 0); // Initialise the text system on the bottom screen
PA_InitText(1, 0); // Initialise the text system on the top screen

PA_OutputText(1, 0, 0, "Loading PAFS…");

u32 FileNumber = PA_FSInit(); // Inits PA File System, and returns the number of files

PA_OutputText(1, 0, 1, " Files : %d ", FileNumber);

// For each file, we’ll draw it’s name on the bottom screen…
s32 i;
for (i = 0; i < FileNumber; i++){
PA_OutputText(0, 0, i, "%s.%s Size : %d, %d", PA_FSFile[i].Name, PA_FSFile[i].Ext, PA_FSFile[i].Length, PA_FSFile[i].FilePos);
}

// Output the first file text on the top screen, just to test…
PA_OutputText(1, 0, 5, "File 0 : %s", PA_PAFSFile(0));
PA_OutputText(1, 0, 7, "File 1 : %s", PA_PAFSFile(1));
PA_OutputText(1, 0, 9, "File 2 : %s", PA_PAFSFile(2));

// Infinite loop to keep the program running
while (1)
{
PA_WaitForVBL();
}

我们以2个文件初始化函数作为开始，每个屏幕一个，以及一个非常傻瓜的装载PAFS。。。。文本。。。。我不再细说了。

让我们看看重要的部分：

• u32 FileNumber = PA_FSInit(); PA_FSInit 是初始化文件系统的函数。如果你不调用它，你就不能读任何文件。。。如果需要文件的信息，你只要遍历一遍所有的文件。。。 这个函数返回了文件的个数，我把它存在FileNumber这个变量里面。

然后是PA_OutputText(1, 0, 1, " Files : %d ", FileNumber);用文本显示文件的个数。

下面是有趣的部分：

s32 i;
for (i = 0; i < FileNumber; i++){
PA_OutputText(0, 0, i, "%s.%s Size : %d, %d", PA_FSFile[i].Name, PA_FSFile[i].Ext, PA_FSFile[i].Length, PA_FSFile[i].FilePos);
}

这些代码起什么作用呢？对每个文件（按照文件顺序，0号文件，1号。。。），显示出文件的名称，文件名后缀，文件长度，文件在文件系统中的位置。你不会使用最后2个信息，但是文件名称和后缀是非常有用的。

• 名称，这样你才能允许用户指定装载哪个文件。。。
• 扩展名，这样你就能知道文件是什么类型。。。

就像你看到的那样，获取这些信息非常简单。他们被包含在PA_FSFile结构数组里面。PA_FSFile[n]是第n个文件（注意：编号是从0开始，不是从1），.Name, .Ext, .Length, .FilePos是这个结构的值。

你看到的最后一件事情是PA_OutputText(1, 0, 5, "File 0 : %s", PA_PAFSFile(0));. 非常重要的东西，张大你的眼睛！（译：我觉得这个作者是不是老师出身？）

• PA_PAFSFile(File Number) 是指向真正文件的指针，参数Number是文件的编号。做关于这个文件的任何操作，我们都要使用这个指针。。。它就像文件名称一样唯一标示了这个文件，在PAFS中你就得学会用这个。。。

这个例子里，我们使用在文本命令里面使用指针。。。为什么？很简单因为我们增加的这些文件是文本文件，所以我们能够把文本显示在屏幕上。。。如果你试图显示其他类型（比如音乐文件）的文件到屏幕上，你将看到一屏幕的天书。。。

好了，现在我们看过了代码，你编译下。。。在把你的ROM放到你的闪存卡之前，别忘了加入文件！要做到这个，运行一下PAFS.bat，它会把所有Files目录下的文件搞到你的ROM里面。烧录，测试，你现在可以在你的DS屏幕上看到你的文本啦！（译：看起来实现读书功能实在太简单了，比我原来设想的要简单很多）

哈哈，程序已经完成了！但是教程还没有结束。还有很多东西值得一看，比如说读取目录结构（是的，PAFS支持目录！）或者在WMB和CF卡上使用PAFS。。。。还有一些例子演示了如果从文件装载图片和音乐，你可以在对应的目录下找到这些例子。

（译：待续）

文章的脚注信息由WordPress的wp-posturl插件自动生成

唉，自从上上周五发现了DS的开发资源以后，高烧不退，水深火热。

一周间翻译PAlib的wiki达数万字。混成了NDSBBS版的开发版斑竹。开发数个DS应用。

最新的进展为"火箭升空"游戏和"是男人就下一百层"游戏。

上周日老婆批准了DS购入计划。教主夫人洪福齐天,仙福永享!

相关链接：

是男人就下一百层：http://www.ndsbbs.com/read.php?tid=56679

照美女：http://www.ndsbbs.com/read.php?tid=55988

火箭升空：http://www.ndsbbs.com/read.php?tid=56433

文章的脚注信息由WordPress的wp-posturl插件自动生成

这里我们将介绍所有PAlib中特别针对DS的函数，比如：关机，合起状态，用户信息，时钟。。。

时间和日期

获取时间和日期非常简单，简直不用学习！例子在PAlibExamples/Other/Date_Time，只有2行

PA_OutputText(1, 2, 10, "%02d/%02d/%02d", PA_RTC.Day, PA_RTC.Month, PA_RTC.Year); // Date

PA_OutputText(1, 2, 12, "%02d:%02d %02d seconds", PA_RTC.Hour, PA_RTC.Minutes, PA_RTC.Seconds); // Time

你不用关心文本显示的函数，只用关心里面的变量。。。PA_RTC是一个每帧刷新的结构，包含了当前日期和时间。PA_TRC有如下变量：

• PA_RTC.Day, 日期，范围1到31
• PA_RTC.Month, 月份，范围1到12
• PA_RTC.Year, 年份，从 00 (相当于 2000) 到 99 (相当于2099)
• PA_RTC.Hour, 小时，0到23
• PA_RTC.Minutes, 分钟，0到59
• PA_RTC.Seconds, 秒，0到59

不用再废话了吧。。一清二楚。

用户信息

（译：用户信息就是第一次开机的时候输入的生日啊，喜欢的颜色啊，等等信息）

用户信息并不难获取！看看PAlibExamples/Other/UserInfo这个例子。。。

用户信息包含在PA_UserInfo结构中，包含以下变量：

文章的脚注信息由WordPress的wp-posturl插件自动生成

今天，我们谈一点DS的声音播放。。。首先，你要知道PAlib提供了两种声音输出的方式：

• raw格式，就像播放wav文件一样。对于声效很有用，如果作为音乐就太占地方了。
• mod播放（鸣谢Deku!），作为音乐回放非常好，因为他占用rom空间比较笑。。。

Raw声音文件

DS不能播放Wav文件（也不能放mp3和ogg文件），因此你必须先转化成raw格式，再播放。。。

转化Wav文件到Raw格式

---

我个人喜欢使用switch工具，http://www.nch.com.au/switch/，因为它工作得不错，而且容易使用，但是Kleevah会向你们推荐Audacity, http://audacity.sourceforge.net/，还有一些人喜欢使用Sox（命令行方式）。我将在教程中使用Switch工具，如果你们中有人使用其他工具得话，我们可以增加相关工具的教学。。。

下载安装Switch以后，打开它，你会看到：

http://www.palib.info/wiki/lib/exe/fetch.php?cache=cache&media=http%3A%2F%2Fwww.palib.info%2FScreens%2FSwitch1.png

现在，点一下"增加文件"或"增加目录"按钮，把你要转化的文件加到列表里面。。。增加完成以后，在界面左下方修改输出格式为raw格式，并修改编码设置如下：

http://www.palib.info/wiki/lib/exe/fetch.php?cache=cache&media=http%3A%2F%2Fwww.palib.info%2FScreens%2FSwitch2.png

如果你喜欢的话，也可以保留立体声输出，速率也可以设置为其他值。。。但是你必须把格式设置成"8 bit signed"，否则就玩不起来了。。。我推荐使用图中的参数，它可以帮助你获得较小的文件以及不错的音质。

设置一下你的输出路径，然后点一下"转化"按钮，稍等一会，你就得到你要的raw文件了！

播放RAW文件

---

现在你已经有了raw文件，把他们放到你工程的data目录下。如果没有这个目录，那就创建它。。。我们使用Sound/Sound这个例子来讲解。。。

可以看到代码很容易理解：

#include <PA9.h> // Include for PA_Lib

#include "saberoff_raw.h" // Include the sound (found in the data folder in .raw format)

// Function: main()

int main(int argc, char ** argv)

{

PA_Init(); // Initializes PA_Lib

PA_InitVBL(); // Initializes a standard VBL

PA_InitText(0, 0);

PA_InitSound(); // Init the sound system

PA_OutputSimpleText(0, 6, 10, "Press A to play the sound");

// Infinite loop to keep the program running

while (1)

{ // Play the sound if A is pressed…

if (Pad.Newpress.A) PA_PlaySimpleSound(0, saberoff_raw);

PA_WaitForVBL();

}

return 1;

}

只需要做以下的步骤：

1. #include "saberoff_raw.h" include 你的raw文件，告诉编译器他们在哪里。。。。就是 nameoftherawfile.h 文件，放到你的include目录下。。。
2. PA_InitSound(); 初始化PAlib的声音系统（raw和mod都适用），设置确认raw文件类型为11025采样率和8 bit signed格式。。。
3. PA_PlaySimpleSound(channel, soundfile); 这个函数很容易使用，选择一个声道 (0-7) 和一个声音文件。。。同时可以播放8个声道（缺省情况下，另外8个声道（译：共有16个声道）是保留给mod播放器的，但是这个也可以设置，后面我们再具体谈）

编译，下载到你的烧录卡中，按一下A键享受你的音乐吧！

Mod文件

Mod文件用起来非常酷，容易使用，占用空间少，效果不错。。。。唯一不好的地方就是不容易创建，比较好的办法是去网络上下载。。。我个人推荐去http://www.modarchive.com/， http://www.exotica.org.uk/frames.html， ftp://ftp.modland.com/pub/modules/这几个地方下载。可惜只有mod文件，没有转化工具。。。

现在，让我们开始我们的例子吧：Sound/ModPlayer !

首先，把mod文件放到data目录下。。。

让我们看代码：

// Includes

#include <PA9.h> // Include for PA_Lib

#include "modfile_mod.h" // Include the mod file (the .mod file is in the data directory)

// Function: main()

int main(int argc, char ** argv){

PA_Init(); // PA Init…

PA_InitVBL(); // VBL Init…

PA_InitSound(); // Sound Init, for the mod player…

PA_PlayMod(modfile_mod); // Play a given mod

while(1){ // Infinite loop

PA_WaitForVBL();

}

return 0;

} // End of main()

只需要知道3件事情！

1. #include "modfile_mod.h" 必须放在你的文件头部，在PAlib include之后。。。如果你不加，程序就不知道你的mod文件在哪里。
2. PA_InitSound(); 是初始化的函数，必须在播放之前调用它。
3. PA_PlayMod(modfile); 使用这个函数播放mod文件。

现在，最后一件事情：我们看看有哪些限制。。。你的mod文件最多只能有16个声道，我推荐使用8个，你可以使用剩下的8个播放音效。

文章的脚注信息由WordPress的wp-posturl插件自动生成

文章的脚注信息由WordPress的wp-posturl插件自动生成