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	<TITLE>SC API Introduction</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8</HEAD>
9<BODY>
10
11<H1>SC API Introduction</H1>
12
13<H2>Introduction</H2>
14<p>
15The SC library allows you to reference and change console settings. For Nintendo GameCube, these functions are in the OS library. Be sure to use this SC library with the Revolution.
16</p>
17
18<H2>Initialization</H2>
19<p>
20Before using the SC library, you must call the <a href="SCInit.html"><code>SCInit</code></a> function and initialize the library. Because the initialization process is executed in the background, be sure to separately check that initialization has completed. For details, see the page for <code>SCInit()</code>.
21</p>
22
23<p>
24<a href="SCInit.html"><code>SCInit()</code></a> automatically calls <a href="../nand/NANDInit.html"><code>NANDInit()</code></a>.
25</p>
26
27<H2>Reflecting Setting Changes in Internal Flash Memory</H2>
28<p>
29The console settings are stored in the built-in flash memory.
30</p>
31
32<p>
33Only settings maintained in RAM can be changed when using <code>SCSet*()</code> to change settings. Be sure to call <a href="SCFlush.html"><code>SCFlush*()</code></a> to reflect these changes in flash memory.
34</p>
35
36<p>
37When more than one setting is changed in the same cycle, you only need to call <a href="SCFlush.html"><code>SCFlush*()</code></a>  once at the end.
38</p>
39
40<H2>Flash Memory Lifetime</H2>
41<p>
42Be aware that frequently changing settings affects the lifetime of flash memory.
43</p>
44
45<H2>Access Time</H2>
46<p>
47Referencing and changing settings takes some time. Implement application independent of the SC library processing time.
48</p>
49
50<H2>Appropriateness of Setting Values</H2>
51<p>
52Setting values are not necessarily logically consistent if the <code>SCGet*()</code> function for accessing settings succeeds. The library does not check setting values, particularly when they are stored in a structure. Make sure there are no mistaken operations, even if unexpected setting values are returned.
53</p>
54
55<H2><S>Emulator Functions</S> (Deleted)</H2>
56<p>
57Do not call the emulation function as it has been removed. The functions remain for backward-compatibility purposes, but they do nothing and return <code>FALSE</code>.
58</p>
59
60<p>
61Use the <a href="../tools/devkitmenu.html">NDEV System Menu</a> to modify the aspect ratio or language settings.
62</p>
63
64
65<H2>Revision History</H2>
66<P>2006/8/15 Added <code>SCGetWpadMotorMode</code>, <code>SCGetWpadSensorBarPosition</code>, <code>SCGetWpadSpeakerVolume</code>, <code>SCSetWpadMotorMode</code>, <code>SCSetWpadSensorBarPosition</code>, and <code>SCSetWpadSpeakerVolume</code>.<br> Deleted the emulate function(s).<BR>05/29/2006 Initial version.</P>
67
68<hr>
69<P>CONFIDENTIAL</p>
70</BODY>
71</HTML>
72