*CE_FE_RegisterSharedEntities

Registers pre-existing entities to a single connector.

Syntax

*CE_FE_RegisterSharedEntities connector_id entity_type_string_array number_of_strings id_integer_array number_of_integers

Type

HyperMesh Tcl Modify

Description

Registers pre-existing entities to a single connector.

Note that a single entity can be registered with multiple connectors.

Inputs

connector_id
The ID of the connector to register to.
entity_type_string_array
The ID of the string array containing the additional entity types to register. The array is created using the *createstringarray command. This should always be set to 1.
This array should either map one-to-one with id_integer_array or it should have a single index indicating all of the IDs are of the same entity type.
number_of_strings
Integer indicating the size (number of entity types) in the string array created using *createstringarray.
id_integer_array
The ID of the integer array containing the entity IDs to register. The array is created using the *createarray command. This should always be set to 1.
number_of_integers
Integer indicating the size (number of IDs) in the integer array created using *createarray.

Example

Change connector 10 to the user-control mode:

*CE_SetSpecifiedDetailById 10 2 1 0;

Create the necessary arrays to register component 3, property 7, material 8, set 12 and group 14:

*createstringarray 5 "component" "property" "material" "set" "group";
*createarray 5 3 7 8 12 14;

Register the entities with connector 10:

*CE_FE_RegisterSharedEntities 10 1 5 1 5;

Change connector 10 back to normal control mode (optional):

*CE_SetSpecifiedDetailById 10 2 0 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

2017.1