Point3Bvr Class

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.

For relevant methods and fields from the Statics class, see the following topics.

Point3Bvr Methods

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

getSphericalCoordXYAngle Retrieves the NumberBvr object that should more properly be thought of as an XZ angle.

getSphericalCoordYZAngle Retrieves the NumberBvr object that should more properly be thought of as an XY angle.

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

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

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

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

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

newUninitBvr Enables you to refer to a Point3Bvr behavior before that behavior has been defined.

getSphericalCoordLength

Point3Bvr Class

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

Syntax

public NumberBvr getSphericalCoordLength( );

Return Value

Returns the NumberBvr object.

getSphericalCoordXYAngle

Point3Bvr Class

Retrieves 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].

Syntax

public NumberBvr getSphericalCoordXYAngle( );

Return Value

Returns the NumberBvr object.

See Also

getSphericalCoordYZAngle, getSphericalCoordLength, point3Spherical

getSphericalCoordYZAngle

Point3Bvr Class

Retrieves 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].

Syntax

public NumberBvr getSphericalCoordYZAngle( );

Return Value

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.

Syntax

public NumberBvr getX( );

Return Value

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.

Syntax

public NumberBvr getY( );

Return Value

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.

Syntax

public NumberBvr getZ( );

Return Value

Returns the NumberBvr object.

See Also

getX, getY, point3

project

Point3Bvr Class

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

Syntax

public Point2Bvr project( CameraBvr camera );

Parameters

camera
CameraBvr object projecting the three-dimensional point onto the image plane.

Return Value

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.

Syntax

public Point3Bvr transform( Transform3Bvr xf );

Parameters

xf
Transform3Bvr object.

Return Value

Returns the Point3Bvr object.

Remarks

This attribute composes values.

newUninitBvr

Point3Bvr Class

Enables you to refer to a 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.

Syntax

public static Point3Bvr newUninitBvr( );

Return Value

Returns the Point3Bvr object.