1 files changed, 45 insertions, 0 deletions
diff --git a/source/blender/python/api2_2x/doc/Geometry.py b/source/blender/python/api2_2x/doc/Geometry.py
new file mode 100644
index 00000000000..5ffc5928cc6
--- /dev/null
+++ b/source/blender/python/api2_2x/doc/Geometry.py
@@ -0,0 +1,45 @@
+# Blender.Geometry module and its subtypes
+
+"""
+The Blender.Geometry submodule.
+
+Geometry
+========
+
+This new module provides access to a geometry function.
+"""
+
+def PolyFill(polylines):
+  """
+  Takes a list of polylines and calculates triangles that would fill in the polylines.
+  Multiple lines can be used to make holes inside a polyline, or fill in 2 seperate lines at once.
+  @type polylines: List of lists containing vectors, each representing a closed polyline.
+  @rtype: list
+  @return: a list if tuples each a tuple of 3 ints representing a triangle indexing the points given.
+  @note: 2D Vectors will have an assumed Z axis of zero, 4D Vectors W axis is ignored.
+  @note: The order of points in a polyline effect the direction returned triangles face, reverse the order of a polyline to flip the normal of returned faces.
+
+  I{B{Example:}}
+
+  The example below creates 2 polylines and fills them in with faces, then makes a mesh in the current scene::
+    import Blender
+    Vector= Blender.Mathutils.Vector
+
+    # Outline of 5 points
+    polyline1= [Vector(-2.0, 1.0, 1.0), Vector(-1.0, 2.0, 1.0), Vector(1.0, 2.0, 1.0), Vector(1.0, -1.0, 1.0), Vector(-1.0, -1.0, 1.0)]
+    polyline2= [Vector(-1, 1, 1.0), Vector(0, 1, 1.0), Vector(0, 0, 1.0), Vector(-1.0, 0.0, 1.0)]
+    fill= Blender.Geometry.PolyFill([polyline1, polyline2])
+
+    # Make a new mesh and add the truangles into it
+    me= Blender.Mesh.New()
+    me.verts.extend(polyline1)
+    me.verts.extend(polyline2)
+    me.faces.extend(fill) # Add the faces, they reference the verts in polyline 1 and 2
+
+    ob= Blender.Object.New('Mesh')
+    ob.link(me)
+    scn = Blender.Scene.GetCurrent()
+    scn.link(ob)
+
+    Blender.Redraw()
+  """