hm_comparegettransformationmatchentities

Returns the entity IDs associated with a specific transformation and match.

Syntax

hm_comparegettransformationmatchentities transformation_index match_index match_location

Type

HyperMesh Tcl Query

Description

Returns the entity IDs associated with a specific transformation and match. This must be preceded by a call to a relevant hm_compareentities* command.

Inputs

transformation_index: The index of the transformation to query, starting with 0. The number of transformations can be found using hm_comparegettransformationcount.
match_index: The index of the match corresponding to the transformation_index to query, starting with 0. The number of matches can be found using hm_comparegettransformationmatchcount.
match_location: The location of the match to query. Valid values are:; 1 - Source entities; 2 - Target entities

Example

To find the source entity IDs for transformation 0 and match 5 for the recursive comparison of surfs 1-20 and 101-120:

*createmark surfs 1 1-20
*createmark surfs 2 101-120
hm_compareinit
hm_compareentitiesrecursive surfs 1 surfs 2 0.1 2 0
set source_entities [hm_comparegettransformationmatchentities 0 5 1]
hm_compareend

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