## DAStatic Functions Relevant to DAPath2 Objects

###

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.

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

##### Parameters

startAngle
  The number (a double) representing the starting angle of the oval segment, expressed in degrees.
endAngle
  The number (a double) representing the ending angle of the oval segment, expressed in degrees.
arcWidth
  The 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
  The 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 Values

Returns the DAPath2 object.

###

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.

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

##### Parameters

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

##### Return Values

Returns the DAPath2 object.

##### Remarks

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

###

ArcRadians

DAStatics Class

Same as ArcRadiansAnim except that the arguments are non-animated numbers (doubles).

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

###

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.

lib.Concat(
p1,
p2
)

##### Parameters

p1 and p2
  The DAPath2 objects.

##### Return Values

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.

lib.ConcatArray(
paths
)

##### Parameters

paths
  The array (variant) of DAPath2 objects.

##### Return Values

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, and requires that:

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.

lib.CubicBSplinePath(
points,
knots
)

##### Parameters

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

##### Return Values

Returns the DAPath2 object.

###

Line

DAStatics Class

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

lib.Line(
p1,
p2
)

##### Parameters

p1 and p2
  The DAPoint2 objects.

##### Return Values

Returns the DAPath2 object.

###

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.

lib.OvalAnim(
width,
height
)

##### Parameters

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

##### Return Values

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.

###

Oval

DAStatics Class

Same as OvalAnim except that the arguments are non-animated numbers (doubles).

lib.Oval(
width,
height
)

###

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.

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

##### Parameters

startAngle
  The double 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 Values

Returns the DAPath2 object.

###

PieRadiansAnim

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.

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

##### Parameters

startAngle
  The DANumber object representing the starting angle of the oval segment, expressed in radians. This must be an animated number.
endAngle
  The DANumber object representing the ending angle of the oval segment, expressed in radians. This must be an animated number.
arcWidth
  The 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
  The 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 Values

Returns the DAPath2 object.

###

PieRadians

DAStatics Class

Same as PieRadiansAnim except that the arguments are non-animated numbers (doubles).

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

###

PolyDrawPath

DAStatics Class

Creates a DAPath2 object by manipulating the array of points with the codes contained in the DANumber array. The codes represent the instructions that can be OR'd together, 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.

lib.PolyDrawPath(
points,
codes
)

##### Parameters

points
  An array of DAPoint2 objects.
codes
  An array of DANumber objects representing the instruction codes.

##### Return Values

Returns the DAPath2 object.

##### Remarks

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

###

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.

lib.Polyline(
points
)

##### Parameters

points
  An array (variant) of DAPoint2 objects.

##### Return Values

Returns the DAPath2 object.

###

Ray

DAStatics Class

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

lib.Ray(
p
)

##### Parameters

p
  The DAPoint2 object.

##### Return Values

Returns the DAPath2 object.

###

RectAnim

DAStatics Class

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

lib.RectAnim(
width,
height
)

##### Parameters

width
  The 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
  The 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 Values

Returns the DAPath2 object.

##### Remarks

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

###

Rect

DAStatics Class

Same as RectAnim except that the arguments are non-animated numbers (doubles).

lib.Rect(
width,
height
)

###

RoundRectAnim

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.

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

##### Parameters

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

##### Return Values

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.

###

RoundRect

DAStatics Class

Same as RoundRectAnim except that the arguments are non-animated numbers (doubles).

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

###

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.

lib.StringPathAnim(
string,
fs
)

##### Parameters

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

##### Return Values

Returns the DAPath2 object.

##### See Also

StringPath

###

StringPath

DAStatics Class

Same as StringPathAnim except that string is non-animated.

lib.StringPath(
string,
fs
)

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