RCOXML Animations: Difference between revisions

From PS3 Developer wiki
Jump to navigation Jump to search
m (→‎RCO TOC entry types: page sections separators)
Line 52: Line 52:
==(0x09 0x00) AnimTree==
==(0x09 0x00) AnimTree==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': No}}
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': No}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <AnimTree></syntaxhighlight>}}
{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09000000 (AnimTree)
|+RCO TOC entry_type 0x09000000 (AnimTree)
Line 63: Line 65:
==(0x09 0x01) Animation==
==(0x09 0x01) Animation==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': No}}
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': No}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <Animation name="label"></syntaxhighlight>}}
The '''AnimTree''' can have one or more '''Animation''' childrens, and every '''Animation''' can have a list of the childrens listed below
The '''AnimTree''' can have one or more '''Animation''' childrens, and every '''Animation''' can have a list of the childrens listed below


Line 76: Line 80:
==(0x09 0x02) MoveTo==
==(0x09 0x02) MoveTo==
{{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}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <MoveTo object="object:label" duration="1000" accelMode="0x3" x="1" y="1" z="1" unknownInt5="0x0" unknownInt6="0x0" unknown7="0" /></syntaxhighlight>}}
{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09020000 (MoveTo)
|+RCO TOC entry_type 0x09020000 (MoveTo)
Line 96: Line 102:
| 0x40 || 0x04 || float || '''z''' || {{yes}} || {{yes}} || 3F 80 00 00 || <MoveTo <span style="color:#000099;">z</span><span style="color:#990000;">="1"</span> /> || updates the value of attribute '''PositionZ''' from the animated [[RCOXML Objects|object]]
| 0x40 || 0x04 || float || '''z''' || {{yes}} || {{yes}} || 3F 80 00 00 || <MoveTo <span style="color:#000099;">z</span><span style="color:#990000;">="1"</span> /> || updates the value of attribute '''PositionZ''' from the animated [[RCOXML Objects|object]]
|-
|-
| 0x44 || 0x04 || int ? || {{cellcolors|#DD6666}} '''unknownInt5''' || {{no}} || {{yes}} || 00 00 00 00 || <MoveTo <span style="color:#000099;">unknownInt5</span><span style="color:#990000;">="0"</span> /> ||  
| 0x44 || 0x04 || int ? || {{cellcolors|#DD6666}} '''unknownInt5''' || {{no}} || {{yes}} || 00 00 00 00 || <MoveTo <span style="color:#000099;">unknownInt5</span><span style="color:#990000;">="0x0"</span> /> ||  
|-
|-
| 0x48 || 0x04 || int ? || {{cellcolors|#DD6666}} '''unknownInt6''' || {{no}} || {{yes}} || 00 00 00 00 || <MoveTo <span style="color:#000099;">unknownInt6</span><span style="color:#990000;">="0"</span> /> ||  
| 0x48 || 0x04 || int ? || {{cellcolors|#DD6666}} '''unknownInt6''' || {{no}} || {{yes}} || 00 00 00 00 || <MoveTo <span style="color:#000099;">unknownInt6</span><span style="color:#990000;">="0x0"</span> /> ||  
|-
|-
| 0x4C || 0x04 || unk ? || {{cellcolors|#DD6666}} '''unknown7''' || {{no}} || {{yes}} || 00 00 00 00 || <MoveTo <span style="color:#000099;">unknown7</span><span style="color:#990000;">="0"</span> /> ||  
| 0x4C || 0x04 || unk ? || {{cellcolors|#DD6666}} '''unknown7''' || {{no}} || {{yes}} || 00 00 00 00 || <MoveTo <span style="color:#000099;">unknown7</span><span style="color:#990000;">="0"</span> /> ||  
Line 108: Line 114:
==(0x09 0x03) Recolour==
==(0x09 0x03) Recolour==
{{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}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <Recolour object="object:label" duration="1000" accelMode="0x3" red="1" green="1" blue="1" alpha="1" /></syntaxhighlight>}}
{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09030000 (Recolour)
|+RCO TOC entry_type 0x09030000 (Recolour)
Line 133: Line 141:
==(0x09 0x04) Rotate==
==(0x09 0x04) Rotate==
{{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}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <Rotate object="object:label" duration="1000" accelMode="0x3" x="1" y="1" z="1" /></syntaxhighlight>}}
{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09040000 (Rotate)
|+RCO TOC entry_type 0x09040000 (Rotate)
Line 156: Line 166:
==(0x09 0x05) Resize==
==(0x09 0x05) Resize==
{{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}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <Resize object="object:label" duration="1000" accelMode="0x3" width="1" height="1" depth="1" /></syntaxhighlight>}}
{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09050000 (Resize)
|+RCO TOC entry_type 0x09050000 (Resize)
Line 179: Line 191:
==(0x09 0x06) Fade==
==(0x09 0x06) Fade==
{{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}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <Fade object="object:label" duration="1000" accelMode="0x3" transparency="1" /></syntaxhighlight>}}
{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09060000 (Fade)
|+RCO TOC entry_type 0x09060000 (Fade)
Line 198: Line 212:
==(0x09 0x07) Delay==
==(0x09 0x07) Delay==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <Delay time="1000" /></syntaxhighlight>}}
{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09070000 (Delay)
|+RCO TOC entry_type 0x09070000 (Delay)
Line 213: Line 229:
==(0x09 0x08) FireEvent==
==(0x09 0x08) FireEvent==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <FireEvent event="event:native:/runFuctionX" /></syntaxhighlight>}}
Triggers (or "fires") an event, there are different types of events (see [[RCOXML Coding]]). The most used inside animations are "native events" and "animation events" itself
Triggers (or "fires") an event, there are different types of events (see [[RCOXML Coding]]). The most used inside animations are "native events" and "animation events" itself


Line 232: Line 250:
==(0x09 0x09) Lock==
==(0x09 0x09) Lock==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <Lock unknownInt0="0xffffffff" /></syntaxhighlight>}}
Disables [[XMB]]. Note in [[Talk:Custom_render_plugin]] how '''anim_coldboot''', '''anim_coldboot2''', '''anim_gameboot''', and '''anim_otherboot''' animations starts by locking the XMB to dont interfere
Disables [[XMB]]. Note in [[Talk:Custom_render_plugin]] how '''anim_coldboot''', '''anim_coldboot2''', '''anim_gameboot''', and '''anim_otherboot''' animations starts by locking the XMB to dont interfere


Line 251: Line 271:
==(0x09 0x0A) Unlock==
==(0x09 0x0A) Unlock==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <Unlock unknownInt0="0xffffffff" /></syntaxhighlight>}}
Enables [[XMB]]. Note in [[Talk:Custom_render_plugin]] how '''anim_gameboot''', and '''anim_otherboot''' animations doesnt unlocks XMB at the ending because when the animation is completed a game/app boots (doesnt returns to XMB)
Enables [[XMB]]. Note in [[Talk:Custom_render_plugin]] how '''anim_gameboot''', and '''anim_otherboot''' animations doesnt unlocks XMB at the ending because when the animation is completed a game/app boots (doesnt returns to XMB)


Line 268: Line 290:
==(0x09 0x0B) SlideOut==
==(0x09 0x0B) SlideOut==
{{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}}
{{Boxcode|content=<syntaxhighlight lang="xml"> <SlideOut object="object:label" duration="1000" accelMode="0x3" xspeed="1" yspeed="1" xcompress="1" ycompress="1" /></syntaxhighlight>}}
{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x090B0000 (SlideOut)
|+RCO TOC entry_type 0x090B0000 (SlideOut)

Revision as of 14:46, 4 October 2016

Description

RCOXML animations are defined in the XML code embedded inside .rco files. See Resource Container (RCO) and RCOXML Coding

General concepts

Delays and execution timeline

RCOXML animations delays ---> http://endlessparadigm.com/forum/showthread.php?tid=19501&pid=262236#pid262236

Standard attributes

RCO TOC Animations standard attributes
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x28 0x08 ref object Yes Yes 04 09 / 00 00 / 12 34 56 78 <Element object="object:label"/> links the animation to an object (ref_type[2], padding[2], label_string_table_offset[4])
0x30 0x04 float time Yes Yes 44 7A 00 00 <Element time="1000"/>
0x34 0x04 int accelMode Yes Yes 00 00 00 03 <Element accelMode="0x3"/>
  • accelMode. Used to accelerate or decelerate an animation effect, used by most of the animations, posible values are:
    • 0x0 - no accelaration
    • 0x1 - starts fast, ends slow
    • 0x2 -
    • 0x3 -
    • 0x4 - starts slow, ends fast

Measure units and conversions

Measure units used in RCOXML code
  • XYZ Position, in pixels
  • RGBA Color Scale in percentage in a scale from 0 up to 1, where 1 represents the max value posible of 255 (decimal value divided by 255 to get into this scale)
  • XYZ Size, in pixels, negative numbers mirrors the image
  • XYZ Size Scale, in percentage in a scale from 0 up to 1, negative numbers mirrors the image
  • Time, in miliseconds, where 1000 is one second
  • XYZ Angle, in radians with right-handed rule coordinates, where radians=(π*degrees)/180, and degrees=(180*radians)/π, as example for one turn of 360º degrees: radians=(3.141*360)/180=6.283 ...so... 360º degrees = 6.283 radians

RCOXML Animation example

Code Sample

RCO TOC entry types

RCO TOC entry types
Second byte
0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 0x0A 0x0B 0x0C 0x0D 0x0E 0x0F 0x10 0x11 0x12 0x13 0x14 0x15 0x16 0x17 0x18 0x19 0x1A 0x1B 0x1C 0x1D 0x1E 0x1F
First byte 0x01 unk MainTree
0x02 ScriptTree
0x03 TextTree Text
0x04 ImageTree Image
0x05 ModelTree Model
0x06 SoundTree Sound
0x07 FontTree Font
0x08 ObjectTree Page Plane Button XMenu XMList XList Progress Scroll MList MItem unk XItem Text ModelObject Spin Action ItemSpin Group LList LItem Edit Clock IList IItem Icon UButton unk CheckboxGroup CheckboxItem Meter EditBox
0x09 AnimTree Anim MoveTo Recolour Rotate Resize Fade Delay FireEvent Lock Unlock SlideOut
Supported by PSP icon and PS3 icon Supported by PS3 icon only
  • The entry_types with the suffix Tree (as example MainTree) are special and doesnt uses attributes, MainTree is always located as the first entry, doesn't have a parent, and doesn't have any previous or next "sibling", the maximun number posible of childrens for MainTree is 8 (containing all the other "trees"). The other "trees" (as example imageTree or soundTree) are siblings and are the childrens of "MainTree", Every one of those "trees" contains a variable number of entry_types that are its childrens
  • The attributes of the RCOXML Objects (entry_types starting with 0x08) and RCOXML Animations (entry_types starting with 0x09) can be grouped in standard attributes (used by most entryes of this type) and specific attributes (different for every entry_type). The standard attributes are always located before the specific attributes
  • First two bytes are swapped based on architecture (PSP in little endian, PS3 in big endian). The table shows the values in big endian
RCO TOC reference types
reference_type pointer Method Loader Loads From Example (XML) Notes
0xFFFF0000 0xFFFFFFFF n/a All Nothing None <Entry reference="nothing"/>
0x04000000 relative event: RCOXML Objects
RCOXML Animations
Code function Associated .SPRX <Entry event="event:native:/runFuctionX"/>
ScriptTree/Script File inside RCO <Entry event="event:script:/main/runFuctionX"/>
0x04010000 # (0-based) text: RCOXML Objects
XMBML Code
TextTree/Text Strings inside RCO <Entry text="text:msg_mytext"/>
0x04020000 absolute image: RCOXML Objects
XMBML Code
ImageTree/Image File inside RCO <Entry image="image:tex_mytexture"/>
0x04030000 absolute model: RCOXML Objects ModelTree/Model File inside RCO <Entry model="model:mymodel"/>
0x04040000 absolute ? sound: ? associated .SPRX SoundTree/Sound File inside RCO <Entry sound="sound:mysound"/> ? speculation
0x04050000 absolute font: RCOXML Objects FontTree/Font File inside RCO ? <Entry font="font:fontstyle_sanserif"/>
0x04060000 absolute ? anim2: ? RCOXML Objects ? AnimTree/Animation ? RCOXML code ? <Entry anim2="anim2:myanimation"/> ? speculation
0x04070000 absolute object2: RCOXML Objects ObjectTree/Object RCOXML code <Entry object2="object2:plane_myplane"/>
0x04080000 absolute anim: RCOXML Animations AnimTree/Animation RCOXML code <Entry anim="anim:myanimation"/>
0x04090000 absolute object: RCOXML Animations ObjectTree/Object RCOXML code <Entry object="object:plane_myplane"/>
  • A reference attribute is composed by two values, the first is the reference_type that indicates the "tree" of the entry that is going to be loaded, and the second is a pointer to a text string with the label of the entry that is going to be loaded
  • The reference_type event doesnt loads an entry from a "tree" though, it runs a code function from either a .sprx (by storing the text native:/ as part of the text string inside the RCO) or from a VSMX script (by storing the text script:/ as part of the text string inside the RCO)
  • First two bytes are swapped based on architecture (PSP in little endian, PS3 in big endian). The table shows the values in big endian


(0x09 0x00) AnimTree

Info
Console support: PSP icon PS3 icon
Standard attributes: No
Specific attributes: No
Code Sample
RCO TOC entry_type 0x09000000 (AnimTree)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 00 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <AnimTree /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown

(0x09 0x01) Animation

Info
Console support: PSP icon PS3 icon
Standard attributes: No
Specific attributes: No
Code Sample

The AnimTree can have one or more Animation childrens, and every Animation can have a list of the childrens listed below

RCO TOC entry_type 0x09010000 (Animation)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 01 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <Animation name-"label"> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown

(0x09 0x02) MoveTo

Info
Console support: PSP icon PS3 icon
Standard attributes: Yes
Specific attributes: Yes
Code Sample
RCO TOC entry_type 0x09020000 (MoveTo)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 02 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <MoveTo /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x08 ref object Yes Yes 04 09 / 00 00 / 12 34 56 78 <MoveTo object="object:label"/> links the animation to an object (ref_type[2], padding[2], label_string_table_offset[4])
0x30 0x04 float time Yes Yes 44 7A 00 00 <MoveTo time="1000"/>
0x34 0x04 int accelMode Yes Yes 00 00 00 03 <MoveTo accelMode="0x3"/>
0x38 0x04 float x Yes Yes 3F 80 00 00 <MoveTo x="1" /> updates the value of attribute PositionX from the animated object
0x3C 0x04 float y Yes Yes 3F 80 00 00 <MoveTo y="1" /> updates the value of attribute PositionY from the animated object
0x40 0x04 float z Yes Yes 3F 80 00 00 <MoveTo z="1" /> updates the value of attribute PositionZ from the animated object
0x44 0x04 int ? unknownInt5 No Yes 00 00 00 00 <MoveTo unknownInt5="0x0" />
0x48 0x04 int ? unknownInt6 No Yes 00 00 00 00 <MoveTo unknownInt6="0x0" />
0x4C 0x04 unk ? unknown7 No Yes 00 00 00 00 <MoveTo unknown7="0" />
  • Speculation
    • The unknowns either updates SizeX/Y/Z, or are XMB Layouts overrides ?

(0x09 0x03) Recolour

Info
Console support: PSP icon PS3 icon
Standard attributes: Yes
Specific attributes: Yes
Code Sample
RCO TOC entry_type 0x09030000 (Recolour)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 03 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <Recolour /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x08 ref object Yes Yes 04 09 / 00 00 / 12 34 56 78 <Recolour object="object:label"/> links the animation to an object (ref_type[2], padding[2], label_string_table_offset[4])
0x30 0x04 float time Yes Yes 44 7A 00 00 <Recolour time="1000"/>
0x34 0x04 int accelMode Yes Yes 00 00 00 03 <Recolour accelMode="0x3"/>
0x38 0x04 float red Yes Yes 3F 80 00 00 <Recolour red="1" /> updates the value of attribute ColorScaleR from the animated object
0x3C 0x04 float green Yes Yes 3F 80 00 00 <Recolour green="1" /> updates the value of attribute ColorScaleG from the animated object
0x40 0x04 float blue Yes Yes 3F 80 00 00 <Recolour blue="1" /> updates the value of attribute ColorScaleB from the animated object
0x44 0x04 float alpha Yes Yes 3F 80 00 00 <Recolour alpha="1" /> updates the value of attribute ColorScaleA from the animated object

(0x09 0x04) Rotate

Info
Console support: PSP icon PS3 icon
Standard attributes: Yes
Specific attributes: Yes
Code Sample
RCO TOC entry_type 0x09040000 (Rotate)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 04 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <Rotate /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x08 ref object Yes Yes 04 09 / 00 00 / 12 34 56 78 <Rotate object="object:label"/> links the animation to an object (ref_type[2], padding[2], label_string_table_offset[4])
0x30 0x04 float time Yes Yes 44 7A 00 00 <Rotate time="1000"/>
0x34 0x04 int accelMode Yes Yes 00 00 00 03 <Rotate accelMode="0x3"/>
0x38 0x04 float x Yes Yes 3F 80 00 00 <Rotate x="1" />
0x3C 0x04 float y Yes Yes 3F 80 00 00 <Rotate y="1" />
0x40 0x04 float z Yes Yes 3F 80 00 00 <Rotate z="1" />

(0x09 0x05) Resize

Info
Console support: PSP icon PS3 icon
Standard attributes: Yes
Specific attributes: Yes
Code Sample
RCO TOC entry_type 0x09050000 (Resize)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 05 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <Resize /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x08 ref object Yes Yes 04 09 / 00 00 / 12 34 56 78 <Resize object="object:label"/> links the animation to an object (ref_type[2], padding[2], label_string_table_offset[4])
0x30 0x04 float time Yes Yes 44 7A 00 00 <Resize time="1000"/>
0x34 0x04 int accelMode Yes Yes 00 00 00 03 <Resize accelMode="0x3"/>
0x38 0x04 float width Yes Yes 3F 80 00 00 <Resize width="1" /> updates the value of attribute SizeScaleX from the animated object
0x3C 0x04 float height Yes Yes 3F 80 00 00 <Resize height="1" /> updates the value of attribute SizeScaleY from the animated object
0x40 0x04 float depth Yes Yes 3F 80 00 00 <Resize depth="1" /> updates the value of attribute SizeScaleZ from the animated object

(0x09 0x06) Fade

Info
Console support: PSP icon PS3 icon
Standard attributes: Yes
Specific attributes: Yes
Code Sample
RCO TOC entry_type 0x09060000 (Fade)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 06 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <Fade /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x08 ref object Yes Yes 04 09 / 00 00 / 12 34 56 78 <Fade object="object:label"/> links the animation to an object (ref_type[2], padding[2], label_string_table_offset[4])
0x30 0x04 float time Yes Yes 44 7A 00 00 <Fade time="1000"/>
0x34 0x04 int accelMode Yes Yes 00 00 00 03 <Fade accelMode="0x3"/>
0x38 0x04 float transparency Yes Yes 3F 80 00 00 <Fade transparency="1" /> updates the value of attribute ColorScaleA from the animated object

(0x09 0x07) Delay

Info
Console support: PSP icon PS3 icon
Standard attributes: No
Specific attributes: Yes
Code Sample
RCO TOC entry_type 0x09070000 (Delay)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 07 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <Delay /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x04 float time Yes Yes 44 7A 00 00 <Delay time="1000" />

(0x09 0x08) FireEvent

Info
Console support: PSP icon PS3 icon
Standard attributes: No
Specific attributes: Yes
Code Sample

Triggers (or "fires") an event, there are different types of events (see RCOXML Coding). The most used inside animations are "native events" and "animation events" itself

By triggering an animation event from inside an animation... both animations are played consecutivelly. Also is posible to reload the animation by triggering itself to create an infinite animation loop

RCO TOC entry_type 0x09080000 (FireEvent)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 08 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <FireEvent /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x08 reference event Yes Yes FF FF 00 00 FF FF FF FF <FireEvent event="event:native:/runFuctionX" />
<FireEvent event="event:script:/main/runFuctionX" />
<FireEvent event="anim:myanimation" />

(0x09 0x09) Lock

Info
Console support: PSP icon PS3 icon
Standard attributes: No
Specific attributes: Yes
Code Sample

Disables XMB. Note in Talk:Custom_render_plugin how anim_coldboot, anim_coldboot2, anim_gameboot, and anim_otherboot animations starts by locking the XMB to dont interfere

  • In latest firmwares (where is used coldboot.raf animation) if XMB is not locked + having a dynamic theme applyed the PS3 crashes. Is because inside dynamic themes the background is a .raf animation. Is not posible to play 2 .raf animations together overlapped (from coldboot.raf and from inside a dynamic theme)
RCO TOC entry_type 0x09090000 (Lock)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 09 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <Lock /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x04 integer unknownInt0 Yes Yes FF FF FF FF <Lock unknownInt0="0xffffffff" />

(0x09 0x0A) Unlock

Info
Console support: PSP icon PS3 icon
Standard attributes: No
Specific attributes: Yes
Code Sample

Enables XMB. Note in Talk:Custom_render_plugin how anim_gameboot, and anim_otherboot animations doesnt unlocks XMB at the ending because when the animation is completed a game/app boots (doesnt returns to XMB)

RCO TOC entry_type 0x090A0000 (Unlock)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 0A 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <Unlock /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x04 integer unknownInt0 Yes Yes FF FF FF FF <Unlock unknownInt0="0xffffffff" />

(0x09 0x0B) SlideOut

Info
Console support: PSP icon PS3 icon
Standard attributes: Yes
Specific attributes: Yes
Code Sample
RCO TOC entry_type 0x090B0000 (SlideOut)
Offset Length Data type Name PSP icon PS3 icon Example (TOC) Example (XML) Notes
0x00 0x04 int entry_type Yes Yes 09 0B 00 00 / 00 00 <00 00 00 48 name="label"/> entry_type[2], padding[2]
0x04 0x04 int entry_label_offset Yes Yes FF FF FF FF label_string_table_offset[4] (optional)
0x08 0x04 int attributes_offset Yes Yes <SlideOut /> represents XML hierarchy Attributes offset relative to the start of this entry (optional)
0x0C 0x04 int children_offset Yes Yes 00 00 00 28 First children offset relative to the start of this entry (optional)
0x10 0x04 int children_number Yes Yes 00 00 00 00 Number of subentries
0x14 0x04 int next_sibling_offset Yes Yes 00 00 00 00 Next sibling offset relative to the start of this entry (optional)
0x18 0x04 int prev_sibling_offset Yes Yes 00 00 00 00 Previous sibling offset relative to the start of this entry (optional)
0x1C 0x04 int parent_offset Yes Yes 00 00 00 00 This entry offset relative to the start of the parent entry
0x20 0x08 unk toc_entry_unk Yes Yes 00 00 00 00 .. . no XML representation Unknown
0x28 0x08 ref object Yes Yes 04 09 / 00 00 / 12 34 56 78 <SlideOut object="object:label"/> links the animation to an object (ref_type[2], padding[2], label_string_table_offset[4])
0x30 0x04 float time Yes Yes 44 7A 00 00 <SlideOut time="1000"/>
0x34 0x04 int accelMode Yes Yes 00 00 00 03 <SlideOut accelMode="0x3"/>
0x38 0x04 float xspeed Yes Yes 3F 80 00 00 <SlideOut xspeed="1" />
0x3C 0x04 float yspeed Yes Yes 3F 80 00 00 <SlideOut yspeed="1" />
0x40 0x04 float xcompress Yes Yes 3F 80 00 00 <SlideOut xcompress="1" />
0x44 0x04 float ycompress Yes Yes 3F 80 00 00 <SlideOut ycompress="1" />

example