diff options
Diffstat (limited to 'doc/classes/Plane.xml')
| -rw-r--r-- | doc/classes/Plane.xml | 100 |
1 files changed, 58 insertions, 42 deletions
diff --git a/doc/classes/Plane.xml b/doc/classes/Plane.xml index 32eb71f1c7..aa09081e3e 100644 --- a/doc/classes/Plane.xml +++ b/doc/classes/Plane.xml @@ -18,112 +18,121 @@ </constructor> <constructor name="Plane"> <return type="Plane" /> - <argument index="0" name="from" type="Plane" /> + <param index="0" name="from" type="Plane" /> <description> Constructs a [Plane] as a copy of the given [Plane]. </description> </constructor> <constructor name="Plane"> <return type="Plane" /> - <argument index="0" name="a" type="float" /> - <argument index="1" name="b" type="float" /> - <argument index="2" name="c" type="float" /> - <argument index="3" name="d" type="float" /> + <param index="0" name="a" type="float" /> + <param index="1" name="b" type="float" /> + <param index="2" name="c" type="float" /> + <param index="3" name="d" type="float" /> <description> - Creates a plane from the four parameters. The three components of the resulting plane's [member normal] are [code]a[/code], [code]b[/code] and [code]c[/code], and the plane has a distance of [code]d[/code] from the origin. + Creates a plane from the four parameters. The three components of the resulting plane's [member normal] are [param a], [param b] and [param c], and the plane has a distance of [param d] from the origin. </description> </constructor> <constructor name="Plane"> <return type="Plane" /> - <argument index="0" name="normal" type="Vector3" /> + <param index="0" name="normal" type="Vector3" /> <description> Creates a plane from the normal vector. The plane will intersect the origin. + The [param normal] of the plane must be a unit vector. </description> </constructor> <constructor name="Plane"> <return type="Plane" /> - <argument index="0" name="normal" type="Vector3" /> - <argument index="1" name="d" type="float" /> + <param index="0" name="normal" type="Vector3" /> + <param index="1" name="d" type="float" /> <description> Creates a plane from the normal vector and the plane's distance from the origin. + The [param normal] of the plane must be a unit vector. </description> </constructor> <constructor name="Plane"> <return type="Plane" /> - <argument index="0" name="normal" type="Vector3" /> - <argument index="1" name="point" type="Vector3" /> + <param index="0" name="normal" type="Vector3" /> + <param index="1" name="point" type="Vector3" /> <description> Creates a plane from the normal vector and a point on the plane. + The [param normal] of the plane must be a unit vector. </description> </constructor> <constructor name="Plane"> <return type="Plane" /> - <argument index="0" name="point1" type="Vector3" /> - <argument index="1" name="point2" type="Vector3" /> - <argument index="2" name="point3" type="Vector3" /> + <param index="0" name="point1" type="Vector3" /> + <param index="1" name="point2" type="Vector3" /> + <param index="2" name="point3" type="Vector3" /> <description> Creates a plane from the three points, given in clockwise order. </description> </constructor> </constructors> <methods> - <method name="center" qualifiers="const"> - <return type="Vector3" /> + <method name="distance_to" qualifiers="const"> + <return type="float" /> + <param index="0" name="point" type="Vector3" /> <description> - Returns the center of the plane. + Returns the shortest distance from the plane to the position [param point]. If the point is above the plane, the distance will be positive. If below, the distance will be negative. </description> </method> - <method name="distance_to" qualifiers="const"> - <return type="float" /> - <argument index="0" name="point" type="Vector3" /> + <method name="get_center" qualifiers="const"> + <return type="Vector3" /> <description> - Returns the shortest distance from the plane to the position [code]point[/code]. If the point is above the plane, the distance will be positive. If below, the distance will be negative. + Returns the center of the plane. </description> </method> <method name="has_point" qualifiers="const"> <return type="bool" /> - <argument index="0" name="point" type="Vector3" /> - <argument index="1" name="tolerance" type="float" default="1e-05" /> + <param index="0" name="point" type="Vector3" /> + <param index="1" name="tolerance" type="float" default="1e-05" /> <description> - Returns [code]true[/code] if [code]point[/code] is inside the plane. Comparison uses a custom minimum [code]tolerance[/code] threshold. + Returns [code]true[/code] if [param point] is inside the plane. Comparison uses a custom minimum [param tolerance] threshold. </description> </method> <method name="intersect_3" qualifiers="const"> <return type="Variant" /> - <argument index="0" name="b" type="Plane" /> - <argument index="1" name="c" type="Plane" /> + <param index="0" name="b" type="Plane" /> + <param index="1" name="c" type="Plane" /> <description> - Returns the intersection point of the three planes [code]b[/code], [code]c[/code] and this plane. If no intersection is found, [code]null[/code] is returned. + Returns the intersection point of the three planes [param b], [param c] and this plane. If no intersection is found, [code]null[/code] is returned. </description> </method> <method name="intersects_ray" qualifiers="const"> <return type="Variant" /> - <argument index="0" name="from" type="Vector3" /> - <argument index="1" name="dir" type="Vector3" /> + <param index="0" name="from" type="Vector3" /> + <param index="1" name="dir" type="Vector3" /> <description> - Returns the intersection point of a ray consisting of the position [code]from[/code] and the direction normal [code]dir[/code] with this plane. If no intersection is found, [code]null[/code] is returned. + Returns the intersection point of a ray consisting of the position [param from] and the direction normal [param dir] with this plane. If no intersection is found, [code]null[/code] is returned. </description> </method> <method name="intersects_segment" qualifiers="const"> <return type="Variant" /> - <argument index="0" name="from" type="Vector3" /> - <argument index="1" name="to" type="Vector3" /> + <param index="0" name="from" type="Vector3" /> + <param index="1" name="to" type="Vector3" /> <description> - Returns the intersection point of a segment from position [code]from[/code] to position [code]to[/code] with this plane. If no intersection is found, [code]null[/code] is returned. + Returns the intersection point of a segment from position [param from] to position [param to] with this plane. If no intersection is found, [code]null[/code] is returned. </description> </method> <method name="is_equal_approx" qualifiers="const"> <return type="bool" /> - <argument index="0" name="to_plane" type="Plane" /> + <param index="0" name="to_plane" type="Plane" /> <description> - Returns [code]true[/code] if this plane and [code]plane[/code] are approximately equal, by running [method @GlobalScope.is_equal_approx] on each component. + Returns [code]true[/code] if this plane and [param to_plane] are approximately equal, by running [method @GlobalScope.is_equal_approx] on each component. + </description> + </method> + <method name="is_finite" qualifiers="const"> + <return type="bool" /> + <description> + Returns [code]true[/code] if this plane is finite, by calling [method @GlobalScope.is_finite] on each component. </description> </method> <method name="is_point_over" qualifiers="const"> <return type="bool" /> - <argument index="0" name="point" type="Vector3" /> + <param index="0" name="point" type="Vector3" /> <description> - Returns [code]true[/code] if [code]point[/code] is located above the plane. + Returns [code]true[/code] if [param point] is located above the plane. </description> </method> <method name="normalized" qualifiers="const"> @@ -134,9 +143,9 @@ </method> <method name="project" qualifiers="const"> <return type="Vector3" /> - <argument index="0" name="point" type="Vector3" /> + <param index="0" name="point" type="Vector3" /> <description> - Returns the orthogonal projection of [code]point[/code] into a point in the plane. + Returns the orthogonal projection of [param point] into a point in the plane. </description> </method> </methods> @@ -146,7 +155,7 @@ In the scalar equation of the plane [code]ax + by + cz = d[/code], this is [code]d[/code], while the [code](a, b, c)[/code] coordinates are represented by the [member normal] property. </member> <member name="normal" type="Vector3" setter="" getter="" default="Vector3(0, 0, 0)"> - The normal of the plane, which must be normalized. + The normal of the plane, which must be a unit vector. In the scalar equation of the plane [code]ax + by + cz = d[/code], this is the vector [code](a, b, c)[/code], where [code]d[/code] is the [member d] property. </member> <member name="x" type="float" setter="" getter="" default="0.0"> @@ -173,15 +182,22 @@ <operators> <operator name="operator !="> <return type="bool" /> - <argument index="0" name="right" type="Plane" /> + <param index="0" name="right" type="Plane" /> <description> Returns [code]true[/code] if the planes are not equal. [b]Note:[/b] Due to floating-point precision errors, consider using [method is_equal_approx] instead, which is more reliable. </description> </operator> + <operator name="operator *"> + <return type="Plane" /> + <param index="0" name="right" type="Transform3D" /> + <description> + Inversely transforms (multiplies) the [Plane] by the given [Transform3D] transformation matrix. + </description> + </operator> <operator name="operator =="> <return type="bool" /> - <argument index="0" name="right" type="Plane" /> + <param index="0" name="right" type="Plane" /> <description> Returns [code]true[/code] if the planes are exactly equal. [b]Note:[/b] Due to floating-point precision errors, consider using [method is_equal_approx] instead, which is more reliable. |