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.
Sample:
Media Player
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); } |
|
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.