This function open a new animated image in a user-defined stream to which subsequent fxAnimWrite calls will write animation frames. The image compression format is specified by the FileFormat member variable of the info structure.
Parameter | Description |
---|---|
info |
Pointer to the DT_AUX_INFO structure containing the applicable initialization parameters. |
bitmap_format |
See fxImageWrite. |
bitmap_subformat |
See fxImageWrite. |
width |
All bitmaps that will be added to the animation via subsequent subsequent fxAnimWrite calls must have the same width. The width parameter specifies this width, in pixels. |
height |
All bitmaps that will be added to the animation via subsequent subsequent fxAnimWrite calls must have the same height. The height parameter specifies this height, in pixels. |
flags |
A bitmask value.
|
frames_count |
The number of frames that will be added to the animated image. This value must equal the number of subsequent fxAnimWrite calls. |
gattribs | |
user_stream |
See DT_AUX_USER_STREAM. |
If the function was successful, the return value is 1. Otherwise, the function returns 0.
The only image formats that currently support animation are DV_AUX_FILEFORMAT_APNG and DV_AUX_FILEFORMAT_GIF. The animated image opened by this function must be closed by fxAnimEnd.