Editing RCOXML Objects

=Description=

'''RCOXML Objects''' are defined in the [[RCOXML Coding]] code embedded inside [[Resource Container (RCO)]] files, should be considered the "construction blocks" of the [[XMB]]

=General concepts=

The grid is a 3D scene defined by the X, Y, Z axis, the camera (TV screen frame) is located in the vertical of Z axis, the world coordinates is located in the center of the screen (0, 0, 0)

<gallery>

File:PSP screen coordinates.jpg|PSP screen coordinates

File:PSP screen coordinates (RCOXML objects overlay).png|PSP screen coordinates (example of objects overlay)

</gallery>

==Override attributes==

The .rco format is inherited from PSP, but PSP only used 1 screen resolution so this feature of the .rco format was not used in PSP, is specific for PS3

*For a better understanding is posible to difference two groups of attributes based in how are used by the objects

**'''Standard attributes''' are used by all the objects except the main '''Page''', some menu builders ('''XMList, XItem, MItem, LItem, IItem'''), and '''CheckboxItem'''

}}

==Measure units and conversions==

But for wiki purposes (better understanding of what every object does, and for comparison of objects) is better to order them in a different way based in his purpose, however in this wiki page appears the object name and his ID... as example, the object '''Page''' has '''0x01''' ID

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}

|-

|-

|-

|-

|-

|}

*'''pageMode''' speculation

**Related with firmware/vsh/sprx execution/loading/visibility modes ?...

**The data type has been changed to "unk" to allow a raw extraction of the value (that looks like flags)

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}

A '''plane''' is the second most important object, it can be located inmediatlly under a '''page''' (and also in lower levels of the hierarchy, as example: a '''plane''' inside a '''group''', inside another '''plane''', inside a '''page''')

The only other object that can be located inmediatlly under a '''page''' is a '''group'''. In this sense a '''plane''' and a '''group''' are similar, the bigger difference is a '''plane''' uses "standard object attributes" + "specific object attributes" and a '''group''' only uses "specific object attributes"

|-

|-

|}

{| class="wikitable" border="1"

*This attribute seems to use the same format and valid values than:

**Others ?

-->

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|}

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|}

|-

|-{{cellcolors|#DD6666}}

|-

|-

|-

|-

|-

|-

|-

|}

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}

|-

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

|-

|}

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}

|-

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

|-

|-

|-

|}

|-

|-

|-{{cellcolors|#DD6666}}

|-

|-{{cellcolors|#DD6666}}

|-

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|}

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}

| mitemTextOrImage1 || ref || {{yes}} || {{yes}} || text:msg_latin2_852<br>image:tex_vc_mpeg2 ||  || weird, in videoeditor_plugin.rco is an image (used 5 times), but in the others is a text (used 1053 times), or "nothing" (used 68 times)

|-

|-

|}

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}

{| class="wikitable"

! colspan="5" | Attribute !! rowspan="2" | How it works

|-

! Name !! Type !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Examples

|-

|-

|-{{cellcolors|#DD6666}}

|}

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}

Some of the "specific object attributes" from text seems to be similar than the "standard object attributes" (color scalers)

{| class="wikitable"

|+specific attributes for Text

| textMessage || text || {{yes}} || {{yes}} || text:msg_pw_changed || Loads a text from [[RCOXML Texts|TextTree]]

|-

|-{{cellcolors|#DD6666}}

|-

|-

| textTopColorScaleR || float || {{yes}} || {{yes}} || 1 || rowspan="3" | Text top, color channels scaler (scale 0-1), values found in PS3 4.76 ofw: "0", "0.5", "1"

| textBottomColorScaleB || float || {{yes}} || {{yes}} || 0.5

|-

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

| textShadowOffsetX || float || {{yes}} || {{yes}} || 4 || rowspan="3" | Text shadow effect displacement, in pixels, values found in PS3 4.76 ofw: "0", "4", "-5"

| textShadowColorScaleA || float || {{yes}} || {{yes}} || 1

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|}

*PS3 texts has a "tilt" effect that increases and decreases the light reflect every 2 seconds or so... probably this tilt effect is defined by one of the "unknowns", and/or maybe the 7 unknowns labeled as "focus" are actually the "shining glow effects" (offset, and color scaler)

**{{icon content ps3|50px}} Used 1305 times in PS3 4.76 ofw with values:

***"0x1000000" (351 times)

**{{icon content psp|50px}} Used 1357 times in PSP 6.61 ofw with values: "0xffffffff" (600 times), "0x0" (757 times)

{| class="wikitable"

|-

! Name !! Type !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Examples

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

|-

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

|-

|-

|-

|-

|-

|-

|-

|}

{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}

{| class="wikitable"

! colspan="5" | Attribute !! rowspan="2" | How it works

|-

! Name !! Type !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Examples

|-

|-

|-

|-

|-