hm_getentities_dirty

Returns a list of dirty entities for an entity type.

Syntax

hm_getentities_dirty entity_type dirtiness_aspect

Type

HyperMesh Tcl Query Command

Description

An automatic mechanism marks includes/modules dirty (modified) when they or entities belonging to them are changed. They get “cleaned” when exported (for includes) or saved as representations (for modules).

This query returns a list of IDs of the specified entity type which are considered dirty for a specific aspect (currently only “dirty_for_export”).

Inputs

entity_type: Currently, only includes and modules are valid entity types.
dirtiness_aspect: Must always be “dirty_for_export”. Parameter exists to support other aspects in the future.

Examples

Returns a list of dirty modules:

set list_modified [hm_getentities_dirty modules dirty_for_export]

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {hm_getentities_dirty modules dirty_export} ] } {
   # Handle error
}

Version History

2021.2