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</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 Wii platform.
16</p>
17
18<H2>Initialization</H2>
19
20<p>
21<B>From RevolutionSDK 2.2 on, initialization has been integrated into the <code>OSInit</code> function. Initialization by applications is no longer necessary.</B>
22</p>
23
24<p>
25The initialization process described below is required for versions of Revolution SDK older than 2.2. However, there is no problem executing this initialization process under Revolution SDK 2.2 or later.
26</p>
27
28<BLOCKQUOTE>
29<p>
30Before 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 the <a href="SCInit.html"><code>SCInit</code></a> function.
31</p>
32
33<p>
34The <a href="SCInit.html"><code>SCInit</code></a> function automatically calls the <a href="../nand/NANDInit.html"><code>NANDInit</code></a> function.
35</p>
36</BLOCKQUOTE>
37
38
39<H2>Reflecting Setting Changes in Internal Flash Memory</H2>
40<p>
41The console settings are stored in the built-in flash memory.
42</p>
43
44<p>
45Only the settings maintained in RAM are changed when the <code>SCSet*</code> functions are called. Be sure to call the <a href="SCFlush.html"><code>SCFlush*</code></a> functions to reflect these changes in flash memory.
46</p>
47
48<p>
49When more than one setting is changed in the same cycle, you only need to call the <a href="SCFlush.html"><code>SCFlush*</code></a> functions once at the end of the cycle.
50</p>
51
52<H2>Flash Memory Life Span</H2>
53<p>
54Be aware that frequently changing settings affects the life span of flash memory.
55</p>
56
57<H2>Access Time</H2>
58<p>
59Referencing and changing settings takes some time. Implement applications independent of the SC library processing time.
60</p>
61
62<H2>Appropriateness of Setting Values</H2>
63<p>
64Setting values are not necessarily logically consistent if the <code>SCGet*</code> functions for accessing settings succeed. 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.
65</p>
66
67<H2>Functions That Are No Longer Publicly Disclosed</H2>
68
69<p>
70Under Revolution SDK 2.3 and later versions, applications are prohibited from changing sound and video mode-related settings. The following functions, including SC library functions specific to the WPAD library, are no longer available.
71</p>
72
73<ul>
74<li><a href="SCSetSoundMode.html"><code>SCSetSoundMode()</code></a>
75<li><a href="SCSetProgressiveMode.html"><code>SCSetProgressiveMode()</code></a>
76<li><a href="SCSetEuRgb60Mode.html"><code>SCSetEuRgb60Mode()</code></a>
77<li><a href="SCGetWpadMotorMode.html"><code>SCGetWpadMotorMode()</code></a>
78<li><a href="SCGetWpadSensorBarPosition.html"><code>SCGetWpadSensorBarPosition()</code></a>
79<li><a href="SCGetWpadSpeakerVolume.html"><code>SCGetWpadSpeakerVolume()</code></a>
80<li><a href="SCSetWpadMotorMode.html"><code>SCSetWpadMotorMode()</code></a>
81<li><a href="SCSetWpadSensorBarPosition.html"><code>SCSetWpadSensorBarPosition()</code></a>
82<li><a href="SCSetWpadSpeakerVolume.html"><code>SCSetWpadSpeakerVolume()</code></a>
83</ul>
84
85<p>
86For details, click <a href="stopped.html">here</a>.
87</p>
88
89
90<H2>Revision History</H2>
91<P>
922006/10/25 The following functions are no longer public: <code>SCSetSoundMode</code>, <code>SCSetProgressiveMode</code>, <code>SCSetEuRgb60Mode</code>, <code>SCGetWpadMotorMode</code>, <code>SCGetWpadSensorBarPosition</code>, <code>SCGetWpadSpeakerVolume</code>, <code>SCSetWpadMotorMode</code>, <code>SCSetWpadSensorBarPosition</code>, <code>SCSetWpadSpeakerVolume</code><br>2006/09/06 Revised the description along with integration of the initialization process in the <code>OSInit</code> function.<br>2006/08/31 Corrected a problem with <code>SCFlush</code>. Corrected a problem with <code>SCFlushAsync</code> and added a callback function.<br>2006/08/26 Added the return values for <code>SCGetLanguage</code>.<br>2006/08/15 Added <code>SCGetWpadMotorMode</code>, <code>SCGetWpadSensorBarPosition</code>, <code>SCGetWpadSpeakerVolume</code>, <code>SCSetWpadMotorMode</code>, <code>SCSetWpadSensorBarPosition</code>, and <code>SCSetWpadSpeakerVolume</code>. Deleted the emulator functions.<br>2006/05/29 Initial version.<br>
93</P>
94
95<hr><p>CONFIDENTIAL</p></body>
96</HTML>
97