rust-constructor 2.8.0

A cross-platform GUI framework built on egui, the simplest way to develop GUI projects in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

# `Rust Constructor V2`

## A cross-platform `GUI` framework built on `egui`, the simplest way to develop `GUI` projects with `Rust`

[![Author: ChepleBob](https://img.shields.io/badge/author-ChepleBob-00B4D8)](https://github.com/ChepleBob30)
[![Language: Rust](https://img.shields.io/badge/language-Rust-5F4C49)](https://www.rust-lang.org/)
[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/version-v2.8.0-421463)](https://github.com/ChepleBob30/Rust-Constructor/releases)

English | [简体中文](./README_zh.md)

---

`Rust Constructor` is an open-source project, but it has no direct relationship with the `egui` development team!

## Table of Contents

- [Version Update Information](#version-update-information)
- [Introduction](#introduction)
- [Quick Start](#quick-start)
- [Purpose of Creating Rust Constructor](#purpose-of-creating-rust-constructor)
- [FAQ](#faq)
- [License](#license)
- [Epilogue](#epilogue)

---

## Version Update Information

- Current latest version is `v2.8.0 Three Core Principles`.
  - This update introduces improvements centered around three key aspects: "Multiple Dimensions", "Fast Execution", and "Ease of Use".
    - Modified `modify_tags` definition in `RustConstructorResource` to support optional clearing of existing tags;
    - Extracted `position` and `size` from `position_size_config`, added new methods `display_position` and `display_size` in `BasicFrontResource`;
    - Removed event system and all associated components;
    - Reintegrated `Rust Constructor Extra` into `Rust Constructor` (i.e., added three new resources `Background`, `Switch`, `ResourcePanel` with their corresponding methods);
    - Split color property into separate `color` and `alpha` fields;
    - Removed `truncate` from `Text`, now enforces text truncation with `auto_fit` parameter controlling render layer sizing behavior (whether `size` reflects actual text dimensions or bounding box dimensions);
    - Enhanced `ResourcePanel` layout system - layout strategy can now be defined internally within `ResourcePanel`;
    - Implemented scrollbars for `ResourcePanel`;
    - Fixed layout corruption issues in `ResourcePanel`;
    - Resolved several known bugs.

---

## Introduction

- `Rust Constructor` is a Rust graphical development library built on egui, including commonly used functions such as timers, resource storage, and error handling.
- `Rust Constructor` released its first version in `2025.2`, and today's `Rust Constructor` has undergone earth-shaking changes compared to that time.

---

## Quick Start

- To introduce `Rust Constructor`, please add `rust_constructor = "x.y.z"` (please replace xyz according to your needs) to `toml`.
- If you want to start `App` and perform some simple operations, it is recommended to refer to the [official documentation of egui](https://github.com/emilk/egui).
- You can refer to the official tutorial of `Rust Constructor` [Rust Constructor Guide](https://github.com/ChepleBob30/Rust-Constructor-Guide).

---

## Purpose of Creating Rust Constructor

We encountered some problems that `egui` could not solve during the development of [Targeted Vector](https://github.com/ChepleBob30/Targeted-Vector), so we expanded many tools. In order to allow more people to develop conveniently, we created `Rust Constructor`.

---

## FAQ

- Q1: Which platforms does `Rust Constructor` support?

- A1: `macOS` and `Windows` have been confirmed to be fully supported, and other platforms depend on `egui` support.

- Q2: What is the difference between `Rust Constructor V2` and `V1`?

- A2: The original architecture was modified to conform to the structure of the library `crate`, published on [crates.io](https://crates.io/), and added an official guide.

- Q3: Why do I get an error when calling a resource?

- A3: Please ensure that you have added the resource through the `add` method and there are no spelling errors.

- Q4: How to modify resources?

- A4: Take out the resource through `get_resource_mut`.

- Q5: What should I do if I encounter unknown error prompts?

- A5: Prioritize checking the `RustConstructorError` definition in the `Rust Constructor` source code, find the problem you triggered and correct it.

- Q6: Why is there only `V2` of `Rust Constructor` on `crates.io`?

- A6: `Rust Constructor V0` and `Rust Constructor V1` are essentially bloated projects with many redundant functions and meaningless code, so they were not released.

---

## License

[MIT](./LICENSE-MIT) © 2025 ChepleBob

## Epilogue

If you like this project, please give me a `star` on `GitHub`. You can also join our organization [Binder](https://github.com/Binder-organize).