ImageGear for C and C++ on Windows v19.8 - Updated
IG_mult_frame_num_from_time_get
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Multimedia Functions > IG_mult_frame_num_from_time_get

This function returns the number of the frame that would be visible at the given time under normal speed playback conditions.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_mult_frame_num_from_time_get(
        HIGMULT hMult, 
        AT_UINT msTime, 
        LPAT_UINT lpFrameNum
);

Arguments:

Name Type Description
hMult HIGMULT Multimedia instance handle.
msTime AT_UINT Time in milliseconds (since the beginning).
lpFrameNum LPAT_UINT Frame number at given time.

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:

None

Example:

 
Copy Code
/* Finds the # of the frame at 1 second from the beginning */
AT_ERRCOUNT nErrcount;  /* Number of errors on stack */
HIGMULT hMult;          /* Multimedia instance handle */
AT_UINT frameNum;       /* Returned frame number */
nErrcount = IG_mult_frame_num_from_time_get(hMult, 1000, &frameNum);