*ME_ModuleOccurrencesSyncContents
Synchronize the contents of one module occurrence to the specified target occurrences that shares a common module prototype.
Syntax
*ME_ModuleOccurrencesSyncContents source_id target_ids ?options?
Type
HyperMesh Tcl Modify Command
Description
Synchronize the contents of one module occurrence to the specified target occurrences that shares a common module prototype.
Every module occurrence has an associated module prototype. A single module prototype may provide the base definition for multiple module occurrences, i.e. a prototype of a wheel, might have four occurrences in a vehicle. This command is applied to synchronize a single occurrence with one or more additional instanced occurrences of a common prototype, i.e. one wheel updating the 3 other wheels of a vehicle. It will clear any current contents of the target occurrences and copy/synchronize the contents of the source occurrence into the targets.
Inputs
- source_id
- The ID of the source module which provides the content to be synchronized.
- target_ids
- The IDs of the target modules to receive the synchronized content, within quotes if more than 1. Specifying a single value of 0 is a shortcut to target all other instanced occurrences that share a common prototype withsource_id.
- ?options?
- List of input options, passed as a comma separated string enclosed in quotes. Valid
options are:
- copy_partrep_status=<value>
- 0 - Do not update the current rep and mapped/loaded rep status of the target occurrences
- excluded_entity_types=<type1> ?<type2>? ... ?<typeN>?
- A space separated list of module entity types to not synchronize.
Examples
Synchronize the contents of module 22 to all other instanced occurrences that share a common module prototype with no additional options:
*ME_ ModuleOccurrencesSyncContents 22 0
Synchronize the contents of module 22 to specified target occurrences 24, 26 and 28. Ignore copying/synchronizing properties and materials (to avoid duplicates) and update the target occurrences’ rep statuses:
*ME_ ModuleOccurrencesSyncContents 22 "24 26 28" "copy_partrep_status=1, excluded_entity_types=props mats"
Errors
if { [ catch {command_name...} ] } {
# Handle error
}
Version History
2020.1