NITRO-System
Function Reference Manual
Compatible with the 2007/03/14 Version NITRO-System

Confidential

This document contains confidential and proprietary information of Nintendo and is also protected under the copyright laws of the United States and foreign countries. No part of this document may be released, distributed, transmitted or reproduced in any form or by any electronic or mechanical means, including information storage and retrieval systems, without permission in writing from Nintendo.

Caution: This document contains proprietary information. Please take strict measures to keep this information secret.

Microsoft Internet Explorer 5.0 or later recommended


Notes

Multi-thread operation

The NITRO-System library is not designed to be fundamentally thread-safe (in a form that supports multi-threading). Consequently, calling an API of the NITRO-System library from an interrupt handler or a different thread might not work properly.

However, the functions of the sound driver (SND) are thread–safe and they can be called from an interrupt handler and different threads.

Using Dividers

The G2D and G3D libraries of NITRO-System use dividers. When using NITRO-System without backing up or restoring the calculator used for internal processing, there is a chance for the calculation result of the interrupt source will be destroyed.

When using NITRO-System for interrupt processing, be sure to backup/restore the status of any divider used inside an interrupt with CP_SaveContext and CP_RestoreContext of NITRO-SDK.


Additions and Updates to the Function Reference (2007/03/14)

Additions

NNS_G2dFontGetFlags
NNS_G2dGetOamBuffer
NNS_GfdDumpFrmPlttVramManagerEx
NNS_GfdDumpFrmTexVramManagerEx
NNS_GfdDumpLnkPlttVramManagerEx
NNS_GfdDumpLnkTexVramManagerEx
NNS_SndArcStrmGetChannelCount
NNS_SndArcStrmSetVolume

Updates

G2D Sample Demos
NNS_G2dBGLoadScreenRect
NNS_G2dCharCanvasDrawChar
NNS_G2dCharCanvasDrawGlyph
NNS_G2dCharCanvasInitForBG
NNS_G2dCharCanvasInitForOBJ2DRect
NNS_G2dCharCanvasMakeCell*
Font Overview
NNS_G2dFontGetBaselinePos
NNS_G2dFontGetCharWidth
NNS_G2dFontGetCharWidthFromIndex
NNS_G2dFontGetCharWidths
NNS_G2dFontGetCharWidthsFromIndex
NNS_G2dFontGetGlyph
NNS_G2dFontGetGlyphFromIndex
NNS_G2dFontGetHeight
NNS_G2dFontGetMaxCharWidth
NNS_G2dFontGetStringWidth
NNS_G2dFontGetTextHeight
NNS_G2dFontGetTextRect
NNS_G2dFontGetTextWidth
NNS_G2dTextCanvasDrawString
NNS_G2dTextCanvasDrawTaggedText
NNS_G2dTextCanvasDrawText
NNS_G2dTextCanvasDrawTextRect
NNS_G2dTextCanvasGetStringWidth
NNS_G2dTextCanvasGetTextHeight
NNS_G2dTextCanvasGetTextRect
NNS_G2dTextCanvasGetTextWidth
NNS_GfdAllocPlttVram
NNS_GfdAllocTexVram
NNS_SndArcSetCurrent
NNS_SndArcStrmMoveVolume

Deletions