*isolateentitybymark

Turns on the display of a mark of entities and turns off the display of all others of the same type.

Syntax

*isolateentitybymark mark_id string_array number_of_strings

Type

HyperMesh Tcl Modify

Description

Turns on the display of a mark of entities and turns off the display of all others of the same type.

Inputs

mark_id
The ID of the mark containing the entities. Valid values are 1 and 2. All entities with a display state on the specified mark, regardless of entity type, are considered.
string_array
The ID of the string array that contains the additional input parameters. The string array is created using the *createstringarray command. This should always be set to 1.
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray. The valid strings are:
elements_off - This indicates that elements in the specified collectors should not be considered. If not provided, the default is to consider elements in the specified collectors.
geometry_off - This indicates that geometry in the specified collectors should not be considered. If not provided, the default is to consider geometry in the specified collectors.
showcomps - This indicates that components in which elements/geometry are referred will also be shown when we show elements/geometry. If not provided, only specified elements/geometry are shown.
refflag_# - A flag that indicates the referenced entities to also show when showing an entity. # is a value from 1-7 and is defined as below. If not provided, the default is 7.
  • 1 - Show all referenced collected entities
  • 2 - Show all referenced data name entities
  • 3 - Show all referenced collected and data name entities
  • 4 - Show all referenced attribute entities
  • 5 - Show all referenced attribute and collected entities
  • 6 - Show all referenced attribute and data name entities
  • 7 - Show all referenced attribute, data name and collected entities

Examples

To isolate geometry and elements for components 1-3, and all referenced entities:

*createmark comps 1 1-3
*isolateentitybymark 1

or

*createmark comps 1 1-3
*createstringarray 1 refflag_7
*isolateentitybymark 1 1 1

To isolate all comps and load collectors, considering only elements and collected entities:

*createmark comps 1 all
*createmark loadcols 1 all
*createstringarray 2 geometry_off refflag_1
*isolateentitybymark 1 1 2

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

12.0.110