gbadev.org forum archive

This is a read-only mirror of the content originally found on forum.gbadev.org (now offline), salvaged from Wayback machine copies. A new forum can be found here.

DS development > libnds documentation

#130218 - snowsquirrel - Thu May 31, 2007 11:41 pm

I am migrating my code from PA_Lib to pure libnds, but I can't seem to find much for documentation.

I found this:
http://devkitpro.sourceforge.net/devkitProWiki/libnds/index.html

But it contains no reference to the function videoSetMode()...

Some tutorials use things like
Code:

irqInit();
irqEnable();


other tutorials bitwise operators on registers... which is the preferred (newer) method of doing things?

I am currently dealing with bg's. Know of any good tutorials for 2d, tiled, 256 color palette bg's (text bgs)? I have found a couple, but they were pretty scant on detail and explanation.

Thanks,
~S

#130219 - relpats_eht - Thu May 31, 2007 11:48 pm

For documentation use the comments in code itself, or run the code through dyoxygen; the documentation on the website is horribly out of date.

I would say it doesn't really matter if you use functions or registers--most of what can be inlined is.

As for tutorials, when programming as low a level as you are on the DS (at least with the current state of the development scene) you will have to figure out most things yourself, after which, you probably won't want to write a tutorial anymore. Thus, the cycle continues.
_________________
- relpats_eht

#130346 - wintermute - Sat Jun 02, 2007 11:43 am

relpats_eht wrote:
For documentation use the comments in code itself, or run the code through dyoxygen; the documentation on the website is horribly out of date.


It might be incomplete but it certainly isn't horribly out of date.

snowsquirrel:

Reading through the examples is probably the best way to go for now.
_________________
devkitPro - professional toolchains at amateur prices
devkitPro IRC support
Personal Blog

#130371 - relpats_eht - Sat Jun 02, 2007 5:09 pm

wintermute wrote:
It might be incomplete but it certainly isn't horribly out of date.


Really? I suppose I had never even bothered to look at the date. Might I ask why?
_________________
- relpats_eht

#130377 - wintermute - Sat Jun 02, 2007 6:41 pm

Why is it incomplete?

Because we don't have enough people with enough time and motivation to document the libraries fully. Large parts of libnds need refactoring - especially the god awful video.h header.

It's difficult to rework things properly and not break existing code though.
_________________
devkitPro - professional toolchains at amateur prices
devkitPro IRC support
Personal Blog

#130379 - relpats_eht - Sat Jun 02, 2007 7:05 pm

I suppose I am going senile (at such an age, what a pity) I had thought the whole of the code had been documented.
_________________
- relpats_eht