This function advances the current frame to the next frame.
Copy Code
|
|
---|---|
AT_ERRCOUNT ACCUAPI IG_mult_current_frame_advance(HIGMULT hMult); |
Name | Type | Description |
---|---|---|
hMult | HIGMULT | Multimedia instance handle. |
Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.
This function does not process image pixels.
Media Player
Copy Code
|
|
---|---|
AT_ERRCOUNT nErrcount; /* Number of errors on stack */ HIGMULT hMult; /* Multimedia instance handle */ AT_BOOL bValid; /* Is current frame valid? */ HIGEAR hIGear; /* HIGEAR handle of image */ while (IG_mult_current_frame_is_valid(hMult, &bValid) == IGE_SUCCESS && bValid) { nErrcount = IG_mult_current_frame_image_get(hMult, &hIGear); nErrcount = IG_mult_current_frame_advance(hMult); } |
You can use this in a loop to iterate over all of the frames. This function will not generate an error when you advance beyond the last available frame. You should use IG_mult_current_frame_is_valid() to determine whether or not the end has been reached.