You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+27-31Lines changed: 27 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,19 +1,14 @@
1
-
Unity Gizmo Drawer Tool
1
+
Unity Gizmo Tool
2
2
==================
3
3
4
-

4
+
# Description
5
+
The Gizmo Tool enables you to use gizmos as components. This project is useful for level editing and other tasks where simple visualization is needed. See the [Wiki](https://github.com/MccDev260/com.mccdev260.gizmo-tool/wiki) section of the repo for more detail.
5
6
6
-
Description
7
-
-----------
8
-
9
-
The Gizmo Drawer tool is a custom script that allows you to draw built in gizmos with customizable properties in the Unity scene. This script provides a versatile way to draw gizmos with a custom inspector to adjust their properties from within the editor.
10
-
11
-
12
-
Features
13
-
--------
14
-
* Has a custom Inspector to easily adjust gizmo properties directly in the Editor.
15
-
* Supports nearly all gizmo types, **except Frustum**, as of Editor v2023.3
16
-
* Customize the properties of each gizmo type, such as position, scale, color, and more.
7
+
# Features
8
+
* Draw Gizmos with a component for quick visualization in the editor.
9
+
* Use a custom Inspector to easily adjust gizmo properties.
10
+
* Supports most gizmo types.
11
+
* All scripts in this package only run in the editor and are excluded from builds.
17
12
18
13
## Supported Types:
19
14
* Sphere
@@ -28,36 +23,37 @@ Features
28
23
* Icon
29
24
* GUI Texture
30
25
31
-
Installation
32
-
------------
26
+
## Considerations
27
+
Since this package is excluded from builds, be mindful of controlling `GizmoDrawer` with runtime scripts.
28
+
See [Wiki/ExtendingBehaviour](https://github.com/MccDev260/com.mccdev260.gizmo-tool/wiki/Extending-Behviour) for a list of public members and suggested approaches.
33
29
30
+
# Installation
34
31
1. Open Unity package manager window.
35
32
2. From the '+' menu in the top left corner, select '*Add package from git URL...*'
36
33
3. Copy and paste this repository's URL into the URL field.
37
34
38
-
Usage
39
-
-----
35
+
# Getting Started
40
36
1. Attach the `GizmoDrawer` script to a GameObject in your scene.
41
-
2. In the Inspector, configure the gizmo properties based on your desired gizmo type.
42
-
3. Toggle the `drawOnSelectOnly` option to control whether the gizmo should be drawn only when the GameObject is selected.
43
-
4. Customize the gizmo's appearance by adjusting the color, size, scale, texture, and other relevant properties.
44
-
5. To see the gizmos in the Scene view, ensure the Gizmos toggle is enabled at the top of the Scene view.
37
+
2. Toggle the `drawOnSelectOnly` option to control whether the gizmo should be drawn only when the GameObject is selected.
38
+
3. Configure the gizmos properties with the custom inspector.
45
39
46
-
Example
47
-
-------
48
-
To draw a sphere gizmo:
40
+
For more detailed explanation about each gizmo type and their properties, See the [Wiki](https://github.com/MccDev260/com.mccdev260.gizmo-tool/wiki) section of the repo.
41
+
42
+
# Troubleshooting
43
+
## I can't see gizmos in the scene view?
44
+
- Make sure the Gizmos Menu is toggled on in the top right corner.
45
+
- If this doesn't work - Expand menu, find `GizmoDrawer` in the scripts list and ensure it's enabled.
46
+
- Check the `GizmoDrawer` properties in the inspector and ensure its origin is set to the expected value.
49
47
50
-
1. Attach the `GizmoDrawer` script to a GameObject.
51
-
2. Set the `gizmoType` to `Sphere`.
52
-
3. Either manually set the gizmos origin via the exposed Vector3 `originPos` property, or reference a target Transform with the `originTransfom` property.
53
-
4. Adjust the `floatRadius` to control the sphere's radius.
54
-
5. Optionally, customize the `gizmoColor` to change the sphere's color.
55
-
6. In the Scene view, the sphere gizmo will be drawn with the desired properties.
Contributions are welcome! If you find any issues or want to enhance the project, feel free to fork this repository and submit pull requests.
56
+
Contributions are welcome! If you have any problems or an idea for a new feature, feel free to submit a new issue [here](https://github.com/MccDev260/com.mccdev260.gizmo-tool/issues).
0 commit comments