Editing RCOXML Animations

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

*External links
**RCOXML animations basic ---> http://endlessparadigm.com/forum/showthread.php?tid=19501&pid=255053#pid255053
**RCOXML animations cube sample ---> http://endlessparadigm.com/forum/showthread.php?tid=19501&pid=326948#pid326948
{{RCOXML contents PS3}}

=General concepts=

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

==entry types and reference types==
{{RCO TOC entry types}}
{{RCO TOC reference types}}

==Standard attributes used by animations==
{| class="wikitable" style="font-size:small;"
|+RCO TOC Animations standard attributes {{ed right|RCO TOC Animations standard attributes}}
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| {{RCO TOC Animations standard attributes}}
|-
|}

*'''accelMode'''. Used to accelerate or decelerate an animation, 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}}

=Animations=
Example
{{Boxcode|code=<syntaxhighlight lang="xml">
<RcoFile>
	<MainTree name="maintree_label">
		<AnimTree>
			<Anim name="animation_1_label">
				<Fade object="object:animated_object_label" time="100" accelMode="0x0" colorScaleA="1" />
				<FireEvent event="event:native:/runFuctionX" />
			</Anim>
		</AnimTree>
	</MainTree>
</RcoFile>			
</syntaxhighlight>}}

==(0x09 0x00) AnimTree==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': No}}
{{Boxcode|code=<syntaxhighlight lang="xml">		<AnimTree></syntaxhighlight>}}

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09000000 (AnimTree)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 00|FF FF FF FF|AnimTree|00 00 00 00|00 00 00 28|unnamed}}
|}

==(0x09 0x01) Anim==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': No}}
{{Boxcode|code=<syntaxhighlight lang="xml">			<Anim name="label"></syntaxhighlight>}}

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

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09010000 (Animation)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 01|00 00 00 00|Anim|00 00 00 00|00 00 00 28|}}
|}

==(0x09 0x02) MoveTo==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<syntaxhighlight lang="xml">				<MoveTo	object="object:label" time="1000" accelMode="0x3" positionX="1" positionY="1" positionZ="1" positionOverrideX="0x0" positionOverrideY="0x0" positionOverrideZ="0x0" /></syntaxhighlight>}}

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09020000 (MoveTo)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 02|FF FF FF FF|MoveTo|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC Animations standard attributes|MoveTo}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x38 || 0x04 || float || '''positionX''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><MoveTo positionX="1" /></syntaxhighlight> || updates the value of attribute '''positionX''' from the animated [[RCOXML Objects|object]]
|-
| 0x3C || 0x04 || float || '''positionY''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><MoveTo positionY="1" /></syntaxhighlight> || updates the value of attribute '''positionY''' from the animated [[RCOXML Objects|object]]
|-
| 0x40 || 0x04 || float || '''positionZ''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><MoveTo positionZ="1" /></syntaxhighlight> || updates the value of attribute '''positionZ''' from the animated [[RCOXML Objects|object]]
|-
| 0x44 || 0x04 || <abbr title="data type unk used on purpose because rcomage cant convert the value correctlly">unk</abbr> || '''positionOverrideX''' || {{no}} || {{yes}} || 00 00 00 00 || <syntaxhighlight lang="xml" enclose="none"><MoveTo positionOverrideX="0x0" /></syntaxhighlight> || rowspan="3" | '''XYZ Position Override''' with values from [[XMB Layouts]]<!--<br>(first 2 bytes = line_number, last 2 bytes = unknown)-->
|-
| 0x48 || 0x04 || <abbr title="data type unk used on purpose because rcomage cant convert the value correctlly">unk</abbr> || '''positionOverrideY''' || {{no}} || {{yes}} || 00 00 00 00 || <syntaxhighlight lang="xml" enclose="none"><MoveTo positionOverrideY="0x0" /></syntaxhighlight>
|-
| 0x4C || 0x04 || <abbr title="data type unk used on purpose because rcomage cant convert the value correctlly">unk</abbr> || '''positionOverrideZ''' || {{no}} || {{yes}} || 00 00 00 00 || <syntaxhighlight lang="xml" enclose="none"><MoveTo positionOverrideZ="0x0" /></syntaxhighlight>
|}

==(0x09 0x03) Recolour==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<syntaxhighlight lang="xml">				<Recolour object="object:label" time="1000" accelMode="0x3" colorScaleR="1" colorScaleG="1" colorScaleB="1" colorScaleA="1" /></syntaxhighlight>}}

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09030000 (Recolour)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 03|FF FF FF FF|Recolour|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC Animations standard attributes|Recolour}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x38 || 0x04 || float || '''colorScaleR''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Recolour colorScaleR="1" /></syntaxhighlight> || updates the value of attribute '''colorScaleR''' from the animated [[RCOXML Objects|object]]
|-
| 0x3C || 0x04 || float || '''colorScaleG''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Recolour colorScaleG="1" /></syntaxhighlight> || updates the value of attribute '''colorScaleG''' from the animated [[RCOXML Objects|object]]
|-
| 0x40 || 0x04 || float || '''colorScaleB''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Recolour colorScaleB="1" /></syntaxhighlight> || updates the value of attribute '''colorScaleB''' from the animated [[RCOXML Objects|object]]
|-
| 0x44 || 0x04 || float || '''colorScaleA''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Recolour colorScaleA="1" /></syntaxhighlight> || updates the value of attribute '''colorScaleA''' from the animated [[RCOXML Objects|object]]
|}

==(0x09 0x04) Rotate==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<syntaxhighlight lang="xml">				<Rotate object="object:label" time="1000" accelMode="0x3" radiansX="1" radiansY="1" radiansZ="1" /></syntaxhighlight>}}

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09040000 (Rotate)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 04|FF FF FF FF|Rotate|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC Animations standard attributes|Rotate}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x38 || 0x04 || float || '''radiansX''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Rotate radiansX="1" /></syntaxhighlight> || 
|-
| 0x3C || 0x04 || float || '''radiansY''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Rotate radiansY="1" /></syntaxhighlight> || 
|-
| 0x40 || 0x04 || float || '''radiansZ''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Rotate radiansZ="1" /></syntaxhighlight> || 
|}

