static DynamicSprite* DynamicSprite.Create(int width, int height,
optional bool hasAlphaChannel)
Creates a new blank dynamic sprite of the specified size. It will initially be
fully transparent, and can optionally have an alpha channel. This command is
useful if you just want to create a new sprite and then use the DrawingSurface
commands to draw onto it.
If the game colour depth is lower than 32-bit, then the hasAlphaChannel
parameter will be ignored.
Use the Graphic property of the DynamicSprite to
interface with other commands and to use the new sprite in the game.
IMPORTANT: This command loads an extra sprite into memory which is not controlled
by the normal AGS sprite cache and will not be automatically disposed of. Therefore, when
you are finished with the image you MUST call Delete on it to free its memory.
IMPORTANT: If the DynamicSprite instance is released from memory (ie. there is
no longer a DynamicSprite* variable pointing to it), then the sprite will also be
removed from memory. Make sure that you keep a global variable pointer to the sprite
until you are finished with it, and at that point call Delete.
Example:
DynamicSprite* sprite = DynamicSprite.Create(50, 30);
DrawingSurface *surface = sprite.GetDrawingSurface();
surface.DrawingColor = 14;
surface.DrawPixel(25, 15);
surface.Release();
sprite.Delete();
creates a 50x30 sprite, draws a white dot in the middle, then deletes the sprite.
See Also: DynamicSprite.Delete,
DynamicSprite.Graphic,
DynamicSprite.GetDrawingSurface
| 
Home