/Godot 3.1

# Plane

Category: Built-In Types

## Brief Description

Plane in hessian form.

## Properties

 float d Vector3 normal float x float y float z

## 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_point_over ( Vector3 point ) Plane normalized ( ) Vector3 project ( Vector3 point )

## Constants

• PLANE_YZ = Plane( 1, 0, 0, 0 )
• PLANE_XZ = Plane( 0, 1, 0, 0 )
• PLANE_XY = Plane( 0, 0, 1, 0 )

## 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.

## Method Descriptions

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

Creates a plane from the four parameters “a”, “b”, “c” and “d”.

Creates a plane from three points.

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

### Vector3 center ( )

Returns the center of the plane.

### float distance_to ( Vector3 point )

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

### Vector3 get_any_point ( )

Returns a point on the plane.

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

Returns `true` if “point” is inside the plane (by a very minimum threshold).

### Vector3 intersect_3 ( Plane b, Plane c )

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

### Vector3 intersects_ray ( Vector3 from, Vector3 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.

### Vector3 intersects_segment ( Vector3 begin, Vector3 end )

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

### bool is_point_over ( Vector3 point )

Returns `true` if “point” is located above the plane.

### Plane normalized ( )

Returns a copy of the plane, normalized.

### Vector3 project ( Vector3 point )

Returns the orthogonal projection of point “p” into a point in the plane.

© 2014–2019 Juan Linietsky, Ariel Manzur, Godot Engine contributors