Function Entry: GETPOINT

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: GETPOINT

Name

getpoint

Class

Function

Syntax

(getpoint [pt] [msg])

Arguments and Values

  • pt: optional base point
  • msg: optional prompt string

Autodesk documents pt as a 2D or 3D base point in the current UCS. Autodesk also documents that a single integer or real may be supplied as pt, invoking direct-distance entry from LASTPOINT.

Description

Prompts the user to specify a point.

Return Values

Returns a 3D point list or nil.

Side Effects

  • prompts the user
  • consumes interactive input

Compatibility

Host-interaction-specific; point representation remains ordinary list data.

Availability

  • AutoCAD 2026: documented (per Autodesk reference page).
  • BricsCAD V26: presumed compatible (no contradicting page found).
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Notes

  • Autodesk documents that if pt is present as a point, the host draws a rubber-band line from that point to the current crosshair position.
  • Autodesk documents that the user cannot respond with another AutoLISP expression.

clautolisp

clautolisp implementation deviation — not part of the normative specification above. AutoCAD and BricsCAD collect this point through the graphical drawing editor: a command-line prompt combined with pointer/keyboard interaction in the drawing window (implicitly a GUI). clautolisp has no drawing editor — it writes the prompt to the standard output and reads the answer as one line of text from the standard input (a TUI interaction). Interactively this is the REPL's terminal; for scripted, deterministic runs it is the file attached with --mock-input. A live CAD host, when connected, restores the native GUI behavior. On the TUI the point is typed as whitespace-separated coordinates — X Y or X Y Z; a 2D entry gets Z = 0.0. There is no crosshair, rubber-band line, or direct-distance entry; invalid input returns nil rather than re-prompting.