nw::font::ArchiveFont::StreamingConstruct Member Function

Syntax

ConstructResult StreamingConstruct(
     ConstructContext * pContext,
     const void*         stream,
     u32 streamSize
);

Arguments

Name Description
out pContext Pointer to the streaming construct context initialized with InitStreamingConstruct().
in stream Pointer to the buffer storing a portion of the archive font.
in streamSize Number of bytes of data stored in the buffer pointed to by stream.

Return Values

Returns the progress of the construct process.

Description

Constructs a font from successive loads from the archive font.

In stream, specify a pointer to a portion of the archive font loaded into memory; in streamSize, specify the portion's size. As long as the portions of the specified archive font are in order from the beginning, there are no restrictions on partition size or cycles.

By using the nw::font::ArchiveFont::InitStreamingConstruct unction and the StreamingConstruct function as a pair, you can build a font from a DVD or NAND using only a small read buffer. To construct the font, first initialize the streaming construct context with the nw::font::ArchiveFont::InitStreamingConstruct function, then call the StreamingConstruct function each time data is obtained from DVD or NAND.

If the entire archive font can be read into memory, you can use the simpler nw::font::ArchiveFont::Construct function.

See Also

nw::font::ArchiveFont::InitStreamingConstruct
nw::font::ArchiveFont::Construct

Revision History

2009/11/09
Initial version.

CONFIDENTIAL