hm_plotshape

Creates a graphical shape.

Syntax

hm_plotshape entity_type <select_type>=<selection> shape=<shape> ?<option1>=<value1>? ?<option2>=<value2>? ... ?<optionN>=<valueN>?

Type

HyperMesh Tcl GUI Command

Description

Creates a graphical shape.

Inputs

entity_type
The type of entity to create shapes for. Valid values are nodes.
<select_type>=<selection>
The entity or entities to create shapes 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.
shape=<shape>
The shape to create. Valid values are box, cone, cylinder, ellipsoid, frustum and sphere.
height=<value>
The height for shape=cone, shape=cylinder and shape=frustum.. Default 1.0.
l1=<value>
The x-component for shape=box. Default 1.0.
l2=<value>
The y-component for shape=box. Default 1.0.
l3=<value>
The z-component for shape=box. Default 1.0.
radius=<value> or r1=<value>
The radius for shape=cone, shape=cylinder and shape=sphere.. The x-component for shape=ellipsoid. The top radius for shape=frustum. Default 3.0.
r2=<value>
The y-component for shape=ellipsoid. The bottom radius for shape=frustum. Default 3.0.
r3=<value>
The z-component for shape=ellipsoid. Default 3.0.
color=<color>
The color to use for the shape. Valid values are 1-64. If not specified, 1 is used.
drawmode=<location>
0 - Wireframe
1 - Line with mesh (default)
2 - Only mesh
transparency=<value>
The transparency of the shape. If not specified, no transparency is used.
system=<id>
The coordinate system to which the shape must be oriented. Default is global system.

Examples

To create a box shape with dimensions 10x15x20 on nodes 1-100:

*createmark nodes 1 1-100
hm_plotshape nodes mark=1 shape=box l1=10 l2=15 l3=20

To create a box shape with dimensions 10x15x20 on nodes 1-100 using color 20 and wireframe:

*createmark nodes 1 1-100
hm_plotshape nodes mark=1 shape=box l1=10 l2=15 l3=20 color=20 drawmode=0

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