*modent_clonebymark

Creates instances of existing modular entities.

Syntax

*modent_clonebymark modular_entity_type input_mark_id output_mark_id ?copy_contents=<value>? ?delta_matrix=<value>?

Type

HyperMesh Tcl Modify Command

Description

Creates instances of existing modular entities, that is, it adds a new instance on their prototypes and realizes the newly created occurrences.

Before cloning a subsystem its representation must be saved.

Inputs

modular_entity_type
The type of modular entity to be cloned. Currently only supported for subsystems.
input_mark_id
The ID of the mark containing the entities to be cloned. Valid values are 1 and 2.
output_mark_id
The ID of the mark containing the entities that have been cloned as a result. Valid values are 1 and 2.
copy_contents=<value>
0 – Do not clone contents on the cloned modular entity.
1 – Clone contents on the cloned modular entity. (default)
delta_matrix=<value>
The transformation to apply to the cloned modular entity in respect to its cloned initial position.

Examples

To clone subsystems ID 2 and 3 (inside input mark ID 1) by copying their contents, translating them by 100 points in x axis and get the cloned subsystems in output mark ID 2:
*createmark subsystems 1 2 3 
*modent_clonebymark subsystems 1 2 copy_contents=1 delta_matrix={1 0 0 0 0 1 0 0 0 0 1 0 100 0 0 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

2023