Method

This node renders lines between pairs of nearby particles, giving the impression of a mesh-like structure.

The connection pairs are determined by locating particles that are near to each other using a spatial grid. This grid may be scaled by connecting a node to the Bounding Box input. A particle may be connected to multiple others; the amount is controlled by the Max Lines Per Particle parameter. The Min Distance and Distance Threshold parameters are used to limit the distance between particles that are allowed to be connected, and the Max X/Y/Z Difference parameters control the limits on separations in each dimension of space. Additionally a position and radius may be used to limit the area of space where lines can be generated, specified by the Affected Radius parameter and the Affected Centre Position input.

Once connected, particles remain joined for a period of time specified by the Line Connection Lifetime parameter unless one of the particles dies.

Particles can be sorted in back to front rendering order if Sort Particles is enabled, allowing transparent particles to render and blend together correctly. The Blend Mode parameter is used to control the blend mode between individual particles and also between the particles and the rest of the scene. The Particle Alpha parameter can be used to control the transparency of individual particles, scaling the alpha value already on the particle’s colour channel. Lines may be rendered as thin single pixel lines, or thickened and rendered as quads with softened edges, determined by the Use Thick Lines parameter. When rendered as thick lines the line thickness may be controlled by the Line Thickness parameter.

Example
This image is taken from the “imag_samples.dfx” sample project.

Attributes

Name Description
Particle Alpha Change the alpha value for the particles.
Luminance Randomness Control how much randomness is in the luminance of the rendered particles.
Sort Key Value Biases the depth-based render order, to force the particle system to be drawn before or after other objects in the scene.
Depth Bias Offsets particles in depth so they are closer or further away from the camera, changing the point at which they intersect with the rest of the scene.
Distance Threshold Maximum distance a line can be drawn at.
Min Distance Maximum distance a line can be drawn at.
Particle Use Amount Percentage of particles that can be used by the node.
Line Thickness Edit the thickness of the line rendered. Only functions if “Use Thick Lines” is enabled.
Depth Of Field Amount How much depth of field effects the particles.
Line Connection Lifetime Length of time a line between two points can exist.
Affected Radius The radius of the area of space within which connections may be generated.
Max X Difference The maximum separation of particles in the X axis that can be connected.
Max Y Difference The maximum separation of particles in the Y axis that can be connected.
Max Z Difference The maximum separation of particles in the Z axis that can be connected.
Cast Shadows Control whether shadows are cast.
Sort Particles Toggle whether the particles are sorted by depth from camera from back to front before rendering, enabling transparent particles to be rendered correctly.
Blend Mode Edit the blend mode used for the particles. See Blend Modes for details.
Use Thick Lines Toggle whether the lines have 3D thickness, or not.
Max Lines Per Particle Maximum number of lines that can be drawn from each particle.

Inputs

Name Description Typical Node Input
Bounding Box Limit the area for which shadow casting will be calculated. Bounding Box
Affected Centre Position Controls the centre position of a radial area of space where the connections may be generated. Null
Rendered Emitters Specify which emitters are rendered using this renderer. By default, all emitters connected to the same particle root as the renderer are rendered. Primitive Emitter
Transform Modifier Links all transform properties to the input node. Null
Target Node Always faces the x-axis towards the inputs anchor point. Null
Local Transform Override Override the transformation values of the node, relative to its parent. Null

Outputs

The outputs section for this node is currently being worked on.