Voronoi

From RealMotion Wiki

Image Processing/Process/Voronoi

Calculates the Voronoi diagram of a set of points ​

Description

The Voronoi box calculates the Voronoi diagram of a set of points. It can output a vector of points corresponding to the lines to be traced or a texture.

As three connectivity modes are available, the Voronoi box can output a Delaunay triangulation, a Voronoi diagram, or lines connecting dots' centers.

General Use Case: The Voronoi diagram is a mathematical concept that divides a plane into cells based on the distance between a set of points on the same plane (see also : https://en.wikipedia.org/wiki/Voronoi_diagram). It is used both in mathematics and arts.

Inputs

Points 2D Points Receives points as coordinates.

Outputs

Line Points 2D Points Outputs the vector of points.
Texture 2D Render Target Outputs the Voronoi simulation as a texture.
Vertex Colors Float4 Vector Outputs a vector of color matching the line count (pair of points).

Parameters

General

Connectivity Mode String Sets the Connectivity Mode. The Center to Edge mode outputs lines corresponding to the Delaunay triangulation of the vector of points. The Center to Center mode outputs lines that connect directly all dots that meet the connection distance parameter. The Edge only mode outputs lines corresponding to the strict definition of a Voronoi diagram : a line equidistant between two close points and perpendicular to the line connecting them.
Maximum Connection Distance Float Sets the maximum distance for two dots to consider themselves near each other.
Line Color Float4 Sets the lines color.
Output Mode String Sets the output mode between a vector of points and a texture. The Points mode outputs a new vector of points depending on the Connectivity Mode for the Render Lines box to connect.
Render Triangles Toggle Render triangles filling the voronoi cells instead of lines.
Render Triangles Border Toggle Render the border of the triangles over the triangles.
Triangle Color 1 Float4 Set the first color of the color gradient for the generated triangles. The color gradient is interpolated between the Triangle Colors 1 and 2.
Triangle Color 2 Float4 Set the second color of the color gradient for the generated triangles. The color gradient is interpolated between the Triangle Colors 1 and 2.
Animate Gradient Toggle Allows the gradient to change once created from Color 1 to Color 2 and loop back.
Gradient Animation Speed Float Sets the speed at which the gradient complete the animation from Color 1 to Color 2.

Format

|}

Channel Settings

Set Format Toggle Allows the box to change the format of the outputted texture. Once enabled, this creates a new memory allocation for the texture created.
Format String Sets the format of the outputted texture. RGBA 8 bits is the common format. RGBA 16 bits allows negative vector calculation and is mostly used for simulation. RGBA 32 bits allows high precision but may negatively affect the FPS and the Grayscale has only the Red component.
Format Components String Sets the Components used for the outputted texture.
Format Component Bit Depth String Sets the Bit Depth of the outputted texture. 8 bits is the common format, 16 bits allow negative vector calculation and is mostly used for simulation, 32 bits allow high precision but may negatively affect the FPS.
Format Component Type String Sets the pixels value type depending on the Bit Depth.

Canvas Settings

Set Resolution Toggle Allows the box to change the resolution of the outputted texture. Once enabled, this creates a new memory allocation for the texture created.
Resolution Mode String Sets the Resolution Mode. Canvas uses the project configuration settings, Custom uses local setting resolution not shared with other box and Project Aspect Ratio uses the project aspect ratio and proportionally scales the height and width. The parameter chooses the reference Canvas setting the resolution of the outputted texture.
Canvas 2D ResolutionRef Chooses the reference Canvas and sets the resolution of the outputted texture.
Maximum Resolution Int Sets the maximal resolution of the X-axis and calculates the resolution of the Y-axis based on the aspect ratio of the Content Canvas.
Lock Aspect Ratio Toggle Locks the Aspect Ratio for Custom resolution.
Aspect Ratio 2D ResolutionRef Chooses the reference Canvas for the aspect ratio.
Size XY Int2 Sets the size in pixels of the outputted texture.

Alpha

Set Alpha Toggle Enables the alpha overwrite.
Alpha Float Sets the alpha value to override with.

See Also

Boxes related

Pointer Device, Render Lines, Pointers To Points, Particle System 2D, Point Simulator, ​​

Version Information

Current documentation version: 2.1.3. ​ ​