emWin - SEGGER Microcontroller

168 CHAPTER Displaying bitmap files
GUI_GIF_GetInfoEx()
Description
Returns an information structure with information about the size and the number of
sub images within the given GIF file, which needs not to be loaded into memory.
Prototype
int GUI_GIF_GetInfoEx(GUI_GET_DATA_FUNC * pfGetData, void * p,
GUI_GIF_INFO * pInfo);;
Parameter Description
pfGetData
Pointer to a function which is called for getting data. For details about the GetData
function, refer to “Getting data with the ...Ex() functions” on page 174.
p Void pointer passed to the function pointed by pfGetData.
pInfo Pointer to a GUI_GIF_INFO structure which will be filled by this function.
Return value
0 on success, != 0 on error.
Elements of GUI_GIF_INFO
Data type Element Description
int XSize Pixel size in X of the image.
int YSize Pixel size in Y of the image.
int NumImages Number of sub images in the file.
GUI_GIF_GetXSize()
Description
Returns the X-size of a specified GIF image, which has been loaded into memory.
Prototype
int GUI_GIF_GetXSize(const void * pGIF);
Parameter Description
pGIF Pointer to the start of the memory area in which the gif file resides.
Return value
X-size of the GIF image.
GUI_GIF_GetXSizeEx()
Description
Returns the X-size of a specified GIF image, which needs not to be loaded into memory.
Prototype
int GUI_GIF_GetXSizeEx(GUI_GET_DATA_FUNC * pfGetData, void * p);
Parameter Description
pfGetData
Pointer to a function which is called for getting data. For details about the GetData
function, refer to “Getting data with the ...Ex() functions” on page 174.
p Void pointer passed to the function pointed by pfGetData.
Return value
X-size of the GIF image.
UM03001 User & Reference Guide for emWin V5.18 © 1997 - 2012 SEGGER Microcontroller GmbH & Co. KG