/******************************Module*Header*******************************\
* Module Name: lines.h
*
* Line drawing constants and structures.
*
* NOTE: This file mirrors LINES.INC. Changes here must be reflected in
* the .inc file!
*
* Copyright (c) 1992-1994 Microsoft Corporation
\**************************************************************************/
typedef struct _PDEV PDEV; // Handy forward declaration
//
// These constants are used for the W32p line drawing algorithm
//
// method 1
#define NO_X_FLIP 0
#define NO_Y_FLIP 0
#define X_FLIP 1
#define Y_FLIP 1
#define X_MAJOR 1
#define Y_MAJOR 0
// method 2
#define LINE_DRAW 0x80
#define LINE_USE_ERROR_TERM 0x20
#define LINE_X_NEG 0x01
#define LINE_Y_NEG 0x12
#define LINE_X_MAJOR 0x04
// We have to be careful that we don't overflow any registers when using
// the hardware to draw lines (as opposed to going through the strips
// routines, which will never overflow). We accomplish this by simply
// checking the bounds of the path; if it is so large that any of the
// hardware terms may overflow, we punt the entire path to the strips
// code (should be pretty rare).
#define MAX_INTEGER_BOUND (1535) // W32's line length term is limited to
#define MIN_INTEGER_BOUND (-512) // a maximum value of 2047
// We have special strip routines when all strips have at most this many
// pixels:
#define MAX_SHORT_STROKE_LENGTH 15
// # of strip drawers in every group:
#define NUM_STRIP_DRAW_DIRECTIONS 4
// # of strip drawers for doing either solid lines or styled lines:
#define NUM_STRIP_DRAW_STYLES 8
typedef LONG STYLEPOS;
#define STYLE_MAX_COUNT 16
#define STYLE_MAX_VALUE 0x3fffL
#define RUN_MAX 20
#define STRIP_MAX 100
#define STYLE_DENSITY 3
// Flip and round flags:
#define FL_H_ROUND_DOWN 0x00000080L // .... .... 1... ....
#define FL_V_ROUND_DOWN 0x00008000L // 1... .... .... ....
#define FL_FLIP_D 0x00000005L // .... .... .... .1.1
#define FL_FLIP_V 0x00000008L // .... .... .... 1...
#define FL_FLIP_SLOPE_ONE 0x00000010L // .... .... ...1 ....
#define FL_FLIP_HALF 0x00000002L // .... .... .... ..1.
#define FL_FLIP_H 0x00000200L // .... ..1. .... ....
#define FL_ROUND_MASK 0x0000001CL // .... .... ...1 11..
#define FL_ROUND_SHIFT 2
#define FL_RECTLCLIP_MASK 0x0000000CL // .... .... .... 11..
#define FL_RECTLCLIP_SHIFT 2
#define FL_STRIP_MASK 0x00000003L // .... .... .... ..11
#define FL_STRIP_SHIFT 0
#define FL_SIMPLE_CLIP 0x00000020 // .... .... ..1. ....
#define FL_COMPLEX_CLIP 0x00000040 // .... .... .1.. ....
#define FL_CLIP (FL_SIMPLE_CLIP | FL_COMPLEX_CLIP)
#define FL_STYLED 0x00000400L // .... .1.. .... ....
#define FL_ALTERNATESTYLED 0x00001000L // ...1 .... .... ....
#define FL_STYLE_MASK 0x00000400L
#define FL_STYLE_SHIFT 10
#define FL_LAST_PEL_INCLUSIVE 0x00002000L // ..1. .... .... ....
// Miscellaneous DDA defines:
#define LROUND(x, flRoundDown) (((x) + F/2 - ((flRoundDown) > 0)) >> 4)
#define F 16
#define FLOG2 4
#define LFLOOR(x) ((x) >> 4)
#define FXFRAC(x) ((x) & (F - 1))
////////////////////////////////////////////////////////////////////////////
// NOTE: The following structures must exactly match those declared in
// lines.inc!
typedef struct _STRIP {
LONG cStrips; // # of strips in array
LONG flFlips; // Indicates if line goes up or down
POINTL ptlStart; // first point
LONG alStrips[STRIP_MAX]; // Array of strips
} STRIP;
typedef struct _LINESTATE {
STYLEPOS* pspStart; // Pointer to start of style array
STYLEPOS* pspEnd; // Pointer to end of style array
STYLEPOS* psp; // Pointer to current style entry
STYLEPOS spRemaining; // To go in current style
STYLEPOS spTotal; // Sum of style array
STYLEPOS spTotal2; // Twice sum of style array
STYLEPOS spNext; // Style state at start of next line
STYLEPOS spComplex; // Style state at start of complex clip line
STYLEPOS* aspRtoL; // Style array in right-to-left order
STYLEPOS* aspLtoR; // Style array in left-to-right order
ULONG ulStyleMask; // Are we working on a gap in the style?
// 0xff if yes, 0x0 if not
ULONG xyDensity; // Density of style
ULONG cStyle; // Size of style array
ULONG ulStyleMaskLtoR;// Original style mask, left-to-right order
ULONG ulStyleMaskRtoL;// Original style mask, right-to-left order
BOOL ulStartMask; // Determines if first element in style
// array is for a gap or a dash
} LINESTATE; /* ls */
// Strip drawer prototype:
typedef VOID (*PFNSTRIP)(PDEV*, STRIP*, LINESTATE*);
extern PFNSTRIP gapfnStripP[];
// Strip drawers:
VOID vssSolidHorizontal(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vssSolidVertical(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vssSolidDiagonalHorizontal(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vssSolidDiagonalVertical(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vrlSolidHorizontal(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vrlSolidVertical(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vrlSolidDiagonalHorizontal(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vrlSolidDiagonalVertical(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vStripStyledHorizontal(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vStripStyledVertical(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vrlSolidHorizontalP(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vrlSolidVerticalP(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vrlSolidDiagonalHorizontalP(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vrlSolidDiagonalVerticalP(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vStripStyledHorizontalP(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
VOID vStripStyledVerticalP(PDEV* ppdev, STRIP *pStrip, LINESTATE *pLineState);
// External calls:
BOOL bLines(PDEV*, POINTFIX*, POINTFIX*, RUN* prun, ULONG,
LINESTATE*, RECTL*, PFNSTRIP apfn[], FLONG);
//
// axis must be a constant
//
#define SETUP_DRAW_LINE(pjBase,dx,dy,axis,cBpp) \
{ \
WAIT_FOR_EMPTY_ACL_QUEUE(ppdev, pjBase); \
\
if (axis == 1) \
{ \
/* X major */ \
CP_XCNT(ppdev, pjBase, ((dx - 1) * cBpp)); \
CP_YCNT(ppdev, pjBase, 0xfff); \
CP_DELTA_MINOR(ppdev, pjBase, dy); \
CP_DELTA_MAJOR(ppdev, pjBase, dx); \
} \
else /*if (axis == 0)*/ \
{ \
/* Y major */ \
CP_XCNT(ppdev, pjBase, 0xfff); \
CP_YCNT(ppdev, pjBase, (dy - 1)); \
CP_DELTA_MINOR(ppdev, pjBase, dx); \
CP_DELTA_MAJOR(ppdev, pjBase, dy); \
} \
}