DirectAnimation Animated Header --Static Methods Relevant to Point3Bvr Objects DirectAnimation Animated Header --Static Methods Relevant to Point3Bvr Objects* Microsoft DirectAnimation SDK
*Index  *Topic Contents
*Previous Topic: Static Fields Relevant to Point2Bvr Objects
*Next Topic: Static Fields Relevant to Point3Bvr Objects

Static Methods Relevant to Point3Bvr Objects



add

Statics Class

Creates a three-dimensional point behavior. The location of the point is calculated by adding the corresponding coordinates of the given point and vector behaviors.

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

Parameters
pt
A Point3Bvr object.
vec
A Vector3Bvr object.
Return Values

Returns the Point3Bvr object.

See Also

sub


bSpline

Statics Class

Creates a Point3Bvr behavior based on a B-spline function. The function depends on the control elements, the knot vector, the mathematical degree, and the weights of the control elements (these are optional).

A B-spline function without weights is piecewise polynomial and with weights is piecewise rational (the quotient of two polynomials). It requires that:

numberOfControlElements = numberOfKnots - degree + 1

The control elements define the approximate direction and shape of the function. The knots represent junction values, in parameter space, between the connected polynomial parts.

Given a degree d and a number of knots k, the function is valid in the range knotd to knotk-d+1, and is otherwise undefined. For example, for a degree 2 curve, the valid range is from the second knot to the next to the last knot, inclusive.

The returned Point3Bvr is the traversal of the spline function according to the evaluation parameter. The evaluation parameter is a NumberBvr that must be in the valid range of the spline, which is [knotd, knotk-d+1]. Any values outside this range are automatically clamped to the end values.

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

Parameters
degree
A number representing the mathematical degree of the B-spline to evaluate. Must be 1, 2, or 3.
knots
An array of NumberBvr objects representing the knots used to calculate the B-spline.
control_elements
An array of Point3Bvr objects representing the control elements used to calculate the B-spline.
weights
An array of NumberBvr objects representing the weights used to calculate the B-spline. There must be the same number of weights as control elements. For non-rational B-splines, the value of weights is null.
evaluation
A NumberBvr object that controls the spline evaluation.
Return Values

Returns the Point3Bvr object.


derivative

Statics Class

Creates a three-dimensional vector behavior of the instantaneous derivative (rate of change) of the given point behavior. For example, a constant yields a constant derivative of [0 0 0], and point3(time, 0) (without additional time substitutions) yields a constant derivative of [1 0 0].

public static Vector3Bvr derivative(
  Point3Bvr pt
  );

Parameters
pt
A Point3Bvr object.
Return Values

Returns the Vector3Bvr object.


distance

Statics Class

Creates a number behavior representing the distance between two point behaviors.

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

Parameters
p1 and p3
The Point3Bvr objects.
Return Values

Returns the NumberBvr object.

See Also

distanceSquared


distanceSquared

Statics Class

Creates a number behavior representing the square of the distance between two point behaviors. This is the same as the distance method except that the distance is squared.

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

Parameters
p1 and p3
The Point3Bvr objects.
Return Values

Returns the NumberBvr object.

Remarks

This method is slightly more efficient than the distance method.

See Also

distance


point3

Statics Class

Creates a three-dimensional point behavior. The location of the point is given in Cartesian coordinates.

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

Parameters
x, y, and z
The NumberBvr objects, specifying the coordinate values. The x specifies the distance along the x-axis from the origin to the point, y specifies the distance along the y-axis, and z the distance along the z-axis. These parameters can also be of type double.
Return Values

Returns the Point3Bvr object.

See Also

point3Spherical


point3Spherical

Statics Class

Creates a three-dimensional point behavior. The location of the point is given in spherical coordinates.

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

Parameters
XYangle
A NumberBvr object of the counter-clockwise XY angle, in radians, of the point about the positive y-ray. The angle begins at the positive z-ray, so that [0 0 1] has a XYangle of 0, and [1 0 0] has a XYangle of pi/2. This parameter can also be of type double.
YZangle
A NumberBvr object of the counter-clockwise elevation angle, in radians, of the point above the XZ-plane. A YZangle of pi/2 means the point is straight up (on the positive y-ray), and a YZangle of -pi/2 is straight down (on the negative y-ray). This parameter can also be of type double.
length
A NumberBvr object of the distance of the point from the origin. This parameter can also be of type double.
Return Values

Returns the Point3Bvr object.

Remarks

The following table correlates Cartesian coordinates with polar coordinates:
Cartesian XYangle YZangle Length
Coordinates
[0 0 0] X X 0
[d 0 0] pi/2 0 d
[-d 0 0] -pi/2 0 d X = Don't Care
[0 d 0] X pi/2 d
[0 -d 0] X -pi/2 d
[0 0 d] 0 0 d
[0 0 -d] pi 0 d

See Also

point3


sub

Statics Class

Creates a three-dimensional vector behavior. The coordinate values of the vector are calculated by subtracting the coordinates of p3 from the corresponding coordinates of p1.

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

Parameters
p1 and p3
The Point3Bvr objects.
Return Values

Returns the Vector3Bvr object.


sub

Statics Class

Creates a three-dimensional point behavior. The location of the point is calculated by subtracting the coordinates of the given vector behavior from the corresponding coordinates of the given point behavior.

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

Parameters
pt
A Point3Bvr object.
vec
A Vector3Bvr object.
Return Values

Returns the Point3Bvr object.

See Also

add

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

*Top of Page