SMDH - Revision history

Damariobros: /* Flags */ Added new restricted application flag not previously documented.

2025-06-10T21:56:57Z

Flags: Added new restricted application flag not previously documented.

← Older revision		Revision as of 01:56, 11 June 2025
Line 291:		Line 291:
	\| New 3DS exclusive title. Shows an error if used on Old 3DS.		\| New 3DS exclusive title. Shows an error if used on Old 3DS.
	\| 0x1000		\| 0x1000
			\|-
			\| Application is restricted by Parental Controls.
			\| 0x4000
	\|}		\|}

KevinBlue18: /* Application Titles */ Grammar fix: space before opening parenthesis

2019-12-31T07:35:49Z

Application Titles: Grammar fix: space before opening parenthesis

← Older revision		Revision as of 10:35, 31 December 2019
Line 61:		Line 61:

	All encoded in UTF-16.		All encoded in UTF-16.
	There are 16 app title structs(currently only 12 are used), 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:

KevinBlue18: Grammar fix

2019-12-31T07:19:34Z

Grammar fix

← Older revision		Revision as of 10:19, 31 December 2019
Line 1:		Line 1:
	This page describes the format of the icon stored at [[NCCH#CXI\|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 [[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).		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).

	== Format ==		== Format ==

Qyriad: /* Icon graphics */ Notes that Nintendo stores pixel data in word-order

2017-06-19T13:35:39Z

Icon graphics: Notes that Nintendo stores pixel data in word-order

← Older revision		Revision as of 17:35, 19 June 2017
Line 362:		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.

	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 423:		Line 423:
	\|-		\|-
	\|}		\|}


	== Tools ==		== Tools ==

Cruel: /* Flags */

2016-09-29T16:37:21Z

Flags

← Older revision		Revision as of 20:37, 29 September 2016
Line 262:		Line 262:
	\| 0x0001		\| 0x0001
	\|-		\|-
	\| [[Home Menu#Auto-~~Boot Kiosk Function~~\|Auto-boot]] this gamecard title		\| [[Home Menu#Auto-Boot_Function\|Auto-boot]] this gamecard title
	\| 0x0002		\| 0x0002
	\|-		\|-

Ihaveamac: /* Flags */ new 3ds exclusive bit

2016-08-15T22:14:36Z

Flags: new 3ds exclusive bit

← Older revision		Revision as of 02:14, 16 August 2016
Line 288:		Line 288:
	\| Disables [[SD Savedata Backups]] for this title. This is in addition to [[NS CFA\|the blacklist]].		\| Disables [[SD Savedata Backups]] for this title. This is in addition to [[NS CFA\|the blacklist]].
	\| 0x0400		\| 0x0400
			\|-
			\| New 3DS exclusive title. Shows an error if used on Old 3DS.
			\| 0x1000
	\|}		\|}

LiquidFenrir: /* Region Specific Game Age Ratings */

2016-06-24T11:39:29Z

Region Specific Game Age Ratings

← Older revision		Revision as of 15:39, 24 June 2016
Line 197:		Line 197:

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

	=== Region Lockout ===		=== Region Lockout ===

Ryccardo: /* Effect of SaveData and AutoSave */ explanation

2016-06-18T07:56:42Z

Effect of SaveData and AutoSave: explanation

← Older revision		Revision as of 11:56, 18 June 2016
Line 267:		Line 267:
	\| 0x0004		\| 0x0004
	\|-		\|-
	\| Require accepting CTR EULA(see below)		\| Require accepting CTR EULA before being launched by Home (see below)
	\| 0x0008		\| 0x0008
	\|-		\|-
	\| Autosave on exit?		\| Autosave on exit? (see below)
	\| 0x0010		\| 0x0010
	\|-		\|-
Line 279:		Line 279:
	\| 0x0040		\| 0x0040
	\|-		\|-
	\| Uses save data?		\| Uses save data? (see below)
	\| 0x0080		\| 0x0080
	\|-		\|-
Line 285:		Line 285:
	\| 0x0100		\| 0x0100
	\|-		\|-
	\| Disables [[SD Savedata Backups]] for this title.		\| Disables [[SD Savedata Backups]] for this title. This is in addition to [[NS CFA\|the blacklist]].
	\| 0x0400		\| 0x0400
	\|}		\|}

			====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 ===		=== EULA Version ===

MarioErmando: /* Region Specific Game Age Ratings */

2015-10-17T09:34:44Z

Region Specific Game Age Ratings

← Older revision		Revision as of 13:34, 17 October 2015
Line 173:		Line 173:
	\| 0x2012		\| 0x2012
	\| 0x1		\| 0x1
	\| CGSRR (~~China~~)		\| CGSRR (Taiwan)
	\|-		\|-
	\| 0x2013		\| 0x2013

