3dbrew

Changes

SMDH (edit)

Revision as of 10:35, 31 December 2019

5,870 bytes added ,  10:35, 31 December 2019
m
→‎Application Titles: Grammar fix: space before opening parenthesis
Line 1: Line 1: −
This page describes the format of the icon stored at [[CXI]] ExeFS:/icon and [[CIA]] icons.
+
This page describes the format of the icon stored at [[NCCH#CXI|CXI]] ExeFS:/icon and [[CIA]] icons.
−
The size of icons is 0x36c0 bytes. The CXI icon is displayed by homemenu, while CIA icons are only displayed while selecting CIAs from SD card on a dev 3DS.
+
The size of icons are 0x36c0 bytes. The CXI icon is displayed by [[Home Menu]] and [[System Settings]](3DS Software Management), while [[CIA#Meta|CIA icons]] are dummies and not yet utilised by Dev 3DS' (as of rev 47586).
   −
=== Header ===
+
== Format ==
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
!  START
+
!  OFFSET
 
!  SIZE
 
!  SIZE
 
!  DESCRIPTION
 
!  DESCRIPTION
Line 15: Line 15:  
|-  
 
|-  
 
|  0x04
 
|  0x04
−
|  0x04
+
|  0x02
−
|  Reserved = 0
+
|  Version
 +
|-
 +
|  0x06
 +
|  0x02
 +
|  Reserved
 +
|-
 +
|  0x8
 +
|  0x2000
 +
|  16 application titles structs, each 0x200 bytes
 +
|-
 +
| 0x2008
 +
| 0x30
 +
| Application Settings
 +
|-
 +
| 0x2038
 +
| 0x8
 +
| Reserved
 +
|-
 +
| 0x2040
 +
| 0x1680
 +
| Icon graphics
 
|}
 
|}
−
This header is immediately followed by meta-data:
     −
=== Application Titles ===
+
== Application Titles ==
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 41: Line 60:  
|}
 
|}
   −
All encoded in UCS-2.
+
All encoded in UTF-16.
−
There's 11 app title struct blocks, each one for separate languages.
+
There are 16 app title structs (currently only 12 are used), each one for separate languages.
    
The languages by order of appearance:
 
The languages by order of appearance:
Line 52: Line 71:  
* 5th: Italian title name
 
* 5th: Italian title name
 
* 6th: Spanish title name
 
* 6th: Spanish title name
−
* 7th: Chinese title name
+
* 7th: Simplified Chinese title name
 
* 8th: Korean title name
 
* 8th: Korean title name
 
* 9th: Dutch title name
 
* 9th: Dutch title name
 
* 10th: Portuguese title name
 
* 10th: Portuguese title name
 
* 11th: Russian title name
 
* 11th: Russian title name
 +
* 12th: Traditional Chinese title name
 +
 +
== Application Settings ==
 +
 +
Most of these flags are only used by the [[Home Menu]]. All of these are represented in SMDH files in little endian. But when documented below, the tables represent values in big endian.
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
!  START
 +
!  SIZE
 +
!  DESCRIPTION
 +
|-
 +
|  0x2008
 +
|  0x10
 +
|  Region Specific Game Ratings (For use with Parental Controls)
 +
|-
 +
|  0x2018
 +
|  0x4
 +
|  Region Lockout
 +
|- 
 +
|  0x201C
 +
|  0xC
 +
|  Match Maker IDs (Online Play)
 +
|-   
 +
|  0x2028
 +
|  0x4
 +
|  Flags
 +
|-   
 +
|  0x202C
 +
|  0x2
 +
|  EULA Version
 +
|-   
 +
|  0x202E
 +
|  0x2
 +
|  Reserved
 +
|- 
 +
|  0x2030
 +
|  0x4
 +
|  'Optimal Animation Default Frame' (for BNR)
 +
|-   
 +
|  0x2034
 +
|  0x4
 +
|  CEC (StreetPass) ID (So the Home Menu knows which application icon to show the 'Green' CEC notification for)
 +
|}
 +
 +
=== Region Specific Game Age Ratings ===
 +
 +
These flags tell the 3DS the 'Age Rating' of the software for the below regions:
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
!  START
 +
!  SIZE
 +
!  DESCRIPTION
 +
|-
 +
|  0x2008
 +
|  0x1
 +
|  CERO (Japan)
 +
|-
 +
|  0x2009
 +
|  0x1
 +
|  ESRB (USA)
 +
