IG_mult_current_frame_seek

This function seeks to the given absolute time in milliseconds since the beginning of the multimedia instance.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_mult_current_frame_seek_time( HIGMULT hMult, AT_UINT msTime );

Arguments:

Name	Type	Description
hMult	HIGMULT	Multimedia instance handle.
msTime	AT_UINT	Time to seek to in milliseconds.

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
/* Grab frames at two second intervals / AT_ERRCOUNT nErrcount; / Number of errors on stack / HIGMULT hMult; / Multimedia instance handle / AT_BOOL bValid; / Is the current frame valid? / AT_UINT msTime = 0; / Timestamp used for seeking / HIGEAR hIGear; / HIGEAR handle of image */ IG_mult_current_frame_reset(hMult); while (IG_mult_current_frame_is_valid(hMult, &bValid) == IGE_SUCCESS && bValid) { nErrcount = IG_mult_current_frame_image_get(hMult, &hIGear); msTime += 2000; nErrcount = IG_mult_current_frame_seek_time(hMult, msTime); }

Copy Code

/* Grab frames at two second intervals */
AT_ERRCOUNT nErrcount;  /* Number of errors on stack */
HIGMULT hMult;          /* Multimedia instance handle */
AT_BOOL bValid;         /* Is the current frame valid? */
AT_UINT msTime = 0;     /* Timestamp used for seeking */
HIGEAR hIGear;          /* HIGEAR handle of image */
IG_mult_current_frame_reset(hMult);
while (IG_mult_current_frame_is_valid(hMult, &bValid) == IGE_SUCCESS && bValid)
{
        nErrcount = IG_mult_current_frame_image_get(hMult, &hIGear);
        msTime += 2000;
        nErrcount = IG_mult_current_frame_seek_time(hMult, msTime);
}

Remarks:

This function locates the frame that would be visible at this time under normal speed playback conditions and makes this the current frame. Seeking to a time of 0 will seek to the beginning, 1000 will seek to one second after the beginning, and so on.