NTMV_M2dInitForMemEx

Syntax

#include <ntmv/m2d.h>
void NTMV_M2dInitForMemEx(
         NTMVM2dManualViewerInfo*    pManualViewerInfo,
         NNSFndAllocator*            pAllocator,
         void*                       manualArcData,
         void*                       uiResource,
         const NNSG2dFont *const     fonts[],
         u16                         lang);

Arguments

pManualViewerInfo Pointer to a structure that stores information used by the M2d library.
pAllocator Pointer to the TWL-System allocator.
manualArcData Pointer to the e-manual binary data.
uiResource Pointer to the resource data used by the M2d library.
The resource data must be aligned to a 32-byte boundary.
fonts Array of pointers to NNSG2dFont structures configured with the internal system fonts (TWL bitmap fonts) used to display the e-manual. Pointers to font data must be set in the following order.
Index 0: Large font
Index 1: Medium font
Index 2: Small font
lang Language in which to display the manual.
Specify an ISO 639 language code (2 letters) as a 16-bit integer value. For example, specify 'en' for English.
The language codes of the main languages are shown below.
  English   ... 'en'
  French  ... 'fr'
  Spanish ... 'es'
  German  ... 'de'
  Italian ... 'it'
  Dutch ... 'nl'
  Japanese   ... 'ja'

Return Values

None.

Description

Allocates memory and configures the hardware to display the e-manual. The TWL-System allocator handles memory allocation.

This function specifies the E-Manual binary data and the resource data used by the M2d library with pointers to memory. Use the NTMV_M2dInitForFilePath or NTMV_M2dInitForFilePathEx function to specify path strings to the ROM files.

The e-manual binary file and the resource files used by the library are compressed with the compBLZ TWL-SDK tool. Use the MI_SecureUncompressBLZ TWL-SDK function to decompress data before passing it to this function.
Resource data used by the library must be aligned to a 32-byte boundary.

Unlike the NTMV_M2dInitForMem function, this function allows the display language for the e-manual to be specified explicitly. If the e-manual binary file for the specified language cannot be found, the manual is displayed using the topmost of the languages that were selected in TWL Manual Editor when the project was output to binary.

See Also

NTMV_M2dInitForMem
NTMV_M2dInitForFilePath
NTMV_M2dInitForFilePathEx

Revision History

2009/02/20 Added the language code list.
2008/12/12 Initial version.


CONFIDENTIAL