Wii Programming Guidelines
Total Page:16
File Type:pdf, Size:1020Kb
Wii Programming Guidelines Ver sion : 1.08 2008 /04 /02 The content of this document is highly confidential and should be handled accordingly. 2006 -2008 N intendo RVL -06 -0132 -001 -P CONFI DENTIAL Released : May 2, 2008 Wii Programming Gui delines Revolution SDK Confidential These coded instructions, statements, and computer programs contain proprietary information of Nintendo of America Inc. and/or Nintendo Company Ltd. and are protected by Federal copyright law. They may not be disclosed to third parties or copie d or duplicated in any form, in whole or in part, without the prior written consent of Nintendo. RVL -06 -0132 -001 -P 2 2006 -2008 N intendo Released : May 2, 2008 CONFIDENTIAL Revolution SDK Wii Programming Guidelines Table of Contents 1 Overview ................................ ................................ ................................ ................................ ..................... 12 1.1 Level of Importance ................................ ................................ ................................ ............................ 12 1.2 Wii Programming Guidelines Note ................................ ................................ ................................ ...... 12 1.3 Do Not Use Wii Development an d SDK Files on Other Platforms ................................ ...................... 12 2 All ................................ ................................ ................................ ................................ ................................ 13 2.1 Prohibition of Dependency on Device Specifications [Required] ................................ ........................ 13 2.2 Memory and Register Initialization [Required] ................................ ................................ .................... 13 2.3 Startup Time Restriction [Recommended] ................................ ................................ .......................... 13 2.4 Startup Disc Error Handling [Required] ................................ ................................ ............................... 13 2.5 Compliance with Legal Rights Display [Required] ................................ ................................ .............. 13 2.6 Usin g the Latest Packages [Recommended] ................................ ................................ ...................... 14 2.7 Removal of Debug Information [Required] ................................ ................................ ......................... 14 2.8 Prohibition of Device Access Without t he Use of a Library [Required] ................................ ............... 14 2.9 Prohibition of Development Support Libraries in Release Version [Required] ................................ ... 14 2.10 Guarant eeing Extended Operation of the Application [Required] ................................ ....................... 14 2.11 Integrating Banners, Comments, and Icons [Information] [Deleted] ................................ ................... 14 2.12 Application of Wii System Settings [Required] ................................ ................................ .................... 15 2.13 Prohibition of Health and Safety Warning Display by Applications [Required] ................................ ... 15 2.14 Display at Application Startup [Information] [Deleted] ................................ ................................ ......... 15 2.15 [N. American Version Only] Displaying the ESRB Online Rating Notice for Applications Using Network Features [R equired] ................................ ................................ ................................ .... 15 2.16 Program Distribution Method [Required] ................................ ................................ ............................ 16 2.17 Parental Controls [Information] ................................ ................................ ................................ ........... 16 2.18 [North American, European, and Australian Versions] License Display of Licensee Titles [Required] ...... 17 2.19 Using Firmware of Specified Versions [Required ] ................................ ................................ .............. 17 2.20 Time Restriction when Screen Is in Static State [Required] ................................ ................................ 17 2.21 Terminology and Image Specifications ................................ ................................ ............................... 18 2.21.1 Standardized Terminology [Required] ................................ ................................ ......................... 18 2.21.2 Restrictions on Images Used Instead of Names [Recommended] ................................ ............. 18 2.22 Using the Time from the Wii System Clock ................................ ................................ ......................... 18 2.22.1 Procedure when Time of Wii System Clock Differs Greatly from Real Time [Required] ............. 18 2.22.2 Prompting a User to Check the Current Time [Recommended] ................................ .................. 18 3 Wii Game Discs and Drive ................................ ................................ ................................ .......................... 19 3.1 Prohibition on Drive Specification Dependency [Required] ................................ ................................ 19 3.2 Wii Game Disc Error Handling [Required] ................................ ................................ .......................... 19 2006 -2008 N intendo 3 RVL -06 -0132 -001 -P CONFIDENTIAL Released : May 2, 2008 Wii Programming Gui delines Revolution SDK 3.3 Prohibition of Sustained Continuous Non -Sequential Access [Required] ................................ .......... 19 3.4 [Multiple Disc Games Only] Independent Startup of All Discs [Required] ................................ .......... 20 3.5 Normal Operation after the Disc Drive Motor Is Shut Off From a Period of Inactivity [Required] [Deleted] ................................ ................................ ................................ ............................ 20 3.6 Display for Disc Drive Motor Shut Off From a Period of Inactivity [Recommended] [Deleted] .......... 20 3.7 Data Layout for Double Layer Disc ................................ ................................ ................................ .... 20 3.7.1 Avoid Disc Access Spanning Layer s [Required] ................................ ................................ ......... 20 3.7.2 Avoid Reading Data to Alternate Layers [Recommended] ................................ ......................... 20 3.8 Startup Disc Error Handling [Required] ................................ ................................ .............................. 21 3.9 Resetting and Shutting Down in Response to Fatal Errors [Required] ................................ .............. 21 3.10 Resetting and Shutting Down in Response to Disc Error s Other than Fatal Errors [Required] ......... 21 3.11 Message Display in Response to Fatal Errors [Required] ................................ ................................ 21 4 Sound ................................ ................................ ................................ ................................ ......................... 22 4.1 Applying Wii System Sound Settings [Required] ................................ ................................ ............... 22 4.2 Sound Setting on the Wii Console [Required] [Deleted] ................................ ................................ .... 22 4.3 Sound Output for Applications Supporting Multiple Sound Settings [Required] [Deleted] ................. 22 4.4 Do Not Modify the Audio Playback Frequency Within an Applic ation [Required] ............................... 22 5 Photosensitivity ................................ ................................ ................................ ................................ ........... 23 5.1 About Photosensitivity and These Guidelines [Information] ................................ ............................... 23 5.2 Restrictions on Flashing Images and Lights [Recommended] ................................ ........................... 24 5.3 Restrictions on Flashing Saturated Red Colors [Recommended] ................................ ...................... 25 5.4 Restrictions on Image Reversals [Recommended] ................................ ................................ ............ 25 5.5 Restrictions on Regular Patterns [Recommended] ................................ ................................ ............ 25 5.6 Screen Brightness Calculations [Information] ................................ ................................ .................... 26 6 Video ................................ ................................ ................................ ................................ ........................... 29 6.1 Display Within the Safe Frame [Recom mended] ................................ ................................ ............... 29 6.2 Video Settings [Information] [Deleted] ................................ ................................ ................................ 29 6.3 Support for Progressive Display [Recommended] ................................ ................................ ............. 29 6.4 Settings and Display when Progressive Display Is Supported [Required] ................................ ......... 29 6.5 Procedure for Switching from Progressive Display to Interlaced Di splay [Recommended] ............... 29 6.6 Addition of Interlaced/Progressive Switch Operation [Deleted] ...............................