## IupGLProgressBar (since 3.11)

Creates an embedded OpenGL progress bar control. Shows a percent value that can be updated to simulate a progression. It inherits from IupGLSubCanvas. It exists only inside an IupGLCanvasBox.

### Creation

    Ihandle* IupGLProgressBar(void); [in C]
    iup.glprogressbar{} -> (elem: ihandle) [in Lua]
    glprogressbar() [in LED]

Returns: the identifier of the created element, or NULL if an error occurs.

### Attributes

The IupGLProgressBar element handle all attributes defined for a IupGLSubCanvas control.

BACKIMAGE (non inheritable): image name to be used as background. It will be zoomed to fill the background (it does not includes the border). Use IupSetHandle or IupSetAttributeHandle to associate an image to a name. See also IupImage. (since 3.11.2)

BACKIMAGEHIGHLIGHT (non inheritable): background image name of the element in highlight state. If it is not defined then the BACKIMAGE is used. (since 3.11.2)

BACKIMAGEINACTIVE (non inheritable): background image name of the element when inactive. If it is not defined then the BACKIMAGE is used and its colors will be replaced by a modified version creating the disabled effect. (since 3.11.2)

BACKIMAGEPRESS (non inheritable): background image name of the element in pressed state. If it is not defined then the BACKIMAGE is used.(since 3.11.2)

FGCOLOR: Controls the bar color. Can have an alpha component. Default: "200 225 245".

FITTOBACKIMAGE (non inheritable): enable the natural size to be computed from the BACKIMAGE. If BACKIMAGE is not defined will be ignored. When set to Yes it will set BORDERWIDTH to 0. Can be Yes or No. Default: No. (since 3.11.2)

MAX (non inheritable): Contains the maximum value. Default is "1".

MIN (non inheritable): Contains the minimum value. Default is "0".

ORIENTATION: can be "VERTICAL" or "HORIZONTAL". Default: "HORIZONTAL". Horizontal goes from left to right, and vertical from bottom to top.

PADDING: internal margin. Default value: "0x0".

CPADDING: same as PADDING but using the units of the SIZE attribute. It will actually set the PADDING attribute. (since 3.29)

SHOWTEXT: Indicates if the text inside the bar is to be shown or not. Possible values: "YES" or "NO". Default: "YES".

TEXT (non inheritable): Contains a text to be shown inside the bar when SHOW_TEXT=YES. If it is NULL, the percentage calculated from VALUE will be used.

TXTCOLOR: Text color. Can have an alpha component. Default: "0 0 0".

VALUE (non inheritable): Contains a number between "MIN" and "MAX", controlling the current position.

### Notes

The natural size is the height of one character in one direction and the width of 15 characters in the other, plus PADDING and BORDERWIDTH.