|
The macros
API_BEGIN and
API_END
|
|
|
The macros
API_NOP_BEGIN and
API_NOP_END begin and end every
ACIS API that does not change the model. They provide a way to use the bulletin mechanism to make changes to an
ENTITY, then throw away the changes when done. This is useful when you want to evaluate the model without changing it. Changes are allowed to happen as part of the operation, but they are then undone by
API_NOP_END.
|
|
|
API_NOP_BEGIN creates a stacked bulletin board. The stacked bulletin board is logically nested inside an already existing bulletin board, if one exists. Nesting of the associated macros must be strictly maintained.
|
|
|
Because
API_NOP_BEGIN and
API_NOP_END make use of the bulletin facilities, the effect is lost if bulletin board logging is turned off. Therefore, bulletin board logging is temporarily turned on in
API_NOP_BEGIN and reset in
API_NOP_END.
|
|
|
API_NOP_BEGIN creates a new bulletin board but does not roll back any failed previous bulletin boards. This ensures that the bulletin board is in the same state after the
NOP macros as it was before.
API_NOP_END rolls over the bulletin board opened by
API_NOP_BEGIN. The bulletin pointers of the entities in the previous bulletin are restored to their original state, leaving the bulletin board in the state it was before the
API_NOP_BEGIN macro.
|