Wii Programming Guidelines
Total Page:16
File Type:pdf, Size:1020Kb
Wii Programming Guidelines Ver sion : 1.14 2009/ 07/01 The content of this document is highly confidential and should be handled accordingly. 2006 -2009 N intendo RVL -06 -0132 -001 -V CONFIDENTIAL Released : August 18, 2009 Revolution SDK Wii Programming Guidelines Confidential These coded instructions, statements, and computer programs contain proprieta ry information of Nintendo and/or its licensed developers a nd are protected by national and international copyright law s. They may not be disclosed to third parties or copied or duplicated in any form, in whole or in part, without the prior written consent of Nintendo. RVL -06 -0132 -001 -V 2 2006 -2009 N intendo Released : August 18, 2009 CONFIDENTIAL Wii Programming Guidelines Revolution SDK Table of Contents 1 Overview ................................ ................................ ................................ ................................ ..................... 13 1.1 Level of Importance ................................ ................................ ................................ ............................ 13 1.2 Wii Programming Guidelines Note ................................ ................................ ................................ ...... 13 1.3 Do Not Use Wii Development and SDK Files on Other Platforms ................................ ...................... 13 1.4 Items Warranting Special Mention ................................ ................................ ................................ ...... 13 2 All ................................ ................................ ................................ ................................ ................................ 14 2.1 Prohibition of Dependency on Device Specifications [Required] ................................ ........................ 14 2.2 Memory and Register Initialization [Required] ................................ ................................ .................... 14 2.3 Startup Time Restriction [Recommended] ................................ ................................ .......................... 14 2.4 Startup Disc Error Handling [Required] [Deleted] ................................ ................................ ............... 14 2.5 Compliance with Legal Rights Display [Required] ................................ ................................ .............. 14 2.6 Using the Latest Packages [Recommended] ................................ ................................ ...................... 15 2.7 Removal of Debug Information [Requir ed] ................................ ................................ ......................... 15 2.8 Prohibition of Device Access Without the Use of a Library [Required] ................................ ............... 15 2.9 Prohibition of Development Support Librar ies in the Release Version [Required] ............................. 15 2.10 Guaranteeing Extended Operation of the Application [Required] ................................ ....................... 15 2.11 Integrating Banners, Comments, and Icons [Information] [Deleted] ................................ ................... 15 2.12 Application of Wii System Settings [Required] ................................ ................................ .................... 16 2.13 Prohibition o f Health and Safety Warning Display by Applications [Required] ................................ ... 16 2.14 Display at Application Startup [Information] [Deleted] ................................ ................................ ......... 16 2.15 [North American Version Only] Displaying the ESRB Online Rating Notice for Applications Using Network Features [Required] ................................ ................................ ................................ .............. 16 2.16 Program Distribution Method [Required] ................................ ................................ ............................ 17 2.17 Parental Controls [Information] ................................ ................................ ................................ ........... 17 2.18 [North American, European, Australian, and Korean Versions] License Display of Licensee Titles [Required] ................................ ................................ ................................ ................................ ............ 17 2.19 Using Firmware of Specified Versions [Required] ................................ ................................ .............. 18 2.20 Time Restriction When Screen Is in Static State [Requ ired] ................................ ............................... 18 2.21 Terminology and Image Specifications ................................ ................................ ............................... 19 2.21.1 Standardized Terminology [Required] ................................ ................................ ......................... 19 2.21.2 Restrictions on Images Used Instead of Names ................................ ................................ ......... 19 2.22 Using the Time from the Wii System Clock ................................ ................................ ......................... 20 2.22.1 Procedure When Time of Wii System Clock Differs Greatly from Real Time [Required] ............ 20 2.22.2 Prompting a User to Check the Current Time [Recommended] ................................ .................. 20 3 Wii Game Discs and Drive ................................ ................................ ................................ .......................... 21 2006 -200 9 N intendo 3 RVL -06 -0132 -001 -V CONFIDENTIAL Released : August 18, 2009 Revolution SDK Wii Programming Guidelines 3.1 Prohibition on Drive Specification Dependency [Required] ................................ ................................ 21 3.2 Wii Game Disc Error Handling [Required] ................................ ................................ .......................... 21 3.3 Prohibition of Sustained Continuous Non -Sequential Access [Required] ................................ .......... 21 3.4 [Multiple -Disc Games Only] Independent Startup of All Discs [Required] ................................ .......... 22 3.5 Normal Operation After the Disc Drive Motor Is Shut Off from a Period of Inactivity [Required] [Deleted] ................................ ................................ ................................ ................................ ............. 22 3.6 Display for Disc Drive Motor Shut Off from a Period of Inactivity [Recommended] [Deleted] ............ 22 3.7 Data Layout for Double -Layer Disc ................................ ................................ ................................ .... 22 3.7.1 Avoid Disc Access Spanning Layers [Required] ................................ ................................ ......... 22 3.7.2 Avoid Reading Data to Alternate Layers [Recommended] ................................ ......................... 22 3.8 Startup Disc Error Handling [Required] ................................ ................................ .............................. 23 3.9 Resetting and Shutting Down in Response to Fatal Errors [Required] ................................ .............. 23 3.10 Resetting and Shutting Down in Response to Disc Errors Other than Fatal Errors [Required] ......... 23 3.11 Message Display in Response to F atal Errors [Required] ................................ ................................ 23 3.12 Prohibiting Disc Access Using the CNT Library in the Release Version [Required] .......................... 23 4 Sound ................................ ................................ ................................ ................................ ......................... 24 4.1 Applying Wii System Sound Settings [Required] ................................ ................................ ............... 24 4.2 Sound Setting on the Wii Console [Required] [Deleted] ................................ ................................ .... 24 4.3 Sound Output for Applications Supporting Multiple Sound Settings [Required] [Deleted] ................. 24 4.4 Do Not Modify the Audio Playback Frequency Withi n an Application [Required] ............................... 24 4.5 Considerations for the User’s Sound Output Environment [Information] ................................ ........... 24 5 Photosensitivity ................................ ................................ ................................ ................................ ........... 25 5.1 About Photosensitivity and These Guidelines [Information] ................................ ............................... 25 5.2 Restrictions on Flashing Images and Lights [Recommended] ................................ ........................... 26 5.3 Restrictions on Flashing Saturated Red Colors [Recommended] ................................ ...................... 27 5.4 Restrictions on Image Reversals [Recommended] ................................ ................................ ............ 27 5.5 Restrictions on Regular Patterns [Recommended] ................................ ................................ ............ 27 5.6 Screen Brightness Calculations [Information] ................................ ................................ .................... 28 6 Video ................................ ................................ ................................ ................................ ........................... 31 6.1 Display Within the Safe Frame [Recommended] ................................ ................................ ............... 31