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

This class inherits from DABehavior.

DAPoint3 Functions

bullet1.gifProject

bullet1.gifTransform


Project

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

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 attribute composes values.

DAPoint3 Properties

bullet1.gifSphericalCoordLength

bullet1.gifSphericalCoordXYAngle

bullet1.gifSphericalCoordYZAngle

bullet1.gifX

bullet1.gifY

bullet1.gifZ


SphericalCoordLength

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

A read-only property with a DANumber value that is the counter-clockwise angle, in radians, of the point about the y-axis, starting at positive z. The range is [-Pi, +Pi].

point3Obj.SphericalCoordXYAngle

See Also

SphericalCoordYZAngle, SphericalCoordLength, Point3SphericalAnim


SphericalCoordYZAngle

A read-only property with a DANumber value that is the YZ angle, in radians, going up from the XZ-plane towards the positive y-ray. The range is [-Pi/2, +Pi/2].

point3Obj.SphericalCoordYZAngle

Return Values

Returns the DANumber object.

See Also

SphericalCoordXYAngle, SphericalCoordLength, Point3SphericalAnim


X

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

point3Obj.X

See Also

Y, Z, Point3Anim


Y

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

point3Obj.Y

See Also

X, Z, Point3Anim


Z

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.Point3(x, y, z)

lib.Point3Anim(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.