DAPoint3 Class

Creates a DAPoint3 object. At any given time, the value is a point representing a location in a three-dimensional space. Each point has a triplet of coordinate values that defines the point's location relative to a fixed point called the origin. These coordinate values are given as either Cartesian coordinates (x,y,z) or spherical coordinates (XYangle,YZangle,length) when the point behavior is created.

Because coordinate values are DANumber objects, the location of a DAPoint3 object can change over time as the DANumber values change.

This class inherits from DABehavior.

For relevant functions and properties from the DAStatics class, see the following topics.

DAPoint3 Functions

Project Creates the DAPoint2 object of the projection of the DAPoint3 object onto the image plane, via the given DACamera object.

Transform Creates a new DAPoint3 object that is the result of applying the given transformation to the original point.

DAPoint3 Properties

SphericalCoordLength A read-only property with a DANumber value that is the distance of the point from the origin.

SphericalCoordXYAngle A read-only property with a DANumber value that should more properly be thought of as an XZ angle.

SphericalCoordYZAngle A read-only property with a DANumber value that should more properly be thought of as an XY angle.

X A read-only property with a DANumber value that is the x coordinate of this DAPoint3 object.

Y A read-only property with a DANumber value that is the y coordinate of this DAPoint3 object.

Z A read-only property with a DANumber value that is the z coordinate of this DAPoint3 object.

DAPoint3 Functions

This section contains reference material for the DAPoint3 functions.

Project

DAPoint3 Class

Creates the DAPoint2 object of the projection of the DAPoint3 object onto the image plane, via the given DACamera object.

Syntax

point3Obj.Project( camera )

Parameters

camera
DACamera object projecting the three-dimensional point onto the image plane.

Return Value

Returns the DAPoint2 object.

Transform

DAPoint3 Class

Creates a new DAPoint3 object that is the result of applying the given transformation to the original point.

Syntax

point3Obj.Transform( xf )

Parameters

xf
DATransform3 object.

Return Value

Returns the DAPoint3 object.

Remarks

This function composes values. The resulting transformation is the new value applied to the old value.

DAPoint3 Properties

This section contains reference material for the DAPoint3 properties.

SphericalCoordLength

DAPoint3 Class

A read-only property with a DANumber value that is the distance of the point from the origin.

Syntax

point3Obj.SphericalCoordLength

See Also

SphericalCoordXYAngle, SphericalCoordYZAngle, Point3SphericalAnim

SphericalCoordXYAngle

DAPoint3 Class

A read-only property with a DANumber value that should more properly be thought of as an XZ angle. For positive values, it is the counter-clockwise angle, in radians, of the point in the XZ plane. When the angle is 0, the point lies on the z-axis. The range is [-Pi, +Pi].

Syntax

point3Obj.SphericalCoordXYAngle

See Also

SphericalCoordYZAngle, SphericalCoordLength, Point3SphericalAnim

SphericalCoordYZAngle

DAPoint3 Class

A read-only property with a DANumber value that should more properly be thought of as an XY angle. For positive values, it is the counter-clockwise angle, in radians, going from the XZ-plane towards the positive y-ray. When the angle is 0, the point lies on the x-axis. The range is [-Pi/2, +Pi/2].

Syntax

point3Obj.SphericalCoordYZAngle

Return Value