OSLoadFont

C Specification

#include <revolution/os.h>

// For OSLoadFont(*, temp)
#define OS_FONT_ROM_SIZE_ANSI   12288   // 0x03000
#define OS_FONT_ROM_SIZE_SJIS   315392  // 0x4D000

// For OSLoadFont(fontData, *)
#define OS_FONT_DATA_SIZE_ANSI  65824
#define OS_FONT_DATA_SIZE_SJIS  593636

u32 OSLoadFont (OSFontHeader* fontData, void* temp);

Arguments

`fontData`	Pointer to the font data buffer that has size `OS_FONT_DATA_SIZE_*` which depends on the font encoding. Must be 32-byte aligned.
`temp`	Pointer to a temporary buffer that the `OSLoadFont` function uses. The buffer size must be `OS_FONT_ROM_SIZE_*`. This temporary buffer can be released after the function completes. Must be 32-byte aligned.

Return Values

Font data size in bytes. Returns zero if font data is unavailable.

Description

The OSLoadFont function loads a ROM font. This is a low-level font function that must be used in conjuction with the OSGetFontTexel function.

Note: This font is currently used on a provisional basis. It may not be allowed on the product version. For the product version of Revolution, we plan to prepare a new font set that uses the internal flash memory. A new font library for accessing this font will be prepared in future SDKs.

Revision History