https://github.com/foresightminingsoftwarecorporation/bevy_transform_gizmo

A 3d gizmo for transforming entities in Bevy.
https://github.com/foresightminingsoftwarecorporation/bevy_transform_gizmo

bevy gizmo

Last synced: 6 days ago
JSON representation

A 3d gizmo for transforming entities in Bevy.

• Host: GitHub
• URL: https://github.com/foresightminingsoftwarecorporation/bevy_transform_gizmo
• Owner: ForesightMiningSoftwareCorporation
• License: apache-2.0
• Created: 2021-05-10T19:06:24.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-11-05T05:39:43.000Z (3 months ago)
• Last Synced: 2025-01-18T03:03:19.248Z (6 days ago)
• Topics: bevy, gizmo
• Language: Rust
• Homepage:
• Size: 41.1 MB
• Stars: 161
• Watchers: 12
• Forks: 41
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        


    

# Bevy Transform Gizmo


**Simple 3D transform gizmo for bevy**

https://user-images.githubusercontent.com/2632925/227469248-726b21c8-5308-49f0-9b04-e567833774e1.mp4

[![crates.io](https://img.shields.io/crates/v/bevy_transform_gizmo)](https://crates.io/crates/bevy_transform_gizmo)

[![docs.rs](https://docs.rs/bevy_transform_gizmo/badge.svg)](https://docs.rs/bevy_transform_gizmo)

[![CI-CD](https://github.com/ForesightMiningSoftwareCorporation/bevy_transform_gizmo/actions/workflows/release.yml/badge.svg)](https://github.com/ForesightMiningSoftwareCorporation/bevy_transform_gizmo/actions/workflows/release.yml)

[![Bevy tracking](https://img.shields.io/badge/Bevy%20tracking-main-lightblue)](https://github.com/bevyengine/bevy/blob/main/docs/plugins_guidelines.md#main-branch-tracking)

    



# Demo

Run a minimal implementation of the gizmo by cloning this repository and running:

```shell

cargo run --example minimal

```

# Features

* Prebuilt transform gizmo appears when you select a designated mesh

* Translation handles (axis, plane, and normal to camera)

* Rotation handles

* Gizmo always renders on top of the main render pass

* Gizmo is always the same size at it moves closer/further from the camera

# Usage

This plugin is built on and relies on [`bevy_mod_picking`](https://github.com/aevyrie/bevy_mod_picking) for 3d mouse interaction with the scene.

See the [minimal](examples/minimal.rs) demo for an example of a minimal implementation.

# License

bevy_transform_gizmo is free and open source! All code in this repository is dual-licensed under either:

* MIT License ([LICENSE-MIT](LICENSE-MIT) or [http://opensource.org/licenses/MIT](http://opensource.org/licenses/MIT))

* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0))

at your option. This means you can select the license you prefer! This dual-licensing approach is the de-facto standard in the Rust ecosystem and there are very good reasons to include both.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.