RAYGUI_VERSION

GUI STYLE (guiStyle):

raygui uses a global data array for all gui style properties (allocated on data segment by default), when a new style is loaded, it is loaded over the global style... but a default gui style could always be recovered with GuiLoadStyleDefault() function, that overwrites the current style to the default one

The global style array size is fixed and depends on the number of controls and properties:

uint guiStyle[RAYGUI_MAX_CONTROLS*(RAYGUI_MAX_PROPS_BASE + RAYGUI_MAX_PROPS_EXTENDED)];

guiStyle size is by default: 16*(16 + 8) = 384*4 = 1536 bytes = 1.5 KB

Note that the first set of BASE properties (by default guiStyle[0..15]) belong to the generic style used for all controls, when any of those base values is set, it is automatically populated to all controls, so, specific control values overwriting generic style should be set after base values.

After the first BASE set we have the EXTENDED properties (by default guiStyle[16..23]), those properties are actually common to all controls and can not be overwritten individually (like BASE ones) Some of those properties are: TEXT_SIZE, TEXT_SPACING, LINE_COLOR, BACKGROUND_COLOR

Custom control properties can be defined using the EXTENDED properties for each independent control.

TOOL: rGuiStyler is a visual tool to customize raygui style.

GUI ICONS (guiIcons):

raygui could use a global array containing icons data (allocated on data segment by default), a custom icons set could be loaded over this array using GuiLoadIcons(), but loaded icons set must be same RICON_SIZE and no more than RICON_MAX_ICONS will be loaded

Every icon is codified in binary form, using 1 bit per pixel, so, every 16x16 icon requires 8 integers (16*16/32) to be stored in memory.

When the icon is draw, actually one quad per pixel is drawn if the bit for that pixel is set.

The global icons array size is fixed and depends on the number of icons and size:

uint guiIcons[RICON_MAX_ICONS*RICON_DATA_ELEMENTS];

guiIcons size is by default: 256*(16*16/32) = 2048*4 = 8192 bytes = 8 KB

TOOL: rGuiIcons is a visual tool to customize raygui icons.

CONFIGURATION:

#define RAYGUI_IMPLEMENTATION Generates the implementation of the library into the included file. If not defined, the library is in header only mode and can be included in other headers or source files without problems. But only ONE file should hold the implementation.

#define RAYGUI_STANDALONE Avoid raylib.h header inclusion in this file. Data types defined on raylib are defined internally in the library and input management and drawing functions must be provided by the user (check library implementation for further details).

#define RAYGUI_NO_RICONS Avoid including embedded ricons data (256 icons, 16x16 pixels, 1-bit per pixel, 2KB)

#define RAYGUI_CUSTOM_RICONS Includes custom ricons.h header defining a set of custom icons, this file can be generated using rGuiIcons tool

VERSIONS HISTORY:

3.0 (xx-Sep-2021) Integrated ricons data to avoid external file REDESIGNED: GuiTextBoxMulti() REMOVED: GuiImageButton*() Multiple minor tweaks and bugs corrected 2.9 (17-Mar-2021) REMOVED: Tooltip API 2.8 (03-May-2020) Centralized rectangles drawing to GuiDrawRectangle() 2.7 (20-Feb-2020) ADDED: Possible tooltips API 2.6 (09-Sep-2019) ADDED: GuiTextInputBox() REDESIGNED: GuiListView*(), GuiDropdownBox(), GuiSlider*(), GuiProgressBar(), GuiMessageBox() REVIEWED: GuiTextBox(), GuiSpinner(), GuiValueBox(), GuiLoadStyle() Replaced property INNER_PADDING by TEXT_PADDING, renamed some properties ADDED: 8 new custom styles ready to use Multiple minor tweaks and bugs corrected 2.5 (28-May-2019) Implemented extended GuiTextBox(), GuiValueBox(), GuiSpinner() 2.3 (29-Apr-2019) ADDED: rIcons auxiliar library and support for it, multiple controls reviewed Refactor all controls drawing mechanism to use control state 2.2 (05-Feb-2019) ADDED: GuiScrollBar(), GuiScrollPanel(), reviewed GuiListView(), removed Gui*Ex() controls 2.1 (26-Dec-2018) REDESIGNED: GuiCheckBox(), GuiComboBox(), GuiDropdownBox(), GuiToggleGroup() > Use combined text string REDESIGNED: Style system (breaking change) 2.0 (08-Nov-2018) ADDED: Support controls guiLock and custom fonts REVIEWED: GuiComboBox(), GuiListView()... 1.9 (09-Oct-2018) REVIEWED: GuiGrid(), GuiTextBox(), GuiTextBoxMulti(), GuiValueBox()... 1.8 (01-May-2018) Lot of rework and redesign to align with rGuiStyler and rGuiLayout 1.5 (21-Jun-2017) Working in an improved styles system 1.4 (15-Jun-2017) Rewritten all GUI functions (removed useless ones) 1.3 (12-Jun-2017) Complete redesign of style system 1.1 (01-Jun-2017) Complete review of the library 1.0 (07-Jun-2016) Converted to header-only by Ramon Santamaria. 0.9 (07-Mar-2016) Reviewed and tested by Albert Martos, Ian Eito, Sergio Martinez and Ramon Santamaria. 0.8 (27-Aug-2015) Initial release. Implemented by Kevin Gato, Daniel Nicolás and Ramon Santamaria.

CONTRIBUTORS:

Ramon Santamaria: Supervision, review, redesign, update and maintenance Vlad Adrian: Complete rewrite of GuiTextBox() to support extended features (2019) Sergio Martinez: Review, testing (2015) and redesign of multiple controls (2018) Adria Arranz: Testing and Implementation of additional controls (2018) Jordi Jorba: Testing and Implementation of additional controls (2018) Albert Martos: Review and testing of the library (2015) Ian Eito: Review and testing of the library (2015) Kevin Gato: Initial implementation of basic components (2014) Daniel Nicolas: Initial implementation of basic components (2014)