*CE_AddLinkEntitiesWithDetails

Update connectors at the specified locations with rules and other details.

Syntax

*CE_AddLinkEntitiesWithDetails connector_mark_id entity_type entity_mark_id entity_state ce_rules ce_le_rule tolerance_flag tolerance num_ents string_array number_of_strings

Type

HyperMesh Tcl Modify Command

Description

This command updates connectors at the specified locations with rules and other details.

Inputs

connector_mark_id

The ID of the mark containing the connectors to update. Valid values are 1 and 2.

entity_type

Type of entity to be added to the connectors as links.

entity_mark_id

The ID of the mark containing the entities to use as links. Valid values are 1 and 2.

entity_state

The state of the link entities. Valid values are:

0 - Geometry.

1 - Elements.

ce_rules

Flag indicating when to make the links. Valid values are:

0 - Now.

1 - At realize.

ce_le_rule

Flag indicating how to make the links. Valid values are:

0 - None.

1 - Use ID.

2 - Use name.

tolerance_flag

Flag indicating whether to use the default tolerance. Valid values are:

0 - Use default.

1 - Use specified value.

tolerance

Used to add entities only within the given tolerance from the specified connector.

num_ents

Number of entities to add/update connector (connectors thickness (2T, 3T, etc.) value).

string_array

The ID of the string array that contains the additional input parameters. The string array is created using the *createstringarray command. This should always be set to 1. Valid strings are:

ce_delete_links=1: Delete existing connector links.
ce_spot_extralinknum=1: The number of extra links for spot connectors.
ce_seam_extralinknum=0: The number of extra links for seam connectors.

number_of_strings

Integer indicating the size (number of strings) in the string array created using *createstringarray.

Examples

Update links for spot connector 1 and seam connector 2 by deleting existing links first:

*createmark connectors 1 1 2
*createmark comps 1 21 23 24 27
*createstringarray 3 "ce_delete_links=1" "ce_spot_extralinknum=1" "ce_seam_extralinknum=0"
*CE_AddLinkEntitiesWithDetails 1 comps 1 1 1 0 0 0 2 1 3

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

12.0