*createmarkpanel

Provides a panel to add entities to a mark.

Syntax

*createmarkpanel entity_type mark_id message ?face_edge_mode? ?filter?

Type

HyperMesh Tcl Modify

Description

Provides a panel to add entities to a mark.

Inputs

entity_type
The type of entities to add.
mark_id
The ID of the mark. Valid values are 1 and 2.
message
A string to show in the message bar when entering the panel.
?face_edge_mode?
The default face/edge selection mode to use when entering the panel. This is valid only for nodes and elements. An invalid value defaults to 0, or is ignored for non-supported entity types.
  • 0 – Standard entity selection
  • 1 – 2D faces (elems) or faces (nodes)
  • 2 – 2D faces ext (elems and nodes)
  • 3 – Free edges (nodes only)
  • 4 – Edges (nodes only)
  • 5 – Loops (nodes only)
  • 6 - Free edges ext (nodes only)
  • 7 - Edges ext (nodes only)
?filter?
Defines which selection modes should be allowed. Bit values are used and the value is calculated as (Bit0 + 2*Bit1 + 4*Bit2 + 8*Bit3 + 16*Bit4 + 32*Bit5 + 64*Bit6 + 128*Bit7).
A value of 0 (default) means all selection modes are available.
For nodes, if the sum does not include Bit0 set to 1, although nodes are collected, what is highlighted are the faces/edges. Proceed from the panel, and the corresponding nodes will be highlighted.
Bit0:
0 – Do not allow standard selection (elems and nodes)
1 – Allow standard selection (elems and nodes).
Bit1:
0 – Do not allow 2D faces (elems) or faces (nodes)
1 – Allow 2D faces (elems) or faces (nodes)
Bit2:
0 – Do not allow 2D faces ext (elems and nodes)
1 – Allow 2D faces ext (elems and nodes)
Bit3:
0 – Do not allow free edges (nodes only)
1 – Allow free edges (nodes only)
Bit4:
0 – Do not allow edges (nodes only)
1 – Allow edges (nodes only)
Bit5:
0 – Do not allow loops (nodes only)
1 – Allow loops (nodes only)
Bit6:
0 – Do not allow free edges ext (nodes only)
1 – Allow free edges ext (nodes only)
Bit7:
0 – Do not allow edge ext (nodes only)
1 – Allow edge ext (nodes only)

Examples

To create a mark of elements in a panel:
*createmarkpanel elems 1 "Please select the elements"
hm_getmark elems 1
To create a mark of elements in a panel using 2D faces as the default selection mode:
*createmarkpanel elems 1 "Please select the elements" 1
hm_getmark elems 1
To create a mark of elements in a panel using 2D faces as the default selection mode, only allowing 2D faces and 2D faces ext modes:
*createmarkpanel elems 1 "Please select the elements" 1 6
hm_getmark elems 1

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

2019 – Added new face_edge_mode values 6 and 7.