DAStatic Functions Relevant to DAPath2 Objects


		Index Topic Contents
	Previous Topic: DAStatic Properties Relevant to DANumber Objects Next Topic: DAStatic Functions Relevant to DAPoint2 Objects

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
  )
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.
Top of Page

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.