std-inp-nentsel


Synopsis

(std-inp-nentsel <flag> <kwd> <msg> <def>)

Description

std-nentsel with full options. Before R14 often used for changing polyline segments, now only for getting block attributes or nested block subentities.

The enhancements over std-nentsel are:
msg is nicely formatted.

options for initget, like looping for input (flag 1),

handling and printing keywords,

handling defaults

A possible feature could be a filter list.

Arguments

flag: integer, same as the INITGET flag or nil

kwd: a initget-like string or a list of strings or nil

msg: a string to be displayed as a prompt. If nil "\nSelect object: " is prompted.

def: default value or nil

Return Value

Same as entsel.

If a keyword is matching, the keyword string.

On not complex objects (i.e., not a polyline or block), STD-INP-NENTSEL returns the same information as ENTSEL.

On complex objects, nentsel returns the picked subentity information, a list containing the name of the subentity (vertex) and the pick point. This is similar to the list returned by ENTSEL, except that the name of the selected vertex is returned instead of the polyline header. The NENTSEL function always returns the starting vertex of the selected polyline segment. Picking the third segment of a polyline, for example, returns the third vertex. The Seqend subentity is never returned by nentsel for a polyline.

When the selected object is a component of a block reference other than an attribute, NENTSEL returns a list containing four elements, the third is the Model to World Transformation Matrix. and the forth the list of all nested block names.

Side Effects

Interrupts the program flow, prints the formatted message and waits for user input if there is no pre-selected pickset or it contains more than one entity

Module

(std-require 'STDINPUT)

Defined in STDINPUT