1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META http-equiv="Content-Style-Type" content="text/css">
6<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
7<TITLE>OSInitFont</TITLE>
8</HEAD>
9<BODY>
10<H1>OSInitFont</H1>
11
12<H2>C Specification</H2>
13<DL>
14  <DD>
15<PRE><CODE>#include &lt;revolution/os.h&gt;</CODE></PRE>
16  <DD>
17<PRE>#define OS_FONT_SIZE_ANSI       (288 + 131072)
18#define OS_FONT_SIZE_SJIS       (3840 + 1179648)
19
20BOOL OSInitFont(OSFontHeader* fontData);</PRE>
21</DL>
22<H2>Arguments</H2>
23<TABLE border="1" cellpadding="3" cellspacing="0.1">
24  <TBODY>
25    <TR>
26<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE><STRONG><EM><CODE>fontData</CODE></EM></STRONG></CODE></STRONG></EM></TD>
27<TD width="520">Pointer to the font data buffer that has size <code>OS_FONT_SIZE_*</code> which depends on the font encoding.&nbsp;Must be 32-byte aligned.</TD>
28    </TR>
29  </TBODY>
30</TABLE>
31<H2>Return Values</H2>
32<P>Returns <CODE>TRUE</CODE> if ends normally; <font face="Courier New">FALSE</font> if font data is unavailable.</P>
33<H2>Description</H2>
34<P>This function loads and expands ROM font data. The <code>OSInitFont</code> function should be used in conjunction with the <a href="OSGetFontTexture.html"><code>OSGetFontTexture</code></a> function. To save main memory space, use the <a href="OSLoadFont.html"><code>OSLoadFont</code></a> function instead of  the <code>OSInitFont</code> function.</P>
35<P><STRONG>Note: </STRONG><font color="red">This font is currently used on a provisional basis. It may not be allowed on the product version. </font>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. </p>
36<H2>See Also</H2>
37<P><A target="contents" href="../toc.html#Font">Font Functions</A></P>
38<H2>Revision History</H2>
39<P>03/01/2006 Initial version.</P>
40</BODY>
41</HTML>