PrintingMaskedRenderRegion Class Reference

This is a simplified version of the MaskedRenderRegion. It does not have to cope with a mix of complex and simple shapes to be rendered, but knows that there will be a run of complex shapes and then all the rest will be simple. More...

#include <pmaskrgn.h>

Inheritance diagram for PrintingMaskedRenderRegion:

List of all members.

Public Member Functions
	PrintingMaskedRenderRegion (DocRect, Matrix, FIXED16, double, BOOL Printing)
	Constructs a PrintingMaskedRenderReigon INT32 dpi changed to double dpi (12/12/95) to improve the range of values allowed at the < 1000dpi settings that we will be using.
	~PrintingMaskedRenderRegion ()
	destructor - the base classes do all the work here
void	SetMaskDrawingMode (BOOL OnOff)
	The render region can either be rendering simple nodes or complex nodes in runs (ie you get a block or complex one, then a block of simple ones). This function allows you to change the render regions idea of whether the nodes are complex or simple.
virtual void	DrawPathToOutputDevice (Path *PathToRender, PathShape shapePath=PATHSHAPE_PATH)
	Renders a path black if we are in a complex run, or white if not.
virtual void	DrawRect (DocRect *RectToRender)
	Renders a path black if we are in a complex run, or white if not.
virtual void	DrawLine (const DocCoord &StartPoint, const DocCoord &EndPoint)
	Renders a path black if we are in a complex run, or white if not.
virtual void	DrawPixel (const DocCoord &Point)
	Renders a path black if we are in a complex run, or white if not.
virtual void	DrawBitmap (const DocCoord &Point, KernelBitmap *pBitmap)
	Renders a path black if we are in a complex run, or white if not.
virtual void	DrawBitmap (const DocCoord &Point, UINT32 BitmapID, UINT32 ToolID=NULL)
	Renders a path black if we are in a complex run, or white if not.
virtual BOOL	DrawTransformedBitmap (NodeBitmap *pNodeBitmap)
	Renders a path black if we are in a complex run, or white if not.
virtual BOOL	RenderChar (WCHAR ch, Matrix *pMatrix)
	Renders a char into the mask sometimes - there are times when we do not want the char to render - eps when we are dealing with postscript, where what we render and what postscript renders may be different.
virtual WinRect	CalculateWinRect (Matrix &RenderMatrix, const DocRect &docrect, const double dpi)
	To convert a rectangle in Doc coordinates to a rectangle in Win coordinates taking account of the destination dpi rather than assuming screen dpi. Virtual so that it can be overriden by different render regions if so required.
virtual GMATRIX	MakeGavinMatrix (Matrix NewRenderMatrix, DocRect ClipRect, double dPixelsPerInch, BOOL bMasterCapture)
	Make a Gavin Matrix out of a Kernel Matrix.
virtual void	SetOffscreen (OffscreenAttrValue *)
	Create a new bitmap into which, the subtree rooted at this attributes parent, will be rendered. Then call base version to push the current OffscreenAttr onto the context stack.
virtual void	RestoreOffscreen (OffscreenAttrValue *)
Private Attributes
BOOL	IsComplexRun

---

Detailed Description

This is a simplified version of the MaskedRenderRegion. It does not have to cope with a mix of complex and simple shapes to be rendered, but knows that there will be a run of complex shapes and then all the rest will be simple.

Author:

Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com>

Date:

24/7/95

Definition at line 118 of file pmaskrgn.h.

---

Constructor & Destructor Documentation

PrintingMaskedRenderRegion::PrintingMaskedRenderRegion (  DocRect  Rect, Matrix  Mat, FIXED16  Scale, double  dpi, BOOL  Printing )

