GetPoint

Pauses for user input of a point.

Syntax

rhinoscriptsyntax.GetPoint ( message=None, basePoint=None, distance=None, in_plane=False )

rhinoscript.userinterface.GetPoint ( message=None, basePoint=None, distance=None, in_plane=False )

Parameters

message

Optional.  String.  A prompt or message.

basePoint

Optional.  list or On3dPoint.  A list of 3 numbers or ON_3dPoint identifying a starting, or base, point.

distance

Optional.  Number.  A constraining distance.  If a constraining distance is specified, a base point must also be specified.

in_plane

Optional.  Boolean.  Constrain the point selection to the active construction plane.

Returns

Point3d

the 3-D point input by the user successful.

None

If not successful, or on error.

Example

import rhinoscriptsyntax as rs

point1 = rs.GetPoint("Pick first point")

if point1:

    rs.AddPoint(point1)

    point2 = rs.GetPoint("Pick second point", point1)

    if point2:

        rs.AddPoint(point2)

        distance = (point1-point2).Length

        point3 = rs.GetPoint("Pick third point", point2, distance)

        if point3: rs.AddPoint(point3)

Also See

GetPointOnCurve

GetPointOnSurface

GetPoints

GetRectangle