*CE_MarkUpdateLink

Allows search and replace of an existing link in the specified connector mark with a new link entity.

Syntax

*CE_MarkUpdateLink mark_id search_type search_id search_name ?search_rule? ?replace_type? ?replace_id? ?replace_name? ?replace_rule? ?replace_state? ?keep_current_state? ?search_uid? ?replace_uid?

Type

HyperMesh Tcl Modify

Description

Allows search and replace of an existing link in the specified connector mark with a new link entity.

Inputs

mark_id
Mark of connectors.
search_type
The entity type to search in the connector. This must be specified. The supported entities are comps, props, assems, surfs, tags, elems, nodes and parts.
search_id
The link entity ID to replace in the connector. The ID is optional only if one of the following is true:
3 - Use name
4 - Proximity
5 - Use UID
search_name
The name of the link entity to replace in the connector. The name is optional only if one of the following is true:
1 - None
2 - Use ID
4 - Proximity
5 - Use UID
?search_rule?
The rule by which the link entity was added to the connector. The following codes define the different rules:
0 - Undefined
1 - None
2 - Use ID
3 - Use name
4 - Proximity
5 - Use UID
If the rule is specified, the entity search is performed in accordance with the rule. For example, a search_rule of 2 requires search_id.
?replace_type?
The type of entity that replaces the found link entity (search_type) in the connector. If not specified, the entity type information is not replaced for the found link (replace_type = search_type). The supported types are the same as that for search_type.
?replace_id?
The entity ID that replaces the found link entity. If not specified, the entity ID information is not replaced for the found link (replace_id = search_id).
?replace_name?
The entity Name that replaces the found link entity. If not specified, the entity name information is not replaced for the found link (replace_name = search_name).
?replace_rule?
The rule to set for the found link entity. All the rules supported for search_rule parameters are supported.
?replace_state?
The flag to set for the link entity that specifies if you are connecting to mesh or to geometry. The supported values are:
0 - Undefined
1 - Connect to mesh
2 - Connect to geometry
?keep_current_state?
Optional option to keep the current connector state after the update operation. Valid states are:
0 - Unrealize if needed (default)
1 - Keep current state
At most, one of the "replace" data must be specified to see a change in the link attributes. If the replace data exactly matches the search data, the connector is not unrealized and no change is made to the link entity.
?search_uid?
The UID of the link entity to replace in the connector. The UID is optional, only if search_rule is 1, 2, 3 or 4.
?replace_uid?
The entity UID that replaces the found link entity. If not specified, the entity UID information is not replaced for the found link (replace_uid = search_uid).

Examples

To replace component ID 10 with component ID 20 for displayed connectors:
*createmyark connectors 1 "displayed"
*CE_MarkUpdateLink 1 comps 10 "" 0 0 20 "" 0 0
To replace component name "comp1" with component name "bumper" for displayed connectors:
*createmaryk connectors 1 "displayed"
*CE_MarkUpdateLink 1 comps 0 "comp1" 0 0 0 "bumper" 0 0
To replace use ID with use name rule for component ID 10 for displayed connectors:
*createmark connectors 1 "displayed"
*CE_MarkUpdateLink 1 comps 10 "" 2 0 0 "" 3 0
To replace the state for component ID 10 for displayed connectors from "connect to elems" to "connect to geom":
*createmark connectors 1 "displayed"
*CE_MarkUpdateLink 1 comps 10 "" 0 0 0 "" 0 2

Note that in all of the above cases, the connector entity is unrealized and any existing welds are removed from the connector. At most, one of the "replace" data must be specified to see a change in the link attributes. If the replace data exactly matches the search data, the connector is not unrealized and no change is made to the link entity.

Version History

2017.2 – Added new optional arguments keep_current_state, search_uid and replace_uid.