Editing Rich Appearance Format (RAF)

=RAF contents=

It must comply with these max restrictions :

  -Textures size max: 15 mb ( 15728640 Bytes ) ( on [[RSX]] local memory at run time )

  -Scripts: 1

   

  -Actors: 128

==RAF Scene (.XML)==

The camera and lights are a bit special, there are different 2 ways to integrate them in the scene because are not visible (is imposible to see the camera because you are looking at the scene from inside of the camera) and lights are just light rays (the emitter is not visible, only the rays)... For this reason camera and lights can be completly defined in the scene.xml (so no need to create 3D object for them)... but they also admits to be defined as 3D objects (for this method is needed to create 3D objects for them, this allows for more complex lights animations or cinematic effects like camera travellings)

<?xml version='1.0' encoding="UTF-8"?>

<raf angle_unit="radian/degree">

<model id="model" file="model.dae" vertex_color="disable/enable" >

<animation id="animation" file="animation.dae" start="1" end="100" sampling_rate="1" />

</model>

<material id="material" effect="pure_texture/pure_texture_alpha_0_depth_1/pure_texture_alpha_1_depth_0/pure_texture_alpha_0_depth_0/basic_lighting/basic_lighting_alpha_0/basic_lighting_edge_lit/basic_lighting_edge_lit_alpha_0/basic_lighting_alpha_add" >

<texture file="texture.jpg/texture.dds" type="color_map/normal_map/specular_map/tangent_normal_map" />

</material>

<actor id="actor" model="model" material="material" position="x,y,z" rotation="x,y,z" scale="x,y,z" color="r,g,b,a" uv_scale="u,v" uv_offset="u,v" anim_weight="anim0, anim1, anim2, anim3" anim_speed="anim0, anim1, anim2, anim3" anim_time="anim0, anim1, anim2, anim3" />

<camera id="camera" file="camera.dae" type="perspective/orthographic" yfov="1" ymag="1" znear="1" zfar="1" position="x,y,z" direction="x,y,z" up="x,y,z" />

<light id="light" file="light.dae" type="ambient/point" color="r,g,b" position="x,y,z" direction="x,y,z" attenuation="1,1,1" />

<script file="script.js" />

</raf>

</syntaxhighlight>}}

{| class="wikitable"

|-

| angle_unit  ||  Unit of angles in the scene file (radian/degree)

|}

===Model===

{| class="wikitable"

|-

| id  || String accessed as the model attribute of the <actor> element

| vertex_color || Usage (or lack) of color regarding each vertex

*enable/disable

|}

====Animation====

{| class="wikitable"

|-

| id || String accessed by scripts

|-

| sampling_rate || Sampling rate

|}

===Material===

{| class="wikitable"

|-

| id  || String accessed as the material attribute of the <actor> element

* basic_lighting_alpha_add : Derive blending of basic_lighting by addition calculation

* sce01 : internal/reserved ? (used in coldboot.raf compiled with raf tools v1.00)

|}

====Texture====

{| class="wikitable"

|-

| file || Path to the texture file

*specular_map : Specular strength (G)

*tangent_normal_map : Normal in tangent space, valid only for models with TEXTANGENT (RGB)

|}

===Actor===

{| class="wikitable"

|-

| id || String accessed by scripts

| position || Vector to the initial position (x, y, z)

|-

|-

| scale || Vector to the initial scale (x, y, z)

|-

| anim_time || Vector to the animation's initial time (anim0, anim1, anim2, anim3)

| zsort || String indicating the z sort type (unspecified/back to front/front to back) <!-- mandatory in raf format v1.02... not mandatory/inexistant in raf format v1.00 -->

|}

===Camera===

{| class="wikitable"

|-

| id || String accessed by scripts

|-

| up || Vector to the initial up direction (x, y, z)

|}

===Light===

{| class="wikitable"

|-

| id || String accessed by scripts

|-

| attenuation || Vector to the initial attenuation (zero-order, first-order, second-order)

|}

===Script===

{| class="wikitable"

|-

| file || Path to the script file

|}

=Links=

*RAF pages in other wiki/s

**http://ps3.duduclx.fr/index.php?title=Th%C3%A8mes_dynamiques_PS3

*See also: [[Qt Resource Container (QRC)]]