DAStatics Functions Relevant to DAImage Objects
GradientHorizontal Creates a DAImage object that smoothly interpolates between the start and stop colors. Same as GradientHorizontalAnim except that power is a nonanimated number (a double). GradientHorizontalAnim Creates a DAImage object that smoothly interpolates between the start and stop colors. GradientPolygon Creates a polygon from an array of points and an array of colors. GradientSquare Creates a DAImage object with a square color wash. HatchBackwardDiagonal Creates backward diagonal (lines that slant from right to left) hatch marks. Same as HatchBackwardDiagonalAnim except that size is a nonanimated number (a double). HatchBackwardDiagonalAnim Creates backward diagonal (lines that slant from right to left) hatch marks. HatchCross Creates cross-hatched markings. Same as HatchCrossAnim except that size is a nonanimated number (a double). HatchCrossAnim Creates cross-hatched markings. HatchDiagonalCross Creates diagonally crisscrossed hatch marks. Same as HatchDiagonalCrossAnim except that size is a nonanimated number (a double). HatchDiagonalCrossAnim Creates diagonally crisscrossed hatch marks. HatchForwardDiagonal Creates forward diagonal (lines that slant from left to right) hatch marks. Same as HatchForwardDiagonalAnim except that size is a nonanimated number (a double). HatchForwardDiagonalAnim Creates forward diagonal (lines that slant from left to right) hatch marks. HatchHorizontal Creates horizontal hatch lines. Same as HatchHorizontalAnim except that size is a nonanimated number (a double). HatchHorizontalAnim Creates horizontal hatch lines. HatchVertical Creates vertical hatch lines. Same as HatchVerticalAnim except that size is a nonanimated number (a double). HatchVerticalAnim Creates vertical hatch lines. ImportImage Creates a DAImage by synchronously importing the given bitmap. ImportImageAsync Asynchronously imports the given bitmap. ImportImageAsyncColorKey Enables a particular color in the asynchronously imported image, specified by an RGB value, to be treated as transparent. ImportImageColorKey Enables a particular color in the synchronously imported image, specified by an RGB value, to be treated as transparent. ImportMovie Downloads a movie synchronously. ImportMovieAsync Imports a movie asynchronously. LinearGradientMulticolor Creates a DAImage object that is a linear fill of an array of colors at an array of positions. The positions define vertical bands from left to right. Overlay Creates a DAImage object by laying the image i1 over the image behavior i2. OverlayArray Creates a DAImage object by layering the DAImage objects. RadialGradientMulticolor Creates a DAImage object with a radial fill created from an array of colors at an array of positions in concentric circles from the image's center. RadialGradientPolygon Creates a DAImage object that is a regular polygon with a radial fill. Same as RadialGradientPolygonAnim except that power is a double, not an animated number. RadialGradientPolygonAnim Creates a DAImage object that is a regular polygon with a radial fill. RadialGradientRegularPoly Creates a DAImage object that is a regular, gradient polygon with the specified number of sides (there must be at least three) and a radial fill. Same as RadialGradientRegularPolyAnim except that edges and power are nonanimated numbers (double values). RadialGradientRegularPolyAnim Creates a DAImage object that is a regular, gradient polygon with the specified number of sides (there must be at least three) and a radial fill. RadialGradientSquare Creates a DAImage object with a square radial fill. Same as RadialGradientSquareAnim except that power is a nonanimated number (a double). RadialGradientSquareAnim Creates a DAImage object with a square radial fill. SolidColorImage Creates a DAImage object and applies the given color behavior to all points in the image. StringImage Constructs a DAImage object from a DAString object and a DAFontStyle object. Same as StringImageAnim except that string is a string. StringImageAnim Constructs a DAImage object from a DAString object and a DAFontStyle object.
GradientHorizontal
DAStatics Class
Creates a DAImage object that smoothly interpolates between the start and stop colors. Same as GradientHorizontalAnim except that power is a nonanimated number (a double).
Syntax
lib.GradientHorizontal( start, stop, power )
Parameters
- start
- DAColor object representing the first color of the gradient fill.
- stop
- DAColor object representing the final color of the gradient fill.
- power
- A double value that is an exponent controlling how rapidly one color transitions into another. A value of 1 is a linear transition. For power < 1 the transition occurs rapidly, while power > 1 means that the transition occurs more slowly. For example, if you are transitioning from red to blue, and power = 2, you will see a great deal of red in the gradient fill. On the other hand, if power = 0.5 (the inverse of 2), you will see very little red. If power = 0, you will see only blue. More precisely, if x is considered the normalized distance (from 0 to 1), then the gradient is xp, where p is in the range [0, infinity]. This is a nonanimated number.
Return Value
Returns the DAImage object.
GradientHorizontalAnim
DAStatics Class
Creates a DAImage object that smoothly interpolates between the start and stop colors. Colors start on the left and go toward the right, based on the power specified by power.
The extent of the generated image is [–0.5, –0.5] to [0.5, 0.5]. These dimensions are always in meters, even if the PixelLibrary is selected. To convert from pixels to meters, use the Pixel conversion factor.
Syntax
lib.GradientHorizontalAnim( start, stop, power )
Parameters
- start
- DAColor object representing the first color of the gradient fill.
- stop
- DAColor object representing the final color of the gradient fill.
- power
- DANumber object that is an exponent controlling how rapidly one color transitions into another. A value of 1 is a linear transition. For power < 1 the transition occurs rapidly, while power > 1 means that the transition occurs more slowly. For example, if you are transitioning from red to blue, and power = 2, you will see a great deal of red in the gradient fill. On the other hand, if power = 0.5 (the inverse of 2), you will see very little red. If power = 0, you will see only blue. More precisely, if x is considered the normalized distance (from 0 to 1), then the gradient is xp, where p is in the range [0, infinity]. This must be an animated number.
Return Value
Returns the DAImage object.
GradientPolygon
DAStatics Class
Creates a polygon from an array of points and an array of colors. The polygon has a smooth interpolation between the colors at the vertices. This interpolation is in RGB space. The image is transparent and unpickable outside the polygon. The polygon must be convex and fanned, with at least 3 vertices. The tessellation into triangles occurs by fanning around the first vertex. If, for example, the first triangle is from vertices [0, 1, 2], the second is from [0, 2, 3], and so on. The tessellation determines how the color interpolation is done. The bounding box is the box surrounding the points of the polygon.
Syntax
lib.GradientPolygon( pts, colors )
Parameters
Return Value
Returns the DAImage object.
GradientSquare
DAStatics Class
Creates a DAImage object with a square color wash. The image is a unit-sized square, centered at the origin, reaching from [-0.5, -0.5] to [0.5, 0.5]. The image contains the specified colors in the specified corners. The gradient fills are determined by bilinearly interpolating between these specified colors. (This means that, rather than being simply a four-cornered polygon, it is a polygon with four corners plus a point in the middle that is the average of the four colors.) The image is transparent and unpickable outside of this region. The interpolation is in RGB space. The bounding box is a box from (-0.5, -0.5) to (0.5, 0.5).
Syntax
lib.GradientSquare( lowerLeft, upperLeft, upperRight, lowerRight )
Parameters
- lowerLeft
- DAColor color in the lower-left hand corner of the square.
- upperLeft
- DAColor color in the upper-left hand corner of the square.
- upperRight
- DAColor color in the upper-right hand corner of the square.
- lowerRight
- DAColor color in the lower-right hand corner of the square.
Return Value
Returns the DAImage object.
HatchBackwardDiagonal
DAStatics Class
Creates backward diagonal (lines that slant from right to left) hatch marks. Same as HatchBackwardDiagonalAnim except that size is a nonanimated number (a double).
Syntax
lib.HatchBackwardDiagonal( color, size )
Parameters
- color
- DAColor object representing the line color.
- size
- A double value representing the size of the hatch box. This is not an animated number.
Return Value
Returns the DAImage object.
HatchBackwardDiagonalAnim
DAStatics Class
Creates backward diagonal (lines that slant from right to left) hatch marks. All hatches fit in a box, of dimension size, that is infinitely tiled. For perpendicular hatches, the size of the box is twice the distance between the hatch lines. By default, hatch marks are black and appear on a transparent background.
Syntax
lib.HatchBackwardDiagonalAnim( color, size )
Parameters
Return Value
Returns the DAImage object.
HatchCross
DAStatics Class
Creates cross-hatched markings. Same as HatchCrossAnim except that size is a nonanimated number (a double).
Syntax
lib.HatchCross( color, size )
Parameters
- color
- DAColor object representing the line color.
- size
- A double value representing the size of the hatch box. This is a nonanimated number.
Return Value
Returns the DAImage object.
HatchCrossAnim
DAStatics Class
Creates cross-hatched markings. This function can be thought of as a combination of the HatchVerticalAnim and the HatchHorizontalAnim functions. All hatches fit in a box, of dimension size, that is infinitely tiled. For perpendicular hatches, the size of the box is twice the distance between the hatch lines. By default, hatch marks are black and appear on a transparent background.
Syntax
lib.HatchCrossAnim( color, size )
Parameters
Return Value
Returns the DAImage object.
HatchDiagonalCross
DAStatics Class
Creates diagonally crisscrossed hatch marks. Same as HatchDiagonalCrossAnim except that size is a nonanimated number (a double).
Syntax
lib.HatchDiagonalCross( color, size )
Parameters
- color
- DAColor object representing the line color.
- size
- A double value representing the size of the hatch box. This is a nonanimated number.
Return Value
Returns the DAImage object.
HatchDiagonalCrossAnim
DAStatics Class
Creates diagonally crisscrossed hatch marks. All hatches fit in a box, of dimension size, that is infinitely tiled. For perpendicular hatches, the size of the box is twice the distance between the hatch lines. By default, hatch marks are black and appear on a transparent background.
Syntax
lib.HatchDiagonalCrossAnim( color, size )
Parameters
Return Value
Returns the DAImage object.
HatchForwardDiagonal
DAStatics Class
Creates forward diagonal (lines that slant from left to right) hatch marks. Same as HatchForwardDiagonalAnim except that size is a nonanimated number (a double).
Syntax
lib.HatchForwardDiagonal( color, size )
Parameters
- color
- DAColor object representing the line color.
- size
- A double value representing the size of the hatch box. This is a nonanimated number.
Return Value
Returns the DAImage object.
HatchForwardDiagonalAnim
DAStatics Class
Creates forward diagonal (lines that slant from left to right) hatch marks. All hatches fit in a box, of dimension size, that is infinitely tiled. For perpendicular hatches, the size of the box is twice the distance between the hatch lines.
Syntax
lib.HatchForwardDiagonalAnim( color, size )
Parameters
Return Value
Returns the DAImage object.
HatchHorizontal
DAStatics Class
Creates horizontal hatch lines. Same as HatchHorizontalAnim except that size is a nonanimated number (a double).
Syntax
lib.HatchHorizontal( color, size )
Parameters
- color
- DAColor object representing the line color.
- size
- A double value representing the size of the hatch box. This is a nonanimated number.
Return Value
Returns the DAImage object.
HatchHorizontalAnim
DAStatics Class
Creates horizontal hatch lines. All hatches fit in a box, of dimension size, that is infinitely tiled. For perpendicular hatches, the size of the box is twice the distance between the hatch lines. By default, hatch marks are black and appear on a transparent background.
Syntax
lib.HatchHorizontalAnim( color, size )
Parameters
Return Value
Returns the DAImage object.
HatchVertical
DAStatics Class
Creates vertical hatch lines. Same as HatchVerticalAnim except that size is a nonanimated number (a double).
Syntax
lib.HatchVertical( color, size )
Parameters
- color
- DAColor object representing the line color.
- size
- A double value representing the size of the hatch box. This is a nonanimated number.
Return Value
Returns the DAImage object.
HatchVerticalAnim
DAStatics Class
Creates vertical hatch lines. All hatches fit in a box, of dimension size, that is infinitely tiled. For perpendicular hatches, the size of the box is twice the distance between the hatch lines. By default, hatch marks are black and appear on a transparent background.
Syntax
lib.HatchVerticalAnim( color, size )
Parameters
Return Value
Returns the DAImage object.
ImportImage
DAStatics Class
Creates a DAImage by synchronously importing the given bitmap.
Syntax
lib.ImportImage( url )
Parameters
- url
- Path of the image to be downloaded.
Return Value
Returns the DAImage object.
Remarks
The file formats that can be imported are .png, .jpg, .bmp, and .gif.
The pixels of the bitmap are mapped to points in the image such that the center of the bitmap is placed at (0,0). The extent of the points affected depends on the width and height of the bitmap in pixels and the resolution of the bitmap in pixels per meter. The bounding box of an imported image is calculated as follows:
If the pixel dimensions are WxH, and given that:
halfWidthMeters = lib.mul(lib.DANumber(W/2), lib.Pixel) halfHeightMeters = lib.mul(lib.DANumber(H/2), lib.Pixel)then the bounding box will be (-halfWidthMeters, -halfHeightMeters) to (halfWidthMeters, halfHeightMeters) with the resultant image centered at the origin.
Synchronous loads are blocking calls, which means that ticking will not continue on any model until all synchronous downloads are completed. These downloads should be small and listed before asynchronous downloads. Use asynchronous downloads for more complex images and sounds. See below for a description of the asynchronous function, ImportImageAsync.
See Also
ImportImageAsync
DAStatics Class
Asynchronously imports the given bitmap.
Syntax
lib.ImportImageAsync( url, imgStandIn )
Parameters
- url
- Path (a string) of the image to be downloaded.
- imgStandIn
- DAImage object to use while the contents at url are still being downloaded. This argument cannot be null, however, the image can be empty.
Return Value
Returns the DAImportationResult object, which has the following relevant properties.
- CompletionEvent,which is the event that fires once the download is complete.
- Image, which is the imported image.
- Progress, which is the percentage of the download that has completed.
- Size, which is the size of the imported image, in bytes.
Remarks
The pixels of the bitmap are mapped to points in the image such that the center of the bitmap is placed at (0,0). The extent of the points affected depends on the width and height of the bitmap in pixels and the resolution of the bitmap in pixels per meter. The bounding box of an imported image is calculated as follows:If the pixel dimensions are WxH, and given that:
halfWidthMeters = lib.mul(lib.DANumber(W/2), lib.Pixel) halfHeightMeters = lib.mul(lib.DANumber(H/2), lib.Pixel)then the bounding box will be (-halfWidthMeters, -halfHeightMeters) to (halfWidthMeters, halfHeightMeters) with the resultant image centered at the origin.
Asynchronous downloads should be listed after synchronous ones and used for more complex sounds and images. For a description of the synchronous import function, see ImportImage.
See Also
ImportImageAsyncColorKey
DAStatics Class
Enables a particular color in the asynchronously imported image, specified by an RGB value, to be treated as transparent.
Syntax
lib.ImportImageAsyncColorKey( url, imgStandIn, red, green, blue )
Parameters
- url
- Path (a string) of the image to be downloaded.
- imgStandIn
- DAImage object to use while the contents at url are still being downloaded. This argument cannot be null, however, the image can be empty.
- red
- Red component, expressed as a value (a byte) ranging from 0 to 255.
- green
- Green component, expressed as a value (a byte) ranging from 0 to 255.
- blue
- Blue component, expressed as a value (a byte) ranging from 0 to 255.
Return Value
Returns the DAImportationResult object.
See Also
ImportImageColorKey
DAStatics Class
Enables a particular color in the synchronously imported image, specified by an RGB value, to be treated as transparent.
Syntax
lib.ImportImageColorKey( url, red, green, blue )
Parameters
- url
- Path (a string) of the image to be downloaded.
- red
- Red component, expressed as a value (a byte) ranging from 0 to 255.
- green
- Green component, expressed as a value (a byte) ranging from 0 to 255.
- blue
- Blue component, expressed as a value (a byte) ranging from 0 to 255.
Return Value
Returns the DAImage object.
See Also
ImportMovie
DAStatics Class
Downloads a movie synchronously. Synchronous loads are blocking calls, which means that ticking will not continue on any model until all synchronous downloads are completed. These downloads should be small and listed before asynchronous downloads. Use asynchronous downloads for more complex images and sounds. See ImportMovieAsync for a description of the asynchronous import function.
The image portion of a movie has the same bounding box and placement as a static image such as a GIF or PNG. For more information, see ImportImage.
Syntax
lib.ImportMovie( url )
Parameters
- url
- Path (a string) of the movie to be downloaded.
Return Value
Returns the DAImportationResult object, which has the following relevant properties.
ImportMovieAsync
DAStatics Class
Imports a movie asynchronously. Asynchronous downloads should be listed after synchronous ones and used for more complex sounds and images. For a description of the synchronous import function, see ImportMovie.
The image portion of a movie has the same bounding box and placement as a static image such as a GIF or PNG. For more information, see ImportImage.
Syntax
lib.ImportMovieAsync( url, imgStandIn, sndStandIn )
Parameters
- url
- Path (a string) of the movie to download.
- imgStandIn
- DAImage to use while the movie is still being downloaded. This parameter cannot be null, however, the image can be empty.
- sndStandIn
- DASound to use while the movie is still being downloaded. This parameter cannot be null, however, the sound can be silence.
Return Value
Returns the DAImportationResult object, which has the following relevant properties.
- CompletionEvent, which is the event that triggers once the download is complete.
- Duration, which is the length of the movie, in seconds
- Image, which is the imported image component of the movie.
- Progress, which is the percentage of the download that has completed.
- Size, which is the size of the imported image, in bytes.
- Sound, which is the imported sound component of the movie.
LinearGradientMulticolor
DAStatics Class
Creates a DAImage object that is a linear fill of an array of colors at an array of positions. The positions define vertical bands from left to right. This function reads an array of colors and an array of positions. The positions determine the band for each corresponding color.
Note You can only use this function with Microsoft® DirectAnimation® versions later than 6.0, for example, version 6.00.06.xxx or later. Versions with this function are available in Microsoft Internet Explorer 5, Microsoft Windows® 98 Second Edition, and Windows 2000.
Syntax
lib.LinearGradientMulticolor( offsets, colors )
Parameters
- offsets
- Array (variant) of DANumber objects or doubles representing the positions of the bands at which the different colors should be used for the gradient. Must have the same number of elements as the colors array.
- colors
- Array (variant) of DAColor objects representing the colors of bands at the different positions. Must have the same number of elements as the offsets array.
Return Value
Returns the DAImage object.
Overlay
DAStatics Class
Creates a DAImage object by laying the image i1 over the image behavior i2. The new image consists of all fully opaque points of i1, all points of i2 that lie beneath fully transparent points in i1, and all partially opaque points of i1 modified such that the new point is a combination of the i1 point and the i2 point under it. The bounding box of a set of overlaid images is simply the union of the bounding boxes of the images themselves.
Syntax
lib.Overlay( i1, i2 )
Parameters
- i1 and i2
- DAImage objects.
Return Value
Returns the DAImage object.
OverlayArray
DAStatics Class
Creates a DAImage object by layering the DAImage objects in the order in which they appear in the array with the first image in the array on the top, the second image in the array immediately behind the first image and so on. The bounding box of a set of overlaid images is simply the union of the bounding boxes of the images themselves.
Syntax
lib.OverlayArray( im )
Parameters
- im
- Array (variant) of DAImage objects.
Return Value
Returns the DAImage object.
RadialGradientMulticolor
DAStatics Class
Creates a DAImage object that is an image of infinite size with a radial fill created from an array of colors at an array of positions in concentric circles from the image's center. This function reads an array of colors and an array of positions. The positions determine the range along the radius for each corresponding color. The color of the largest radius fills the outer part of the image.
Note You can only use this function with DirectAnimation versions later than 6.0, for example, version 6.00.06.xxx or later. Versions with this function are available in Microsoft Internet Explorer 5, Windows 98 Second Edition, and Windows 2000.
Syntax
lib.RadialGradientMulticolor( offsets, colors )
Parameters
- offsets
- Array (variant) of DANumber objects or doubles representing the positions along the image's radius at which the different colors should be used for the gradient. Must have the same number of elements as the colors array.
- colors
- Array (variant) of DAColor objects representing the colors at the different offsets along the image's radius. Must have the same number of elements as the offsets array.
Return Value
Returns the DAImage object.
RadialGradientPolygon
DAStatics Class
Creates a DAImage object that is a regular polygon with a radial fill. Same as RadialGradientPolygonAnim except that power is a nonanimated number (a double).
Syntax
lib.RadialGradientPolygon( inner, outer, points, power )
Parameters
- inner
- DAColor object representing the color at the origin of the polygon.
- outer
- DAColor object representing the color at the vertices.
- points
- DAPoint2 object representing the array of points that determine the polygon's vertices.
- power
- A double value that is an exponent controlling how rapidly one color transitions into another. A value of 1 is a linear transition. For power < 1 the transition occurs rapidly, while power > 1 means that the transition occurs more slowly. For example, if you are transitioning from red to blue, and power = 2, you will see a great deal of red in the gradient fill. On the other hand, if power = 0.5 (the inverse of 2), you will see very little red. If power = 0, you will see only blue. More precisely, if x is considered the normalized distance (from 0 to 1), then the gradient is xp, where p is in the range [0, infinity]. This is a nonanimated number.
Return Value
Returns the DAImage object.
RadialGradientPolygonAnim
DAStatics Class
Creates a DAImage object that is a regular polygon with a radial fill. The image contains the specified colors at the origin and the exterior points, respectively. The gradient fill is determined by the power argument and occurs in RGB space. Outside of the filled-in region, the image is transparent and unpickable. The bounding box is the box surrounding the points of the polygon.
Syntax
lib.RadialGradientPolygonAnim( inner, outer, points, power )
Parameters
- inner
- DAColor object representing the color at the origin of the polygon.
- outer
- DAColor object representing the color at the vertices.
- points
- DAPoint2 object representing the array of points that determine the polygon's vertices.
- power
- DANumber object that is an exponent controlling how rapidly one color transitions into another. A value of 1 is a linear transition. For power < 1 the transition occurs rapidly, while power > 1 means that the transition occurs more slowly. For example, if you are transitioning from red to blue, and power = 2, you will see a great deal of red in the gradient fill. On the other hand, if power = 0.5 (the inverse of 2), you will see very little red. If power = 0, you will see only blue. More precisely, if x is considered the normalized distance (from 0 to 1), then the gradient is xp, where p is in the range [0, infinity]. This must be an animated number.
Return Value
Returns the DAImage object.
RadialGradientRegularPoly
DAStatics Class
Creates a DAImage object that is a regular, gradient polygon with the specified number of sides (there must be at least three) and a radial fill. Same as RadialGradientRegularPolyAnim except that edges and power are nonanimated numbers (double values).
Syntax
lib.RadialGradientRegularPoly( inner, outer, edges, power )
Parameters
- inner
- DAColor object representing the color at the origin of the polygon.
- outer
- DAColor object representing the color at the vertices.
- edges
- A double value representing the number of edges the polygon has.
- power
- A double value that is an exponent controlling how rapidly one color transitions into another. A value of 1 is a linear transition. For power < 1 the transition occurs rapidly, while power > 1 means that the transition occurs more slowly. For example, if you are transitioning from red to blue, and power = 2, you will see a great deal of red in the gradient fill. On the other hand, if power = 0.5 (the inverse of 2), you will see very little red. If power = 0, you will see only blue. More precisely, if x is considered the normalized distance (from 0 to 1), then the gradient is xp, where p is in the range [0, infinity]. This is a nonanimated number.
Return Value
Returns the DAImage object.
RadialGradientRegularPolyAnim
DAStatics Class
Creates a DAImage object that is a regular, gradient polygon with the specified number of sides (there must be at least three) and a radial fill. It has a unit width and height, centered at the origin, with an extent from (–0.5, –0.5) to (0.5, 0.5). (These dimensions are always in meters, even if the PixelLibrary is selected. To convert from pixels to meters, use the Pixel conversion factor.) The image contains the specified colors at the origin and the exterior points, respectively. The gradient fill is determined by the power argument and occurs in RGB space. Outside of the filled-in region, the image is transparent and unpickable. The bounding box is the box surrounding the points of the polygon.
Creates a DAImage object that smoothly interpolates between the start and stop colors. Colors start on the left and go toward the right, based on the power specified by power.
Syntax
lib.RadialGradientRegularPolyAnim( inner, outer, edges, power )
Parameters
- inner
- DAColor object representing the color at the origin of the polygon.
- outer
- DAColor object representing the color at the vertices.
- edges
- DANumber object representing the number of edges the polygon has.
- power
- DANumber object that is an exponent controlling how rapidly one color transitions into another. A value of 1 is a linear transition. For power < 1 the transition occurs rapidly, while power > 1 means that the transition occurs more slowly. For example, if you are transitioning from red to blue, and power = 2, you will see a great deal of red in the gradient fill. On the other hand, if power = 0.5 (the inverse of 2), you will see very little red. If power = 0, you will see only blue. More precisely, if x is considered the normalized distance (from 0 to 1), then the gradient is xp, where p is in the range [0, infinity]. This must be an animated number.
Return Value
Returns the DAImage object.
RadialGradientSquare
DAStatics Class
Creates a DAImage object with a square radial fill. Same as RadialGradientSquareAnim except that power is a nonanimated number (a double).
Syntax
lib.RadialGradientSquare( inner, outer, power )
Parameters
- inner
- DAColor at the center of the image.
- outer
- DAColor at the corners of the image.
- power
- A double value that is an exponent controlling how rapidly one color transitions into another. A value of 1 is a linear transition. For power < 1 the transition occurs rapidly, while power > 1 means that the transition occurs more slowly. For example, if you are transitioning from red to blue, and power = 2, you will see a great deal of red in the gradient fill. On the other hand, if power = 0.5 (the inverse of 2), you will see very little red. If power = 0, you will see only blue. More precisely, if x is considered the normalized distance (from 0 to 1), then the gradient is xp, where p is in the range [0, infinity]. This is a nonanimated number.
Return Value
Returns the DAImage object.
RadialGradientSquareAnim
DAStatics Class
Creates a DAImage object with a square radial fill. The image is a unit-sized square, centered at the origin, reaching from [-0.5, -0.5] to [0.5, 0.5]. (These dimensions are always in meters, even if the PixelLibrary is selected. To convert from pixels to meters, use the Pixel conversion factor.) The image contains the specified colors in the center and at the corners, respectively. The gradient fill is determined by the power argument. The interpolation occurs in RGB space. Outside of the fill, the image is transparent and unpickable. The bounding box is a box from [-0.5, -0.5] to [0.5, 0.5].
Creates a DAImage object that smoothly interpolates between the start and stop colors. Colors start on the left and go toward the right, based on the power specified by power.
Syntax
lib.RadialGradientSquareAnim( inner, outer, power )
Parameters
- inner
- DAColor at the center of the image.
- outer
- DAColor at the corners of the image.
- power
- DANumber object that is an exponent controlling how rapidly one color transitions into another. A value of 1 is a linear transition. For power < 1 the transition occurs rapidly, while power > 1 means that the transition occurs more slowly. For example, if you are transitioning from red to blue, and power = 2, you will see a great deal of red in the gradient fill. On the other hand, if power = 0.5 (the inverse of 2), you will see very little red. If power = 0, you will see only blue. More precisely, if x is considered the normalized distance (from 0 to 1), then the gradient is xp, where p is in the range [0, infinity]. This must be an animated number.
Return Value
Returns the DAImage object.
SolidColorImage
DAStatics Class
Creates a DAImage object and applies the given color behavior to all points in the image. The bounding box of a solid-color image is the infinite bounding box.
Syntax
lib.SolidColorImage( col )
Parameters
- col
- DAColor object used to color the image.
Return Value
Returns the DAImage object.
StringImage
DAStatics Class
Constructs a DAImage object from a DAString object and a DAFontStyle object. Same as StringImageAnim except that string is a nonanimated string.
Syntax
lib.StringImage( string, font )
Parameters
- string
- Nonanimated string specifying the text.
- font
- DAFontStyle object specifying the font style (this can include the face, the size, the color, and the attributes).
Return Value
Returns the DAImage object.
StringImageAnim
DAStatics Class
Constructs a DAImage object from a DAString object and a DAFontStyle object. Because both parameters are potentially animated, they can vary over time.
Syntax
lib.StringImageAnim( string, font )
Parameters
- string
- DAString object specifying the text.
- font
- DAFontStyle object specifying the font style (this can include the face, the size, the color, and the attributes).
Return Value
Returns the DAImage object.
Top of Page
© 2000 Microsoft and/or its suppliers. All rights reserved. Terms of Use.