oZone3D.Net - Demoniak3D Developer Guide

The <particle_system_action> node

Function

The particle_system_action node describes an action that allows to modify the basic characteristics of a particle (speed, size, color, etc...).

General syntax

<particle_system_action
	name=""
	master_object=""
	type="GRAVITY" >

	<color_final_color
		r="0.0" 
		g="0.0" 
		b="0.0" 
		a="0.0" />
		
	<color_variation_velocity
		r="0.001" 
		g="0.001" 
		b="0.001" 
		a="0.0" />

	<gravity_vector
		x="0.0" 
		y="0.0" 
		z="0.0" />
	
	<orbit_point_acceleration_vector
		x="0.0" 
		y="0.0" 
		z="0.0" />

	<size_final_size
		x="10.0" 
		y="10.0"  />
	
	<size_variation_velocity
		x="10.0" 
		y="10.0" />
</particle_system_action>

particle_system_action element

particle_system_action is the xml tag that defines a particle_system_action node.

Attributes:

name - [STR127] - name of the node. This name will make it possible to refer this node throughout the XML script.
master_object - [STR127] - name of the node representing the reference object. the meaning of master_object dependends on the type of the action.
type - [ENUM] - action type:
- GRAVITY: simulates the gravity effect. See the gravity_vector instruction to set gravity - default value
- COLOR: modifies the initial color of the particle. See the color_final_color and color_variation_velocity instructions to set the color action
- SIZE: modifies the initial size of the particle. See the size_final_size and size_variation_velocity to set the size action
- ORBIT_POINT: creates an attraction point for the particles. See the orbit_point_acceleration_vector instructions to set the orbit point

gravity_vector element

gravity_vector specifies the value of the gravity vector.

Attributes:

x - [REAL] - X component of the gravity vector - default value: 0.0
y - [REAL] - Y component of the gravity vector - default value: -10.0
z - [REAL] - Z component of the gravity vector - default value: 0.0

size_final_size element

size_final_size specifies the final value of the particles size.

Attributes:

x - [REAL] - final width - default value: 10.0
y - [REAL] - final height - default value: 10.0

size_variation_velocity element

size_variation_velocity allows to specify the size variation speed at each frame.

Attributes:

x - [REAL] - width variation speed - default value: 0.001
y - [REAL] - height variation speed - default value: 0.001

orbit_point_acceleration_vector element

orbit_point_acceleration_vector allows to specify the acceleration vector to be applied to the particles.

Attributes:

x - [REAL] - X component of the acceleration vector - default value: 10.0
y - [REAL] - Y component of the acceleration vector - default value: 50.0
z - [REAL] - Z component of the acceleration vector - default value: 10.0

color_final_color element

color_final_color specifies the end value of the particles color.

Attributes:

r - [REAL] - final value of the red component of the color - default value: 0.0
g - [REAL] - final value of the green component of the color - default value: 0.0
b - [REAL] - final value of the blue component of the color - default value: 0.0
a - [REAL] - final value of the alpha component of the color - default value: 0.0

color_variation_velocity element

color_variation_velocity allows to specify the variation speed the color at each frame.

Attributes:

r - [REAL] - value of the variation speed of the red component - default value: 0.001
g - [REAL] - value of the variation speed of the green component - default value: 0.001
b - [REAL] - value of the variation speed of the blue component - default value: 0.001
a - [REAL] - value of the variation speed of the alpha component - default value: 0.0