1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" />
7<title>MountSharedFont</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/pl/Overview.html">pl</a>::<a href="../../../nn/pl/CTR/Overview.html">CTR</a>::MountSharedFont</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">nn::Result</a> MountSharedFont(
15     const char * archiveName,
16     <a href="../../../nn/pl/CTR/SharedFontType.html">SharedFontType</a> sharedFontType,
17     size_t maxFile,
18     size_t maxDirectory,
19     void * workingMemory,
20     size_t workingMemorySize
21);
22</pre>
23    </div>
24<h2>Arguments</h2>
25    <div class="section">
26      <table class="arguments">
27        <thead>
28          <tr>
29            <td width="15" />
30<th>Name</th>
31<td>Description</td>
32          </tr>
33        </thead>
34        <tr>
35<td>in</td>
36<th>archiveName</th>
37<td>Specifies the archive name. (Example: &quot;fnt1:&quot;)</td>
38        </tr>
39        <tr>
40<td>in</td>
41<th>sharedFontType</th>
42<td>Specifies the type of the shared font.</td>
43        </tr>
44        <tr>
45<td>in</td>
46<th>maxFile</th>
47<td>Specifies the number of files that can be opened simultaneously.</td>
48        </tr>
49        <tr>
50<td>in</td>
51<th>maxDirectory</th>
52<td>Specifies the number of directories that can be opened simultaneously.</td>
53        </tr>
54        <tr>
55<td>in</td>
56<th>workingMemory</th>
57<td>Specifies the address of the working region.</td>
58        </tr>
59        <tr>
60<td>in</td>
61<th>workingMemorySize</th>
62<td>Specifies the size of the working region.</td>
63        </tr> </table>
64    </div>
65<h2>Return Values</h2>
66<div class="section">Returns the result. <br />
67      <table class="arguments">
68        <thead>
69          <tr>
70<th>Value</th>
71<td>Description</td>
72          </tr>
73        </thead>
74        <tr>
75<th>nn::pl::ResultSharedFontNotFound</th>
76<td>The specified shared font was not found.</td>
77        </tr>
78      </table> </div>
79<h2>Description</h2>
80    <div class="section">
81<p>Mounts the archive of the shared font.</p><p>When using a font other than that which can be obtained with the <CODE><a href="../../../nn/pl/CTR/GetSharedFontType.html">nn::pl::CTR::GetSharedFontType</a></CODE> function, the application itself must mount the archive and open the font file.</p><p>
82The font files included within the archive are as follows. We assume an archive name of &quot;font&quot; when the archive is opened.</p><ul><li>SHARED_FONT_TYPE_STD:&quot;font:/cbf_std.bcfnt.lz&quot;</li><li>SHARED_FONT_TYPE_CN:&quot;font:/cbf_zh-Hans-CN.bcfnt.lz&quot;</li><li>SHARED_FONT_TYPE_KR:&quot;font:/cbf_ko-Hang-KR.bcfnt.lz&quot;</li><li>SHARED_FONT_TYPE_TW:&quot;font:/cbf_zh-Hant-TW.bcfnt.lz&quot;</li></ul><p>
83The arguments related to mounting are the same as for other mounting interfaces.
84            </p><p>
85For 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:
86            <ul><li>
87For 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.
88            </li><li>
89For 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.
90</li></ul><B>In the Japanese, North American, and European markets</B>, 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.
91            </p><p>
92The <CODE>bcfnt</CODE> 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.
93            </p></div>
94<h2>Revision History</h2>
95    <div class="section">
96      <dl class="history">
97        <dt>2010/11/10</dt>
98<dd>Initial version.<br />
99        </dd>
100        <dt>2012/01/16</dt>
101<dd>Added changes and precautions relating to the built-in China, Korea, and Taiwan system fonts in SystemUpdater 0.17x and later versions.<br />
102        </dd>
103      </dl>
104    </div>
105  <hr><p>CONFIDENTIAL</p></body>
106</html>