*startnotehistorystate

Defines the start of a history state.

Syntax

*startnotehistorystate name

Type

HyperMesh Tcl Modify Command

Description

Defines the start of a history state. Must be followed by a call to *endnotehistorystate with the same name value.

This is used to group a set of commands into a single undo/redo operation. All commands that appear within the start/end block must be supported for undo/redo.

Inputs

name: The name of the history state. If the name contains spaces, it must be enclosed in curly braces or quotes.

Example

To execute an element remesh operation on two selections of elements, but consider them as a single history operation:

*startnotehistorystate {Remesh two element selections}
*setedgedensitylinkwithaspectratio 0
*setoption element_order=1
*setusefeatures 3
*createmark elements 1 1-100
*defaultremeshelems 1 1 2 2 1 1 1 1 0 0 0 0 2 30
*createmark elements 1 1-1-200
*defaultremeshelems 1 2 2 2 1 1 1 1 0 0 0 0 2 30
*setusefeatures 0
*endnotehistorystate {Remesh two element selections}

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

14.0