Skip to content

Commit bf55884

Browse files
Update README.md
- Simplified README content. - Removed Example Gif and deleted file to reduce footprint. - Made a wiki for more detailed info.
1 parent f39b682 commit bf55884

File tree

4 files changed

+27
-166
lines changed

4 files changed

+27
-166
lines changed

README.md

Lines changed: 27 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,14 @@
1-
Unity Gizmo Drawer Tool
1+
Unity Gizmo Tool
22
==================
33

4-
![Visualizing waypoints for a moving platform and character look source.](ReadMeImgs/MovingPlatformExample-LineStrip.gif)
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.
56

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.
1712

1813
## Supported Types:
1914
* Sphere
@@ -28,36 +23,37 @@ Features
2823
* Icon
2924
* GUI Texture
3025

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.
3329

30+
# Installation
3431
1. Open Unity package manager window.
3532
2. From the '+' menu in the top left corner, select '*Add package from git URL...*'
3633
3. Copy and paste this repository's URL into the URL field.
3734

38-
Usage
39-
-----
35+
# Getting Started
4036
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.
4539

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.
4947

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.
48+
References
49+
-------
50+
* [Unity - Scripting API: Gizmos](https://docs.unity3d.com/ScriptReference/Gizmos.html)
51+
* [Unity - Manual: Gizmos Menu](https://docs.unity3d.com/Manual/GizmosMenu.html).
5652

5753
Contributing
5854
------------
5955

60-
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).
6157

6258
License
6359
-------

ReadMeImgs.meta

Lines changed: 0 additions & 8 deletions
This file was deleted.
-5.98 MB
Binary file not shown.

ReadMeImgs/MovingPlatformExample-LineStrip.gif.meta

Lines changed: 0 additions & 127 deletions
This file was deleted.

0 commit comments

Comments
 (0)