Geometry Utilities (mathutils.geometry)

The Blender geometry module

mathutils.geometry.BarycentricTransform()

Undocumented (contribute)

mathutils.geometry.BezierInterp()

Undocumented (contribute)

mathutils.geometry.BoxPack2D()

Undocumented (contribute)

mathutils.geometry.ClosestPointOnLine(pt, line_p1, line_p2)

Takes a point and a line and returns a tuple with the closest point on the line and its distance from the first point of the line as a percentage of the length of the line.

Return type:

(mathutils.Vector, float)

Parameters:

• pt (mathutils.Vector) – Point
• line_p1 (mathutils.Vector) – First point of the line
• line_p1 – Second point of the line

mathutils.geometry.Intersect(v1, v2, v3, ray, orig, clip=True)

Returns the intersection between a ray and a triangle, if possible, returns None otherwise.

Return type:

boolean

Parameters:

• v1 (mathutils.Vector) – Point1
• v2 (mathutils.Vector) – Point2
• v3 (mathutils.Vector) – Point3
• ray (mathutils.Vector) – Direction of the projection
• orig (mathutils.Vector) – Origin
• clip (boolean) – Clip by the ray length

mathutils.geometry.LineIntersect(v1, v2, v3, v4)

Returns a tuple with the points on each line respectively closest to the other.

Return type:

tuple with elements being of type mathutils.Vector

Parameters:

• v1 (mathutils.Vector) – First point of the first line
• v2 (mathutils.Vector) – Second point of the first line
• v3 (mathutils.Vector) – First point of the second line
• v4 (mathutils.Vector) – Second point of the second line

mathutils.geometry.LineIntersect2D(lineA_p1, lineA_p2, lineB_p1, lineB_p2)

Takes 2 lines (as 4 vectors) and returns a vector for their point of intersection or None.

Return type:

mathutils.Vector

Parameters:

• lineA_p1 (mathutils.Vector) – First point of the first line
• lineA_p2 (mathutils.Vector) – Second point of the first line
• lineB_p1 (mathutils.Vector) – First point of the second line
• lineB_p2 (mathutils.Vector) – Second point of the second line

mathutils.geometry.PointInQuad2D(pt, quad_p1, quad_p2, quad_p3, quad_p4)

Takes 5 vectors (using only the x and y coordinates): one is the point and the next 4 define the quad, only the x and y are used from the vectors. Returns 1 if the point is within the quad, otherwise 0.

Return type:

int

Parameters:

• pt – Point
• quad_p1 (mathutils.Vector) – First point of the quad
• quad_p2 (mathutils.Vector) – Second point of the quad
• quad_p3 (mathutils.Vector) – Third point of the quad
• quad_p4 (mathutils.Vector) – Forth point of the quad

mathutils.geometry.PointInTriangle2D(pt, tri_p1, tri_p2, tri_p3)

Takes 4 vectors (using only the x and y coordinates): one is the point and the next 3 define the triangle. Returns 1 if the point is within the triangle, otherwise 0.

Return type:

int

Parameters:

• pt – Point
• tri_p1 (mathutils.Vector) – First point of the triangle
• tri_p2 (mathutils.Vector) – Second point of the triangle
• tri_p3 (mathutils.Vector) – Third point of the triangle

mathutils.geometry.PolyFill(veclist_list)

Takes a list of polylines (each point a vector) and returns the point indicies for a polyline filled with triangles.

Return type:

list

Parameters:

• veclist_list – list of polylines

mathutils.geometry.QuadNormal(v1, v2, v3, v4)

Returns the normal of the 3D quad defined.

Return type:

mathutils.Vector

Parameters:

• v1 (mathutils.Vector) – Point1
• v2 (mathutils.Vector) – Point2
• v3 (mathutils.Vector) – Point3
• v4 (mathutils.Vector) – Point4

mathutils.geometry.TriangleArea(v1, v2, v3)

Returns the area size of the 2D or 3D triangle defined.

Return type:

float

Parameters:

• v1 (mathutils.Vector) – Point1
• v2 (mathutils.Vector) – Point2
• v3 (mathutils.Vector) – Point3

mathutils.geometry.TriangleNormal(v1, v2, v3)

Returns the normal of the 3D triangle defined.

Return type:

mathutils.Vector

Parameters:

• v1 (mathutils.Vector) – Point1
• v2 (mathutils.Vector) – Point2
• v3 (mathutils.Vector) – Point3