Function Entry: SSGET

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

Function Entry: SSGET

Name

ssget

Class

Host Function

Syntax

(ssget [sel-method] [pt1 [pt2]] [pt-list] [filter-list])

Arguments and Values

  • optional selection method
  • optional points
  • optional point list
  • optional filter list

Description

Constructs a selection set by interactive or programmatic selection.

Return Values

Selection set (PICKSET) or nil.

Side Effects

  • may prompt the user
  • may consume interactive input
  • depends on drawing state and selection semantics

Affected By

  • selection mode
  • filter list syntax
  • current host selection settings
  • vendor-specific extensions

Exceptional Situations

Autodesk documents many ERRNO cases related to invalid filter lists and selection usage.

Compatibility

This is one of the most host-specific functions in the core language.

BricsCAD has historically documented additional ssget modes and differences.

Notes

Autodesk explicitly documents selection methods including at least:

  • A
  • C
  • CP
  • F
  • I
  • L
  • P
  • W
  • WP
  • X

The selection-method sublanguage should later be given its own dedicated specification subsection.

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.

See Also

  • BricsCAD V9 documented ssget as compatible-with-enhancements. The current BricsCAD V26 surface is presumed compatible with AutoCAD; specific BricsCAD enhancements should be verified in Phase 5 against a live product.