About Reset; Reset Procedures; Hot Reset; Restart - Nintendo GameCube Manual

1. About Reset

This document provides explanations and warnings related to the process of resetting the Nintendo
TM
GameCube . In this context, "reset" refers to the process that returns the game to the initial screen.
The next section explains three ways of preparing an application process for resetting the game. The
TM
Nintendo GameCube
performed when this button is used. Choose the method that is most appropriate for your game. The
"reset" operation described in this document refers to both a reset that is done by pressing and
releasing the Nintendo GameCube
TM
GameCube Controller (in-hand Reset).

2. Reset Procedures

There are three reset procedures:
•

Hot reset

•

Restart

•

Application-driven restart

This section explains all of these reset procedures. No matter which reset procedure you use, there
are certain steps that must be performed before the reset process is executed. Please refer to Section
4.
2.1 Hot reset
If you specify OS_RESET_HOTRESET as the value for reset in the OSResetSystem function's first
argument, the hardware will be reset while the application is running. By performing a hot reset, the
system first returns to the IPL before reloading the executable file (the .dol file) from the
Nintendo GameCube™ Game Disc and then restarts the application. Additionally, if you specify TRUE
as the value for forcemenu in the OSResetSystem function's third argument, you can go directly to the
IPL's menu screen.
For details, see the section on the OSResetSystem function in the Nintendo GameCube
Reference Manual.
2.2 Restart
If you specify OS_RESET_RESTART as the value for reset in the OSResetSystem function's first
argument, the system reloads the executable file (the .dol file) from the Nintendo GameCube™ Game
Disc and then restarts the application.
For details, see the section on the OSResetSystem function in the Nintendo GameCube
Reference Manual.
2.3 Application-driven Restart
This procedure returns the game process to a predetermined position. The exact position is up to the
programmer: it can be the opening movie, or the game start screen or some other place. The
programmer is also responsible for such processes as saving the variables that were used during the
game.

3. API

Below is a summary of the functions that have been prepared for the reset procedure. For details,
please read the Nintendo GameCube
3.1

OSResetSystem

This function performs either a hot reset or a restart for the hardware. Select which of these you want
to perform in reset, contained in the first argument of the function. If you choose to perform a hot reset,
you can go directly to the IPL's menu screen by also specifying TRUE for forcemenu in the third
argument of the function.
© 2001 Nintendo of America Inc.
has a RESET Button, but the application is responsible for the process that is
TM
RESET Button, and a reset performed with the Nintendo
TM
Function Reference Manual.
3
Reset Guidelines
TM
Function
TM
Function
DOL-06-0028-001-A2
Released: 9/13/01