RCOXML Animations

From PS3 Developer wiki
Jump to navigation Jump to search

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 PSP icon PS3 icon Examples
object ref Yes Yes PS3 icon 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 PSP icon PS3 icon Examples
object ref Yes Yes PS3 icon 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 PSP icon PS3 icon Examples
object ref Yes Yes PS3 icon 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 PSP icon PS3 icon Examples
object ref Yes Yes PS3 icon 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 PSP icon PS3 icon Examples
object ref Yes Yes PS3 icon 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 PSP icon PS3 icon 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 PSP icon PS3 icon 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 PSP icon PS3 icon 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 PSP icon PS3 icon Examples
unknownInt0 int Yes Yes

SlideOut

Attribute How it works
Name Type PSP icon PS3 icon Examples
object ref Yes Yes PS3 icon 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