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 Library Introduction</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 8</HEAD> 9<BODY> 10 11<H1>SC Library 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 platform. 16</p> 17 18<H2>Initialization</H2> 19 20<p> 21<B>From RevolutionSDK 2.2 on, initialization has been integrated into <code>OSInit()</code>. 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 <code>SCInit()</code>. 31</p> 32 33<p> 34<a href="SCInit.html"><code>SCInit()</code></a> automatically calls <a href="../nand/NANDInit.html"><code>NANDInit()</code></a>. 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 <code>SCSet*()</code> is called. Be sure to call <a href="SCFlush.html"><code>SCFlush*()</code></a> 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 <a href="SCFlush.html"><code>SCFlush*()</code></a> once at the end of the cycle. 50</p> 51 52<H2>Flash Memory Lifetime</H2> 53<p> 54Be aware that frequently changing settings affects the lifetime 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> 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. 65</p> 66 67<H2>Functions That Are No Longer 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 disclosed. 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 <code><a href="../gx/Enumerated_Types/GXTexFmt.html">here</a></code>. 87</p> 88 89 90<H2>Revision History</H2> 91<P>2006/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 <code>OSInit</code>.<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.</P> 92 93<hr> 94<P>CONFIDENTIAL</p> 95</BODY> 96</HTML> 97