hm_getunusedoremptyentities
Returns empty or unused entities.
Syntax
hm_getunusedoremptyentities mode=<mode> outputmark=<mark_id> <select_type>=<selection> ?type=<entity_type>?
Type
HyperMesh Tcl Query Command
Description
Returns empty or unused entities, and places them on a mark. The return value is a list of lists. Each sub-list contains the empty or unused entity type as its first value, and the found entity IDs as the remainder of the sub-list. For example:
{sets 1 2} {comps 3} {mats 3 4}
Inputs
- mode=<mode>
- The query mode. Valid values are empty and unused.
- outputmark=<mark_id>
- The ID of the mark to use for the output entities.
- <select_type>=<selection>
- The entity or entities that are to be queried. There are several ways to provide the
entities to be queried. Only one option can be used at a time:
- id=<id>
- The ID of the single entity to query.
- name=<name>
- The name of the single entity to query.
- mark=<mark_id>
- The ID of the mark containing the entities to query. If specified, this must be different from outputmark.
- type=<entity_type>
- The type of entity to query. If not specified, all entities in the database are queried.
Examples
To get the empty sets out of sets ids 1 2 3:
*createmark sets 1 1 2 3
hm_getunusedoremptyentities mode=empty type=sets inputmark=1 outputmark=2
To query all unused entities in database:
hm_getunusedoremptyentities mode=unused outputmark=2
Errors
if { [ catch {command_name...} ] } {
# Handle error
}
Version History
14.0