Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/raysan5/rguiicons

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

icons iconset pixel-art raygui ui-design

Last synced: 3 months ago
JSON representation

A simple and easy-to-use raygui icons editor

Host: GitHub
URL: https://github.com/raysan5/rguiicons
Owner: raysan5
License: zlib
Created: 2019-09-01T09:56:12.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-10-15T17:22:27.000Z (3 months ago)
Last Synced: 2024-10-17T00:30:30.624Z (3 months ago)
Topics: icons, iconset, pixel-art, raygui, ui-design
Language: C
Homepage: https://raylibtech.itch.io/rguiicons
Size: 1.37 MB
Stars: 47
Watchers: 4
Forks: 6
Open Issues: 1
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

# `rGuiIcons`

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

Useful for tools icons customization. The best tool companion for [rGuiLayout](https://raylibtech.itch.io/rguilayout) and [rGuiStyler](https://github.com/raysan5/rguistyler).

`rGuiIcons` can be used for free as a [WebAssembly online tool](https://raylibtech.itch.io/rguiicons) and it can also be downloaded as a **standalone tool** for _Windows_ and _Linux_ with some extra features.

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

## Features

- **Icon editing** and preview at multiple sizes
- **Cut, copy, paste** icons for easy editing
- **Undo/Redo** system for icon changes
- Save and load as binary iconset file `.rgi`
- Export iconset as an embeddable **code file** (`.h`)
- Export iconset as a `.png` black&white image
- Icon name ids exported as standard PNG chunk (`zTXt`)
- Multiple UI styles for tools reference
- **+200 custom icons for reference** and basic edition
- Command-line support for `.rgi`/`.h`/`.png` batch conversion
- **Completely portable (single-file, no-dependencies)**
- **Free and open source**

## Screenshot

![rGuiIcons](screenshots/rguiicons_v200_shot02.png)

## Usage

The tool is quite intuitive, the expected steps to follow are:
1. Choose the icon to edit from icons panel
2. Edit the icon pixels in the right panel
3. Select next icon for edit or export set/individual icon

NOTE: Icon changes are previewed in real time in the same tool!

Once icons have been created/edited, they can be saved as a raygui-ready icon set (.rgi), exported as an embeddable `.h` **code file** or exported as a `.png` image. Note that the `.png` contains the icons ids information in a standard chunk (`tEXt`/`zTXt`).

- raygui icon set file (`.rgi`) can be loaded by raygui using the function `GuiLoadIcons()`.

- raygui icon set code file (`.h`) can be embedded into a raygui-based application just defining:

```c
#define RAYGUI_IMPLEMENTATION
#define RAYGUI_CUSTOM_ICONS // Custom icons set required
#include "gui_iconset.h" // Custom icons set provided, generated with rGuiIcons tool
#include "raygui.h"
```

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

> rguiicons.exe --help

## License

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

`rGuiIcons` binaries are completely free for anyone willing to compile it directly from source.

`rGuiIcons Standalone` desktop tool is distributed as freeware.

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