Index

C/C++ Functions

fxAnimWrite

DT_SLONG fxAnimWrite(DT_AUX_INFO* info, const DT_UBYTE* bitmap_ptr, const DT_UBYTE* alpha_ptr, DT_SLONG bitmap_padding, DT_SLONG alpha_padding, DT_SLONG cx, DT_SLONG cy, DT_SLONG cw, DT_SLONG ch, DT_SLONG quality, DT_UWORD flags, DT_SLONG delay)

Short Description: Write animation frame

This function adds a new frame to an animated image that was opened by fxAnimStart.

Parameters

ParameterDescription

info

Pointer to the DT_AUX_INFO structure containing the applicable initialization parameters.

bitmap_ptr

See fxImageWrite.

alpha_ptr

See fxImageWrite.

bitmap_padding

See fxImageWrite.

alpha_padding

See fxImageWrite.

cx

The x-coordinate of the animation frame, in pixels.

cy

The y-coordinate of the animation frame, in pixels.

cw

The width of the animation frame, in pixels.

ch

The height of the animation frame, in pixels.

quality

Bitmap quality. Currently this value is respected only if image format is DV_AUX_FILEFORMAT_GIF. In this case values over 75 will activate dithering.

flags

A bitmask value.

  • bit 0 (1) — Flip the bitmap vertically

delay

A non-negative integer that defines the animation delay for this animation frame, in 1/100 seconds.

Return Value

If the function was successful, the return value is 1. Otherwise, the function returns 0.

 

Index