*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; 1 - Update the current rep and mapped/loaded rep status of the target occurrences to be same as source
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

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

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2020.1