hm_plotmarker

Creates a graphical marker.

Syntax

hm_plotmarker entity_type <select_type>=<selection> ?dataname=<data name/attribute>? ?inputmarker=<string_array>? ?color=<value >? ?location=<location>? ?display=<value>? ?precision=<value>?

Type

HyperMesh Tcl GUI Command

Description

Creates a graphical marker.

Inputs

entity_type
The type of entity to create markers for. Valid values are nodes, elements, points, lines, surfs and solids.
<select_type>=<selection>
The entity or entities to create markers for.
id=<id>
The ID of the single entity.
list=<list_id>
The ID of the list containing the entities. Valid values are 1 and 2.
mark=<mark_id>
The ID of the mark containing the entities. Valid values are 1 and 2.
dataname=<data name/attribute>
The data name or attribute to create markers for.
If not specified, inputmarker must be used.
inputmarker=<data name/attribute>
The ID of the string array that contains the input strings to create markers for. The string array is created using the *createstringarray command. This should always be set to 1.
If not specified, dataname must be used.
color=<color>
The color to use for the markers. Valid values are 1-64. If not specified, 1 is used.
location=<location>
The location where the marker should be drawn. Valid for entity_type elements and lines only. Valid values are centroid (default), and <nodeindex> (e.g. node1, node 3, etc...).
display=<value>
The default label details.
Values if dataname is specified:
0 - value (default)
1 - data name : value
2 - entity_type : entity_id : data name : value
Values if inputmarker is specified:
0 - value (default)
1 - value
2 - entity_type : entity_id : value
precision=<value>
The precision of double values coming from data names. Valid only if dataname is specified. Valid values are 0-6. Default is 6. Trailing zeros are always removed (e.g. 529.70900 becomes 529.709).

Examples

To create a marker using the ID data name for elements 1-100:

*createmark elems 1 1-100
hm_plotmarker elements mark=1 dataname=id

To create a marker using the ID data name for elements 1-100 using color 20 and the node3 location:

*createmark elems 1 1-100
hm_plotmarker elements mark=1 dataname=id color=20 location=node3

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.1