Shader Type

Primitive: Draws each particle point as a specific primitive type such as a sphere, snowflake, cube, etc.

Primitive Type

Specifies the type of primitive used to draw the particle. You can choose Points, Cubes, Spheres (Solid), Spheres (Wireframe), Snowflake, Debris, Quad, or Arrows.

Point Size

Sets the size (width) of the point primitive in pixels. The default is 1.0.

Available when Primitive Type is set to Points.

Smooth Point

Enables primitive antialiasing.

Available when Primitive Type is set to Points.

Stretch Along Velocity

Stretches the primitive along the length of each particle’s velocity vector.

Available when Primitive Type is set to Cubes, Spheres (Solid), Spheres (Wireframe), Snowflake, Debris, Quad, or Arrows.

Use GPU Instancing

GPU instancing is way of transforming the particles using the GPU which can double your render speeds, particularly for very large particle clouds. Instead of transforming the vertices of the primitive on the CPU (basically positioning each particle and then rendering an instance), the GPU renders the instance and then passes the position as an attribute of the vertex. The position of the particle is retrieved and transformed in the vertex shader.

When disabled, the primitive is rendered using the traditional method of transforming the instances on the CPU.

Available when Primitive Type is set to Cubes, Spheres (Solid), Spheres (Wireframe), Snowflake, Debris, Quad, or Arrows.

Custom Fragment Shader

Opens a text editor where you can enter the code for a fragment shader. This allows you to override the fixed functionality part of the pipeline with your own custom fragment shader code.

Available when Primitive Type is set to Cubes, Spheres (Solid), Spheres (Wireframe), Snowflake, Debris, Quad, or Arrows.

Fragment Shader

The text editor widget supports text customization (font, color, size), syntax styling, folding (hiding blocks such as functions and subroutines), auto-completion and highlighting for keywords.

To implement this text editor widget in your own plug-ins, see Text Editor Widget [SDK Guide].

Sprite Layout

When you are using a texture as a sprite, you can use the entire image as a tile (Single) or you can separate the texture into tiles of 2x2, 3x3, 4x4, all the way up to 8x8. The texture’s coordinates are updated to use only the tile portion specified by this option.

This is particularly useful if you’re using a multi-image texture (such as the image below) to achieve texture animation in the sprite.

Shader Type

HW Accelerated Sprites: Draws OpenGL hardware accelerated point sprites at each point position.

Point Size

Sets the size (width) of the point primitive in pixels. The default is 1.0.

Point Size Minimum

Sets the attenuated minimum point size. The default is 0.0. Values less than zero are invalid.

Note: If you set the minimum point size greater than the maximum point size then the point size will be undefined.

Point Size Max

Sets the attenuated maximum point size. Values less than zero are invalid.

Fade Threshold

Sets the threshold for alpha attenuation. This fades the point alpha when the point width goes below the given threshold. Values less than zero are invalid.

Attenuation

Attenuation is the effect of points appearing to diminish in size as a function of distance. Each point has constant, linear, and quadratic attenuation factors that are taken into account when the point size is computed.

Constant

Allows the size of a point to be affected by constant distance attenuation.

Linear

Allows the size of a point to be affected by linear distance attenuation.

Quadratic

Allows the size of a point to be affected by quadratic distance attenuation.

Shader Type

Billboard Sprites: Draws billboard sprites for each point primitive using the OpenGL point sprite extension. This shader is similar to the hardware accelerated sprites shader, expect that billboard sprites are expanded on the CPU and then sent to the GPU. This means that the size of the sprites remain the same regardless of the viewing angle.

Sprite Layout

When you are using a texture as a sprite, you can use the entire image as a tile (Single) or you can separate the texture into tiles of 2x2, 3x3, 4x4, all the way up to 8x8. The texture’s coordinates are updated to use only the tile portion specified by this option.

This is particularly useful if you’re using a multi-image texture (such as the image below) to achieve texture animation in the sprite.

