editor.h

#ifndef __EDITOR_H__
#define __EDITOR_H__
/*=============================================================================   
   Module  : editor.h 
   Purpose : Define functions for "undoing" and "redoing" certain workspace 
             operations.
   Author  : Doug Ehlenberger, CNIC Mt. Sinai School of Medicine
             
=============================================================================*/
#include "configure.h"
#include "workspace.h"


typedef enum
   {
   vNO_OPER,
   vOPER_STACK_TRANSLATION,
   vOPER_STACK_CROPPING,
   vOPER_STACK_REMOVAL,
   vOPER_STACK_ADDITIONS
   }
   vOPER_TYPE;


#define vMAX_EDITABLE_STACKS  512


/* Function pointers which if not set to NULL, will be called on an undo or
   a redo. NOTE: These must be explicitly set for a paticular operation every
   time the operation begins. */

typedef vVOID ( *UndoHookProc )( vVOID );
typedef vVOID ( *RedoHookProc )( vVOID );


typedef struct tagEditor
   {
   Workspace    *workspace;
   vOPER_TYPE    operType;
   vSIZE         operCount;
   vHIMAGESTACK  imageStacks[ vMAX_EDITABLE_STACKS ];
   vSIZE         numStacks;
   vHIMAGESTACK  deletedStacks[ vMAX_EDITABLE_STACKS ];
   vSIZE         numDeletedStacks;
   UndoHookProc  undoHook; 
   RedoHookProc  redoHook;
   }
   Editor;


/* NOTE: Only allowing ONE operation to be undone. */


Editor* GetEditor( vVOID );

vVOID SetEditorUndoHookProc( UndoHookProc proc );
vVOID SetEditorRedoHookProc( RedoHookProc proc );


/* Create an editor when workspace opens. */

vBOOL CreateEditor( Workspace *vws );

/* Clear the editor when workspace saved. This performs any 
   cleanup necessary such as removal of deleted stacks projections.
   NOTE: Last operation CANNOT be undone after saving. */

vVOID ClearEditor( Workspace *vws );

/* Destroy the editor right before workspace closes. This 
   function does not do cleanup like ClearEditor(). Therefore
   is the workspace should be closed without saving, dont call
   ClearEditor() before calling DestroyEditor(). */ 

vVOID DestroyEditor( Workspace *vws );

/* Retrieve the number of operations that have been
   performed on the workspace since the last save. */

vSIZE GetOperationCount( Workspace *vws );

/* Call when a new operation is being performed. 
   NOTE: The effects of the previous operation are 
   permanent after calling. For example if the 
   previous operation was removing stacks, then those
   stacks are permanently deleted upon calling.  */

vVOID SetEditorOperation( Workspace *vws, vOPER_TYPE type );

/* Add stack(s) to the "list" of stacks which are being edited
   in some way. */

vVOID AddStackToEditor( Workspace *vws, vHIMAGESTACK hStack );
vVOID AddSelectedStacksToEditor( Workspace *vws );


vVOID UndoLastEditorOperation( Workspace *vws );
vVOID RedoLastEditorOperation( Workspace *vws );


#endif/* __EDITOR_H__ */

---