*showentitybymark
Turns on the display of a mark of entities.
Syntax
*showentitybymark mark_id string_array number_of_strings
Type
HyperMesh Tcl Modify
Description
Turns on the display of a mark of entities.
Inputs
- mark_id
- The mark ID 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 you 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 show geometry and elements for components 1-3, and all referenced
entities:
*createmark comps 1 1-3
*showentitybymark 1
or
*createmark comps 1 1-3
*createstringarray 1 refflag_7
*showentitybymark 1 1 1
To show 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
*showentitybymark 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
11.0.130