NAME

::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

 

RETURNS

A tcl list containing the IDs of the entities, 0 if no entity is found and {} if unsuccessful.

 

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

 

See also

Utils Functions