|-
 +
|  0x200A
 +
|  0x1
 +
|  Reserved
 +
|-
 +
|  0x200B
 +
|  0x1
 +
|  USK (German)
 +
|-
 +
|  0x200C
 +
|  0x1
 +
|  PEGI GEN (Europe)
 +
|-
 +
|  0x200D
 +
|  0x1
 +
|  Reserved
 +
|-
 +
|  0x200E
 +
|  0x1
 +
|  PEGI PRT (Portugal)
 +
|-
 +
|  0x200F
 +
|  0x1
 +
|  PEGI BBFC (England)
 +
|-
 +
|  0x2010
 +
|  0x1
 +
|  COB (Australia)
 +
|-
 +
|  0x2011
 +
|  0x1
 +
|  GRB (South Korea)
 +
|-
 +
|  0x2012
 +
|  0x1
 +
|  CGSRR (Taiwan)
 +
|-
 +
|  0x2013
 +
|  0x1
 +
|  Reserved
 +
|-
 +
|  0x2014
 +
|  0x1
 +
|  Reserved
 +
|-
 +
|  0x2015
 +
|  0x1
 +
|  Reserved
 +
|-
 +
|  0x2016
 +
|  0x1
 +
|  Reserved
 +
|-
 +
|  0x2017
 +
|  0x1
 +
|  Reserved
 +
|}
   −
=== Icon graphics ===
+
Active ratings have a bitmask of 0x80, and inactive ratings have no bitmask at all. Ratings without the 0x80 bitmask are ignored. 0x40 bitmask indicates Rating Pending. 0x20 bitmask indicates No Age Restriction.
 +
Age limits are set by adding the minimal age to 0x80 (for example, limiting to 12 years and up would give a bitmask of 0x8C)
   −
At offset 0x2400, there are two icons:
+
=== Region Lockout ===
−
* Small - 24x24 (shown on top screen when pausing the app)  
+
 
−
* Large - 48x48 icon (the general icon)
+
This u32 flag is what the Home Menu uses to determine the [[Home Menu#Region Lockout|Region Lockout]] of a title.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
!  REGION
 +
!  BITMASK
 +
|-
 +
|  Japan
 +
|  0x01
 +
|-
 +
|  North America
 +
|  0x02
 +
|-
 +
|  Europe
 +
|  0x04
 +
|-
 +
|  Australia
 +
|  0x08
 +
|-
 +
|  China
 +
|  0x10
 +
|-
 +
|  Korea
 +
|  0x20
 +
|-
 +
|  Taiwan
 +
|  0x40
 +
|}
 +
 
 +
Regions are 'included' in region lock by setting their bitmask value. Nintendo defines region free as 0x7fffffff. Early in the 3DS' development, Nintendo grouped the Australian and Europe markets together. Nintendo defines market Europe as having the combined bitmasks of Europe and Australia. No 3DS' which check the Australia bitmask have been seen (Australia uses the European 3DS model).
 +
 
 +
=== Match Maker IDs ===
 +
 
 +
These IDs are an application's online gaming IDs.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
!  START
 +
!  SIZE
 +
!  DESCRIPTION
 +
|-
 +
|  0x201C
 +
|  0x4
 +
|  Match Maker ID
 +
|-
 +
|  0x2020
 +
|  0x8
 +
|  Match Maker BIT ID
 +
|}
 +
 
 +
=== Flags ===
 +
The u32 is used for storing flags as bit-masks.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
!  FLAG
 +
!  BITMASK VALUE
 +
|-
 +
|  Visibility Flag (Required for visibility on the Home Menu)
 +
|  0x0001
 +
|-
 +
