*morphshapecreatecolorsystem

Creates a new shape out of the applied morphs specifying the color and coordinate system.

Syntax

*morphshapecreatecolorsystem name option color system_id

Type

HyperMesh Tcl Modify

Description

The specified shape will be created representing the difference between the current node and handle positions and the original node and handle positions.

If a shape is created which references a coordinate system the shape will be applied relative to that coordinate system when it is applied to the model. This can be very useful for circular shapes such as arc angle changes since shapes can be created for them which reference a cylindrical coordinate system and allow for fractional applications of those shapes to be relative to the system. For example, if an arc angle change of 60 degrees is created as a shape referencing a cylindrical system and it is applied with a multiplier of 0.5, the result would be an arc angle change of 30 degrees with the nodes moving along their correct tangential paths. For shapes which reference rectangular coordinate systems their nodes will always move linearly as a factor of the multiplier and thus will not rotate about an axis, even if the shape was originally created using a rotational morphing method.

was originally created using a rotational morphing method. Saving as handle and node perturbations will try to save everything done as handle perturbations except where biasing factors have changed and constraints have been applied. Saving as pure node perturbations will save the shape exclusively as node perturbations. The difference comes into play when new handles are created. If a shape is saved as handles & nodes, a new handle will not move when the shape is applied, possibly changing the shape. If a shape is saved as pure nodes, a new handle will move along with its grid.

Saving as node perturbations without global handle nodes (option 2) will save the shape as node perturbations excluding the node perturbations for global handles.

Inputs

name
The name of the shape.
option
The shape's save options. Valid values are:
  • 0 - Save as handle and node perturbations
  • 1 - Save as pure node perturbations
  • 2 - Save as node perturbations without global handle nodes
color
The shape's color. Valid values are 1-64.
system_id
The ID of the reference system to use.

Example

To create a shape with a specified color and system:

*morphshapecreatecolorsystem "groovy" 0 15 3

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {*morphshapecreatecolorsystem...} ] } {
   # Handle error
}

Version History

11.0