Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/raysan5/rguistyler

A simple and easy-to-use raygui styles editor
https://github.com/raysan5/rguistyler

imgui raygui ui-components ui-design ui-themes

Last synced: 5 days ago
JSON representation

A simple and easy-to-use raygui styles editor

Host: GitHub
URL: https://github.com/raysan5/rguistyler
Owner: raysan5
License: zlib
Created: 2018-08-17T17:53:28.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-12-31T23:34:14.000Z (21 days ago)
Last Synced: 2025-01-09T19:39:50.331Z (12 days ago)
Topics: imgui, raygui, ui-components, ui-design, ui-themes
Language: C
Homepage: https://raylibtech.itch.io/rguistyler
Size: 8.55 MB
Stars: 58
Watchers: 8
Forks: 12
Open Issues: 1
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

# `rGuiStyler`

A simple and easy-to-use [raygui](https://github.com/raysan5/raygui) styles editor.

Useful for tools style customization. The best tool companion for [rGuiLayout](https://raylibtech.itch.io/rguilayout) and [rGuiIcons](https://raylibtech.itch.io/rguiicons).

`rGuiStyler` can be used for free as a [WebAssembly online tool](https://raylibtech.itch.io/rguistyler) and it can also be downloaded as a **standalone tool** for `Windows`, `Linux` and `macOS` with some extra features.

**NOTE: Latest `rGuiStyler 5.0` release is intended to be used with [`raygui 4.0`](https://github.com/raysan5/raygui/releases/tag/4.0) release.**

## Features

- **Global and control specific styles edition**
- **Style preview** in real time with individual test controls
- **Style templates** available to start customizing new styles
- Selectable controls state: **NORMAL, FOCUSED, PRESSED, DISABLED**
- Save and load as binary style file `.rgs` (with font embedded!)
- Export style as an embeddable **code file** (`.h`) (with font embedded!)
- Export style as a `.png` **controls table image** for showcase
- Embed style as png image chunk: `rGSf` (rgs file data)
- Import, configure and preview **style fonts** (`.ttf`/`.otf`)
- Load custom font charset for the style (Unicode codepoints)
- Color palette for quick color save/selection
- **+10 custom style examples** included for reference
- Command-line support for `.rgs`/`.h`/`.png` batch conversion
- **Completely portable (single-file, no-dependencies)**
- **Free and open source**

## Screenshot

![rGuiStyler](screenshots/rguistyler_v500_shot01.png)

## Usage

The tool is quite intuitive, the expected steps to follow are:
1. Choose the control to edit from first ListView (`DEFAULT` referes to global style for all controls)
2. Choose the property to edit from second ListView
3. Select a value for that property (color, number...)

NOTE: Changes are previewed in real time in the same tool!

Once the desired style has been created, press the `Export Style` button to save it as a `.rgs`**binary style file**. Style can also be exported as an embeddable `.h` **code file** or a `.png` **controls table image** (intended for preview and style showcase)

`rGuiStyler Standalone` comes with command-line support for batch conversion. For usage help:

> rguistyler.exe --help

## License

`rGuiStyler` source code is distributed as **open source**, licensed under an unmodified [zlib/libpng license](LICENSE).

`rGuiStyler` binaries are completely free for anyone willing to compile them directly from source.

`rGuiStyler Standalone` desktop tool is distributed as freeware.

In any case, consider some donation to help the author keep working on software for games development.