Version: 2023.2
LanguageEnglish
  • C#

Gizmos.DrawLineList

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

Declaration

public static void DrawLineList(ReadOnlySpan<Vector3> points);

Parameters

points Pairs of points to use as the beginning and end of each line to draw. Unity throws an exception if points contains an odd number of elements.

Description

Draws multiple lines between pairs of points.

This function provides a more efficient way to draw multiple lines than repeatedly calling the Gizmos.DrawLine function for each one.

Each pair of points from the points span represents the start and end of each line, so Unity draws the first line from points[0] to points[1], the next from points[2] to points[3], and so on.

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { Vector3[] points;

void Start() { points = new Vector3[4] { new Vector3(-100, 0, 0), new Vector3(100, 0, 0), new Vector3(-100, 100, 0), new Vector3(100, 100, 0) }; }

void OnDrawGizmosSelected() { // Draws two parallel blue lines Gizmos.color = Color.blue; Gizmos.DrawLineList(points); } }

Additional resources: Gizmos.DrawLine, Gizmo.DrawLineStrip.