DirectAnimation Animated Header --Point3Bvr Class DirectAnimation Animated Header --Point3Bvr Class* Microsoft DirectAnimation SDK
*Index  *Topic Contents
*Previous Topic: Point2Bvr Class
*Next Topic: Preferences Class

Point3Bvr Class


public class Point3Bvr extends Behavior {

    // Methods
    public NumberBvr getSphericalCoordLength();
    public NumberBvr getSphericalCoordXYAngle();
    public NumberBvr getSphericalCoordYZAngle();
    public NumberBvr getX();
    public NumberBvr getY();
    public NumberBvr getZ();
    public Point2Bvr project(CameraBvr camera)
    public Point3Bvr transform(Transform3Bvr xf);
    
    public static Point3Bvr  newUninitBvr();
}

Creates an object that represents a three-dimensional point behavior. At any given time, the value of the behavior 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 (XY angle,YZ angle,length) when the point behavior is created.

Because coordinate values are number behaviors (NumberBvr objects), the location of a point behavior may change over time as the number behaviors change. For more information about behaviors, see the Behavior class and the Point2Bvr class.

Point3Bvr Methods

bullet1.gifgetSphericalCoordLength

bullet1.gifgetSphericalCoordXYAngle

bullet1.gifgetSphericalCoordYZAngle

bullet1.gifgetX

bullet1.gifgetY

bullet1.gifgetZ

bullet1.gifproject

bullet1.giftransform

bullet1.gifnewUninitBvr


getSphericalCoordLength

Point3Bvr Class

Returns the NumberBvr object that represents the length (or magnitude) of the vector.

public NumberBvr getSphericalCoordLength( );

Return Values

Returns the NumberBvr object.

See Also

getSphericalCoordXYAngle, getSphericalCoordYZAngle, point3Spherical


getSphericalCoordXYAngle

Point3Bvr Class

Returns the NumberBvr object 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].

public NumberBvr getSphericalCoordXYAngle( );

Return Values

Returns the NumberBvr object.

See Also

getSphericalCoordYZAngle, getSphericalCoordLength, point3Spherical


getSphericalCoordYZAngle

Point3Bvr Class

Returns the NumberBvr object 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].

public NumberBvr getSphericalCoordYZAngle( );

Return Values

Returns the NumberBvr object.

See Also

getSphericalCoordXYAngle, getSphericalCoordLength, point3Spherical


getX

Point3Bvr Class

Creates a number behavior that represents the x coordinate of this point behavior.

public NumberBvr getX( );

Return Values

Returns the NumberBvr object.

See Also

getY, getZ, point3


getY

Point3Bvr Class

Creates a number behavior that represents the y coordinate of this point behavior.

public NumberBvr getY( );

Return Values

Returns the NumberBvr object.

See Also

getX, getZ, point3


getZ

Point3Bvr Class

Creates a number behavior that represents the z coordinate of this point behavior.

public NumberBvr getZ( );

Return Values

Returns the NumberBvr object.

See Also

getX, getY, point3


project

Point3Bvr Class

Returns the two-dimensional point behavior of the projection of the three-dimensional point onto the image plane, via the given camera behavior.

public Point2Bvr project(
  CameraBvr camera
  );

Parameters
camera
The CameraBvr object projecting the three-dimensional point onto the image plane.
Return Values

Returns the Point2Bvr object.


transform

Point3Bvr Class

Creates a new three-dimensional point behavior that is the result of applying the given transformation to the original point behavior.

public Point3Bvr transform(
  Transform3Bvr xf
  );

Parameters
xf
The Transform3Bvr object.
Return Values

Returns the Point3Bvr object.

Remarks

This attribute composes values.


newUninitBvr

Point3Bvr Class

This method allows you to refer to an Point3Bvr behavior before that behavior has been defined. With this method you can create the behavior and use it in the definition of other behaviors, but not actually define its contents until some later point. (This is accomplished with the init method, which is available on all behaviors.) The system generates a run-time error if you initialize a non-uninitialized behavior, initialize an uninitialized behavior that has already been initialized, or run an initialized behavior that has not yet been initialized.

public static Point3Bvr newUninitBvr( );

Return Values

Returns the Point3Bvr object.

Relevant Methods from the Statics Class

The following methods are defined in the Statics class and are most relevant to objects of type Point3Bvr.

public static Point3Bvr add(Point3Bvr pt, Vector3Bvr vec);

public static Point3Bvr bSpline(int degree, NumberBvr[] knots, Point3Bvr[] control_elements, NumberBvr[] weights, NumberBvr evaluation);

public static Vector3Bvr derivative(Point3Bvr pt);

public static NumberBvr distance(Point3Bvr p1, Point3Bvr p2);

public static NumberBvr distanceSquared(Point3Bvr p1, Point3Bvr p2);

public static Point3Bvr point3(NumberBvr x, NumberBvr y, NumberBvr z);

public static Point3Bvr point3Spherical(NumberBvr XYangle, NumberBvr YZangle, NumberBvr length);

public static Vector3Bvr sub(Point3Bvr p1, Point3Bvr p2);

public static Point3Bvr sub(Point3Bvr pt, Vector3Bvr vec);

Relevant Fields from the Statics Class

The following fields are defined in the Statics class and are most relevant to objects of type Point3Bvr.

public final static Point3Bvr origin3;

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

*Top of Page