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

**Some of the values in the tables in frontpage (in the red marked rows as speculative) was dumped by rcomage as type "unk" but are "floats", for this reason rcomage didnt made the float-to-decimal conversion and appears as a hexidecimal value with the endianess swapped (bytes reversed) and the starting zeroes removed. To make the decimal conversion you can use this web http://www.h-schmidt.net/FloatConverter/IEEE754.html Example, a value '''0xa0c0''' was extracted by using the type "unk". After changing endianess manually the value is '''0xc0a00000'''. And after the decimal conversion the result is '''-5'''

Every one of this objects is given an ID number when the RCO is created, the object names are lost and is stored only the ID, this ID's was given by the people that created the RCO format and its order is confusing (doesnt seems to follow any rule). Programs like [[Rcomage]] in his settings file '''objattribdef-ps3.ini''' uses the same order than sony for better understanding of the format

PSP can use the objects from 0x01 up to 0x1A, and PS3 up to 0x1F

{{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''': No}}

*objecttree

**page

***group

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

|-

|-

|-

|-

|-

|-

|-

|}

{{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}}

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|}

**{{icon content ps3|50px}} Used 409 times in PS3 4.76 ofw with values: 0x17000000 (1 time), 0x16000000 (1 time), 0x15000000 (127 times), 0x12000000 (14 times), 0x10000000 (4 times), 0xe000000 (31 times), 0xc000000 (5 times), 0xa000000 (2 times), 0x9000000 (5 times), 0x8000000 (6 times), 0x7000000 (20 times), 0x6000000 (104 times), 0x5000000 (3 times), 0x4000000 (9 times), 0x3000000 (13 times), 0x2000000 (39 times), 0x1000000 (20 times), 0x0 (5 times)

*'''mlistItemDefault''' (extracted as data type "int")

**{{icon content ps3|50px}} Used 409 times in PS3 4.76 ofw with values: "0x0" (7 times), "0x1" (7 times), "0x2" (8 times), "0x3" (6 times), "0x4" (4 times), "0x5" (6 times), "0x6" (2 times), "0xa" (2 times), "0xb" (2 times), "0xd" (2 times), "0xffffffff" (363 times)

*'''mlistItemSpacing''' (extracted as data type "float")

**{{icon content ps3|50px}} Used 409 times in PS3 4.76 ofw with value: "0"

**"0x0" (333 times), "0x4c090100" (6 times), "0x7f090100" (1 times), "0x1f070100" (8 times), "0x1f070000" (14 times), "0x69070000" (39 times), "0xc4040000" (8 times)

**"0x0" (208 times), "0x95080000" (1 time), "0xdc050000" (1 time), "0xe7050000" (2 times), "0xe0050000" (1 time), "0x3a040000" (4 times), "0x83040000" (2 times), "0x7f030000" (125 times), "0x87040000" (2 times), "0xc7020000" (1 time), "0xfc010000" (15 times), "0x21030000" (2 times), "0x1e030000" (5 times), "0x3f040000" (2 times), "0x20070000" (4 times), "0x63070000" (31 times), "0xbf070000" (2 times), "0x8f030000" (1 time)

**"0x0" (282 times), "0xe8050000" (2 times), "0x80030000" (125 times)

{{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}}

|-

|-

|-

|-

|-

|-

|-

|}

{{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 ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}

|-

|-{{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}}

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

|-{{cellcolors|#DD6666}}

|-

| xmlistImage || image || {{yes}} || {{yes}} || image:tex_game || Loads a image from [[RCOXML Images|ImageTree]]

|}

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

| xitemText || text || {{yes}} || {{yes}} ||  || {{icon content psp|50px}} Used 0 times in PSP 6.61 ofw<br>{{icon content ps3|50px}} Used 0 times in PS3 4.76 ofw

|-{{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}}

| litemText || text || {{yes}} || {{yes}} || {{icon content psp|50px}} text:msg_wifi_sp_pswd || Loads a text from [[RCOXML Texts|TextTree]]

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|}

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

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

|-{{cellcolors|#DD6666}}

|-

| iitemText || text || {{yes}} || {{yes}} || {{icon content psp|50px}} text:msgupdater_dot<br>{{icon content ps3|50px}} text:msg_edy_driver_version || rowspan="2" | Loads a text from [[RCOXML Texts|TextTree]]

|}

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

|-

| checkboxitemText || text || {{no}} || {{yes}} ||  ||  ||  

|-

|-

|}

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

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

{| class="wikitable"

|+specific attributes for EditBox

! 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}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

|-

|-

| editboxOnFocusIn || event || {{no}} || {{yes}} || event:native:/OnFocusInEdit ||  ||  

| editboxOnFocusDown || event || {{no}} || {{yes}} || event:native:/OnFocusDownEditBoxPassword ||  ||  

|}

==Buttons==

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

{| class="wikitable"

|+specific attributes for Button

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

|-

|-

|-

|-

| buttonText || text || {{yes}} || {{yes}} || text:msg_ok || Loads a text from [[RCOXML Texts|TextTree]]

| buttonOnContext || event || {{yes}} || {{yes}} || event:native:/VideoEditorUpload::ServiceSelect::OnContextMenuButton1

|-{{cellcolors|#DD6666}}

|}

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

{| class="wikitable"

|+specific attributes for UButton

| ubuttonOnFocusDown || event || {{yes}} || {{yes}} ||  || {{icon content psp|50px}} Used 0 times in PSP 6.61 ofw<br>{{icon content ps3|50px}} Used 0 times in PS3 4.76 ofw

|-{{cellcolors|#DD6666}}

|}

==Bars==

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

{| class="wikitable"

|+specific attributes for Progress

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

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

|-

|}

**"1" is a valid value (with data type "float"), found in sysconf_plugin.rco from PS3 firmware 1.02

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

{| class="wikitable"

|+specific attributes for Scroll

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

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

| scrollImageBase || image || {{yes}} || {{yes}} || {{icon content psp|50px}} image:scroll_base || rowspan="5" | Loads a image from [[RCOXML Images|ImageTree]]

| scrollImageSlider || image || {{yes}} || {{yes}} || {{icon content psp|50px}} image:scroll_slider

|-

|-

| scrollImageBaseShadow || image || {{yes}} || {{yes}} || {{icon content psp|50px}} image:scroll_base_shadow

|-

|}

==Spins==

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

Most attributes from "Spin" object are similar than "ItemSpin" object

{| class="wikitable"

|+specific attributes for Spin

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

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-

|-

|-

| spinOnDecide || event || {{yes}} || {{yes}} || {{icon content ps3|50px}} event:native:/OnDecideCaptionDuration || rowspan="3" | Triggers an event, see [[RCOXML Coding]]

|-

| spinOnRollIn || event || {{yes}} || {{yes}} || {{icon content ps3|50px}} event:native:/OnRollInSpinHdmiDetect

|-

| spinOnFocusIn || event || {{yes}} || {{yes}} || {{icon content psp|50px}} event:native:/onFocusIn_premo_settings_connection_spin || rowspan="4" | Triggers an event, see [[RCOXML Coding]]

|-

| spinOnFocusRight || event || {{yes}} || {{yes}} || {{icon content psp|50px}} object2:lftv_page212_group000_ispin001

|}

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

{| class="wikitable"

|+specific attributes for ItemSpin

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

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}

|-{{cellcolors|#DD6666}}