roll:delete-inactive-states
List of: Scheme Extensions
Subjects: History and Roll
Contents: Scheme Support

Action: Deletes all delta states after the current one.

Filename: scm/scmext/roll_scm.cxx

Syntax: (roll:delete-inactive-states [history])

Arg Types: history history

Returns: integer

Description: This extension deletes all delta states not in the active path to free memory used to maintain those states in ACIS (but not the operating system). After calling this extension, it is no longer possible to roll to any of the deleted states. The active path is the set of delta states from the root to the currently active state.


The optional part or entity is used to find the history stream to prune. The default is the stream associated with the active part.


This extension returns the number of deleted states.

Example: ; roll:delete-inactive-states

; Create a solid sphere.

(define sphere1 (solid:sphere (position 0 0 0) 10))

;; sphere1

; Delete inactive delta states.

(roll:delete-inactive-states)

;; 0
PDF/SCM/04SC.PDF
HTM/DATA/SCM/SCM/04SC/0118.HTM