::hwat::utils::GetMarkedEntity
This function clears the mark, creates a mark on the desired entities, and returns the entities on the mark.
Syntax
::hwat::utils::GetMarkedEntity entityType mark args
Arguments
- entityType
- The type of the entity.
- mark
- The ID of the mark.
- args
- The arguments after the mark argument in the *createmark command.
Returns
- Success
- A Tcl list containing the IDs of the entities, 0 if no entity is found.
- Failure
- {}
Example
::hwat::utils::GetMarkedEntity "components" 1 "by sets" Vehicle
Comments
If any one of the arguments is a list in Tcl, like
[list 1 2 3]
or
{1 2 3}
, or a variable which is a list, use
eval before the
::hwat::utils::GetMarkedEntity command. Also, in these cases,
while using options such as by assems or on plane,
pass them as \"by assems\"
or \"on plane\"
respectively. For example: set a {1 2 3}
eval ::hwat::utils::GetMarkedEntity comps 1 \"by assems\" $a
However, if the values 1, 2 and 3 are not in a list:
::hwat::utils::GetMarkedEntity comps 1 "by assems" 1 2 3