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.
Returns the NumberBvr object that represents the length (or magnitude) of the vector.
public NumberBvr getSphericalCoordLength( );
Returns the NumberBvr object.
getSphericalCoordXYAngle, getSphericalCoordYZAngle, point3Spherical
Returns the NumberBvr object that is the counter-clockwise angle, in radians, of the point about the y-axis, starting at positive z. The range is [-Pi, +Pi].
public NumberBvr getSphericalCoordXYAngle( );
Returns the NumberBvr object.
getSphericalCoordYZAngle, getSphericalCoordLength, point3Spherical
Returns the NumberBvr object 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].
public NumberBvr getSphericalCoordYZAngle( );
Returns the NumberBvr object.
getSphericalCoordXYAngle, getSphericalCoordLength, point3Spherical
Creates a number behavior that represents the x coordinate of this point behavior.
public NumberBvr getX( );
Returns the NumberBvr object.
Creates a number behavior that represents the y coordinate of this point behavior.
public NumberBvr getY( );
Returns the NumberBvr object.
Creates a number behavior that represents the z coordinate of this point behavior.
public NumberBvr getZ( );
Returns the NumberBvr object.
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
);
Returns the Point2Bvr object.
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
);
Returns the Point3Bvr object.
This attribute composes values.
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( );
Returns the Point3Bvr object.
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 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);
The following fields are defined in the Statics class and are most relevant to objects of type Point3Bvr.
public final static Point3Bvr origin3;
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.