    Contents  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
> - Relevant Methods from the Statics Class
> - Relevant Fields from the Statics Class

> ### Point3Bvr Methods

> getSphericalCoordLength

> getSphericalCoordXYAngle

> getSphericalCoordYZAngle

> getX

> getY

> getZ

> project

> transform

> newUninitBvr

> ####

> 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