(initget [flags] [keywords])
The initget function initializes keywords and/or input-filters (valid data ranges). It determines keywords for the next user input requested by an application's function, including get***, or entsel, nentsel, and nentselp.
The initialization is only valid for the next function and afterwards becomes invalid.
flags
Control flag for input evaluation. This argument controls the behavior of the single input functions.
The control bits have the following meaning:
| Control Bit | Integer Value | Meaning |
|---|---|---|
| 0 | 1 | A Return or null input is rejected. |
| 1 | 2 | A numerical value of zero is rejected. |
| 2 | 4 | A negative numerical value is rejected. |
| 3 / 4 / 5 | — | Not used. |
| 6 | 64 | The Z coordinate of a 3D point value is ignored. |
| 7 | 128 | Allow arbitrary input whatever the user enters. |
| 8 | 256 | Displays keyword(s) in the Options Bar of the desktop. When the user clicks one of the option buttons, the corresponding keyword is returned by the get*** function. |
keywords
The optional argument keywords can contain a list of pre-defined keywords valid for the next execution of a user-input function. The keywords are supplied as a string separated by one (or more) spaces. The following table shows which control bit is applicable for each function requesting user input:
| Function | No null input |
No zero |
No negative |
No 3D coord. |
Arbitrary input |
Keyword |
|---|---|---|---|---|---|---|
| Control bit | 1 |
2 |
3 |
6 |
7 |
8 |
| Bit value | 0 |
2 |
4 |
64 |
128 |
256 |
| getangle | x |
x |
x |
x |
||
| getcorner | x |
x |
x |
|||
| getdist | x |
x |
x |
x |
x |
x |
| getint | x |
x |
x |
x |
x |
|
| getkword | x |
x |
x |
|||
| getorient | x |
x |
x |
x |
||
| getpoint | x |
x |
x |
|||
| getreal | x |
x |
x |
x |
x |
|
| getstring | x |
|||||
| entsel | x |
|||||
| nentsel | x |
|||||
| nentselp | x |