hm_highlightentity

Control the highlighting of a single entity collector.

Syntax

hm_highlightentity entity_type collector_id highlight

Type

HyperMesh Tcl Query

Description

This command is used for changing the highlighting of a single entity, and requires use of *createentitypanel to select that entity.

Inputs

entity_type
The type of entity to control the highlighting for.
collector_id
The ID of the single entity collector. Usually set to 0.
highlight
The state of the highlighting. Valid values are:
  • l, low or lowlight - set to low (gray) highlighting
  • n, norm or normal - set to normal (no) highlighting
  • h, high or highlight - set to high (white) highlighting

Example

To display a single element in a low state:

*createentitypanel elems "Select one element"
hm_highlightentity elems 0 "low"

Errors

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