Edit

Share via


plane structure

This structure represents a plane using a 3D vector normal and a distance value.

This type is available only in C++. Its .NET equivalent is System.Numerics.Plane.

Constructors

Name Description
plane() Creates an uninitialized plane.
plane(float x, float y, float z, float d) Creates a plane with the specified values.
plane(float3 normal, float d) Creates a plane from a float3 and a distance.
explicit plane(float4 value) Creates a plane from a float4.
plane(Microsoft::Graphics::Canvas::Numerics::Plane const& value) Converts a Microsoft.Graphics.Canvas.Numerics.Plane to a plane.

Functions

Name Description
plane make_plane_from_vertices(float3 const& point1, float3 const& point2, float3 const& point3) Creates a plane from a set of three vertex positions, which must all be different and not in a straight line.
plane normalize(plane const& value) Changes the coefficients of the normal vector of a plane to make it of unit length.
plane transform(plane const& plane, float4x4 const& matrix) Transforms a normalized plane by a matrix.
plane transform(plane const& plane, quaternion const& rotation) Transforms a normalized plane by a quaternion rotation.
float dot(plane const& plane, float4 const& value) Calculates the dot product of a plane with a vector.
float dot_coordinate(plane const& plane, float3 const& value) Calculates the dot product of a plane with a float3 coordinate. Unlike dot_normal, this computation includes the plane d value.
float dot_normal(plane const& plane, float3 const& value) Calculates the dot product of a plane with a float3 normal. Unlike dot_coordinate, this computation ignores the plane d value.

Operators

Name Description
bool operator== (plane const& value1, plane const& value2) Determines whether two instances of plane are equal.
bool operator!= (plane const& value1, plane const& value2) Determines whether two instances of plane are not equal.
operator Microsoft::Graphics::Canvas::Numerics::Plane() const Converts a plane to a Microsoft.Graphics.Canvas.Numerics.Plane.

Fields

Name Description
float3 normal Normal vector of the plane.
float d Distance of the plane along its normal from the origin.

Requirements

Requirement Value
Namespace Windows::Foundation::Numerics
Header
Windowsnumerics.h

See also

windowsnumerics.h APIs