https://github.com/raysan5/rguilayout

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

Last synced: 2 months ago
JSON representation

A simple and easy-to-use raygui layouts editor

• Host: GitHub
• URL: https://github.com/raysan5/rguilayout
• Owner: raysan5
• License: zlib
• Created: 2018-08-17T18:03:04.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2025-03-25T18:28:26.000Z (3 months ago)
• Last Synced: 2025-03-29T08:06:31.727Z (2 months ago)
• Language: C
• Size: 3.38 MB
• Stars: 117
• Watchers: 2
• Forks: 22
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# `rGuiLayout`

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

Useful for custom tools layout creation. The best tool companion for [rGuiStyler](https://raylibtech.itch.io/rguistyler) and [rGuiIcons](https://raylibtech.itch.io/rguiicons).

`rGuiLayout` can be used for free as a [WebAssembly online tool](https://raylibtech.itch.io/rguilayout) and it can also be downloaded as a **standalone tool** for _Windows_ and _Linux_.

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

## Features

 - **25 gui controls to define your immmediate-mode gui layout**

 - Place controls and move/scale them freely

 - Snap to grid mode for maximum precission

 - **Link controls** to anchors for better organization

 - **Edit controls text and code name** (for exported variables)

 - Icon selection panel on control text edition

 - Load/Save your layouts as `.rgl` **text files**

 - Supports `.png` image loading to be used as **tracemap**

 - Support for **custom code templates** to generate your controls code

 - **Export layout directly as plain C code, ready to edit and compile**

 - Multiple GUI styles available with support for custom ones (`.rgs`)

 - Command-line support for `.rgl` to `.c`/`.h` conversion

 - **Completely portable (single-file, no-dependencies)**

 - **Free and open-source**

 

## Screenshot

![rGuiLayout](screenshots/rguilayout_v300_shot01.png)

 

## Usage

For detailed usage information, check provided [USAGE.md](https://github.com/raysan5/rguilayout/blob/master/USAGE.md) file.

The tool works with mouse and several key shortcuts that can be viewed with F1 key.

Use mouse wheel to navigate along the available controls or select them on right controls panel, place them on the main grid and scale as required.

Load and Save `.rgl` layout files to keep working on custom layouts.

Export layouts as code, Code Generation Window offers multiple export options to generate the code. 

**To compile generated code, you need `raygui v4.0` library and latest `raylib v4.6-dev`.**

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

 > rguilayout.exe --help

## License

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

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

`rGuiLayout Standalone` desktop tool could be downloaded with a small donation. 

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

*Copyright (c) 2015-2025 raylib technologies ([@raylibtech](https://twitter.com/raylibtech)) / Ramon Santamaria ([@raysan5](https://twitter.com/raysan5))*