Lines.add Method

Parent Object: Lines

Preview This functionality is provided as a preview of intended future API capabilities. You are encouraged to use it and report any problems or suggestions using the Fusion API and Scripts forum.

Because this is a preview of future functionality, there is the possibility that it will change, which will possibly break any existing programs that use this functionality. Because of that, you should never deliver any programs that use any preview capabilities. For a distributed program, you should wait until it has moved from preview to released state.

Defined in namespace "adsk::drawing" and the header file is <Drawing/Sketch/Lines.h>

Description

Creates a new line (a connected chain of straight segments) on the sheet from the given ordered vertices.

"lines_var" is a variable referencing a Lines object.

returnValue = lines_var.add(points)

"lines_var" is a variable referencing a Lines object.

#include <Drawing/Sketch/Lines.h>

returnValue = lines_var->add(points);

"lines_var" is a variable referencing a Lines object.

returnValue = lines_var.add(points);

Return Value

Type	Description
Line	Returns the newly created Line, or null if the operation failed.

Parameters

Name	Type	Description
points	Point2D[]	The ordered vertices of the line. At least two points are required; supplying fewer than two causes the operation to fail. Coordinates are in drawing length units (millimeters when the drawing standard includes ISO; inches when the standard is ASME without ISO). Build each point with core.Point2D.create(x, y).

Version

Introduced in version September 2026