DAStatics Functions Relevant to DAPath2 Objects

ArcDegrees Creates a DAPath2 object representing a segment of an oval (in effect, this is an arc). The start and end angles are specified in degrees.

ArcRadians Creates a DAPath2 object representing a segment of an oval (in effect, this is an arc). The start and end angles are specified in radians. Same as ArcRadiansAnim except that the parameters are nonanimated numbers (doubles).

ArcRadiansAnim Creates a DAPath2 object representing a segment of an oval (in effect, this is an arc). The start and end angles are specified in radians.

Concat Creates a DAPath2 object that represents the concatenation of the given paths.

ConcatArray Creates a DAPath2 object that represents the concatenation of the DAPath2 objects in the array.

CubicBSplinePath Creates a DAPath2 object based on a cubic B-spline curve.

Line Creates a DAPath2 object that represents the line segment defined by the given points.

Oval Creates a DAPath2 object that represents an oval, centered about the origin, with the specified width and height. Same as OvalAnim except that the parameters are nonanimated numbers (doubles).

OvalAnim Creates a DAPath2 object that represents an oval, centered about the origin, and whose width and height are described by the given DANumber values.

PieDegrees Creates a DAPath2 object representing a closed path that traces a segment of an oval and connects it to the origin. The start and end angles are specified in degrees.

PieRadians Creates a DAPath2 object representing a closed path that traces a segment of an oval and connects it to the origin. The start and end angles are specified in radians. Same as PieRadiansAnim except that the parameters are nonanimated numbers (doubles).

PieRadiansAnim Creates a DAPath2 object representing a closed path that traces a segment of an oval and connects it to the origin. The start and end angles are specified in radians.

PolyDrawPath Creates a DAPath2 object by manipulating the array of points with the codes contained in the DANumber array.

Polyline Creates a DAPath2 object that consists of the given (animated) points.

Ray Creates a DAPath2 object that represents the line segment from the origin to the given (animated) point.

Rect Creates the DAPath2 object representing a rectangle, centered at the origin. Same as RectAnim except that the parameters are nonanimated numbers (doubles).

RectAnim Creates the DAPath2 object representing a rectangle, centered at the origin.

RoundRect Creates a DAPath2 object that is a rectangle, centered about the origin, with rounded, rather than square, corners. Same as RoundRectAnim except that the parameters are nonanimated numbers (doubles).

RoundRectAnim Creates a DAPath2 object that is a rectangle, centered about the origin, with rounded, rather than square, corners.

StringPath Creates a DAPath2 object from the supplied string. Same as StringPathAnim except that string is a nonanimated string.

StringPathAnim Creates a DAPath2 object from the supplied DAString object.

ArcDegrees

DAStatics Class

Creates a DAPath2 object representing a segment of an oval (in effect, this is an arc). The oval is centered at the origin. The start and end angles are specified in degrees.

Syntax

lib.ArcDegrees( startAngle, endAngle, arcWidth, arcHeight )

Parameters

startAngle
Number (a double) representing the starting angle of the oval segment, expressed in degrees.
endAngle
Number (a double) representing the ending angle of the oval segment, expressed in degrees.
arcWidth
Number (a double) representing the arc width, expressed in either meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. If the PixelLibrary is selected, remember that positive-y is down.
arcHeight
Number (a double) representing the arc height, expressed in either meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. If the PixelLibrary is selected, remember that positive-y is down.

Return Value

Returns the DAPath2 object.

ArcRadians

DAStatics Class

Creates a DAPath2 object representing a segment of an oval (in effect, this is an arc). The start and end angles are specified in radians. Same as ArcRadiansAnim except that the parameters are nonanimated numbers (doubles).

Syntax

lib.ArcRadians( startAngle, endAngle, arcWidth, arcHeight )

Parameters

startAngle
A double value representing the starting angle of the arc, expressed in radians. This is a nonanimated number.
endAngle
A double value representing the ending angle of the arc, expressed in radians. This is a nonanimated number.
arcWidth
A double value representing the arc width, expressed in meters, or pixels, depending on whether the PixelLibrary or the MeterLibrary was selected. This is a nonanimated number.
arcHeight
A double value representing the arc height, expressed in meters, or pixels, depending on whether the PixelLibrary or the MeterLibrary was selected. This is a nonanimated number.

Return Value

Returns the DAPath2 object.

Remarks

If the PixelLibrary is selected, remember that the positive y-axis is down.

ArcRadiansAnim

DAStatics Class

Creates a DAPath2 object representing a segment of an oval (in effect, this is an arc). The oval is centered at the origin. The start and end angles are specified in radians.

Syntax

lib.ArcRadiansAnim( startAngle, endAngle, arcWidth, arcHeight )

Parameters

startAngle
DANumber object representing the starting angle of the arc, expressed in radians. This must be an animated number.
endAngle
DANumber object representing the ending angle of the arc, expressed in radians. This must be an animated number.
arcWidth
DANumber object representing the arc width, expressed in meters, or pixels, depending on whether the PixelLibrary or the MeterLibrary was selected. This must be an animated number.
arcHeight
DANumber object representing the arc height, expressed in meters, or pixels, depending on whether the PixelLibrary or the MeterLibrary was selected. This must be an animated number.