Constructs a PrintingMaskedRenderReigon INT32 dpi changed to double dpi (12/12/95) to improve the range of values allowed at the < 1000dpi settings that we will be using. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: Rect  - The Clip Rect of the region [INPUTS] Mat - the rendering matrix to use Scale - the View Scale dpi - the dpi to render to Definition at line 135 of file pmaskrgn.cpp. : MaskedRenderRegion(Rect, Mat, Scale, dpi) { // Default to a non complex run IsComplexRun = FALSE; RenderFlags.Printing = Printing; }

PrintingMaskedRenderRegion::~PrintingMaskedRenderRegion (   )

destructor - the base classes do all the work here Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Definition at line 154 of file pmaskrgn.cpp. { }

---

Member Function Documentation

WinRect PrintingMaskedRenderRegion::CalculateWinRect (  Matrix &  RenderMatrix, const DocRect &  docrect, const double  dpi )  [virtual]

To convert a rectangle in Doc coordinates to a rectangle in Win coordinates taking account of the destination dpi rather than assuming screen dpi. Virtual so that it can be overriden by different render regions if so required. Author: Neville_Humphrys (Xara Group Ltd) <camelotdev@xara.com> Date: 4/10/96 Parameters: DocRect  is a rectangle on document co-ords. [INPUTS] dpi is the resolution of the device we are rendering to RenderMatrix  is the rendering matrix, may have e anf f components changed by the call [OUTPUTS] Returns: Object containing the new rectangle coordinates. See also: OSRenderRegion::DocRectToWin; Reimplemented from GRenderBitmap. Definition at line 177 of file pmaskrgn.cpp. { // lets get the Rect into screen co-ords so we can use our big screen bitmap // Use a version of OSRenderRegion::DocRectToWin that uses the actual dpi we have stored // in PixelsPerInch // This goes back to the GRenderRegion form rather than the GRenderBitmap special form return OSRenderRegion::BitmapDocRectToWin( RenderMatrix, docrect, dpi ); // return OSRenderRegion::DocRectToWin( RenderMatrix, docrect, dpi ); }

void PrintingMaskedRenderRegion::DrawBitmap (  const DocCoord &  Point, UINT32  BitmapID, UINT32  ToolID = NULL )  [virtual]

Renders a path black if we are in a complex run, or white if not. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: Point  - the point to draw the bitmap at [INPUTS] BitmapID - The ID of the bitmap to draw ToolID - the ID of the tool the resource is part of Reimplemented from MaskedRenderRegion. Definition at line 438 of file pmaskrgn.cpp. { // Save the context SaveContext(); // Does this shape make use of complex things if (IsComplexRun) SetNextShapeColour(Black); else SetNextShapeColour(White); // Draw the Bitmap GRenderBitmap::DrawBitmap(Point, BitmapID, ToolID); // restore the context RestoreContext(); }

void PrintingMaskedRenderRegion::DrawBitmap (  const DocCoord &  Point, KernelBitmap *  pBitmap )  [virtual]

Renders a path black if we are in a complex run, or white if not. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: Point  - The point to draw the bitmap at [INPUTS] pBitmap - at the bitmap Reimplemented from MaskedRenderRegion. Definition at line 406 of file pmaskrgn.cpp. { // Save the context SaveContext(); // Does this shape make use of complex things if (IsComplexRun) SetNextShapeColour(Black); else SetNextShapeColour(White); // Draw the bitmap GRenderBitmap::DrawBitmap(Point, pBitmap); // restore the context RestoreContext(); }

void PrintingMaskedRenderRegion::DrawLine (  const DocCoord &  StartPoint, const DocCoord &  EndPoint )  [virtual]

Renders a path black if we are in a complex run, or white if not. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: StartPoint,EndPoint  - the ends of the line [INPUTS] Reimplemented from MaskedRenderRegion. Definition at line 344 of file pmaskrgn.cpp. { // Save the context SaveContext(); // Does this shape make use of complex things if (IsComplexRun) SetNextShapeColour(Black); else SetNextShapeColour(White); // Draw the Line GRenderBitmap::DrawLine(StartPoint, EndPoint); // restore the context RestoreContext(); }

void PrintingMaskedRenderRegion::DrawPathToOutputDevice (  Path *  PathToRender, PathShape  shapePath = PATHSHAPE_PATH )  [virtual]

Renders a path black if we are in a complex run, or white if not. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: PathToRender  - the path to render [INPUTS] Reimplemented from MaskedRenderRegion. Definition at line 245 of file pmaskrgn.cpp. { // Save the context SaveContext(); // Does this shape make use of complex things if (IsComplexRun) SetNextShapeColour(Black); else SetNextShapeColour(White); // Draw the path GRenderBitmap::DrawPathToOutputDevice(PathToRender); /* BOOL RenderFill = FALSE; // Get the current fill attr FillGeometryAttribute* pFillAttr = (FillGeometryAttribute*) CurrentAttrs[ATTR_FILLGEOMETRY].pAttr; if (pFillAttr->GetBitmap() != NULL && pFillAttr->GetBitmap()->GetBPP() <= 8) { INT32 TranspIndex; // If it's a masked bitmap fill, then we'll need to actually render it // (but we'll force all the non-masked pixels to be rendered black) if (pFillAttr->GetBitmap()->GetTransparencyIndex(&TranspIndex)) RenderFill = TRUE; } if (RenderFill) { BOOL OldVMState = RenderFlags.VeryMono; RenderFlags.VeryMono = TRUE; // Forces non-masked pixels to be plotted black // Draw the path, with the bitmap fill GRenderBitmap::DrawPathToOutputDevice(PathToRender); RenderFlags.VeryMono = OldVMState; } else { // Does this shape make use of complex things if (IsComplexRun) SetNextShapeColour(Black); else SetNextShapeColour(White); // Draw the path GRenderBitmap::DrawPathToOutputDevice(PathToRender); } */ // restore the context RestoreContext(); }

void PrintingMaskedRenderRegion::DrawPixel (  const DocCoord &  Point  )  [virtual]

Renders a path black if we are in a complex run, or white if not. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: Point  - the point to draw the pixel at [INPUTS] Reimplemented from MaskedRenderRegion. Definition at line 374 of file pmaskrgn.cpp. { // Save the context SaveContext(); // Does this shape make use of complex things if (IsComplexRun) SetNextShapeColour(Black); else SetNextShapeColour(White); // Draw the Pixel GRenderBitmap::DrawPixel(Point); // restore the context RestoreContext(); }

void PrintingMaskedRenderRegion::DrawRect (  DocRect *  RectToRender  )  [virtual]

Renders a path black if we are in a complex run, or white if not. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: The  rect to render [INPUTS] Reimplemented from MaskedRenderRegion. Definition at line 313 of file pmaskrgn.cpp. { // Save the context SaveContext(); // Does this shape make use of complex things if (IsComplexRun) SetNextShapeColour(Black); else SetNextShapeColour(White); // Draw the Rect GRenderBitmap::DrawRect(RectToRender); // restore the context RestoreContext(); }

BOOL PrintingMaskedRenderRegion::DrawTransformedBitmap (  NodeBitmap *  pNodeBitmap  )  [virtual]

Renders a path black if we are in a complex run, or white if not. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: pNodeBitmap  - the Node bitmap to render [INPUTS] Reimplemented from MaskedRenderRegion. Definition at line 468 of file pmaskrgn.cpp. { // Save the context SaveContext(); // Does this shape make use of complex things if (IsComplexRun) SetNextShapeColour(Black); else SetNextShapeColour(White); // Draw the Bitmap BOOL Result = GRenderBitmap::DrawTransformedBitmap(pNodeBitmap); /* BOOL Result = TRUE; // Work out if we can do this bitmap directly BOOL CanDoBitmap = FALSE; // Does this shape make use of complex things if (!(IsComplexRun || pNodeBitmap->NeedsTransparency())) { // See what kind of bitmaps this render region can do if (HostCaps.ArbitraryBitmaps) { // We can do anything... CanDoBitmap = TRUE; } else { if (HostCaps.SimpleBitmaps) { // Check that the bitmap area is rectangular, and is perpendicular to // the x and y axes. if (pNodeBitmap->HasSimpleOrientation(this)) { // Yes - simple scaling - the render region can do this. CanDoBitmap = TRUE; } } } } // Here we set up reasonable attributes - we want to fill the bitmap // path but not stroke it. NB. This is very important - do not remove // otherwise the mask will be wrong! SetFillColour(DocColour(COLOUR_BLACK)); SetLineColour(DocColour(COLOUR_NONE)); if (CanDoBitmap) { SetNextShapeColour(White); // Draw the path (that represents the bitmap object) GRenderBitmap::DrawPathToOutputDevice(&pNodeBitmap->InkPath); } else { if (pNodeBitmap->NeedsTransparency()) { // It's a masked bitmap, so we'll need to actually render the non-masked // pixels as black BOOL OldVMState = RenderFlags.VeryMono; RenderFlags.VeryMono = TRUE; // Forces non-masked pixels to be plotted black // Call base class to plot the bitmap RenderRegion::DrawTransformedBitmap(pNodeBitmap); RenderFlags.VeryMono = OldVMState; } else { SetNextShapeColour(Black); // Draw the path (that represents the bitmap object) GRenderBitmap::DrawPathToOutputDevice(&pNodeBitmap->InkPath); } } */ // restore the context RestoreContext(); // return if it worked or not return Result; }

GMATRIX PrintingMaskedRenderRegion::MakeGavinMatrix (  Matrix  NewRenderMatrix, DocRect  ClipRect, double  dPixelsPerInch, BOOL  bMasterCapture )  [virtual]

Make a Gavin Matrix out of a Kernel Matrix. Author: Phil_Martin (Xara Group Ltd) <camelotdev@xara.com> (from Will (from Phil code)) Date: ??/??/2004 Parameters: The  Kernel Matrix and cliprect to use to create the Gavin Matrix. [INPUTS] Returns: TRUE if the GMatrix was created ok. See also: GRenderRegion::SetGavinMatrix Notes: Doesn't rely on current state of CurrentClipRect like the above version Reimplemented from GRenderBitmap. Definition at line 204 of file pmaskrgn.cpp. { // Bypass the behaviour inherited from GRenderBitmap because we don't want it return GRenderRegion::MakeGavinMatrix(NewRenderMatrix, ClipRect, dPixelsPerInch, bMasterCapture); }

BOOL PrintingMaskedRenderRegion::RenderChar (  WCHAR  ch, Matrix *  pMatrix )  [virtual]

Renders a char into the mask sometimes - there are times when we do not want the char to render - eps when we are dealing with postscript, where what we render and what postscript renders may be different. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 2/8/95 Parameters: ch  - the char to render [INPUTS] pMatrix  - the matrix to use to render with [OUTPUTS] Returns: TRUE if it worked, FALSE if not. Reimplemented from RenderRegion. Definition at line 573 of file pmaskrgn.cpp. { // Save the context SaveContext(); // Get ready to return BOOL Result = TRUE; // Does this shape make use of complex things // if it is not complex them do not try and punch it out of the mask, as this // causes problems on postscript devices. if (IsComplexRun) { SetNextShapeColour(Black); Result = GRenderBitmap::RenderChar(ch, pMatrix); } // restore the context RestoreContext(); // return return Result; }

virtual void PrintingMaskedRenderRegion::RestoreOffscreen (  OffscreenAttrValue *   )  [inline, virtual]

Reimplemented from MaskedRenderRegion. Definition at line 158 of file pmaskrgn.h. { }

void PrintingMaskedRenderRegion::SetMaskDrawingMode (  BOOL  OnOff  )

The render region can either be rendering simple nodes or complex nodes in runs (ie you get a block or complex one, then a block of simple ones). This function allows you to change the render regions idea of whether the nodes are complex or simple. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 24/7/95 Parameters: OnOff  - TRUE means the nodes we are about render will all be treated as [INPUTS] complex nodes. FALSE means that all the nodes we are about to render are treated as simple nodes. Definition at line 227 of file pmaskrgn.cpp. { // Set our bool, making sure that it is always either TRUE or FALSE IsComplexRun = (OnOff) ? TRUE : FALSE; }

virtual void PrintingMaskedRenderRegion::SetOffscreen (  OffscreenAttrValue *   )  [inline, virtual]

Create a new bitmap into which, the subtree rooted at this attributes parent, will be rendered. Then call base version to push the current OffscreenAttr onto the context stack. Following only used by GRenderRegion version ** info pointer to bmp info struct which we will setup. bits pointer to bitmap bits which we'll setup. See also: GRenderRegion::RestoreOffscreen; GRenderRegion:: Reimplemented from MaskedRenderRegion. Definition at line 155 of file pmaskrgn.h. { }

---

Member Data Documentation

BOOL PrintingMaskedRenderRegion::IsComplexRun [private]

Definition at line 164 of file pmaskrgn.h.

---

The documentation for this class was generated from the following files:

• Kernel/pmaskrgn.h (r1785/r1288)
• Kernel/pmaskrgn.cpp (r1785/r1288)

---