Legacy Documentation: Version 2018.1 (Go to current version)
LanguageEnglish
  • C#
  • JS

Script language

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

Handles.DrawDottedLine

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public static method DrawDottedLine(p1: Vector3, p2: Vector3, screenSpaceSize: float): void;
public static void DrawDottedLine(Vector3 p1, Vector3 p2, float screenSpaceSize);

Parameters

p1The start point.
p2The end point.
screenSpaceSizeThe size in pixels for the lengths of the line segments and the gaps between them.

Description

Draw a dotted line from p1 to p2.


Draw Line in the Scene View.

#pragma strict
// Draw lines to the connected game objects that a script has.
// If the target object doesn't have any game objects attached
// then it draws a line from the object to (0, 0, 0).
@CustomEditor(ConnectedObjectsExample)
class ConnectLineHandleExample extends Editor {
	var dashSize: float = 4.0f;
	function OnSceneGUI() {
		var connectedObjects: ConnectedObjectsExample = target as ConnectedObjectsExample;
		if (connectedObjects.objs == null)return ;
		var center: Vector3 = connectedObjects.transform.position;
		for (var i: int = 0; i < connectedObjects.objs.Length; i++) {
			var connectedObject: GameObject = connectedObjects.objs[i];
			if (connectedObject) {
				Handles.DrawDottedLine(center, connectedObject.transform.position, dashSize);
			}
			else {
				Handles.DrawDottedLine(center, Vector3.zero, dashSize);
			}
		}
	}
}
// Draw lines to the connected game objects that a script has.
// If the target object doesn't have any game objects attached
// then it draws a line from the object to (0, 0, 0).

using UnityEditor; using UnityEngine;

[CustomEditor(typeof(ConnectedObjectsExample))] class ConnectLineHandleExample : Editor { float dashSize = 4.0f; void OnSceneGUI() { ConnectedObjectsExample connectedObjects = target as ConnectedObjectsExample; if (connectedObjects.objs == null) return;

Vector3 center = connectedObjects.transform.position; for (int i = 0; i < connectedObjects.objs.Length; i++) { GameObject connectedObject = connectedObjects.objs[i]; if (connectedObject) { Handles.DrawDottedLine(center, connectedObject.transform.position, dashSize); } else { Handles.DrawDottedLine(center, Vector3.zero, dashSize); } } } }

And the script attached to this Handle:

//ConnectedObjects.js

public var objs: GameObject[] = null;
using UnityEngine;
using System.Collections;

public class ConnectedObjectsExample : MonoBehaviour { public GameObject[] objs = null; }

Did you find this page useful? Please give it a rating: