From ceae37b7bfe50f74a1b6ccb0e0c91736d64a5755 Mon Sep 17 00:00:00 2001 From: Joel Bodenmann Date: Wed, 17 Jul 2013 05:58:03 +0200 Subject: added gwinImageNext() --- include/gwin/image.h | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'include/gwin/image.h') diff --git a/include/gwin/image.h b/include/gwin/image.h index 142f6374..688435c7 100644 --- a/include/gwin/image.h +++ b/include/gwin/image.h @@ -104,6 +104,26 @@ bool_t gwinImageOpenMemory(GHandle gh, const void* memory); */ gdispImageError gwinImageCache(GHandle gh); + +/** + * @brief Prepare for the next frame/page in the image file. + * @return A time in milliseconds to keep displaying the current frame before trying to draw + * the next frame. Watch out for the special values TIME_IMMEDIATE and TIME_INFINITE. + * + * @param[in] gh The widget handle (must be an image box handle) + * + * @pre gwinImageOpenXxx() must have returned successfully. + * + * @note It will return TIME_IMMEDIATE if the first frame/page hasn't been drawn or if the next frame + * should be drawn immediately. + * @note It will return TIME_INFINITE if another image frame doesn't exist or an error has occurred. + * @note Images that support multiple pages (eg TIFF files) will return TIME_IMMEDIATE between pages + * and then TIME_INFINITE when there are no more pages. + * @note An image that displays a looped animation will never return TIME_INFINITE unless it + * gets an error. + */ +delaytime_t gwinImageNext(GHandle gh); + #ifdef __cplusplus } #endif -- cgit v1.2.3