Plane

    Plane represents a normalized plane equation. Basically, “normal” is the normal of the plane (a,b,c normalized), and “d” is the distance from the origin to the plane (in the direction of “normal”). “Over” or “Above” the plane is considered the side of the plane towards where the normal is pointing.

    Tutorials

    Methods

    Plane ( a, float b, c, float d )

    Plane ( v1, Vector3 v2, v3 )

    Plane

    ( Vector3 normal, d )

    Vector3

    ( )

    float

    get_any_point ( )

    has_point ( point, float epsilon=1e-05 )

    intersect_3 ( b, Plane c )

    intersects_ray ( from, Vector3 dir )

    intersects_segment ( begin, Vector3 end )

    is_equal_approx ( plane )

    bool

    ( Vector3 point )

    normalized ( )

    project ( point )

    • PLANE_YZ = Plane( 1, 0, 0, 0 ) —- A plane that extends in the Y and Z axes (normal vector points +X).

    • PLANE_XY = Plane( 0, 0, 1, 0 ) —- A plane that extends in the X and Y axes (normal vector points +Z).

    Property Descriptions

    The distance from the origin to the plane, in the direction of . This value is typically non-negative.

    In the scalar equation of the plane ax + by + cz = d, this is d, while the (a, b, c) coordinates are represented by the normal property.

    • normal

    Vector3( 0, 0, 0 )

    The normal of the plane, which must be normalized.

    In the scalar equation of the plane ax + by + cz = d, this is the vector (a, b, c), where is the d property.

    • x

    The X component of the plane’s normal vector.

    • y

    Default

    0.0

    The Y component of the plane’s normal vector.

    • z

    The Z component of the plane’s normal vector.

    Creates a plane from the four parameters. The three components of the resulting plane’s are a, b and c, and the plane has a distance of d from the origin.

    Creates a plane from the three points, given in clockwise order.

    Creates a plane from the normal and the plane’s distance to the origin.

    Returns the center of the plane.

    Returns the shortest distance from the plane to the position point.

    • get_any_point ( )

    Returns the center of the plane.

    This method is deprecated, please use center instead.

    • has_point ( Vector3 point, epsilon=1e-05 )

    Returns true if point is inside the plane. Comparison uses a custom minimum epsilon threshold.

    Returns the intersection point of the three planes , c and this plane. If no intersection is found, null is returned.

    • intersects_ray ( Vector3 from, dir )

    Returns the intersection point of a ray consisting of the position from and the direction normal dir with this plane. If no intersection is found, null is returned.

    Returns the intersection point of a segment from position begin to position end with this plane. If no intersection is found, null is returned.

    • is_equal_approx ( Plane plane )

    Returns true if this plane and plane are approximately equal, by running on each component.

    • bool is_point_over ( point )

    Returns true if is located above the plane.

    Returns the orthogonal projection of point into a point in the plane.