A library of pre-defined stock images for buttons and labels.


To generate an application that uses this function, the program must be linked to the functions library (iupimglib.lib on Windows and libiupimglib.a on Unix).


void IupImageLibOpen(void); [in C]
iup.ImageLibOpen()  [in Lua]

This function register the names but do not load the images. The images will be loaded only if they are used in a control. The loaded images will be automatically released at IupClose.

In Lua, when require"iupluaimglib" is used this function will be automatically called.


The following names can be used after the library initialization. The names are NOT registered using IupSetHandle, they will be automatically loaded when associated with a control.

Base Library Group

These bitmaps are 16x16-8bpp (Motif) and 32x32-32bpp (Windows) pixels size images that can be used in Buttons, usually inside toolbars. GTK has several image sizes available: 16x16, 18x18, 20x20, 24x24, 32x32, and 48x48. GTK images displayed here are just a sample with the 24x24-32bpp pixels size, they actually depends on the current GTK theme used by the system. Since GTK 3.10 access to stock images directly becomes deprecated, so starting in IUP 3.23 the IupImageLib now contains the base set of GTK images and they will be not affected by the current GTK theme.

In Windows and GTK, to force a specific height for the images use the IMAGESTOCKSIZE global attribute (since 3.16), it can have the following values 16, 24, 32 and 48. In GTK if the system does not provides the image in that size it will be automatically resized from an existing size. In Windows if the image is not 32x32 then it will be automatically resized. The default size depends on the screen resolution: 96 DPI = 16, 144 DPI = 24, 192 DPI = 32, 288 DPI = 48.

Name Image

The following images were removed from the pre-compiled library (since 3.16): "IUP_FileCloseAll", "IUP_FileSaveAll", "IUP_FileText", "IUP_FontBold", "IUP_FontDialog", "IUP_FontItalic", "IUP_WindowsCascade", "IUP_WindowsTile", "IUP_Zoom". Although their C source code is still available.

"IUP_CircleProgressAnimation" animation added in version 3.17. To be used in IupAnimatedLabel to show indefinite progress. It has 12 frames of 32x32 with 32bpp, and FRAMETIME is set to 83ms (approximately 1 second for a full turn).


Logo Group 32x32

These images are 32x32-32bpp pixels size (or just 32 pixels height) images that can be used in Labels, usually inside toolbars.

Name Image
Name Image

Logo Group 48x48 (since 3.3)

These images are 48x48-32bpp pixels size (or just 48 pixels height) images that can be used in Labels, usually inside dialogs.

NOT included in the pre-compiled library, but available as C source code.

Name Image
Name Image

Icon Group 48x48 (since 3.3)

Here are other images available in the IUP stock library, commonly used by the respective systems. All images are 48x48-32bpp pixels size.

NOT included in the pre-compiled library, but available as C source code.

Name Image
Name Image

Icon Group 32x32 () (since 3.16)

Here are other images available in the IUP stock library, commonly used in Windows. All images are 32x32-32bpp pixels size.

NOT included in the pre-compiled library, and NOT available as C source code. The image files are available for download here:



All images are available as PNG files in the "iup/html/en/imglib/*" folder. Except for the GTK images that are only sample images.

Use the IupView application to export PNG images to C, LED or Lua.

All 8bpp images are from the old ImageLib and since Motif does not have any stock images, we selected this set to be used in Motif. Although the IUP Motif driver supports 32bpp images.

The pre-compiled library does not include images larger than 48x48 (inclusive). If you want to use them you must include their source code, or re-compile the library defining USE_IUP_IMGLIB_LARGE during compilation, for example: "make USE_IUP_IMGLIB_LARGE=1".

Not available in AIX.

All "Windows" images copyright Microsoft and were extracted from the Visual Studio 2013 Image Library. Their use must be used consistently with their description in the Visual Studio Image Library, and so consistently with the IUP name. These files are available for free on the link: Visual Studio Image Library. You can find a copy of the license terms here: "Visual Studio 2013 Image Library EULA.docx". The most important statement on this document is: "Media Elements. You may copy and use images in the Image Library provided with the software and identified for such use in documents and projects that you create."

GTK stock images are released under the GTK license.

PUC-Rio, Tecgraf/PUC-Rio, Petrobras and Lua images are copyright of the respective companies or owners. The Petrobras logo images follow the company established rules.

Lua image graphic design by A. Nakonechnyj. Copyright 1998. All rights reserved.

See Also