*CE_UpdateLink
Allows search and replace of an existing link in the specified connector with a new link entity.
Syntax
*CE_UpdateLink id search_type search_id search_name search_rule replace_type replace_id replace_name replace_rule replace_state
Type
HyperMesh Tcl Modify
Description
Allows search and replace of an existing link in the specified connector with a new link entity.
Inputs
- id
- The connector ID to update.
- 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:
- search_rule = 3 (use-name)
- search_rule = 4 (proximity)
- 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:
- search_rule = 1 (none)
- search_rule = 2 (use-id)
- search_rule = 4 (proximity)
- search_rule (optional)
- The rule by which the link entity was added to the connector. The following codes
define the different rules:
- search_rule = 0 (undefined rule)
- search_rule = 1 (none rule)
- search_rule = 2 (use-id rule)
- search_rule = 3 (use-name rule)
- search_rule = 4 (proximity rule)
- replace_type (optional)
- The entity type 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 (optional)
- 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 (optional)
- 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 (optional)
- The rule to set for the found link entity. All the rules supported for search_rule parameters are supported.
- replace_state
- Sets 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
Examples
To replace component ID 10 with component ID 20 for connector ID
1:
*CE_UpdateLink 1 comps 10 "" 0 0 20 "" 0 0
To replace component name "comp1" with component name "bumper" for connector ID
1:
*CE_UpdateLink 1 comps 0 "comp1" 0 0 0 "bumper" 0 0
To replace use-id with use-name rule for component ID 10 for connector ID
1:
*CE_UpdateLink 1 comps 10 "" 2 0 0 "" 3 0
To replace the state for component ID 10 in connector ID 1 from "connect to elems" to
"connect to geom":
*CE_UpdateLink 1 comps 10 "" 0 0 0 "" 0 2
Note: In all 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 match the search data, the
connector is not unrealized and no change is made to the link entity.