Plane in hessian form.

## Description

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 | Plane ( float a, float b, float c, float d ) |

Plane | Plane ( Vector3 v1, Vector3 v2, Vector3 v3 ) |

Plane | Plane ( Vector3 normal, float d ) |

Vector3 | center ( ) |

float | distance_to ( Vector3 point ) |

Vector3 | get_any_point ( ) |

bool | has_point ( Vector3 point, float epsilon=0.00001 ) |

Vector3 | intersect_3 ( Plane b, Plane c ) |

Vector3 | intersects_ray ( Vector3 from, Vector3 dir ) |

Vector3 | intersects_segment ( Vector3 begin, Vector3 end ) |

bool | is_equal_approx ( Plane plane ) |

bool | is_point_over ( Vector3 point ) |

Plane | normalized ( ) |

Vector3 | project ( Vector3 point ) |

## Constants

**PLANE_YZ**=**Plane( 1, 0, 0, 0 )**— A plane that extends in the Y and Z axes.**PLANE_XZ**=**Plane( 0, 1, 0, 0 )**— A plane that extends in the X and Z axes.**PLANE_XY**=**Plane( 0, 0, 1, 0 )**— A plane that extends in the X and Y axes.

## Property Descriptions

- float
**d**

Default | `0.0` |

Distance from the origin to the plane, in the direction of normal.

- Vector3
**normal**

Default | `Vector3( 0, 0, 0 )` |

The normal of the plane. “Over” or “Above” the plane is considered the side of the plane towards where the normal is pointing.

- float
**x**

Default | `0.0` |

The normal’s X component.

- float
**y**

Default | `0.0` |

The normal’s Y component.

- float
**z**

Default | `0.0` |

The normal’s Z component.

## Method Descriptions

Creates a plane from the four parameters. The three components of the resulting plane’s normal 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.

- Vector3
**center****(****)**

Returns the center of the plane.

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

.

- Vector3
**get_any_point****(****)**

Returns a point on the plane.

Returns `true`

if `point`

is inside the plane (by a very minimum `epsilon`

threshold).

Returns the intersection point of the three planes `b`

, `c`

and this plane. If no intersection is found, `null`

is returned.

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.

Returns `true`

if this plane and `plane`

are approximately equal, by running @GDScript.is_equal_approx on each component.

Returns `true`

if `point`

is located above the plane.

- Plane
**normalized****(****)**

Returns a copy of the plane, normalized.

Returns the orthogonal projection of point `p`

into a point in the plane.

## Leave a Reply