Shader Type

Velocity Vectors: Draws a line behind each point primitive, the length of which is dependent on the particle’s velocity.

Sprite Layout

When you are using a texture as a sprite, you can use the entire image as a tile (Single) or you can separate the texture into tiles of 2x2, 3x3, 4x4, all the way up to 8x8. The texture’s coordinates are updated to use only the tile portion specified by this option.

This is particularly useful if you’re using a multi-image texture (such as the image below) to achieve texture animation in the sprite.

Shader Type

Density: Draws each point and displays the cloud density encoded as colors. For each point, the density shader will check the distance of neighboring particles and, depending on the Density Falloff and Density Limit, will shade the point using the Sparse or Dense color settings. This shader is useful for visualizing the density of particle clouds.

Point Size

Sets the size (width) of the point primitive in pixels. The default is 1.0.

Smooth Point

Enables primitive antialiasing.

Density Falloff

Sets the rate at which the particle color blends from the Dense color to the Sparse color, and vise versa.

Density Limit (in # of particles)

Sets the number of particles whose proximity to each other (based on a hard-coded distance to neighboring particles) is considered dense.

Sparse

Sets the color to shade the particles that are considered sparse in terms of their proximity to each other.

Dense

Sets the color to shade the particles that are considered dense in terms of their proximity to each other.

Shader Type

Line Trails: Draws particle trails as lines.

Use GPU Instancing

GPU instancing is way of transforming the particles using the GPU which can double your render speeds, particularly for very large particle clouds. Instead of transforming the vertices of the primitive on the CPU (basically positioning each particle and then rendering an instance), the GPU renders the instance and then passes the position as an attribute of the vertex. The position of the particle is retrieved and transformed within the vertex shader.

Custom Fragment Shader

Opens a text editor where you can enter the code for a fragment shader. This allows you to override the fixed functionality part of the pipeline with your own custom fragment shader code.

Fragment Shader

The text editor widget supports text customization (font, color, size), syntax styling, folding (hiding blocks such as functions and subroutines), auto-completion and highlighting for keywords.

To implement this text editor widget in your own plug-ins, see Text Editor Widget [SDK Guide].

Use OpenGL Lighting

Turns on or off lighting. GL lighting produces a primary and secondary color for each vertex. The effects from enabled light sources are used in conjunction with surface material properties to determine the lit color at a particular vertex.

Use Blending

Enable or disable blending. When enabled, the blend function defines the operation of blending.

BlendScr

The blend source factor (sfactor) specifies which method is used to scale the source color components.

Select one of the supported methods from the drop-down menu. Each method defines four scale factors, one each for red, green, blue, and alpha. All scale factors have range [0,1].

BlendDest

The blend destination factor (dfactor) specifies which method is used to scale the destination color components.

Select one of the supported methods from the drop-down menu. Each method defines four scale factors, one each for red, green, blue, and alpha. All scale factors have range [0,1].

Perform Alpha Testing

Enable or disable alpha testing.

AlphaFunc

Specifies the alpha comparison function (func).

Select one of the supported comparison functions from the drop-down menu. The functions are defined as follows:

• GL_NEVER

Never passes.

• GL_LESS

Passes if the incoming alpha value is less than the reference value.

• GL_EQUAL

Passes if the incoming alpha value is equal to the reference value.

• GL_LEQUAL

Passes if the incoming alpha value is less than or equal to the reference value.

• GL_GREATER

Passes if the incoming alpha value is greater than the reference value.

• GL_NOTEQUAL

Passes if the incoming alpha value is not equal to the reference value.

• GL_GEQUAL

Passes if the incoming alpha value is greater than or equal to the reference value.

• GL_ALWAYS

Always passes.

AlphaRef

Specifies the reference value (ref) that incoming alpha values are compared to. This value is clamped to the range [0,1], where 0 represents the lowest possible alpha value and 1 the highest possible value.