Point3d
References[StructLayout(LayoutKind.Sequential, Pack = 8, Size = 24)]
[DebuggerDisplay("({m_x}, {m_y}, {m_z})")]
[Serializable]
public struct Point3d : ISerializable, IEquatable<Point3d>, IComparable<Point3d>, IComparable, IEpsilonComparable<Point3d>, ICloneable, IFormattable
Represents the three coordinates of a point in three-dimensional space, using double-precision floating point values.
Constructors
Initializes a new point by defining the X, Y and Z coordinates.
public Point3d(Point3d point)
Initializes a new point by copying coordinates from another point.
Parameters:
| point (Point3d) | A point. |
Initializes a new point by copying coordinates from a single-precision point.
Parameters:
| point (Point3f) | A point. |
Initializes a new point by copying coordinates from a four-dimensional point. The first three coordinates are divided by the last one. If the W (fourth) dimension of the input point is zero, then it will be just discarded.
Parameters:
| point (Point4d) | A point. |
Properties
Each coordinate of the point must pass the RhinoMath.IsValidDouble(double) test.
Gets the largest (both positive and negative) valid coordinate in this point, or RhinoMath.UnsetValue if no coordinate is valid, as an absolute value.
Gets the smallest (both positive and negative) coordinate value in this point.
Gets the value of a point at location RhinoMath.UnsetValue,RhinoMath.UnsetValue,RhinoMath.UnsetValue.
Indexers
Methods
Sums up a point and a vector, and returns a new point.
(Provided for languages that do not support operator overloading. You can use the + operator otherwise)
Sums up a point and a vector, and returns a new point.
(Provided for languages that do not support operator overloading. You can use the + operator otherwise)
Sums two Point3d instances.
(Provided for languages that do not support operator overloading. You can use the + operator otherwise)
Sums up a point and a vector, and returns a new point.
(Provided for languages that do not support operator overloading. You can use the + operator otherwise)
Determines whether a set of points is coplanar within a given tolerance.
Parameters:
| points (IEnumerable<Point3d>) | A list, an array or any enumerable of Point3d. |
| tolerance (double) | A tolerance value. A default might be RhinoMath.ZeroTolerance. |
Returns: true if points are on the same plane; false otherwise.
public static Point3d[] CreateNoiseDistribution2D(int targetCount, bool useOrderedThreshold, double xMin = 0, double yMin = 0, double xMax = 1, double yMax = 1)
Generates an array of two-dimensional points distributed according to the specified blue noise type.
Remarks: The distribution and characteristics of the generated points depend on the specified noise type.
Parameters:
| targetCount (int) | The number of points to generate. Must be a positive integer. The actual count may differ because the algorithm distributes points on a grid whose row and column counts are integers derived from the target count and the region's aspect ratio. |
| useOrderedThreshold (bool) | Use the blue noise ordered threshold (true) or the blue noise step (false) spectra for the noise distribution. |
| xMin (double = 0) | The minimum X coordinate of the bounding rectangle. |
| yMin (double = 0) | The minimum Y coordinate of the bounding rectangle. |
| xMax (double = 1) | The maximum X coordinate of the bounding rectangle. |
| yMax (double = 1) | The maximum Y coordinate of the bounding rectangle. |
Returns: An array of Point3d values.
public static Point3d[] CreateNoiseDistribution3D(int targetCount, bool useOrderedThreshold, double xMin = 0, double yMin = 0, double zMin = 0, double xMax = 1, double yMax = 1, double zMax = 1)
Generates an array of three-dimensional points distributed according to the specified blue noise type.
Remarks: The distribution and characteristics of the generated points depend on the specified noise type.
Parameters:
| targetCount (int) | The number of points to generate. Must be a positive integer. The actual count may differ because the algorithm distributes points on a grid whose row and column counts are integers derived from the target count and the region's aspect ratio. |
| useOrderedThreshold (bool) | Use the blue noise ordered threshold (true) or the blue noise step (false) spectra for the noise distribution. |
| xMin (double = 0) | The minimum X coordinate of the bounding box. |
| yMin (double = 0) | The minimum Y coordinate of the bounding box. |
| zMin (double = 0) | The minimum Z coordinate of the bounding box. |
| xMax (double = 1) | The maximum X coordinate of the bounding box. |
| yMax (double = 1) | The maximum Y coordinate of the bounding box. |
| zMax (double = 1) | The maximum Z coordinate of the bounding box. |
Returns: An array of Point3d values.
Removes duplicates in the supplied set of points.
Parameters:
| points (IEnumerable<Point3d>) | A list, an array or any enumerable of Point3d. |
| tolerance (double) | The minimum distance between points. Points that fall within this tolerance will be discarded. . |
Returns: An array of points without duplicates; or null on error.
Computes the distance between two points.
Parameters:
| other (Point3d) | Other point for distance measurement. |
Returns: The length of the line between this and the other point; or 0 if any of the points is not valid.
Computes the square of the distance between two points.
This method is usually largely faster than DistanceTo().
Parameters:
| other (Point3d) | Other point for squared distance measurement. |
Returns: The squared length of the line between this and the other point; or 0 if any of the points is not valid.
Divides a Point3d by a number.
(Provided for languages that do not support operator overloading. You can use the / operator otherwise)
Check that all values in other are within epsilon of the values in this
Implements: EpsilonEquals
Equals
#Parameters:
| obj (object) | The specified object. |
Returns: true if obj is a Point3d and has the same coordinates as this; otherwise false.
Overrides: ValueType.Equals
Determines whether the specified Point3d has the same values as the present point.
Parameters:
| point (Point3d) | The specified point. |
Returns: true if point has the same coordinates as this; otherwise false.
Converts a single-precision point in a double-precision point.
Parameters:
| point (Point3f) | A point. |
Returns: The resulting point.
GetHashCode
#Computes a hash code for the present point.
Returns: A non-unique integer that represents this point.
Overrides: ValueType.GetHashCode
Interpolate between two points.
Multiplies a Point3d by a number.
(Provided for languages that do not support operator overloading. You can use the * operator otherwise)
Multiplies a Point3d by a number.
(Provided for languages that do not support operator overloading. You can use the * operator otherwise)
Orders a set of points so they will be connected in a "reasonable polyline" order.
Also, removes points from the list if their common distance exceeds a specified threshold.
Parameters:
| points (IEnumerable<Point3d>) | A list, an array or any enumerable of Point3d. |
| minimumDistance (double) | Minimum allowed distance among a pair of points. If points are closer than this, only one of them will be kept. |
Returns: The new array of sorted and culled points.
Subtracts a vector from a point.
(Provided for languages that do not support operator overloading. You can use the - operator otherwise)
Subtracts a point from another point.
(Provided for languages that do not support operator overloading. You can use the - operator otherwise)
Parameters:
| obj (object) |
[SecurityPermission(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.SerializationFormatter)]
void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context)
Parameters:
| info (SerializationInfo) | |
| context (StreamingContext) |
ToString
#Constructs the string representation for the current point.
Returns: The point representation in the form X,Y,Z.
Overrides: ValueType.ToString
Formats the value of the current instance using the specified format.
Parameters:
| format (string) | The format to use. -or- A null reference (Nothing in Visual Basic) to use the default format defined for the type of the IFormattable implementation. |
| formatProvider (IFormatProvider) | The provider to use to format the value. -or- A null reference (Nothing in Visual Basic) to obtain the numeric format information from the current locale setting of the operating system. |
Returns: The value of the current instance in the specified format.
public void Transform(Transform xform)
Transforms the present point in place. The transformation matrix acts on the left of the point. i.e.,
result = transformation*point
Parameters:
| xform (Transform) | Transformation to apply. |
Converts the string representation of a point to the equivalent Point3d structure.
Operators
| Operation | Result | Description | ||
|---|---|---|---|---|
| Point3d | + | Vector3d | Point3d | Sums up a point and a vector, and returns a new point. |
| Point3d | + | Vector3f | Point3d | Sums up a point and a vector, and returns a new point. |
| Point3d | + | Point3d | Point3d | Sums two Point3d instances. |
| Vector3d | + | Point3d | Point3d | Sums up a point and a vector, and returns a new point. |
| Point3d | / | double | Point3d | Divides a Point3d by a number. |
| Point3d | == | Point3d | bool | Determines whether two Point3d have equal values. |
| Point3d | > | Point3d | bool | Determines whether the first specified point comes after (has superior sorting value than) the second point. Coordinates evaluation priority is first X, then Y, then Z. |
| Point3d | >= | Point3d | bool | Determines whether the first specified point comes after (has superior sorting value than) the second point, or it is equal to it. Coordinates evaluation priority is first X, then Y, then Z. |
| Point3d | != | Point3d | bool | Determines whether two Point3d have different values. |
| Point3d | < | Point3d | bool | Determines whether the first specified point comes before (has inferior sorting value than) the second point. Coordinates evaluation priority is first X, then Y, then Z. |
| Point3d | <= | Point3d | bool | Determines whether the first specified point comes before (has inferior sorting value than) the second point, or it is equal to it. Coordinates evaluation priority is first X, then Y, then Z. |
| double | * | Point3d | Point3d | Multiplies a Point3d by a number. |
| Point3d | * | double | Point3d | Multiplies a Point3d by a number. |
| Point3d | - | Vector3d | Point3d | Subtracts a vector from a point. |
| Point3d | - | Point3d | Vector3d | Subtracts a point from another point. |
| - | Point3d | Point3d | Computes the additive inverse of all coordinates in the point, and returns the new point. | |
Convertors
| Operation | Result | Description | ||
|---|---|---|---|---|
| explicit | Vector3d | Point3d | Converts a vector in a point, needing casting. | |
| explicit | Point3d | Vector3d | Converts a point in a vector, needing casting. | |
| implicit | Point3d | ControlPoint | Converts a point in a control point, without needing casting. | |
| implicit | Point3f | Point3d | Converts a single-precision point in a double-precision point, without needing casting. | |