==(0x09 0x05) Resize==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<syntaxhighlight lang="xml">				<Resize object="object:label" time="1000" accelMode="0x3" sizeScaleX="1" sizeScaleY="1" sizeScaleZ="1" /></syntaxhighlight>}}

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09050000 (Resize)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 05|FF FF FF FF|Resize|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC Animations standard attributes|Resize}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x38 || 0x04 || float || '''sizeScaleX''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Resize sizeScaleX="1" /></syntaxhighlight> || updates the value of attribute '''sizeScaleX''' from the animated [[RCOXML Objects|object]]
|-
| 0x3C || 0x04 || float || '''sizeScaleY''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Resize sizeScaleY="1" /></syntaxhighlight> || updates the value of attribute '''sizeScaleY''' from the animated [[RCOXML Objects|object]]
|-
| 0x40 || 0x04 || float || '''sizeScaleZ''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Resize sizeScaleZ="1" /></syntaxhighlight> || updates the value of attribute '''sizeScaleZ''' from the animated [[RCOXML Objects|object]]
|}

==(0x09 0x06) Fade==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<syntaxhighlight lang="xml">				<Fade object="object:label" time="1000" accelMode="0x3" colorScaleA="1" /></syntaxhighlight>}}

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09060000 (Fade)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 06|FF FF FF FF|Fade|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC Animations standard attributes|Fade}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x38 || 0x04 || float || '''colorScaleA''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><Fade colorScaleA="1" /></syntaxhighlight> || updates the value of attribute '''colorScaleA''' from the animated [[RCOXML Objects|object]]
|}

==(0x09 0x07) Delay==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<syntaxhighlight lang="xml">				<Delay time="1000" /></syntaxhighlight>}}

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09070000 (Delay)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 07|FF FF FF FF|Delay|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x28 || 0x04 || float || '''time''' || {{yes}} || {{yes}} || 44 7A 00 00 || <syntaxhighlight lang="xml" enclose="none"><Delay time="1000" /></syntaxhighlight> || 
|}

