Editing XMB Layouts

{{wikify}}
=Description=
This files contains a list of numeric values that seems to define the positions, sizes, etc of most/all the items displayed in XMB. Are divided in 4 resolution modes by its heigths: (272, 480, 720, 1080), and its types: (factor, and grid). Factor ones contains less values and seems to be derivated from Grid ones (grid ones are much bigger).

Some of the values seems to be related with the [http://manuals.playstation.net/document/en/ps3/current/settings/videooutput.html video resolution/settings]
{{XMB Layout Tables}}

*The values at grid lines 8 & 9 are loaded by the object '''ps3logo_back_color''' that belongs to '''page_gameboot''' from inside '''[[gamelib_plugin]].rco'''. Are the '''sizeX''' and '''sizeY''' of a full screen plane recolored to pure black

=Versions=
*Hash reports:
**All tables combined (220 variants) [https://www.mirrorcreator.com/files/4LMFEPEY/tableHASHreport.7z_links download]
**All grid tables combined (157 variants) [https://www.mirrorcreator.com/files/1H1MNZIV/tablegridHASHreport.7z_links download]
**All factor tables combined (63 variants) [https://www.mirrorcreator.com/files/3IMROTWL/tablefactorHASHreport.7z_links download]

==Grid==
{{layout_grid_tables}}

==Factor==
{{layout_factor_tables}}

=RCO override attributes=
'''All "Override" attributes are pointers to a value stored in a line of [[XMB Layouts]] .txt files, the override indicates the line number in the .txt and the value in that line is loaded by the .rco
**Some values used by [[RCOXML Objects]] are loaded externally to be able to scale the whole XMB interface for different screen resolution modes. Sony was adding more stuff in the XMB along the different firmware versions, and some of this "new" items used this same method, the result is more "override" values was added to the [[XMB Layouts]] .txt files, and as a consequence some of the other "old" values was "displaced" a few lines down in the [[XMB Layouts]] .txt files. This is the reason why in the changelog of custom_render_plugin.rco (and i bet most of the others .rco's using overrides) the value increases just a few units for every new version of the .rco (that units are a few lines that was added for that firmware in the .txt)
**The reason why the new values added in the .txt displaces the old values... is because the list of values inside the .txt are ordered "by rco ownership". First are stored all the values for rco nº1... then all the values for rco nº2... and so on... obviouslly custom_render_plugin is not at top of the list because it stores his values around line 500. It has other values from other rco's before it and when that others had some addition this made the values of custom_render_plugins to be displaced some lines down in the list
***I have no idea wich position in the [[XMB Layouts]] .txt files uses every .rco probably are ordered by using one of the lists from a .sprx or vsh.self... or maybe the order depends of the compilation enviroment sony uses for the official firmware

Usually the values from a specific .rco file are stored consecutivelly. But other values could be loaded by several .rco files (as example, the position of ICON0.PNG is used by several firmware functions, every .rco associated with this functions could load the position from the same value, this allows for some coherence when designing XMB and to modify several display settings from different functions by a single change)

*There are 122 .rco files in firmware 4.76, the order of how are stored here the groups of values for every .rco is not clear, some posible options:
**Based in a identifyer from the associated module.srpx
**Based on a list in vsh.self
**Alphabetical order
**Based on a "messed up because suffered lot of changes" script used in the official compilation enviroment for PS3 firmware. In other words, the firmware doesnt cares and doesnt knows about the order and simply loads individual values after reading the position from the .rco file

{{custom_render_plugin.rco changelog}}
**It seems the values stored in the [[XMB Layouts]] .txt files for custom_render_plugin.rco never changed (verifyed only in 2.00, 3.55, 4.46, 4.70), below are the real values, taken from  layout_grid_table_1080.txt (for other resolutions the values are different)
***'''scelogo''' plane
****stdOverridePositionX = 400 pixels
****stdOverridePositionY = 0 pixels
****stdOverrideSizeX = 1024 pixels
****stdOverrideSizeY = 64 pixels
***'''ps3logo''' plane
****stdOverrideSizeX = 1200 pixels
****stdOverrideSizeY = 128 pixels

==Example==
In firmware 4.76 custom_render_plugin.rco contains 3 '''plane''' [[RCOXML Objects]] using the 21 standard attributes and 2 specific attributes:
*Page object '''page_coldboot''' - is the old/classic coldboot from firmware 1.00 used when the console boots
**Plane object '''scelogo''' - is an image of 512x32 pixels size. Uses grid pointers
*Page object '''page_coldboot2''' - is the new coldboot introduced in firmware 2.70
**Plane object '''coldboot_ps3logo''' - is a placeholder for the [[coldboot.raf]] animation. Doesnt uses grid pointers
*Page object '''page_gameboot''' - used when a game boots
**Plane object '''ps3logo''' - is an image of 512x54 pixels size. Uses grid pointers
{{spoiler|custom_render_plugin.rco.xml (cropped)|
{{Boxcode|content=<syntaxhighlight lang="xml">
<RcoFile>
	<MainTree>
		<ObjectTree>
			<Page name="page_coldboot" pageMode="0x1110000" pageOnInit="nothing" pageOnCancel="nothing" pageOnContext="nothing" pageOnActivate="nothing">
				<Plane name="scelogo" stdPositionX="0" stdPositionY="0" stdPositionZ="0" stdColorScaleR="1" stdColorScaleG="1" stdColorScaleB="1" stdColorScaleA="1" stdSizeX="0" stdSizeY="0" stdSizeZ="0" stdSizeScaleX="1" stdSizeScaleY="1" stdSizeScaleZ="1" stdAnchorPointMode="0x0" stdOnInit="nothing" stdOverridePositionX="0x98020000" stdOverridePositionY="0x99020000" stdOverridePositionZ="0x0" stdOverrideSizeX="0x9a020100" stdOverrideSizeY="0x9b020100" stdOverrideSizeZ="0x100" planeImage="image:tex_scelogo" planeResizeMode="0x0"></Plane>
			</Page>
			<Page name="page_coldboot2" pageMode="0x1110000" pageOnInit="nothing" pageOnCancel="nothing" pageOnContext="nothing" pageOnActivate="nothing">
				<Plane name="coldboot_ps3logo" stdPositionX="0" stdPositionY="0" stdPositionZ="0" stdColorScaleR="1" stdColorScaleG="1" stdColorScaleB="1" stdColorScaleA="1" stdSizeX="0" stdSizeY="0" stdSizeZ="0" stdSizeScaleX="1" stdSizeScaleY="1" stdSizeScaleZ="1" stdAnchorPointMode="0x0" stdOnInit="nothing" stdOverridePositionX="0x0" stdOverridePositionY="0x0" stdOverridePositionZ="0x0" stdOverrideSizeX="0x100" stdOverrideSizeY="0x100" stdOverrideSizeZ="0x100" planeImage="nothing" planeResizeMode="0x0"></Plane>
			</Page>
			<Page name="page_gameboot" pageMode="0x1110000" pageOnInit="nothing" pageOnCancel="nothing" pageOnContext="nothing" pageOnActivate="nothing">
				<Plane name="ps3logo" stdPositionX="0" stdPositionY="0" stdPositionZ="0" stdColorScaleR="1" stdColorScaleG="1" stdColorScaleB="1" stdColorScaleA="1" stdSizeX="0" stdSizeY="0" stdSizeZ="0" stdSizeScaleX="1" stdSizeScaleY="1" stdSizeScaleZ="1" stdAnchorPointMode="0x0" stdOnInit="nothing" stdOverridePositionX="0x0" stdOverridePositionY="0x0" stdOverridePositionZ="0x0" stdOverrideSizeX="0x9c020100" stdOverrideSizeY="0x9d020100" stdOverrideSizeZ="0x100" planeImage="image:tex_ps3logo" planeResizeMode="0x0"></Plane>
			</Page>
		</ObjectTree>
	</MainTree>
</RcoFile>
</syntaxhighlight>}}
}}

This is the same code, using linefeeds and tabs for a better overview of the attributes
{{Boxcode|content=<syntaxhighlight lang="xml">
<RcoFile>
	<MainTree>
		<ObjectTree>
			<Page name="page_coldboot" pageMode="0x1110000" pageOnInit="nothing" pageOnCancel="nothing" pageOnContext="nothing" pageOnActivate="nothing">
				<Plane name="scelogo"
					stdPositionX="0" stdPositionY="0" stdPositionZ="0"
					stdColorScaleR="1" stdColorScaleG="1" stdColorScaleB="1" stdColorScaleA="1"
					stdSizeX="0" stdSizeY="0" stdSizeZ="0"
					stdSizeScaleX="1" stdSizeScaleY="1" stdSizeScaleZ="1"
					stdAnchorPointMode="0x0"
					stdOnInit="nothing"
					stdOverridePositionX="0x98020000" stdOverridePositionY="0x99020000" stdOverridePositionZ="0x0"
					stdOverrideSizeX="0x9a020100" stdOverrideSizeY="0x9b020100" stdOverrideSizeZ="0x100"

					planeImage="image:tex_scelogo"
					planeResizeMode="0x0"
					>
				</Plane>
			</Page>
			<Page name="page_coldboot2" pageMode="0x1110000" pageOnInit="nothing" pageOnCancel="nothing" pageOnContext="nothing" pageOnActivate="nothing">
				<Plane name="coldboot_ps3logo"
					stdPositionX="0" stdPositionY="0" stdPositionZ="0"
					stdColorScaleR="1" stdColorScaleG="1" stdColorScaleB="1" stdColorScaleA="1"
					stdSizeX="0" stdSizeY="0" stdSizeZ="0"
					stdSizeScaleX="1" stdSizeScaleY="1" stdSizeScaleZ="1"
					stdAnchorPointMode="0x0"
					stdOnInit="nothing"
					stdOverridePositionX="0x0" stdOverridePositionY="0x0" stdOverridePositionZ="0x0"
					stdOverrideSizeX="0x100" stdOverrideSizeY="0x100" stdOverrideSizeZ="0x100"

					planeImage="nothing"
					planeResizeMode="0x0"
					>
				</Plane>
			</Page>
			<Page name="page_gameboot" pageMode="0x1110000" pageOnInit="nothing" pageOnCancel="nothing" pageOnContext="nothing" pageOnActivate="nothing">
				<Plane name="ps3logo"
					stdPositionX="0" stdPositionY="0" stdPositionZ="0"
					stdColorScaleR="1" stdColorScaleG="1" stdColorScaleB="1" stdColorScaleA="1"
					stdSizeX="0" stdSizeY="0" stdSizeZ="0"
					stdSizeScaleX="1" stdSizeScaleY="1" stdSizeScaleZ="1"
					stdAnchorPointMode="0x0"
					stdOnInit="nothing"
					stdOverridePositionX="0x0" stdOverridePositionY="0x0" stdOverridePositionZ="0x0"
					stdOverrideSizeX="0x9c020100" stdOverrideSizeY="0x9d020100" stdOverrideSizeZ="0x100"

					planeImage="image:tex_ps3logo"
					planeResizeMode="0x0"
					>
				</Plane>
			</Page>
		</ObjectTree>
	</MainTree>
</RcoFile>
</syntaxhighlight>}}
As a resume:

*'''page_coldboot'''
**'''scelogo'''
***stdPositionX="0" stdPositionY="0" stdPositionZ="0" <------------------------------------------------------------------------ positions are empty !
***stdSizeX="0" stdSizeY="0" stdSizeZ="0" <-------------------------------------------------------------------------------------- sizes are empty !
***stdOverridePositionX="0x98020000" stdOverridePositionY="0x99020000" stdOverridePositionZ="0x0" <------- grid pointers, overrides the values of attributes '''stdPositionX''' and '''stdPositionY'''
***stdOverrideSizeX="0x9a020100" stdOverrideSizeY="0x9b020100" stdOverrideSizeZ="0x100" <------------------- grid pointers, overrides the values of attributes '''stdSizeX''' and '''stdSizeY'''

*'''page_coldboot2'''
**'''coldboot_ps3logo'''
***stdPositionX="0" stdPositionY="0" stdPositionZ="0" <------------------------------------------------------------------------ positions are empty !
***stdSizeX="0" stdSizeY="0" stdSizeZ="0" <-------------------------------------------------------------------------------------- sizes are empty !
***stdOverridePositionX="0x0" stdOverridePositionY="0x0" stdOverridePositionZ="0x0" <------------------------------ override positions are empty !
***stdOverrideSizeX="0x100" stdOverrideSizeY="0x100" stdOverrideSizeZ="0x100" <----------------------------------- override sizes are empty !

*'''page_gameboot'''
**'''ps3logo'''
***stdPositionX="0" stdPositionY="0" stdPositionZ="0" <------------------------------------------------------------------------ positions are empty !
***stdSizeX="0" stdSizeY="0" stdSizeZ="0" <-------------------------------------------------------------------------------------- sizes are empty !
***stdOverridePositionX="0x0" stdOverridePositionY="0x0" stdOverridePositionZ="0x0" <------------------------------ override positions are empty !
***stdOverrideSizeX="0x9c020100" stdOverrideSizeY="0x9d020100" stdOverrideSizeZ="0x100" <------------------- grid pointers, overrides the values of attributes '''stdSizeX''' and '''stdSizeY'''

----
Before calculating the grid pointers is needed to convert the values manually to the correct format. Every one of the attributes used for grid pointers is composed by 2 values, the first one is the grid pointer itself (first 2 bytes), and the second one is unknown (last 2 bytes). Is needed to cut the attribute at half and swap the bytes

*'''scelogo''' grid pointers
**position
***stdOverridePositionX="0x98020000" <----------- this is 0x0'''298''' (grid pointer) and 0x0000 (unknown)
***stdOverridePositionY="0x99020000" <----------- this is 0x0'''299''' (grid pointer) and 0x0000 (unknown)
***stdOverridePositionZ="0x0" <---------------------- this is 0x0000 (not a grid pointer) and 0x0000 (unknown)
**size
***stdOverrideSizeX="0x9a020100" <----------- this is 0x0'''29a''' (grid pointer) and 0x000'''1''' (unknown)
***stdOverrideSizeY="0x9b020100" <----------- this is 0x0'''29b''' (grid pointer) and 0x000'''1''' (unknown)
***stdOverrideSizeZ="0x100" <------------------- this is 0x0000 (not a grid pointer) and 0x000'''1''' (unknown)

*'''ps3logo''' grid pointers
**size
***stdOverrideSizeX="0x9c020100" <----------- this is 0x0'''29c''' (grid pointer) and 0x000'''1''' (unknown)
***stdOverrideSizeY="0x9d020100" <----------- this is 0x0'''29d''' (grid pointer) and 0x000'''1''' (unknown)
***stdOverrideSizeZ="0x100" <------------------- this is 0x0000 (not a grid pointer) and 0x000'''1''' (unknown)

----
Now to get the correct value from the grid pointers is needed to look at the [[XMB Layouts]] files '''from the same firmware !!!'''

The grid pointer value needs to be converted to decimal, and added a +1 (because the first value posible is 0, must match with the first line in a .txt file that is 1)

*'''scelogo''' grid pointers
**position
***stdOverridePositionX="0x98020000" <----------- the first 2 bytes 0x0'''298''' swapped and converted to decimal = 664 + 1 = '''line 665''' of [[XMB Layouts]] files
***stdOverridePositionY="0x99020000" <----------- the first 2 bytes 0x0'''299''' swapped and converted to decimal = 665 + 1 = '''line 666''' of [[XMB Layouts]] files
**size
***stdOverrideSizeX="0x9a020100" <----------- the first 2 bytes 0x0'''29a''' swapped and converted to decimal = 666 + 1 = '''line 667''' of [[XMB Layouts]] files
***stdOverrideSizeY="0x9b020100" <----------- the first 2 bytes 0x0'''29b''' swapped and converted to decimal = 667 + 1 = '''line 668''' of [[XMB Layouts]] files

*'''ps3logo''' grid pointers
**size
***stdOverrideSizeX="0x9c020100" <----------- the first 2 bytes 0x0'''29c''' swapped and converted to decimal = 668 + 1 = '''line 669''' of [[XMB Layouts]] files
***stdOverrideSizeY="0x9d020100" <----------- the first 2 bytes 0x0'''29d''' swapped and converted to decimal = 669 + 1 = '''line 670''' of [[XMB Layouts]] files

{| class="wikitable" style="font-size:small;"
|+ [[XMB]] Layout grid tables (from 4.76 firmware)
! Line number !! layout_grid_table_272.txt !! layout_grid_table_480.txt !! layout_grid_table_720.txt !! layout_grid_table_1080.txt
|-
! 665
| 177 || 133 || 266 || 400
|-
! 666
| 0 || 0 || 0 || 0
|-
! 667
| 455 || 455 || 682 || 1024
|-
! 668
| 28 || 28 || 42 || 64
|-
! 669
| 533 || 533 || 800 || 1200
|-
! 670
| 56 || 56 || 85 || 128
|-
|}

Now replacing the values from layout_grid_table_1080.txt to see how are displayed in a HD screen:

*'''page_coldboot'''
**'''scelogo''' for 1080p resolution
***position (displaced 400 pixels right from the center of the screen)
****X=400
****Y=0
****Z=0
***size (the original image tex_scelogo.gim is 512x32 pixels, but is displayed exactlly at double his size 1024x64)
****X=1024
****Y=64
****Z=0

*'''page_gameboot'''
**'''ps3logo''' for 1080p resolution
***position (center of the screen)
****X=0
****Y=0
****Z=0
***size (the original image tex_ps3logo.gim is 512x54 pixels, but displayed at 1200x128<!--aspect ratio broken (by a sony mistake or on purpose ?), the correct size to preserve the aspect ratio of the original after scaling is 1200x127-->)
****X=1200
****Y=128
****Z=0

{| class="wikitable"
|-
| {{#ev:youtube|tgPXlMbchFM}} || {{#ev:youtube|GUb1gIKhwMU}}
|}

{{File Formats}}<noinclude>[[Category:Main]]</noinclude>