plane structure
Article 03/13/2023
6 contributors
Feedback
In this article
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