nn::pl::CTR::MountSharedFont Function

nn::Result MountSharedFont(
     const char * archiveName,
     SharedFontType sharedFontType,
     size_t maxFile,
     size_t maxDirectory,
     void * workingMemory,
     size_t workingMemorySize
);

	Name	Description
in	archiveName	Specifies the archive name. (Example: "fnt1:")
in	sharedFontType	Specifies the type of the shared font.
in	maxFile	Specifies the number of files that can be opened simultaneously.
in	maxDirectory	Specifies the number of directories that can be opened simultaneously.
in	workingMemory	Specifies the address of the working region.
in	workingMemorySize	Specifies the size of the working region.

Returns the result.

Value	Description
nn::pl::ResultSharedFontNotFound	The specified shared font was not found.

Mounts the archive of the shared font.

When using a font other than that which can be obtained with the nn::pl::CTR::GetSharedFontType function, the application itself must mount the archive and open the font file.

The font files included within the archive are as follows. We assume an archive name of "font" when the archive is opened.

• SHARED_FONT_TYPE_STD:"font:/cbf_std.bcfnt.lz"
• SHARED_FONT_TYPE_CN:"font:/cbf_zh-Hans-CN.bcfnt.lz"
• SHARED_FONT_TYPE_KR:"font:/cbf_ko-Hang-KR.bcfnt.lz"
• SHARED_FONT_TYPE_TW:"font:/cbf_zh-Hant-TW.bcfnt.lz"

The arguments related to mounting are the same as for other mounting interfaces.

For SystemUpdater 0.17.x and later versions, the built-in China, Korea, and Taiwan system fonts have been changed in the following ways from earlier versions:

• For the built-in fonts for the China and Korea regions, since the display position was higher than Japanese, North American, and European fonts for characters excluding Nintendo's special characters, the display position for characters excluding Nintendo's special characters was lowered by two pixels.
• For the built-in fonts for the Taiwan region, since the display position was higher than Japanese, North American, and European fonts for all characters, the display position for all characters was lowered by one pixel.

In the Japanese, North American, and European markets, the built-in China, Korea, and Taiwan system fonts can only be updated by SystemUpdater via Internet, so in these regions there is a mix of systems with and without the font updates and there may be differences in how things display depending on the system. Note this when using built-in China, Korea, and Taiwan system fonts in the Japanese, North American, and European markets.

The bcfnt file included with the CTR SDK contains the same content as the built-in system fonts. You can avoid the above-mentioned problem by using this file.

2010/11/10

Initial version.

2012/01/16

Added changes and precautions relating to the built-in China, Korea, and Taiwan system fonts in SystemUpdater 0.17x and later versions.