3dsguy at 02:59, 22 March 2014

2014-03-22T01:59:54Z

← Older revision		Revision as of 04:59, 22 March 2014
Line 200:		Line 200:
	=== Region Lockout ===		=== Region Lockout ===

	This flag is what the Home Menu uses ~~in order~~ to determine the [[Home Menu#Region Lockout\|Region Lockout]] of a title~~. These are bitmask flags. Byte[0] is currently the only byte used, the rest are reserved~~.		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"		{\| class="wikitable" border="1"
Line 229:		Line 229:
	\|}		\|}

	~~As these~~ are bitmask ~~flags~~, ~~multiple regions can be 'allowed' access to a title if~~ Nintendo ~~chose~~. Nintendo ~~decided to group~~ Europe and Australia ~~together, with European games including both bitmasks~~. ~~Though at time of writing, Nintendo has not released any~~ 3DS' which ~~actually~~ check the ~~Australian region lock~~ bitmask~~. A "Region Free" title would~~ have ~~each byte = 0xff.~~ (~~For reference,~~ the ~~Nintendo's implementation of "region free", has bytes[0-2] = 0xff, and byte[3] = 0x7f~~)		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 ===		=== Match Maker IDs ===
Line 251:		Line 251:

	=== Flags ===		=== Flags ===
	~~These are a collection of~~ bit-~~mask flags~~.		The u32 is used for storing flags as bit-masks.

	~~{\| class="wikitable" border="1"~~
	\|-
	~~! INDEX~~
	~~! DESCRIPTION~~
	\|-
	~~\| 0~~
	~~\| See Below~~
	\|-
	~~\| 1~~
	~~\| See Below~~
	\|-
	~~\| 2~~
	~~\| Unused~~
	\|-
	~~\| 3~~
	~~\| Unused~~
	\|}

	~~==== Byte[0] ====~~
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 278:		Line 259:
	\|-		\|-
	\| Visibility Flag (Required for visibility on the Home Menu)		\| Visibility Flag (Required for visibility on the Home Menu)
	\| ~~0x01~~		\| 0x0001
	\|-		\|-
	\| [[Home Menu#Auto-Boot Kiosk Function\|Auto-boot]] this gamecard title		\| [[Home Menu#Auto-Boot Kiosk Function\|Auto-boot]] this gamecard title
	\| ~~0x02~~		\| 0x0002
	\|-		\|-
	\| Allow use of 3D? (For use with parental Controls. An application can use the 3D affect, even when this flag isn't set)		\| Allow use of 3D? (For use with parental Controls. An application can use the 3D affect, even when this flag isn't set)
	\| ~~0x04~~		\| 0x0004
	\|-		\|-
	\| Require accepting CTR EULA(see below)		\| Require accepting CTR EULA(see below)
	\| ~~0x08~~		\| 0x0008
	\|-		\|-
	\| Autosave on exit?		\| Autosave on exit?
	\| ~~0x10~~		\| 0x0010
	\|-		\|-
	\| Uses an [[Extended Banner]]?		\| Uses an [[Extended Banner]]?
	\| ~~0x20~~		\| 0x0020
	\|-		\|-
	\| [[SMDH#Region Specific Game Age Ratings\|Region game rating]] required		\| [[SMDH#Region Specific Game Age Ratings\|Region game rating]] required
	\| ~~0x40~~		\| 0x0040
	\|-		\|-
	\| Uses save data?		\| Uses save data?
	\| ~~0x80~~		\| 0x0080
	\|}

	~~==== Byte[1] ====~~
	~~{\| class="wikitable" border="1"~~
	\|-
	~~! FLAG~~
	~~! BITMASK VALUE~~
	\|-		\|-
	\| 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]].		\| 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]].
	\| ~~0x01~~		\| 0x0100
	\|-
	~~\| ?~~
	~~\| 0x02~~
	\|-		\|-
	\| Disables [[SD Savedata Backups]] for this title.		\| Disables [[SD Savedata Backups]] for this title.
	\| ~~0x04~~		\| 0x0400
	\|}		\|}

Line 338:		Line 309:
	=== 'Optimal Animation Default Frame' (for BNR) ===		=== 'Optimal Animation Default Frame' (for BNR) ===

	~~Purpose of this flag: If using an animated BNR~~, it'~~s the~~ most representative frame for the animation.		This is a float, indicating the preferred (or 'most representative') frame for the banner animation.

	~~This value is generated by taking an input value(default BNR frame) as a float, then representing it a hexadecimal array~~.

	=== CEC (StreetPass) ID ===		=== CEC (StreetPass) ID ===
Line 381:		Line 350:

	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.

	~~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).