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

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.