FNTStreamingConstruct

Syntax

#include <revolution/fnt.h>

FNTConstructResult FNTStreamingConstruct(
    FNTHeader* font,
    void* stream,
    u32 streamSize);

Arguments

font Pointer to the font data buffer.
The buffer must be of the size obtained by the function FNTGetDataSize.
Must be 32-byte aligned.
stream Pointer to the buffer storing a portion of the font resource.
Must be 32-byte aligned.
streamSize Number of bytes of data stored in the buffer indicated by stream.

Return Values

Returns the progress status of the expansion process.

Description

Reads the font resource in order and expands the data.

Specify the pointer to the portion of the font resource loaded into memory and its size in stream and streamSize. As long as the portions of the specified font resource are in order from the start, there are no restrictions on size or cycles.

By using the FNTInitStreamingConstruct and FNTStreamingConstruct functions as a pair, a font can be expanded from the disc or NAND with only a small read buffer. To expand the font, first initialize with the FNTInitStreamingConstruct function and then make subsequent calls to the FNTStreamingConstruct function each time data is obtained from the disc or NAND.

When loading the entire font resource into memory, the simpler FNTConstruct function can be used.

See Also

FNTGetDataSize, FNTInitStreamingConstruct, FNTConstruct

Revision History

2006/10/01 Initial version.


CONFIDENTIAL