Custom Handles

[ Demo Video ]

[ Support Forum ]

This package contains source code for a variety of custom editor handles to allow for intuitive control and tuning for complex objects. It includes handles for interactively adjusting arcs, falloff zones, shapes, helixes, joints, and more! The package also contains various examples to get you started, including helical mesh ribbons, helical particles, and simple AI awareness testers. Compatible with all platforms.

Release Notes

3.5.13: - Fix preference menu contents clipped in Unity 5.6.0. - Library updates. 3.5.12: - Fix compiler error in Unity 5.4.x introduced in 3.5.11. - Library updates. 3.5.11: - Fix assorted warning and error messages in console in Unity 5.6.0 beta. - Fix reference to UnityEditor introduced in previous version that would prevent building. - Library updates. 3.5.10: - Fix regression in 3.5.9 that broke keyboard navigation for some editor controls. 3.5.9: - Fix compiler warnings in Unity 5.5.0. - Fix possible Editor crash when GAF plugin is installed. - Removed some obsolete methods. - Library updates. 3.5.8: - Library updates. 3.5.7: - Fixed changes in library code that prevented building to WinRT platforms. 3.5.6: - Library updates. 3.5.5: - Library updates. 3.5.4: - Library updates. 3.5.3: - Fixed inapplicable controls and warning messages on FixedJoint editor. - Fixed harmless console error messages in Unity 5.4.0 beta. - Library updates. 3.5.2: - Library updates. 3.5.1: - Library updates. 3.5.0: - Unity 4.7 is new minimum version. - Library updates. 3.4.3: - Library updates. 3.4.2: - Fixed compiler errors in Unity 4.7.0. - Added SceneGUI.RegisterChange() to manually register non-LMB changes while in a handle context. - LinearHandles.Line() now allows specification of a cap function. - Fix axis handles in JointEditor using wrong matrix when joint is connected to another body but is not a child of the connected body. - Added console message upon compilation if a conflicting joint editor is found in the project while that included in this package is enabled. - FalloffHandles now allow specification of limits on domain and range of curve as applicable. - FalloffHandles now only display labels for selected keyframes. - FalloffHandles.SphereGraph() can now optionally have its values normalized to the domain of the curve. - FalloffHandles.SphereGraph() and FalloffHandles.DiscGraph() have the following new features: - Controls for time and value of keyframes are now unified into single handles that can be dragged on either axis; separate rings for time handles no longer appear. - Keyframes can now be deleted with the backspace or delete key when selected. - Keyframes can now be inserted using the right-click context menu in the scene view. - Added tangent handles when a keyframe value handle is selected - Hold Alt to break tangents, Ctrl/Cmd to reunite them. - Hold Shift to snap tangents at 45-degree intervals. - Smarter handling of colors for uniform curves and curves with specified range limits. - Respect SceneGUI.CurrentAlphaScalar. - Fixed bug where falloff fill colors wouldn't render on the first frame after recompiling. - Removed some obsolete methods. - Properly register availability of product features when using tvOS build target in Unity 5.3.1. - Library updates. 3.4.1: - Fixed HingeJoint angular limit handle not staying with object. - Added preference menu item to disable custom editors for built-in types (e.g., joints). - Fixed bug causing controls for shape handles to be offset too far when Handles.matrix has non-identity scale. - Library updates. 3.4.0: - Simplified product folder organization for Unity 5.3.0 and higher. - Library updates. 3.3.7: - Moved some scripts from Library folders into product folders to make examples easier to find. - Removed CustomHandleDefineSymbols.cs; please delete it. - Library updates. 3.3.6: - Library updates. 3.3.5: - Fixed compiler warnings in example editor scripts in Unity 5.3.0. - Library updates. 3.3.4: - Fixed harmless error message when opening color pickers in editor preference menu. - Fixed bug preventing changes to handles with gradient-based colors from saving to editor preferences. 3.3.3: - Library updates. 3.3.2: - Library updates. 3.3.1: - Fixed compiler error in Unity 5.2. - Updated example assets to use PBR for Unity 5.x. 3.3.0: - Removed unnecessary AxisTripod struct. - Changed color of joint angular limit handles. - The following files were renamed or removed and should be deleted: - BaseJointEditor.cs - HingeJointEditor.cs - CharacterJointEditor.cs - ConfigurableJointEditor.cs - SpringJointEditor.cs - Added Candlelight.Physics.JointEditor - Moved the following types into Candlelight.Physics namespace: - JointAngularLimits - JointX - JointHandles - Completely redid shape editing handles! - All handles now simultaneously edit the center and size, making it easier to keep one end of the shape pinned in place. - Hold Alt to get old behavior (shape center stays pinned in place). - Hold Shift to scale a shape handle proportionally. - Handles slightly overshoot shape so they do not conflict with Unity's built-in collider gizmos, making them more reliably selectable. - All handles now require specification of a based identifier to prevent collisions; this value is the first argument in all methods. - Removed LinearHandles.noLabel. - Removed SceneGUI.nullControlId. - Removed TransformHandles.XHandleHash, YHandleHash, and ZHandleHash; use EditAxis enum to get unique hashes for each axis now. - Fixed bug preventing spring joint handle from working as expected. - Fixed bug causing joint angular limit cone to disappear if z-axis was locked or free. - Removed obsolete methods. - Library updates. 3.2.4: - Added TransformHandles class. - LinearHandles.Translation() is now TransformHandles.Translation(). - TransformHandles.Translation() now displays correctly when rotated. - Added TransformHandles.Rotation() to fix bug with Unity's rotation handle displaying incorrectly when Handle matrix is not identity. - Added anchor handle for joint editors. - CylinderProperties is now an immutable struct. - FalloffHandles.defaultColorGradient is now FalloffHandles.DefaultColorGradient. - ArcHandles.requiredMinAngleChange and ArcHandles.radiusHandleScale are now private. - Fixed bug causing handles in included examples to display even if global scene GUI setting is toggled off. - Fixed bug causing scene view overlay to persist when deselecting multiple objects of the same type. - Fixed bug causing falloff handles to manipulate wrong properties. - Library updates. 3.2.3: - Library updates. 3.2.2: - Most handle types now allow specification of a control ID. - Added LinearHandles.Translation(), which allows more flexibility than built-in Handles.PositionHandle(). - Plug-in now supports WinRT and Windows Phone platforms. - Library updates. 3.2.1: - ISceneGUIContext now defines a property for getting the first target. - Added scene GUI overlay to joint editors. - Fixed console spam when using joint editors and handle scale is 0. - Added handles for editing axes on HingeJoints, CharacterJoints, and ConfigurableJoints. - Other minor improvements to custom editors for all joint types. - Capsule handles can no longer collapse on themselves (like Unity CapsuleCollider). - Removed obsolete methods. - Library updates. 3.2.0: - Overhauled SceneGUI methods for drawing GUI overlay in the scene to account for multiple components with scene GUI and complex selections. Custom editors using SceneGUI.Display() should implement ISceneGUIContext and make appropriate calls to SceneGUI.RegisterObjectGUICallback() and SceneGUI.DeregisterObjectGUICallback() in OnEnable()/OnDisable(). - Library updates. 3.1.2: - Library updates. 3.1.1: - All inspector buttons now support keyboard navigation. - Library updates. 3.1.0: - Moved all files into Plugins directory to reduce compile times and allow compatibility with languages other than C#. - Library updates. 3.0.12: - Unity 4.6 is new minimum version. - Library updates. - Changed version numbering scheme. 3.11: - Fixed missing references and scripts in example scene. 3.10: - Unify project layout and asset IDs across asset store products. 3.09: - Library updates for 5.0b17 compatibility. 3.08: - HandleContextException now logs in the editor console rather than being thrown, which makes them friendlier in cases of user error. - Library updates. 3.07: - Fixed bug with joint handles that could cause HandleContextException. 3.06: - Library updates. 3:05: - Library updates for Unity 5.x. 3.03: - Library updates. 3.02: - Library updates. 3.01: - Library updates. 3.0: - Moved all code into Candlelight namespace; project now uses Unity 4.5 as minimum version. - Renamed properties to better reflect .NET style; this change can cause loss of serialized data if you were relying on any examples scripts in your prefabs for existing projects. - Fixed exception when configurable joint handle orientation cannot be determined. - Fixed rendering bug for configurable joint x-axis angular limit handle when y-axis is set to free or locked. - Added custom editors with scene GUI for CharacterJoint, HingeJoint, and SpringJoint. - Removed obsolete methods.