    Contents  Index  Topic Contents
    Previous Topic: DAPoint2 Class
    Next Topic: DASound Class

> ## 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 define 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.

> - DAPoint3 Functions
> - DAPoint3 Properties
> - Relevant Functions from the DAStatics Class
> - Relevant Properties from the DAStatics Class

> ### DAPoint3 Functions

> Project

> Transform

> ####

> Project

> DAPoint3 Class

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

> point3Obj.Project(
> camera
> )

> ##### Parameters

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

> ##### Return Values

> 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.

> point3Obj.Transform(
> xf
> )

> ##### Parameters

> xf
>   The DATransform3 object.

> ##### Return Values

> Returns the DAPoint3 object.

> ##### Remarks

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

> ### DAPoint3 Properties

> SphericalCoordLength

> SphericalCoordXYAngle

> SphericalCoordYZAngle

> X

> Y

> Z

> ####

> SphericalCoordLength

> DAPoint3 Class

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

> 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].

> 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].

> point3Obj.SphericalCoordYZAngle

> ##### Return Values

> Returns the DANumber object.

> ##### See Also

> SphericalCoordXYAngle, SphericalCoordLength, Point3SphericalAnim

> ####

> X

> DAPoint3 Class

> A read-only property with a DANumber value that is the x coordinate of this point3Obj.

> point3Obj.X

> ##### See Also

> Y, Z, Point3Anim

> ####

> Y

> DAPoint3 Class

> A read-only property with a DANumber value that is the y coordinate of this point3Obj.

> point3Obj.Y

> ##### See Also

> X, Z, Point3Anim

> ####

> Z

> DAPoint3 Class

> A read-only property with a DANumber value that is the z coordinate of this point3Obj.

> point3Obj.Z

> ##### See Also

> X, Y, Point3Anim

> ### Relevant Functions from the DAStatics Class

> The following functions are defined in the DAStatics class and are most relevant to objects of type DAPoint3.

> lib.AddPoint3Vector(pt, vec)

> lib.DerivativePoint3(pt)

> lib.DistancePoint3(p1, p2)

> lib.DistanceSquaredPoint3(p1, p2)

> lib.Point3Anim(x, y, z)

> lib.Point3(x, y, z)

> lib.Point3BSpline(degree, knots, control_elements, weights, evaluation)

> lib.Point3Spherical(XYangle, YZangle, length)

> lib.Point3SphericalAnim(XYangle, YZangle, length)

> lib.SubPoint3(p1, p2)

> lib.SubPoint3Vector(pt, vec)

> ### Relevant Properties from the DAStatics Class

> The following properties are defined in the DAStatics class and are most relevant to objects of type DAPoint3.

> lib.Origin3

> © 1998 Microsoft Corporation. All rights reserved. Terms of Use.

> Top of Page