Struct Line3D

Represents a line in 3D space that is composed of single-precision floating-point X, Y and Z coordinates.

Implements

IEquatable<Line3D>

IComparable<Line3D>

IComparable

Namespace: X10D.Drawing

Assembly: X10D.dll

Syntax

public struct Line3D : IEquatable<Line3D>, IComparable<Line3D>, IComparable

Constructors

Line3D(Vector3, Vector3)

Initializes a new instance of the Line3D struct by taking the start and end points.

Declaration

public Line3D(in Vector3 start, in Vector3 end)

Parameters

Type	Name	Description
Vector3	start	The start point.
Vector3	end	The end point.

Fields

Empty

The empty line. That is, a line whose start and end points are at (0, 0).

Declaration

public static readonly Line3D Empty

Field Value

Type	Description
Line3D

One

The line whose start point is at (0, 0, 0) and end point is at (1, 1, 1).

Declaration

public static readonly Line3D One

Field Value

Type	Description
Line3D

UnitX

The line whose start point is at (0, 0, 0) and end point is at (1, 0, 0).

Declaration

public static readonly Line3D UnitX

Field Value

Type	Description
Line3D

UnitY

The line whose start point is at (0, 0, 0) and end point is at (0, 1, 0).

Declaration

public static readonly Line3D UnitY

Field Value

Type	Description
Line3D

UnitZ

The line whose start point is at (0, 0, 0) and end point is at (0, 0, 1).

Declaration

public static readonly Line3D UnitZ

Field Value

Type	Description
Line3D

Properties

End

Gets the end point of the line.

Declaration

public Vector3 End { get; }

Property Value

Type	Description
Vector3	The end point.

Length

Gets the length of this line.

Declaration

public float Length { get; }

Property Value

Type	Description
System.Single	The length.

LengthSquared

Gets the length of this line, squared.

Declaration

public float LengthSquared { get; }

Property Value

Type	Description
System.Single	The squared length.

Start

Gets the start point of the line.

Declaration

public Vector3 Start { get; }

Property Value

Type	Description
Vector3	The start point.

Methods

CompareTo(Nullable<Object>)

Compares this instance to another object.

Declaration

public int CompareTo(object? obj)

Parameters

Type	Name	Description
System.Nullable<System.Object>	obj	The object with with which to compare

Returns

Type	Description
System.Int32	A signed number indicating the relative values of this instance and obj. Return value Meaning Less than zero The Length of this instance is less than that of obj. Zero This instance is equal to obj, or the Length of both this instance and obj are not a number (), , or . Greater than zero The Length of this instance is greater than that of obj.

Remarks

Comparison internally measures the LengthSquared property to avoid calls to . obj is not an instance of Line3D.

CompareTo(Line3D)

Compares this instance to another Line3D.

Declaration

public int CompareTo(Line3D other)

Parameters

Type	Name	Description
Line3D	other

Returns

Type	Description
System.Int32	A signed number indicating the relative values of this instance and other. Return value Meaning Less than zero The Length of this instance is less than that of other. Zero This instance is equal to other, or the Length of both this instance and other are not a number (), , or . Greater than zero The Length of this instance is greater than that of other.

Remarks

Comparison internally measures the LengthSquared property to avoid calls to .

Equals(Nullable<Object>)

Declaration

public override bool Equals(object? obj)

Parameters

Type	Name	Description
System.Nullable<System.Object>	obj

Returns

Type	Description
System.Boolean

Equals(Line3D)

Returns a value indicating whether this instance and another instance are equal.

Declaration

public bool Equals(Line3D other)

Parameters

Type	Name	Description
Line3D	other	The instance with which to compare.

Returns

Type	Description
System.Boolean	true if this instance and other are considered equal; otherwise, false.

FromLine(Line)

Converts a Line to a LineF.

Declaration

public static Line3D FromLine(in Line line)

Parameters

Type	Name	Description
Line	line	The line to convert.

Returns

Type	Description
Line3D	The converted line.

FromLineF(LineF)

Converts a LineF to a Line3D.

Declaration

public static Line3D FromLineF(in LineF line)

Parameters

Type	Name	Description
LineF	line	The line to convert.

Returns

Type	Description
Line3D	The converted line.

GetHashCode()

Declaration

public override int GetHashCode()

Returns

Type	Description
System.Int32

Operators

Equality(Line3D, Line3D)

Returns a value indicating whether two instances of Line3D are equal.

Declaration

public static bool operator ==(Line3D left, Line3D right)

Parameters

Type	Name	Description
Line3D	left	The first instance.
Line3D	right	The second instance.

Returns

Type	Description
System.Boolean	true if left and right are considered equal; otherwise, false.

GreaterThan(Line3D, Line3D)

Returns a value indicating whether the length of one line is greater than that of another.

Declaration

public static bool operator>(in Line3D left, in Line3D right)

Parameters

Type	Name	Description
Line3D	left	The first instance.
Line3D	right	The second instance.

Returns

Type	Description
System.Boolean	true if the Length of left is greater than that of right; otherwise, false.

GreaterThanOrEqual(Line3D, Line3D)

Returns a value indicating whether the length of one line is greater than or equal to that of another.

Declaration

public static bool operator >=(in Line3D left, in Line3D right)

Parameters

Type	Name	Description
Line3D	left	The first instance.
Line3D	right	The second instance.

Returns

Type	Description
System.Boolean	true if the Length of left is greater than or equal to that of right; otherwise, false.

Implicit(Line to Line3D)

Implicitly converts a Line to a LineF.

Declaration

public static implicit operator Line3D(in Line line)

Parameters

Type	Name	Description
Line	line	The line to convert.

Returns

Type	Description
Line3D	The converted line.

Implicit(LineF to Line3D)

Implicitly converts a LineF to a Line3D.

Declaration

public static implicit operator Line3D(in LineF line)

Parameters

Type	Name	Description
LineF	line	The line to convert.

Returns

Type	Description
Line3D	The converted line.

Inequality(Line3D, Line3D)

Returns a value indicating whether two instances of Line3D are not equal.

Declaration

public static bool operator !=(Line3D left, Line3D right)

Parameters

Type	Name	Description
Line3D	left	The first instance.
Line3D	right	The second instance.

Returns

Type	Description
System.Boolean	true if left and right are considered not equal; otherwise, false.

LessThan(Line3D, Line3D)

Returns a value indicating whether the length of one line is less than that of another.

Declaration

public static bool operator <(in Line3D left, in Line3D right)

Parameters

Type	Name	Description
Line3D	left	The first instance.
Line3D	right	The second instance.

Returns

Type	Description
System.Boolean	true if the Length of left is less than that of right; otherwise, false.

LessThanOrEqual(Line3D, Line3D)

Returns a value indicating whether the length of one line is less than or equal to that of another.

Declaration

public static bool operator <=(in Line3D left, in Line3D right)

Parameters

Type	Name	Description
Line3D	left	The first instance.
Line3D	right	The second instance.

Returns

Type	Description
System.Boolean	true if the Length of left is less than or equal to that of right; otherwise, false.

Implements

IEquatable<>

IComparable<>

IComparable

Extension Methods

Extensions.AsArrayValue<T>(T)

Extensions.AsEnumerableValue<T>(T)

Extensions.RepeatValue<T>(T, Int32)

Extensions.ToJson<T>(T, Nullable<JsonSerializerOptions>)