SC API

Introduction

The 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.

Initialization

From RevolutionSDK 2.2 on, initialization has been integrated into the OSInit function. Initialization by applications is no longer necessary.

The 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.

Before using the SC library, you must call the SCInit 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 SCInit function.

The SCInit function automatically calls the NANDInit function.

Reflecting Setting Changes in Internal Flash Memory

The console settings are stored in the built-in flash memory.

Only the settings maintained in RAM are changed when the SCSet* functions are called. Be sure to call the SCFlush* functions to reflect these changes in flash memory.

When more than one setting is changed in the same cycle, you only need to call the SCFlush* functions once at the end of the cycle.

Flash Memory Life Span

Be aware that frequently changing settings affects the life span of flash memory.

Access Time

Referencing and changing settings takes some time. Implement applications independent of the SC library processing time.

Appropriateness of Setting Values

Setting values are not necessarily logically consistent if the SCGet* 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.

Functions That Are No Longer Publicly Disclosed

Under 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.

• SCSetSoundMode()
• SCSetProgressiveMode()
• SCSetEuRgb60Mode()
• SCGetWpadMotorMode()
• SCGetWpadSensorBarPosition()
• SCGetWpadSpeakerVolume()
• SCSetWpadMotorMode()
• SCSetWpadSensorBarPosition()
• SCSetWpadSpeakerVolume()

For details, click here.

Revision History

2006/10/25 The following functions are no longer public: SCSetSoundMode, SCSetProgressiveMode, SCSetEuRgb60Mode, SCGetWpadMotorMode, SCGetWpadSensorBarPosition, SCGetWpadSpeakerVolume, SCSetWpadMotorMode, SCSetWpadSensorBarPosition, SCSetWpadSpeakerVolume
2006/09/06 Revised the description along with integration of the initialization process in the OSInit function.
2006/08/31 Corrected a problem with SCFlush. Corrected a problem with SCFlushAsync and added a callback function.
2006/08/26 Added the return values for SCGetLanguage.
2006/08/15 Added SCGetWpadMotorMode, SCGetWpadSensorBarPosition, SCGetWpadSpeakerVolume, SCSetWpadMotorMode, SCSetWpadSensorBarPosition, and SCSetWpadSpeakerVolume. Deleted the emulator functions.
2006/05/29 Initial version.

CONFIDENTIAL