paint.h

#ifndef __PAINT_H__
#define __PAINT_H__
/*=============================================================================   
     Module  : paint.h
     Purpose : Define routine for painting the client area( i.e. workspace ) 
               of the main window.
     Author  : Doug Ehlenberger, CNIC Mt. Sinai School of Medicine
               
==============================================================================*/
#include "viasgui.h"
#include "imagerw.h"
#include "vectori.h"


void ClearFrameCount( void );

unsigned GetFrameCount( void );


typedef enum
   {
   vZOOM_0p078,    // 0.078%  
   vZOOM_0p1,     
   vZOOM_0p2,     
   vZOOM_0p3,     
   vZOOM_0p4,     
   vZOOM_0p5,
   vZOOM_0p7,
   vZOOM_1p0,
   vZOOM_1p5,
   vZOOM_2p0,
   vZOOM_3p0,
   vZOOM_4p0,
   vZOOM_5p0,
   vZOOM_6p25,
   vZOOM_8p33,
   vZOOM_12p5,
   vZOOM_16p7,
   vZOOM_25p0,
   vZOOM_33p3,
   vZOOM_50p0,
   vZOOM_66p7,
   vZOOM_100p0,
   vZOOM_200p0,
   vZOOM_300p0,
   vZOOM_400p0,
   vZOOM_500p0,
   vZOOM_600p0,
   vZOOM_700p0,
   vZOOM_800p0,
   vZOOM_1200p0,
   vZOOM_1600p0    // 1600%
   }
   vZOOM_FACTOR;

#define vZOOM_MIN   vZOOM_0p078
#define vZOOM_MAX   vZOOM_1600p0

#define vZOOM_NUM_FACTORS  ( ( vINT )vZOOM_1600p0 + 1 )


/* Get or set what the view is. 
   i.e. which projections are being viewed? */

vVWS_VIEW_TYPE GetPaintingView( vVOID );
vVOID SetPaintingView( vVWS_VIEW_TYPE viewType );


/* For whatever the current view is, get or set the WORKSPACE coordinate 
   of the upper left corner of the client window. NOTE: Due to the zoom 
   factor this may correspond to more than one logical device pixel. 

   Example: # = logical device pixel

   100 %   
   Upper left maps to 1 logical device pixel  ---->#
                                                     
   200 %
   Upper left maps to 4 logical device pixels ---->##
                                                   ##  
*/

vVOID SetPaintingUpperLeft( vCOORD left, vCOORD top );

Vector2i GetPaintingUpperLeft( vVWS_VIEW_TYPE viewType );



vBOOL IsPaintingGridVisible( vVOID );

vVOID SetPaintingGridVisible( vBOOL visible );


int GetPaintingGridStep( void );

void SetPaintingGridStep( int step );


#define GRID_SHOW_LINES   0x001
#define GRID_SHOW_POINTS  0x002


unsigned GetAllPaintingGridFlags( void );

void SetAllPaintingGridFlags( unsigned flags );


void SetPaintingGridFlag( unsigned flag );

void ClearPaintingGridFlag( unsigned flag );

void ClearAllPaintingGridFlags( void );

void TogglePaintingGridFlag( unsigned flag );


typedef enum
   {
   GRID_LINE_DOT,
   GRID_LINE_SOLID
   }
   GRID_LINE_STYLE;

GRID_LINE_STYLE GetPaintingGridLineStyle( void );

void SetPaintingGridLineStyle( const GRID_LINE_STYLE style );


typedef enum
   {
   GRID_POINT_SMALL       = 1,
   GRID_POINT_MEDIUM      = 3,
   GRID_POINT_LARGE       = 5,
   GRID_POINT_EXTRA_LARGE = 7
   }
   GRID_POINT_SIZE;

GRID_POINT_SIZE GetPaintingGridPointSize( void );

void SetPaintingGridPointSize( const GRID_POINT_SIZE size );


COLORREF GetPaintingGridLineColor( void );

void SetPaintingGridLineColor( const COLORREF color );


COLORREF GetPaintingGridPointColor( void );

void SetPaintingGridPointColor( const COLORREF color );



/* For whatever the current view is, translate the upper left corner. */

vVOID TranslatePaintingUpperLeft( Vector2i offset );


/* For whatever the current view is, get/set the zoom factor. */

vZOOM_FACTOR GetPaintingZoomFactor( vVOID );
vVOID SetPaintingZoomFactor( vZOOM_FACTOR zoomFactor );


/* For whatever the current view is, zoom in or out by one factor. 
   Returns false if can't zoom in or out any further. */

vBOOL ZoomInPainting( vVOID );
vBOOL ZoomOutPainting( vVOID );


/* NOTE: The pixel code determines how the RGB color is 
   interpreted. e.g. grayscale pixels. */

COLORREF ConvertPaintingColor( COLORREF color, vPIXEL_CODE_TYPE type );


/* Returns the ORIGINAL color passed to SetPaintingBkgrndColor(),
   NOT the color after being converted. */

COLORREF GetPaintingBkgrndColor( vVOID );

/* NOTE: The pixel code determines how the RGB background color is 
   interpreted. e.g. grayscale pixels. */

vVOID SetPaintingBkgrndColor( COLORREF bkgrndColor, vPIXEL_CODE_TYPE type );


/* NOTE: The background color is set to the passed color no matter what
   the pixel code type is. */

vVOID SetPaintingBkgrndColorEx( COLORREF bkgrndColor );


COLORREF GetPaintingBorderColor( vVOID );
vVOID SetPaintingBorderColor( COLORREF borderColor );


/* Coordinate system transformations. ( View dependent!! )

   if( paint view forward )  
      client x-axis = workspace x-axis
      client y-axis = workspace y-axis

   if( paint view side )
      client x-axis = workspace z-axis
      client y-axis = workspace y-axis

   if( paint view top )
      client x-axis = workspace x-axis
      client y-axis = workspace z-axis, 
      BUT...workspace z-axis decreases as client y-axis increases!!!
*/

Vector2i ClientToWorkspaceCoord( vCOORD x, vCOORD y );
Vector2i WorkspaceToClientCoord( vCOORD x, vCOORD y );

/* Same as above but for rectangles. */

vVOID ClientToWorkspaceRect( RECT *rect );
vVOID WorkspaceToClientRect( RECT *rect );


/* Painting functions. */

vVOID BeginPainting( vVOID ); /* Call on opened or new workspace */
vVOID EndPainting( vVOID );   /* Call on close workspace */


/* Call to get/set/clear/call painting hook procedure. This is a function that
   will be called after painting of any kind occurs. */

typedef vVOID ( *PaintingHookProc )( vVOID );

vVOID SetPaintingHookProc( PaintingHookProc proc );
vVOID ClearPaintingHookProc( vVOID );


vVOID ResizePainting( WPARAM wParam ); /* Use for WM_SIZE */


/* Main drawing function. */
vVOID PaintWorkspace( vVOID );

/* This should be called for fast drawing of workspace.
   ( i.e. stacks haven't changed! ) */
vVOID SwapPaintWorkspace( vVOID );


/* Set title, zoom percentage, etc... */
vVOID PaintMainWindowTitle( vVOID ); 


/* Based on what the current view is, fit the workspace, 
   i.e. adjust upper left and zoom factor so that the workspace is
   centered and fully visible in the client area of the window. */

vVOID FitWorkspaceToScreen( vVOID );


vVOID FitStackToScreen( vHIMAGESTACK hStack );


#endif/* __PAINT_H__ */

---