Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Handles.DotCap

static function DotCap(controlID: int, position: Vector3, rotation: Quaternion, size: float): void;
static void DotCap(int controlID, Vector3 position, Quaternion rotation, float size);
static def DotCap(controlID as int, position as Vector3, rotation as Quaternion, size as float) as void

Description

Draw a camera-facing dot. Pass this into handle functions.

Note: Use HandleUtility.GetHandleSize where you might want to have constant screen-sized handles.


Dot Cap in the Scene View.

	// Draw one Dot on each axis of any GameObject that has 
	// the "DummyDotCapScript.js" script attached.
	
	@CustomEditor (DummyDotCapScript)
	class DotCap extends Editor {
		
		var dotSize : float = 1;
	
	    function OnSceneGUI () {
	    	Handles.color = Color.red;
	    	Handles.DotCap(0,
	    			target.transform.position + Vector3(5,0,0),
	    			target.transform.rotation,
	    			dotSize);
	    	Handles.color = Color.green;
	    	Handles.DotCap(0,
	    			target.transform.position + Vector3(0,5,0),
	    			target.transform.rotation,
	    			dotSize);    	
	    	Handles.color = Color.blue;
	    	Handles.DotCap(0,
	    			target.transform.position + Vector3(0,0,5),
	    			target.transform.rotation,
	    			dotSize);
	    }
	}

And the script attached to this Handle:

	//DummyDotCapScript.js

Debug.Log("I have DotCap Handles attached to this transform!");