|  [[Home Menu#Auto-Boot_Function|Auto-boot]] this gamecard title
 +
|  0x0002
 +
|-
 +
|  Allow use of 3D? (For use with parental Controls. An application can use the 3D affect, even when this flag isn't set)
 +
|  0x0004
 +
|-
 +
|  Require accepting CTR EULA before being launched by Home (see below)
 +
|  0x0008
 +
|-
 +
|  Autosave on exit? (see below)
 +
|  0x0010
 +
|-
 +
|  Uses an [[Extended Banner]]?
 +
|  0x0020
 +
|-
 +
|  [[SMDH#Region Specific Game Age Ratings|Region game rating]] required
 +
|  0x0040
 +
|-
 +
|  Uses save data? (see below)
 +
|  0x0080
 +
|-
 +
|  Application usage is to be recorded. If this is not set, it causes the application's usage to be omitted from the Home Menu's [[Home_Menu#Cache.dat & CacheD.dat|icon cache]], as well as in [[????????|other places]].
 +
|  0x0100
 +
|-
 +
|  Disables [[SD Savedata Backups]] for this title. This is in addition to [[NS CFA|the blacklist]].
 +
|  0x0400
 +
|-
 +
|  New 3DS exclusive title. Shows an error if used on Old 3DS.
 +
|  0x1000
 +
|}
 +
 
 +
====Effect of SaveData and AutoSave====
 +
 
 +
These options have no effect on the performance of the application itself: they're used to select an appropriate warning when closing an application from [[Home Menu|Home]].
 +
 
 +
* Both off: "Closing software" (no warning if quitting directly with X)
 +
* SaveData: "Do you want to close [...]? (Unsaved data will be lost.)"
 +
* AutoSave: ?
 +
* Both on:  "Saving data and closing software..." (no warning if quitting directly with X)
 +
 
 +
=== EULA Version ===
 +
This is the EULA version which is checked when the Accept EULA flag is set, the version is compared to one stored in the 3DS. If the SMDH version is greater, then the user will be prompted to accept the EULA.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
!  START
 +
!  SIZE
 +
!  DESCRIPTION
 +
|-
 +
|  0x202C
 +
|  0x01
 +
|  EULA Version Minor
 +
|-
 +
|  0x202D
 +
|  0x01
 +
|  EULA Version Major
 +
|}
 +
 
 +
=== 'Optimal Animation Default Frame' (for BNR) ===
 +
 
 +
This is a float, indicating the preferred (or 'most representative') frame for the banner animation.
 +
 
 +
=== CEC (StreetPass) ID ===
 +
 
 +
This u32 represents the application CEC ID. This is likely loaded by applications for use with the CEC services as well.
 +
 
 +
== Icon graphics ==
 +
 
 +
At offset 0x2040, there are two icons:
 +
{| class="wikitable" border="1"
 +
|-
 +
!  START
 +
!  SIZE
 +
!  DESCRIPTION
 +
|-
 +
|  0x2040
 +
|  0x480
 +
|  Small - 24x24 (shown on top screen when pausing the app)
 +
|-
 +
|  0x24C0
 +
|  0x1200
 +
|  Large - 48x48 icon (the general icon)
 +
|}
    
Both of the icons are encoded in RGB565 meaning 16bpp. Although both icons are known to be RGB565, developers have the option of encoding icons (and banners) with the following encodings :
 
Both of the icons are encoded in RGB565 meaning 16bpp. Although both icons are known to be RGB565, developers have the option of encoding icons (and banners) with the following encodings :
Line 80: Line 362:  
* ETC1A4
 
* ETC1A4
   −
This does not necessarily mean the other encodings will be used, it is just that those are the options when compiling. Like we've seen with Super Mario 3D Land Nintendo has changed save file encryption, and likewise they can encode icons and banners differently ''should they choose to''. Currently we've seen just RGB565 so don't be fooled if an icon doesn't show up right! It is probably one of these formats above. Although we will probably not see other formats used for a while it's nice to know they have an opportunity to change.
+
This does not necessarily mean the other encodings will be used, it is just that those are the options when compiling. Like we've seen with Super Mario 3D Land Nintendo has changed save file encryption, and likewise they can encode icons and banners differently ''should they choose to''. Currently we've seen just RGB565 so don't be fooled if an icon doesn't show up right! It is probably one of these formats above. Although we will probably not see other formats used for a while it's nice to know they have an opportunity to change. Also note that it seems Nintendo stores each pixel in [https://en.wikipedia.org/wiki/RGBA_color_space word-order], so the actual order of order of each color channel in memory will depend on the endianness.  
−
 
  −
There's a header of 0x40 bytes and then comes the raw data.
      
The data is encoded in tiles (starting from size 8x8, continuing recursively).
 
The data is encoded in tiles (starting from size 8x8, continuing recursively).
Line 143: Line 423:  
|-
 
|-
 
|}
 
|}
 +
 +
== Tools ==
 +
 +
[[CiTRUS]] - (GUI)(Windows Only) Generating ICN files
 +
 +
[[3DSExplorer]] - (GUI)(Windows Only) Parsing ICN files
Retrieved from "https://www.3dbrew.org/wiki/Special:MobileDiff/2786...21139"