*CE_AddLinkEntitiesDirectByRule

Allows the user to add link directly to the connectors without considering tolerance or number of layers.

Syntax

*CE_AddLinkEntitiesDirectByRule mark_id link_type link_rule link_state link_string_array link_number_of_strings extra_link_string_array extra_link_number_of_strings create_group

Type

HyperMesh Tcl Modify Command

Description

Allows the user to add link directly to the connectors without considering tolerance or number of layers.

Inputs

mark_id
The ID of the mark of connectors to update. Valid values are 1 and 2.
link_type
The entity type to be added to the connectors as links.
link_rule
The rule by which the link entity is added to the connector. If the rule is specified, the modification is performed in accordance with the rule. For example, a value of 2 requires link IDs to be specified for link_string_array. Valid values are:
0 - Undefined
1 - None
2 - Use ID
3 - Use Name
4 - Proximity
5 - Use UID
link_state
The state of the link entity which is to be added:
0 - Undefined
1 - Elems
2 - Geom
link_string_array
A string array containing the list of link IDs/names/UIDs to be added directly to connectors, created using*createstringarray. This must be set to 1.
The strings are generally IDs/names/UIDs based on the link_rule.
link_number_of_strings
Integer indicating the size (number of strings) in the link_string_array created using *createstringarray.
extra_link_string_array
A string array containing the list of extra link additions allowed for spots and seams, created using*createstringarray. This must be set to 1.
The strings are generally IDs/names/UIDs based on the link_rule.
extra_link_number_of_strings
Integer indicating the size (number of strings) in the extra_link_string_array created using *createstringarray.
create_group
0 - Add the newly chosen links separately to the connector
1 - Add the newly chosen links as a group to the connector

Examples

Add two component links (ID 1 and 2) directly to connector ID 2 of type spot using without creating a group link:

*createmark connector 1 2
*createstringarray 2 1 2
*createarray 2 2 2
*CE_AddLinkEntitiesDirectByRule 1 comps 2 1 1 2 1 2 0

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

2019