|
|
/*++
Copyright (c) 1996 - 1999 Microsoft Corporation
Module Name:
raster.c
Abstract:
Definitions, structures and constants for unidrv rendering
Environment:
Windows NT Unidrv driver
Revision History:
12/15/96 -alvins- Created
--*/#ifndef _RMRENDER_H_
#define _RMRENDER_H_
/*
* Miscellaneous constants involved in rendering. */
#define BBITS 8 /* Bits per BYTE */
#define WBITS (sizeof( WORD ) * BBITS)
#define WBYTES (sizeof( WORD ))
#define DWBITS (sizeof( DWORD ) * BBITS)
#define DWBYTES (sizeof( DWORD ))
#define COLOUR_MAX 4 /* Maximum number of colours to send to printer */
#define MAX_COMPRESS_MODES 5
/*
* Data compression function prototypes. */
typedef int (* COMPFN)( BYTE *, BYTE *, int );
/*
* The following structures contain the important information used * when rendering the bitmap image to the printer. Data is largely * calculated once for all future references (for this pdev). */
/* Data specific to transpose operations */typedef struct{ void *pvBuf; /* Where the output is placed */ int iSkip; /* Bytes to skip to separte output bytes */ int iHigh; /* Number of input scan lines to transpose */ int iWide; /* Number of pixels in input scan lines */ int cDWL; /* DWORDS per scan line - input */ int cBYL; /* BYTES per scan line - input */ int cBL; /* BITS per scan line */ int iIntlace; /* Interlace factor */ int icbL; /* Bytes to change pointer per line */ DWORD *pdwTransTab; /* Transpose table OR colour separation */} TRANSPOSE;
typedef struct _LEFTRIGHT{ WORD left; WORD right;} LEFTRIGHT, *PLEFTRIGHT;
/* Overall rendering data */typedef struct _RENDER{ int iPassHigh; /* Scan lines processed per print pass */ int iyBase; /* Processing bitmap in multiple passes */ int iyPrtLine; /* Scan line # as printer sees it */ int iyLookAhead; /* How far ahead we have looked - DeskJet */ int iBitsPCol; /* Bits per column per head pass */ WORD iFlags; /* Flag bits - see below for meaning */ WORD fDump; /* Local copy of fDump from Resolution */ int iCursor; /* Resolution.fCursor copy */ int ixOrg; /* Reference point for graphics commands */ int iPosnAdv; /* Scan lines moved after head pass printed */ int iNumScans; /* Number of scan lines to be printed in one block */ int iMaxNumScans; /* How high we can grow our block */ int iHeight; /* Height in pixels of block to be processed*/
int ix; /* Input bitmap x size, pels */ int iy; /* Input bitmap y size, pels */ int iBPP; /* Pel format (#bits per pel) */ int iMaxBytesSend; /* Number of bytes to process in bottom level */
int iSendCmd; /* Command OCD to send with data block */ DWORD dwDevWhiteIndex; // white index for testing leading,trailing
// white space
DWORD *pdwBitMask; /* Bitmask table, built as needed */ DWORD *pdwColrSep; /* Colour separation table */ DWORD *pdwTrailingScans; /* Buffer for dangling scanlines */ BYTE *pStripBlanks;
BYTE *pbColSplit; /* For splitting colour bytes */ BYTE *pbMirrorBuf; /* buffer for mirroring data */
DWORD dwNumCompCmds; // number of different compression modes to run
DWORD dwCompSize; // size of compression buffer
DWORD dwLastCompCmd; // last compression command sent to device
DWORD pdwCompCmds[MAX_COMPRESS_MODES];// table of active compression commands
PBYTE pCompBufs[MAX_COMPRESS_MODES]; // pointers to compression buffers
PBYTE pDeltaRowBuffer; // previous scan line buffer for delta row compression
int iColOff[ COLOUR_MAX ]; /* Address shifting in sepn buffer */
void (*vTransFn)( BYTE *, struct _RENDER * ); /* Transpose function for multi-pin printers */ void (*vLtoPTransFn)( BYTE *, struct _RENDER * ); /* Landscape to portrait transpose fn */
TRANSPOSE Trans; /* The transpose data */
int (*iXMoveFn)( PDEV *, int, int ); /* X positioning function */ int (*iYMoveFn)( PDEV *, int, int ); /* Y positioning function */
BOOL (*bPassProc)( PDEV *, BYTE *, struct _RENDER * ); /* Color/mono */
BOOL (*bWhiteLine)( DWORD *, struct _RENDER *, int ); /* A white scan line? */ BOOL (*bWhiteBand)( DWORD *, struct _RENDER *, int ); /* A white band? */
BOOL bInverted; /* have the bits been inverted yet */ PLEFTRIGHT plrWhite; /* list of left/right pairs for each row */ PLEFTRIGHT plrCurrent; /* left/right pair for current row */ DWORD clr; /* count of left/right scans */ BYTE ubFillWhite; // This value is used to initialize buffers
PRINTERTYPE PrinterType; // type of printer, SERIAL,PAGE,TTY
} RENDER;
/* Make access to transpose data easier */#define pvTransBuf Trans.pvBuf
#define iTransSkip Trans.iSkip
#define iTransHigh Trans.iHigh
#define iTransWide Trans.iWide
#define cDWLine Trans.cDWL
#define cBYLine Trans.cBYL
#define cBLine Trans.cBL
#define iInterlace Trans.iIntlace
#define cbTLine Trans.icbL
/*
* Bits in iFlags above: */
#define RD_GRAPHICS 0x0001 /* Printer is in graphics mode */
#define RD_RESET_DRC 0x0002 /* Need to reset DRC buffer */
#define RD_UNIDIR 0x0004 /* Printer in unidirectional mode */
#define RD_ALL_COLOUR 0x0008 /* Set if ALL colour bands must be sent */
/********************************
* Function prototypes ********************************/
/*
* Initialisation functions. */
BOOL bSkipInit( PDEV * );BOOL bInitTrans( PDEV * );
/*
* Functions to initialise the RENDER structure, and clean it up when done. */
BOOL bRenderInit( PDEV *, SIZEL, int );void vRenderFree( PDEV * );
/*
* Functions to call at the start and finish of each page. */
BOOL bRenderStartPage( PDEV * );BOOL bRenderPageEnd( PDEV * );
/*
* The top level rendering function. */
BOOL bRender( SURFOBJ *, PDEV *, RENDER *, SIZEL, DWORD * );
/*
* Bitmap edge finding function. There are versions for each flavour * of bitmap we support. There is also the one for we always send all * the scan lines. */
BOOL bIsBandWhite( DWORD *, RENDER *, int );BOOL bIsLineWhite( DWORD *, RENDER *, int );BOOL bIsNegatedLineWhite( DWORD *, RENDER *, int );
BOOL bIsRGBBandWhite( DWORD *, RENDER *, int );BOOL bIsRGBLineWhite( DWORD *, RENDER *, int );
BOOL bIs8BPPBandWhite( DWORD *, RENDER *, int );BOOL bIs8BPPLineWhite( DWORD *, RENDER *, int );
BOOL bIs24BPPBandWhite( DWORD *, RENDER *, int );BOOL bIs24BPPLineWhite( DWORD *, RENDER *, int );
BOOL bIsNeverWhite( DWORD *, RENDER *, int );
int iStripBlanks( BYTE *, BYTE *, int, int, int,int);/*
* Functions associated with finding rules in the bitmap. This * is really helpful for LaserJet style printers. */
void vRuleInit( PDEV *, RENDER * );void vRuleFree( PDEV * );BOOL bRuleProc( PDEV *, RENDER *, DWORD * );void vRuleEndPage( PDEV * );
/*
* Functions related to transposing the bitmap from one format to * another. These are for protrait/landscape conversion, or for * turning the output data into the order required for dot matrix * style printers, where the data is in column order. */
/* Special case: 8 x 8 transpose for dot matrix printers */void vTrans8x8( BYTE *, RENDER * );
/* The more general case */void vTrans8N( BYTE *, RENDER * );
/* Transpose for 4 bits per pel colour bitmap */void vTrans8N4BPP( BYTE *, RENDER * );
/* Transpose for 8 bits per pel colour bitmap */void vTrans8BPP( BYTE *, RENDER * );
/* Transpose for 24 bits per pel colour bitmap */void vTrans24BPP( BYTE *, RENDER * );
/* Colour separation for single pin colour printers (e.g. PaintJet) */void vTransColSep( BYTE *, RENDER * );
void vInvertBits(DWORD *, int);
/* Output 24 bit data */BOOL b24BitOnePassOut( PDEV *, BYTE *, RENDER *);
void SelectColor( PDEV *, int );
int iLineOut( PDEV *,RENDER *, BYTE *, int, int );
#endif // !_RMRENDER_H_
|
