GetPoints

Pauses for user input of one or more points.

Syntax

rhinoscriptsyntax.GetPoints( draw_lines=False, in_plane=False, message1=None, message2=None, max_points=None, base_point=None)

rhinoscript.userinterface.GetPoints( draw_lines=False, in_plane=False, message1=None, message2=None, max_points=None, base_point=None)

Parameters

draw_lines

Optional.  Boolean.  Draw lines between points.  The default is not to draw lines between points (False).

in_plane

Optional.  Boolean.  Constrain the point selection to the active construction plane.  The default is not to constrain points to the active construction plane (False).

message1

Optional.  String.  A prompt or message for the first point.

message2

Optional.  String.  A prompt or message for the next points.

max_points

Optional.  Number.  The maximum number of points to pick.  If not specified, an unlimited number of points can be picked.

base_point

Optional.  A starting, or base, point.

Returns

List

A list of 3-D points if successful.

None

If not successful, or on error.

Example

import rhinoscriptsyntax as rs

points = rs.GetPoints(True)

if points: rs.AddPointCloud(points)

Also See

GetPoint

GetPointOnCurve

GetPointOnSurface

GetRectangle