summaryrefslogtreecommitdiff
path: root/README.ds
diff options
context:
space:
mode:
authorSam Lantinga <slouken@libsdl.org>2012-02-12 21:04:01 -0500
committerSam Lantinga <slouken@libsdl.org>2012-02-12 21:04:01 -0500
commit98852b0a8cf84127d91845d3f08cc99513a34988 (patch)
treeb704153f99a8137e30badd1277b4cd783de95b76 /README.ds
parentb878150a83a80b6aa123c8ddfb3f43afc50e5b0c (diff)
Updated Nintendo DS support
Frank Zago This patch updates the DS port: - do not use the now removed compat layer. - integrate parts of libgl2D since I got permission from the author, and thus removed an external dependancy, - a few bugs fixes. Now, the textures should be completely supported, except reading from them which doesn't makes sense to have on the DS. Sound is still not supported. If someone else wants to work on the missing pieces, feel free.
Diffstat (limited to 'README.ds')
-rw-r--r--README.ds21
1 files changed, 13 insertions, 8 deletions
diff --git a/README.ds b/README.ds
index 4e89168f..40bf8823 100644
--- a/README.ds
+++ b/README.ds
@@ -6,11 +6,8 @@ Simple DirectMedia Layer for Nintendo DS
* The devkitpro SDK available at http://devkitpro.org.
Read the information at http://devkitpro.org/wiki/Getting_Started/devkitARM
The necessary packages are devkitARM, libnds, libfat and default arm7.
-* The hardware renderer is using the libgl2d abstraction library that can be found at:
- http://rel.phatcode.net/junk.php?id=117
- Build it, and install the library and the header where SDL can find them (ie. in
- the libnds/lib and libnds/include directories).
-
+* Optionally, use a DS emulator, such as desmume (http://desmume.org/)
+ to program and debug.
-Building SDL-
@@ -18,16 +15,24 @@ After setting the devkitpro environment, cd into your SDL directory and type:
make -f Makefile.ds
This will compile and install the library and headers into the
-devkitpro's portlibs directory. Additionnaly it will compile several
-tests that you can run either on the DS or with desmume. For instance:
+devkitpro's portlibs directory (../portlibs/arm/lib/ and
+../portlibs/arm/include/). Additionally it will compile several tests
+that you can run either on the DS or with desmume. For instance:
+ desmume --cflash-path=test/ test/nds-test-progs/testsprite2/testsprite2.nds
+ desmume --cflash-path=test/ test/nds-test-progs/testspriteminimal/testspriteminimal.nds
+ desmume --cflash-path=test/ test/nds-test-progs/testscale/testscale.nds
desmume test/nds-test-progs/general/general.nds
-Notes-
* The renderer code is based on the gl like engine. It's not using the sprite engine.
+* The hardware renderer is using the parts of the libgl2d abstraction library that can be found at:
+ http://rel.phatcode.net/junk.php?id=117
+ Used with the author's permission.
* The port is very basic and incomplete:
- - SDL currently has to be compiled for either framebuffer mode or render mode.
+ - SDL currently has to be compiled for either framebuffer mode or renderer mode.
See USE_HW_RENDERER in Makefile.ds.
- some optional renderer functions are not implemented.
+ - no sound
-Limitations-
* in hardware renderer mode, don't load too many textures. The internal format is