Voronoi node documentation.

1676133c · Ilya Portnov · 51ab732e · 1676133c
--- a/docs/nodes/modifier_make/voronoi_2d.rst
+++ b/docs/nodes/modifier_make/voronoi_2d.rst
-Voronoi 2D and Delaunay
-=======================
+Voronoi 2D Node
+===============

-This is a spartan note. Both these nodes are written in the same file so both online/offline help files will point into this file.
+Functionality
+-------------

-Bugs?
-The most recent mention of a bug for the Delaunay Node is that you must ensure that your input mesh has no doubles (co-location vertices). Else you will get an edge with zero distance for which the voronoi diagram will fail to compute (due to division by zero)
+This node generates Voronoi_ diagram for the provided set of vertices in 2D space (in XOY plane).
+
+In general, Voronoi diagram is infinite construction that covers the whole XOY
+plane. We cannot deal with such endless thing, so we have to clip that with
+some bounds. It is possible to define bounds either based on bounding box of
+provided vertices, or based on a circle that encloses all provided vertices.
+
+When we clip the diagram, there can be clipped polygons (they are produced when
+the bounding line splits the polygon from original diagram in two parts) or
+clipped lines (because some lines in original Voronoi diagram are endless).
+
+.. _Voronoi: https://en.wikipedia.org/wiki/Voronoi_diagram
+
+Inputs
+------
+
+The node has the following inputs:
+
+* **Vertices**. Set of input vertices to build Voronoi diagram for.
+
+Parameters
+----------
+
+This node has the following parameters:
+
+- **Bounds Mode**. The mode of diagram bounds definition. Possible values are
+  **Bounding Box** and **Circle**. The default value is **Bounding Box**.
+- **Draw Bounds**. If checked, then the edges connecting boundary vertices will
+  be generated. Checked by default.
+- **Draw Tails**. If checked, then the edges that go from the central part of
+  diagram to outside the bounding line, will be generated. This parameter is
+  available only if **Draw Bounds** is not checked. Checked by default.
+- **Clipping**. Amount of space to be added for bounding line. If bounds are
+  defined by bounding box, then this amount of space will be added in each
+  direction (top, bottom, right and left). If bounds are defined by bounding
+  circle, then this amount will be added to the circle's radius. Default value is 1.0.
+
+Outputs
+-------
+
+This node has the following outputs:
+
+- **Vertices**
+- **Edges**
+
+It is possible to use **Fill Holes** node to generate polygons for the diagram.