Description
RCOXML animations are defined in the XML code embedded inside .rco files. See Resource Container (RCO) and RCOXML Structure
General concepts
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
Event types
Template:Event types used in RCOXML code
Delays and execution timeline
RCOXML animations delays ---> http://endlessparadigm.com/forum/showthread.php?tid=19501&pid=262236#pid262236
Animations
- accelMode. Used to accelerate or decelerate an animation effect. Is the third attribute, used by most of the animations, posible values are:
- 0x0 - no accelaration
- 0x1 - starts fast, ends slow
- 0x2 -
- 0x3 -
- 0x4 - starts slow, ends fast
MoveTo
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
object |
ref |
Yes |
Yes |
object:ps3logo |
links the animation to an object
|
duration |
float |
Yes |
Yes |
1000 |
|
accelMode |
int |
Yes |
Yes |
0x0 |
|
x |
float |
Yes |
Yes |
|
updates the value of attribute PositionX from the animated object
|
y |
float |
Yes |
Yes |
|
updates the value of attribute PositionY from the animated object
|
z |
float |
Yes |
Yes |
|
updates the value of attribute PositionZ from the animated object
|
unknownInt5 |
int |
No |
Yes |
|
either updates SizeX, or is an override ?
|
unknownInt6 |
int |
No |
Yes |
|
either updates SizeY, or is an override ?
|
unknown7 |
unk |
No |
Yes |
|
either updates SizeZ, or is an override ?
|
Recolour
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
object |
ref |
Yes |
Yes |
object:ps3logo |
links the animation to an object
|
duration |
float |
Yes |
Yes |
1000 |
|
accelMode |
int |
Yes |
Yes |
0x0 |
|
red |
float |
Yes |
Yes |
|
updates the value of attribute ColorScaleR from the animated object
|
green |
float |
Yes |
Yes |
|
updates the value of attribute ColorScaleG from the animated object
|
blue |
float |
Yes |
Yes |
|
updates the value of attribute ColorScaleB from the animated object
|
alpha |
float |
Yes |
Yes |
|
updates the value of attribute ColorScaleA from the animated object
|
Rotate
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
object |
ref |
Yes |
Yes |
object:ps3logo |
links the animation to an object
|
duration |
float |
Yes |
Yes |
1000 |
|
accelMode |
int |
Yes |
Yes |
0x0 |
|
x |
float |
Yes |
Yes |
|
|
y |
float |
Yes |
Yes |
|
|
z |
float |
Yes |
Yes |
|
|
Resize
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
object |
ref |
Yes |
Yes |
object:ps3logo |
links the animation to an object
|
duration |
float |
Yes |
Yes |
1000 |
|
accelMode |
int |
Yes |
Yes |
0x0 |
|
width |
float |
Yes |
Yes |
|
updates the value of attribute SizeX from the animated object
|
height |
float |
Yes |
Yes |
|
updates the value of attribute SizeY from the animated object
|
depth |
float |
Yes |
Yes |
|
updates the value of attribute SizeZ from the animated object
|
Fade
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
object |
ref |
Yes |
Yes |
object:ps3logo |
links the animation to an object
|
duration |
float |
Yes |
Yes |
1000 |
|
accelMode |
int |
Yes |
Yes |
0x0 |
|
transparency |
float |
Yes |
Yes |
|
updates the value of attribute ColorScaleA from the animated object
|
Delay
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
time |
float |
Yes |
Yes |
|
|
FireEvent
Triggers (or "fires") an event, there are different types of events (see RCOXML Structure). 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
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
event |
ref |
Yes |
Yes |
|
|
Lock
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)
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
unknownInt0 |
int |
Yes |
Yes |
|
|
Unlock
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)
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
unknownInt0 |
int |
Yes |
Yes |
|
|
SlideOut
Attribute |
How it works
|
Name |
Type |
|
|
Examples
|
object |
ref |
Yes |
Yes |
object:ps3logo |
links the animation to an object
|
duration |
float |
Yes |
Yes |
1000 |
|
accelMode |
int |
Yes |
Yes |
0x0 |
|
xspeed |
float |
Yes |
Yes |
|
|
yspeed |
float |
Yes |
Yes |
|
|
xcompress |
float |
Yes |
Yes |
|
|
ycompress |
float |
Yes |
Yes |
|
|
example