Statics Methods Relevant to Point2Bvr Objects

add Creates a two-dimensional point behavior.

bSpline Creates a Point2Bvr behavior based on a B-spline function.

derivative Creates a two-dimensional vector behavior of the instantaneous derivative (rate of change) of the given point behavior.

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

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

point2 Creates a two-dimensional point behavior.

point2Polar Creates a two-dimensional point behavior. The location of the point is given in polar coordinates.

sub(p1, p2) Creates a two-dimensional vector behavior.

sub(pt, vec) Creates a two-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.

add

Statics Class

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

Syntax

public static Point2Bvr add( Point2Bvr pt, Vector2Bvr vec );

Parameters

pt
Point2Bvr object.
vec
Vector2Bvr object.

Return Value

Returns the Point2Bvr object.

See Also

sub

bSpline

Statics Class

Creates a Point2Bvr 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).

Syntax

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

Parameters

degree
Number representing the mathematical degree of the B-spline to evaluate. Must be 1, 2, or 3.
knots
Array of NumberBvr objects representing the knots used to calculate the B-spline.
control_elements
Array of Point2Bvr objects representing the control elements used to calculate the B-spline.
weights
Array of NumberBvr objects representing the weights used to calculate the rational 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
NumberBvr object that controls the spline evaluation.

Return Value

Returns the Point2Bvr object.

Remarks

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 Point2Bvr 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.

derivative

Statics Class

Creates a two-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], and point2 (time, 0) (without additional time substitutions) yields a constant derivative of [1 0].

Syntax

public static Vector2Bvr derivative( Point2Bvr pt );

Parameters

pt
Point2Bvr object.

Return Value

Returns the Vector2Bvr object.

distance

Statics Class

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

Syntax

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

Parameters

p1 and p2
Point2Bvr objects.

Return Value

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.

Syntax

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

Parameters

p1 and p2
Point2Bvr objects.

Return Value

Returns the NumberBvr object.

See Also

distance

point2

Statics Class

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

Syntax

public static Point2Bvr point2( NumberBvr x, NumberBvr y );

Parameters

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

Return Value

Returns the Point2Bvr object.

See Also

point2Polar

point2Polar

Statics Class

Creates a two-dimensional point behavior. The location of the point is given in polar coordinates.

Syntax

public static Point2Bvr point2Polar(
NumberBvr XYangle, NumberBvr length );

Parameters

XYangle
NumberBvr object specifying the angle, in radians, between the positive x-axis and the ray that goes from the origin to the point. This parameter can also be of type double.
length
NumberBvr object specifying the distance from the origin to the point. This parameter can also be of type double.

Return Value

Returns the Point2Bvr object.

See Also

point2

sub(p1, p2)

Statics Class

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

Syntax

public static Vector2Bvr sub( Point2Bvr p1, Point2Bvr p2 );

Parameters

p1 and p2
Point2Bvr objects.

Return Value

Returns the Vector2Bvr object.

sub(pt, vec)

Statics Class

Creates a two-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.

Syntax

public static Point2Bvr sub( Point2Bvr pt, Vector2Bvr vec );

Parameters

pt
Point2Bvr object.
vec
Vector2Bvr object.

Return Value

Returns the Point2Bvr object.

See Also

add