ImageGear for C and C++ on Linux v19.10 - Updated
IG_mult_current_frame_seek
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Multimedia Functions > IG_mult_current_frame_seek

This function seeks to the given frame number in a multimedia instance.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_mult_current_frame_seek(
        HIGMULT hMult, 
        AT_UINT frameNum
);

Arguments:

Name Type Description
hMult HIGMULT Multimedia instance handle.
frameNum AT_UINT Frame number to seek to (0 = first frame).

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
/* Seek to last frame */
AT_ERRCOUNT nErrcount;  /* Number of errors on stack */
AT_UINT numFrames;      /* Total number of frames */
nErrcount = IG_mult_duration_get(hMult, &numFrames, NULL);
nErrcount = IG_mult_current_frame_seek(hMult, numFrames - 1);