Return Value

Returns the DAPath2 object.

Remarks

If the PixelLibrary is selected, remember that the positive y-axis is down.

Concat

DAStatics Class

Creates a DAPath2 object that represents the concatenation of the given paths. In the new path, the points of p1 occur first, followed by those of p2. Path p2 is transformed so that the first point of p2 aligns with the last point of p1.

Syntax

lib.Concat( p1, p2 )

Parameters

p1 and p2
DAPath2 objects.

Return Value

Returns the DAPath2 object.

ConcatArray

DAStatics Class

Creates a DAPath2 object that represents the concatenation of the DAPath2 objects in the array. In the new path, the points of the first path in the array occur first, followed sequentially by the other paths in the array. The second path, for example, is transformed so that its first point aligns with the last point of the first path.

Syntax

lib.ConcatArray( paths )

Parameters

paths
Array (variant) of DAPath2 objects.

Return Value

Returns the DAPath2 object.

CubicBSplinePath

DAStatics Class

Creates a DAPath2 object based on a cubic B-spline curve. The curve depends on the control points and the knot vector.

The control points define the approximate direction and shape of the function. The knots represent the junction values, in parameter space, between the connected polynomial parts. For a number of knots k, the function is valid in the range [3, knotk-2], and is otherwise undefined.

Syntax

lib.CubicBSplinePath( points, knots )

Parameters

points
Array (variant) of DAPoint2 objects representing the points used to calculate the B-spline.
knots
Array (variant) of DANumber objects representing the knots used to calculate the B-spline.

Return Value

Returns the DAPath2 object.

Line

DAStatics Class

Creates a DAPath2 object that represents the line segment defined by the given points.

Syntax

lib.Line( p1, p2 )

Parameters

p1 and p2
DAPoint2 objects.

Return Value

Returns the DAPath2 object.

Oval

DAStatics Class

Creates a DAPath2 object that represents an oval, centered about the origin, with the specified width and height. Same as OvalAnim except that the parameters are nonanimated numbers (doubles).

Syntax

lib.Oval( width, height )

Parameters

width
A double value representing the oval's width. This is a nonanimated number.
height
A double value representing the oval's height. This is a nonanimated number.

Return Value

Returns the DAPath2 object.

Remarks

The units can either be meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. If the PixelLibrary is selected, remember that positive-y is down.

OvalAnim

DAStatics Class

Creates a DAPath2 object that represents an oval, centered about the origin, and whose width and height are described by the given DANumber arguments.

Syntax

lib.OvalAnim( width, height )

Parameters

width
DANumber object representing the oval's width. This must be an animated number.
height
DANumber object representing the oval's height. This must be an animated number.

Return Value

Returns the DAPath2 object.

Remarks

The units can either be meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. If the PixelLibrary is selected, remember that positive-y is down.

PieDegrees

DAStatics Class

Creates a DAPath2 object representing a closed path that traces a segment of an oval and connects it to the origin. (In effect, it is a pie-shaped wedge). The oval is centered at the origin. The start and end angles are specified in degrees.

Syntax

lib.PieDegrees( startAngle, endAngle, arcWidth, arcHeight )

Parameters

startAngle
The double value representing the starting angle of the oval segment, expressed in degrees.
endAngle
The double representing the ending angle of the oval segment, expressed in degrees.
arcWidth
The double representing the arc width, expressed in meters, or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected.
arcHeight
The double representing the arc height, expressed in meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected.

Return Value

Returns the DAPath2 object.

PieRadians

DAStatics Class

Creates a DAPath2 object representing a closed path that traces a segment of an oval and connects it to the origin. The start and end angles are specified in radians. Same as PieRadiansAnim except that the parameters are nonanimated numbers (doubles).

Syntax

lib.PieRadians( startAngle, endAngle, arcWidth, arcHeight )

Parameters

startAngle
A double value representing the starting angle of the oval segment, expressed in radians. This is a nonanimated number.
endAngle
A double value representing the ending angle of the oval segment, expressed in radians. This is a nonanimated number.
arcWidth
A double value representing the arc width, expressed in meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. This is a nonanimated number.
arcHeight
A double value representing the arc height, expressed in meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. This is a nonanimated number.

Return Value

Returns the DAPath2 object.

PieRadiansAnim

DAStatics Class

Syntax

lib.PieRadiansAnim( startAngle, endAngle, arcWidth, arcHeight )

Parameters

startAngle
DANumber object representing the starting angle of the oval segment, expressed in radians. This must be an animated number.
endAngle
DANumber object representing the ending angle of the oval segment, expressed in radians. This must be an animated number.
arcWidth
DANumber object representing the arc width, expressed in meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. This must be an animated number.
arcHeight
DANumber object representing the arc height, expressed in meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. This must be an animated number.

Return Value

Returns the DAPath2 object.

PolyDrawPath

DAStatics Class