==(0x09 0x08) FireEvent==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<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

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, see the examples in [[RCOXML ofw animations]]

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09080000 (FireEvent)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 08|FF FF FF FF|FireEvent|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| rowspan="2" | 0x28 || rowspan="2" | 0x08 || rowspan="2" | ref || rowspan="2" | '''event''' || rowspan="2" {{yes}} || rowspan="2" {{yes}} || 04 00 / <abbr title="Padding, always 0x00 0x00">00 00</abbr> / 12 34 56 78 || <syntaxhighlight lang="xml" enclose="none"><FireEvent event="event:native:/runFuctionX" /></syntaxhighlight><br><syntaxhighlight lang="xml" enclose="none"><FireEvent event="event:script:/main/runFuctionX" /></syntaxhighlight> || Triggers an '''event''' (first 2 bytes '''reference_type''', last 4 bytes '''string_offset''')
|-
| 04 08 / <abbr title="Padding, always 0x00 0x00">00 00</abbr> / 12 34 56 78 || <syntaxhighlight lang="xml" enclose="none"><FireEvent event="anim:label" /></syntaxhighlight> ||  Loads an animation (first 2 bytes '''reference_type''', last 4 bytes '''string_offset''')
|}

==(0x09 0x09) Lock==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<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

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

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x09090000 (Lock)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 09|FF FF FF FF|Lock|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x28 || 0x04 || int || {{cellcolors|#ff9999}} '''unknownInt0''' || {{yes}} || {{yes}} || FF FF FF FF || <syntaxhighlight lang="xml" enclose="none"><Lock unknownInt0="0xffffffff" /></syntaxhighlight> || 
|}

==(0x09 0x0A) Unlock==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': No<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<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)

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x090A0000 (Unlock)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 0A|FF FF FF FF|Unlock|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x28 || 0x04 || int || {{cellcolors|#ff9999}} '''unknownInt0''' || {{yes}} || {{yes}} || FF FF FF FF || <syntaxhighlight lang="xml" enclose="none"><Unlock unknownInt0="0xffffffff" /></syntaxhighlight> || 
|}

==(0x09 0x0B) SlideOut==
{{Boxinfo3|content='''Console support''': {{icon content psp|50px}} {{icon content ps3|50px}}<br />'''Standard attributes''': Yes<br />'''Specific attributes''': Yes}}
{{Boxcode|code=<syntaxhighlight lang="xml">				<SlideOut object="object:label" time="1000" accelMode="0x3" speedX="1" speedY="1" compressX="1" compressY="1" /></syntaxhighlight>}}

{| class="wikitable" style="font-size:small;"
|+RCO TOC entry_type 0x090B0000 (SlideOut)
! Offset !! Length !! <abbr title="Data type">Type</abbr> !! Name !! {{icon content psp|50px}} !! {{icon content ps3|50px}} !! Example (TOC) !! Example (XML) !! Notes
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC entry common area|09 0B|FF FF FF FF|SlideOut|00 00 00 28|00 00 00 00|unnamed}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| {{RCO TOC Animations standard attributes|SlideOut}}
|-
| colspan="9" {{cellcolors|lightgrey}}
|-
| 0x38 || 0x04 || float || '''speedX''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><SlideOut speedX="1" /></syntaxhighlight> || 
|-
| 0x3C || 0x04 || float || '''speedY''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><SlideOut speedY="1" /></syntaxhighlight> || 
|-
| 0x40 || 0x04 || float || '''compressX''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><SlideOut compressX="1" /></syntaxhighlight> || 
|-
| 0x44 || 0x04 || float || '''compressY''' || {{yes}} || {{yes}} || 3F 80 00 00 || <syntaxhighlight lang="xml" enclose="none"><SlideOut compressY="1" /></syntaxhighlight> || 
|}

[http://ctfs.wiki.fc2.com/wiki/SlideOut%E3%81%AE%E4%BD%BF%E7%94%A8%E4%BE%8B example]

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