Creates a DAPath2 object by manipulating the array of points with the codes contained in the DANumber array.

Syntax

lib.PolyDrawPath( points, codes )

Parameters

points
Array of DAPoint2 objects.
codes
Array of DANumber objects representing the instruction codes.

Return Value

Returns the DAPath2 object.

Remarks

The codes represent the instructions that can be combined using a logical OR operation, where:

Code Name Meaning

01 PT_CLOSEFIGURE Connects points to create a closed figure.

02 PT_LINETO Connects points in a line.

04 PT_BEZIERTO Connects points in a Bezier curve. These must occur in multiples of 3.

06 PT_MOVETO Moves to a point. This is, implicitly, always the first instruction.

This function is the equivalent of the Graphics Drawing Interface (GDI) PolyDraw function.

Code	Name	Meaning
01	PT_CLOSEFIGURE	Connects points to create a closed figure.
02	PT_LINETO	Connects points in a line.
04	PT_BEZIERTO	Connects points in a Bezier curve. These must occur in multiples of 3.
06	PT_MOVETO	Moves to a point. This is, implicitly, always the first instruction.

Polyline

DAStatics Class

Creates a DAPath2 object that consists of the given (animated) points. The path can be used either for drawing or animation. The default line style is the defaultLineStyle.

Syntax

lib.Polyline( points )

Parameters

points
Array (variant) of DAPoint2 objects.

Return Value

Returns the DAPath2 object.

Ray

DAStatics Class

Creates a DAPath2 object that represents the line segment from the origin to the given (animated) point.

Syntax

lib.Ray( p )

Parameters

p
DAPoint2 object.

Return Value

Returns the DAPath2 object.

Rect

DAStatics Class

Creates the DAPath2 object representing a rectangle, centered at the origin. Same as RectAnim except that the parameters are nonanimated numbers (doubles).

Syntax

lib.Rect( width, height )

Parameters

width
A double value representing the width of the rectangle, either in meters or pixels depending on whether the MeterLibrary or the PixelLibrary is selected. This is a nonanimated number.
height
A double value representing the height of the rectangle, either in meters or pixels depending on whether the MeterLibrary or the PixelLibrary is selected. This is a nonanimated number.

Return Value

Returns the DAPath2 object.

Remarks

If the PixelLibrary is selected, remember that positive-y is down.

RectAnim

DAStatics Class

Creates the DAPath2 object representing a rectangle, centered at the origin.

Syntax

lib.RectAnim( width, height )

Parameters

width
DANumber object representing the width of the rectangle, either in meters or pixels depending on whether the MeterLibrary or the PixelLibrary is selected. This must be an animated number.
height
DANumber object representing the height of the rectangle, either in meters or pixels depending on whether the MeterLibrary or the PixelLibrary is selected. This must be an animated number.

Return Value

Returns the DAPath2 object.

Remarks

If the PixelLibrary is selected, remember that positive-y is down.

RoundRect

DAStatics Class

Creates a DAPath2 object that is a rectangle, centered about the origin, with rounded, rather than square, corners. The corners are considered to be segments of an oval (in effect, an arc), centered at the origin. Same as RoundRectAnim except that the parameters are nonanimated numbers (doubles).

Syntax

lib.RoundRect( width, height, arcWidth, arcHeight )

Parameters

width
A double value representing the rectangle's width. This is a nonanimated number.
height
A double value representing the rectangle's height. This is a nonanimated number.
arcWidth
A double value representing the arc's width. This is a nonanimated number.
arcHeight
A double value representing the arc's height. This is a nonanimated number.

Return Value

Returns the DAPath2 object.

Remarks

The units can either be meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. If the PixelLibrary is selected, remember that positive-y is down.

RoundRectAnim

DAStatics Class

Syntax

lib.RoundRectAnim( width, height, arcWidth, arcHeight )

Parameters

width
DANumber object representing the rectangle's width. This must be an animated number.
height
DANumber object representing the rectangle's height. This must be an animated number.
arcWidth
DANumber object representing the arc's width. This must be an animated number.
arcHeight
DANumber object representing the arc's height. This must be an animated number.

Return Value

Returns the DAPath2 object.

Remarks

The units can either be meters or pixels, depending on whether the MeterLibrary or the PixelLibrary is selected. If the PixelLibrary is selected, remember that positive-y is down.

StringPath

DAStatics Class

Creates a DAPath2 object from the supplied string. Same as StringPathAnim except that string is a nonanimated string.

Syntax

lib.StringPath( string, fs )

Parameters

string
Nonanimated string used to create the DAPath2 object.
fs
DAFontStyle object specifying the appearance of the text.

Return Value

Returns the DAPath2 object.

StringPathAnim

DAStatics Class

Creates a DAPath2 object from the supplied DAString object. The appearance is specified by the DAFontStyle object. The path behavior is useful for creating a matte to which an image behavior can be clipped.

Syntax

lib.StringPathAnim( string, fs )

Parameters

string
DAString object used to create the DAPath2 object.
fs
DAFontStyle object specifying the appearance of the text.

Return Value

Returns the DAPath2 object.