PSPrintDC Class Reference

Provide a device context for printing to a PostScript printer. More...

#include <psdc.h>

Inheritance diagram for PSPrintDC:

List of all members.

Public Member Functions
	PSPrintDC (CNativeDC *pDC)
	Initialise a DC for printing PostScript.
	~PSPrintDC ()
	Clean up the fonts in the DC.
virtual BOOL	OutputNewLine ()
	Causes a new line to be started in the PostScript stream.
virtual BOOL	OutputToken (TCHAR *)
	Outputs a string token to the EPS file.
virtual BOOL	OutputDirect (BYTE *, INT32)
	Send bytes directly to the PostScript stream with no alteration or padding. Used for sending binary/hex data to stream. NB. The data output must NOT affect the rendering context set up by GDI in any way, as this function does not preserve that context (it cannot because it does not change the data passed in in any way).
virtual BOOL	OutputCoord (DocCoord &, EPSAccuracy Accuracy=ACCURACY_NORMAL)
	Write out a coordinate x,y pair to the export file, automatically converting from spread coordinates to the user space coordinate system. User space is the coordinate system used for PostScript files. GDI sets up the CTM so that 1 user space unit = 1 device unit, so all we do is use the rendering matrix to convert to Windows co-ordinates and output this directly at 0dp accuracy (because a fractional user space value would equate to a fractional device pixel, which has no effect on output).
virtual BOOL	OutputUserSpaceValue (MILLIPOINT, EPSAccuracy Accuracy=ACCURACY_NORMAL)
	Output a 'user space' value to the device context. User space is the coordinate system used for PostScript files. GDI sets up the CTM so that 1 user space unit = 1 device unit, so all we do is use the rendering matrix to convert to Windows co-ordinates and output this directly at 0dp accuracy (because a fractional user space value would equate to a fractional device pixel, which has no effect on output).
void	SetDCTransforms (Matrix RenderMatrix, View *pView)
	Inform the DC how to transform user space values when performing output via OutputCoord. and OutputUserSpaceValue().
WinCoord	TransformCoord (const DocCoord &)
	Transform a DocCoord to a WinCoord, using this DC's transformations, as set up by SetDCTransforms().
void	AttachRenderRegion (PrintPSRenderRegion *pRegion)
void	DetachRenderRegion ()
BOOL	StartOSOutput ()
	Restore the PostScript DC to the context expected by the host OS (GDI), so we can use OS (GDI) functions. You must call EndOSOutput() before calling any Camelot rendering functions. There may be nested calls to this function.
BOOL	EndOSOutput ()
	Inform the DC that we have finished doing GDI output, and so we should prepare the DC for Camelot PS commands (this is deferred until we actually do some output on the stream).
BOOL	FlushDC ()
	Tidy up the PostScript DC and reinstate the GDI context if necessary. Should be called when printing is finished. (Won't cause problems if called more often - just more output).
BOOL	FlushPSBuffer ()
	Flushes the buffer of pending PostScript data to the PostScript device.
BOOL	SelectNewFont (WORD Typeface, BOOL Bold, BOOL Italic, MILLIPOINT Width, MILLIPOINT Height, ANGLE Rotation)
	Selects the specified font into the DC. Performs clever stuff to cache the font so that subsequent requests for the same font don't cause anything to happen.
BOOL	SetClipping (BOOL NewState)
	Set the use of a clip region.
BOOL	OutputPSClipping ()
	Set the use of a clip region.
Protected Member Functions
BOOL	MakeRoomInBuffer (INT32)
	Make sure there is enough room in the PostScript buffer to add the specified number of bytes to the stream. If not, the buffer is flushed to the device.
void	WritePSchar (char *pBuf, INT32 nBytes)
	Writes nBytes of TCHAR to the output stream. Uses Buffer.chardata as a scratch area. Max of MAX_PSBUF can be written at a time.
void	WritePSTCHAR (TCHAR *pBuf, INT32 nBytes)
	Writes nBytes of TCHAR to the output stream. Uses Buffer.chardata as a scratch area. Max of MAX_PSBUF can be written at a time.
Protected Attributes
PassThruBuffer	Buffer
Matrix	RenderMatrix
MILLIPOINT	PixelSize
View *	pView
INT32	SafeToUseGDI
BOOL	StartOfPage
BOOL	GDIContextIsCurrent
BOOL	UsePSLevelClipping
PSDCFontInfo	FontInfo
PrintPSRenderRegion *	pPSRegion

---

Detailed Description

Provide a device context for printing to a PostScript printer.

Author:

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

Date:

28/03/94

See also:

KernelDC; PSPrintRenderRegion

Definition at line 162 of file psdc.h.

---

Constructor & Destructor Documentation

PSPrintDC::PSPrintDC (  CNativeDC *  pDC  )

Initialise a DC for printing PostScript. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 23/04/95 Parameters: The  device context of the PostScript printer. [INPUTS] Definition at line 149 of file psdc.cpp. : KernelDC(pDC, RENDERTYPE_PRINTER_PS) { // Initialise the buffer to being empty. Buffer.nCount = 0; Buffer.Data[0] = 0; // No view yet pView = NULL; // We haven't set up the Camelot context yet, and no-one has asked to do any GDI // output yet. GDIContextIsCurrent = TRUE; SafeToUseGDI = 0; // Once per page StartOfPage = TRUE; // No fonts yet FontInfo.pRenderFont = NULL; FontInfo.pOldFont = NULL; // No render region yet. pPSRegion = NULL; // Suppress the output of a postscript clipping region UsePSLevelClipping = FALSE; }

PSPrintDC::~PSPrintDC (   )

Clean up the fonts in the DC. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 05/30/95 Definition at line 189 of file psdc.cpp. { // Deselect the normal rendering font from the DC if (FontInfo.pRenderFont != NULL) { GetDC()->SetFont(*FontInfo.pOldFont); FontInfo.pOldFont = NULL; delete FontInfo.pRenderFont; FontInfo.pRenderFont = NULL; } }

---

Member Function Documentation

void PSPrintDC::AttachRenderRegion (  PrintPSRenderRegion *  pRegion  )  [inline]

Definition at line 181 of file psdc.h. { pPSRegion = pRegion; }

void PSPrintDC::DetachRenderRegion (   )  [inline]

Definition at line 183 of file psdc.h. { pPSRegion = NULL; }

BOOL PSPrintDC::EndOSOutput (   )

Inform the DC that we have finished doing GDI output, and so we should prepare the DC for Camelot PS commands (this is deferred until we actually do some output on the stream). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 04/30/95 Returns: TRUE if ok; FALSE if not (e.g. call has no corresponding call to StartOSOutput()). See also: PSPrintDC::StartOSOutput Definition at line 831 of file psdc.cpp. { // Just decrement counter - we do the other stuff in OutputToken(). SafeToUseGDI--; ERROR2IF(SafeToUseGDI < 0, FALSE, "Unbalanced call to Start/EndOSOutput() functions!"); // All ok return TRUE; }

BOOL PSPrintDC::FlushDC (   )

Tidy up the PostScript DC and reinstate the GDI context if necessary. Should be called when printing is finished. (Won't cause problems if called more often - just more output). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 04/25/95 Returns: TRUE if ok; FALSE if not (e.g. output problem) See also: PSPrintDC::FlushPSBuffer() Definition at line 622 of file psdc.cpp. { // Restore OS context - just pretend we want to do some OS output //if (!StartOSOutput()) // Error // return FALSE; // Clear out the buffer. if (!FlushPSBuffer()) // Error return FALSE; // Go back to using Camelot context // (NB this is deferred - it will only be reinstated if we do Camelot output) //return EndOSOutput(); return TRUE; }

BOOL PSPrintDC::FlushPSBuffer (   )

Flushes the buffer of pending PostScript data to the PostScript device. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 04/24/95 Returns: TRUE if data flushed ok; FALSE if not (e.g. printer/driver error) See also: PSPrintDC::MakeRoomInBuffer Definition at line 468 of file psdc.cpp. { if (Buffer.nCount <= 0) // Nothing to flush return TRUE; // Get system to flush any of its data first. // (don't have to do anything here) if (Buffer.nCount>MAX_PSBUF) // MAX_PSBUF itself is legal { Buffer.nCount=MAX_PSBUF; ERROR3("Postscript buffer overrun"); } // Ensure the buffer is zero terminated WritePSTCHAR(Buffer.Data, Buffer.nCount); // Clear out buffer Buffer.nCount = 0; Buffer.Data[0] = 0; return TRUE; }

BOOL PSPrintDC::MakeRoomInBuffer (  INT32  nBytesRequired  )  [protected]

Make sure there is enough room in the PostScript buffer to add the specified number of bytes to the stream. If not, the buffer is flushed to the device. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 04/24/95 Parameters: nBytesRequired  - how many bytes of free space are needed in the buffer. [INPUTS] Returns: TRUE if enough space was found; FALSE if not. Errors: Printer/driver error => ERROR1 Buffer cannot accomodate requested size even when empty => ERROR2 See also: PSPrintDC::FlushPSBuffer Definition at line 589 of file psdc.cpp. { if (nBytesRequired >= MAX_PSBUF) { // Can't ever do that many bytes! ERROR2(FALSE, "Too many bytes asked for in PSPrintDC::MakeRoomInBuffer()"); } // Do we need to flush? if (nBytesRequired > (MAX_PSBUF - Buffer.nCount)) // Yes return FlushPSBuffer(); // All ok if we get here return TRUE; }

BOOL PSPrintDC::OutputCoord (  DocCoord &  Coord, EPSAccuracy  Accuracy = ACCURACY_NORMAL )  [virtual]

Write out a coordinate x,y pair to the export file, automatically converting from spread coordinates to the user space coordinate system. User space is the coordinate system used for PostScript files. GDI sets up the CTM so that 1 user space unit = 1 device unit, so all we do is use the rendering matrix to convert to Windows co-ordinates and output this directly at 0dp accuracy (because a fractional user space value would equate to a fractional device pixel, which has no effect on output). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 28/03/94 Parameters: Coord  - the coordinate to write out to the file. [INPUTS] Accuracy - optional parameter - ignored for GDI PostScript output as GDI sets up a coordinate system where 1 user space unit = 1 device unit. Returns: TRUE if the data was written ok; FALSE if not => ERROR1 See also: PSPrintDC::OutputUserSpaceValue Returns: Errors: File/disk error => ERROR1 Reimplemented from KernelDC. Definition at line 705 of file psdc.cpp. { // We need a view to scale the coords. ERROR2IF(pView == NULL, FALSE, "No view attached to PostScript DC!"); WinCoord PSCoord = TransformCoord(Coord); // Output to PostScript stream. BOOL Ok = (OutputValue(PSCoord.x) && OutputValue(PSCoord.y)); return Ok; }

BOOL PSPrintDC::OutputDirect (  BYTE *  Buf, INT32  nBytes )  [virtual]

Send bytes directly to the PostScript stream with no alteration or padding. Used for sending binary/hex data to stream. NB. The data output must NOT affect the rendering context set up by GDI in any way, as this function does not preserve that context (it cannot because it does not change the data passed in in any way). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 23/04/95 Parameters: Buf  - the bytes to send to the stream. [INPUTS] nBytes - the number of bytes to send to the stream. Returns: TRUE if all the bytes were sent ok; FALSE if not. Do NOT use this to send commands that will render something, as the CTM will NOT be set up correctly for Camelot's co-ordinate system. See also: KernelDC::OutputNewLine; KernelDC::OutputToken Reimplemented from KernelDC. Definition at line 429 of file psdc.cpp. { // This could be anything, so we flush the buffer first, and then write directly // to stream. if (!FlushPSBuffer()) // Error occured in buffer handling return FALSE; // Copy data to our buffer - do it in stages if necessary while (nBytes > 0) { // Work out how much we can send this time around. INT32 nBytesToSend = min(nBytes, MAX_PSBUF); WritePSchar((char *)Buf, nBytesToSend); // Update variables to reflect sending this number of bytes nBytes -= nBytesToSend; Buf += nBytesToSend; } // All ok return TRUE; }

BOOL PSPrintDC::OutputNewLine (   )  [virtual]

Causes a new line to be started in the PostScript stream. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 23/04/95 Returns: TRUE if the data was written ok; FALSE if not => ERROR1 See also: PSPrintDC; PSPrintDC::OutputToken Returns: Errors: Disk/file/print error => ERROR1 Reimplemented from KernelDC. Definition at line 217 of file psdc.cpp. { static TCHAR NewLine[] = _T("\n"); // Make sure we have enough room in the buffer if (!MakeRoomInBuffer(camStrlen(NewLine))) // Error occured in buffer handling. return FALSE; // Add newline to buffer camStrcat(Buffer.Data, NewLine); Buffer.nCount += camStrlen(NewLine); // Update line width record. LineWidth = 0; // Success return TRUE; }

BOOL PSPrintDC::OutputPSClipping (   )

Set the use of a clip region. Author: Mike_Kenny (Xara Group Ltd) <camelotdev@xara.com> Date: 09/09/96 Returns: TRUE if a clip region has been exported Definition at line 1109 of file psdc.cpp. { if (UsePSLevelClipping) { // DocRect theRect = pPSRegion->CurrentClipRect; // BODGE - Currently need to deflate this clip region // by the bleed size. This only works because we know we are not // stripping but rendering complete pages. Hence this clip rectangle represents // the page with bleed applied in the document area. We need to output a clip // rectangle which will clip all objects beyond the bleed. This is quite a complex process. PrintView* pView = (PrintView*)(pPSRegion->GetRenderView()); ERROR2IF(pView==NULL,FALSE,"No printview in this PS render region"); ERROR3IF(!pView->IsKindOf(CC_RUNTIME_CLASS(PrintView)), "Not a PrintView in PSPrintDC output token"); // Get the current patch clip rectangle DocRect theRect = pView->PatchInfo.GetClipRect(FALSE,FALSE); // read the regions render matrix. Matrix RMatrix = pPSRegion->GetMatrix(); Matrix IMatrix = RMatrix.Inverse(); RMatrix.transform(&theRect.lo); RMatrix.transform(&theRect.hi); PrintView::CorrectRotatedRectangle((Rect*)&theRect); pView->PatchInfo.InflateRectBy(&theRect,TRUE,FALSE); IMatrix.transform(&theRect.lo); IMatrix.transform(&theRect.hi); PrintView::CorrectRotatedRectangle((Rect*)&theRect); // And finally write the clip region out if (!pPSRegion->WriteClipRegion(this, theRect)) return FALSE; } return TRUE; }

BOOL PSPrintDC::OutputToken (  TCHAR *  Str  )  [virtual]

Outputs a string token to the EPS file. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 23/04/95 Parameters: Str  - the character string to write to the file. [INPUTS] Returns: TRUE if the data was written ok; FALSE if not => ERROR1 See also: PSPrintDC; KernelDC::OutputToken Returns: Errors: Disk/file error => ERROR1 Reimplemented from KernelDC. Definition at line 252 of file psdc.cpp. { #ifndef STANDALONE // Should we re-instate the Camelot context? if (!SafeToUseGDI && GDIContextIsCurrent) { // Yes - just save the context (so we can restore GDI's context) and put our // dictionary on the dict stack. // Must do this first or else we get an infinite loop! GDIContextIsCurrent = FALSE; // Code by Mike // We need to work out where we are in order to render the correct bits of postscript header. BOOL AtStartOfPaper = FALSE; BOOL AtStartOfPatch = StartOfPage; StartOfPage=FALSE; // Work out whether this is the first call to output token for this page if (AtStartOfPatch) { PrintView* pView = (PrintView*)(pPSRegion->GetRenderView()); ERROR2IF(pView==NULL,FALSE,"No printview in this PS render region"); ERROR3IF(!pView->IsKindOf(CC_RUNTIME_CLASS(PrintView)), "Not a PrintView in PSPrintDC output token"); AtStartOfPaper = ((pView->PatchInfo.PatchNumber)==1); } OutputNewLine(); // ok now check our flag. This may be the first time we've // been called from this PSPrintDC construction. If so we // need to output page header stuff. if (AtStartOfPaper) { // We need to get the name of the output plate here // this might be a bit tricky! Na easy... if (!pPSRegion->WritePlateName(this)) return FALSE; } // save the graphics state OutputToken(_T("save")); OutputNewLine(); // wxWidgets and Windows both use (0,0) to mean the top left hand origin of the // paper in logical coordinates. However, they do something rather different in // terms of physical coordinates. What windows printer drivers do (and thus what // Camelot expects) is use a postcript page transformation matrix to invert the // page, and for the postscript to be written in native DPI coordinates with the // origin at the TOP left of the page. What wxWidgets does is write its postscript // in the more natural way with the origin at the BOTTOM of the page, and handle // the coordinate inversion wihin wxWidgets. // // Note that this means while our internally generated PS expects a transformation // matrix that flips the Y coordinate (as the windows drivers produce). We // can't change the transformation matrix in the prologue because this would // affect wxWidgets output (and also it's technically difficult to do). We can't // change our own rendering matrix (so we produce the right coordinates) because // lots of things seem to explode with a matrix which flips the Y access (negative // scale factors etc.). We can't just change the coordinates we write because // other things (e.g. bitmaps) use the native render matrix. So what we do is // temporarily invert the PS transformation matrix during the period of our output. // This seems arcane but reasonably extensive research suggests it is the best // way forward. It's restored before we do any OS output. TCHAR flipbuf[256]; INT32 translate = GetDC()->GetSize().GetHeight(); camSprintf(flipbuf, _T("0 %d translate 1 -1 scale"), translate); OutputToken(flipbuf); OutputNewLine(); // Now start plate writing etc. if (!pPSRegion->WritePhotoNegative(this)) return FALSE; if (AtStartOfPaper) { // We need to fill the page with black if the plate says we // need to negate everything. if (!pPSRegion->WriteRenderPaper(this)) return FALSE; } // Write out our procset. if (!pPSRegion->WriteProlog(this)) // Error return FALSE; OutputNewLine(); OutputToken(_T("XaraStudio1Dict begin")); OutputNewLine(); // Now output the setscreen function for this plate if (!pPSRegion->WritePlateScreen(this)) return FALSE; // try to write out the sep tables if we need them if (!pPSRegion->WriteSepTables(this)) return FALSE; // export any clip region we might need. if (!OutputPSClipping()) return FALSE; } // Special tokens // static TCHAR Space = _T(' '); // static TCHAR NewLine[] = _T("\n"); if (LineWidth > 70) { // Line is getting INT32 - wrap around OutputNewLine(); } // Pad with a space (unless at the beginning of the line) if (LineWidth > 0) { // Make sure we have enough room in the buffer if (!MakeRoomInBuffer(1)) // Error occured in buffer handling. return FALSE; // Add space to buffer camStrcat(Buffer.Data, _T(" ")); Buffer.nCount++; // Update line width record. LineWidth++; } // Write the token out to the file INT32 Len = camStrlen(Str); // Make sure we have enough room in the buffer if (!MakeRoomInBuffer(Len)) // Error occured in buffer handling. return FALSE; // Add space to buffer camStrcat(Buffer.Data, Str); Buffer.nCount += Len; // Update line width record. LineWidth += Len; // Success return TRUE; #else return FALSE; #endif }

BOOL PSPrintDC::OutputUserSpaceValue (  MILLIPOINT  n, EPSAccuracy  Accuracy = ACCURACY_NORMAL )  [virtual]

Output a 'user space' value to the device context. User space is the coordinate system used for PostScript files. GDI sets up the CTM so that 1 user space unit = 1 device unit, so all we do is use the rendering matrix to convert to Windows co-ordinates and output this directly at 0dp accuracy (because a fractional user space value would equate to a fractional device pixel, which has no effect on output). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 28/04/95 Parameters: n  - the value (in millipoints) to output. [INPUTS] Accuracy - optional parameter - ignored for GDI PostScript output as GDI sets up a coordinate system where 1 user space unit = 1 device unit. Returns: TRUE if the data was written ok; FALSE if not => ERROR1 See also: KernelDC::OutputCoord; KernelDC::OutputToken; KernelDC::SetFullAccuracy Returns: Errors: Disk/file error => ERROR1 Reimplemented from KernelDC. Definition at line 668 of file psdc.cpp. { // We need a view to scale the value. ERROR2IF(pView == NULL, FALSE, "No view attached to PostScript DC!"); // Use pixel size to scale to device units. n /= PixelSize; // Output as device units return OutputValue(n); }

BOOL PSPrintDC::SelectNewFont (  WORD  Typeface, BOOL  Bold, BOOL  Italic, MILLIPOINT  Width, MILLIPOINT  Height, ANGLE  Rotation )

Selects the specified font into the DC. Performs clever stuff to cache the font so that subsequent requests for the same font don't cause anything to happen. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 05/28/95 Parameters: Details  of the font to select. [INPUTS] NB. Width is not the actual width; it expresses the aspect ratio required. So, e.g. if Width == Height/2 then the aspect ratio is 50%, and so on. Returns: TRUE if the font was selected ok; FALSE if not. Definition at line 860 of file psdc.cpp. { PORTNOTE("printing", "Removed postscript printing of text") #ifndef EXCLUDE_FROM_XARALX // Check to see if it is cached if ((FontInfo.pRenderFont != NULL) && (FontInfo.Typeface == Typeface) && (FontInfo.Bold == Bold) && (FontInfo.Italic == Italic) && (FontInfo.Width == Width) && (FontInfo.Height == Height) && (FontInfo.Rotation == Rotation)) { // It is the same as the currently selected/cached font TRACEUSER( "Tim", _T("Using the cached font\n")); return TRUE; } TRACEUSER( "Tim", _T("Font cache invalid - generating font to use\n")); // Get ready for GDI operations if (!StartOSOutput()) return FALSE; // Not the cached font - ok, deselect and delete the cached font. if (FontInfo.pOldFont != NULL) { GetDC->SetFont(*FontInfo.pOldFont); FontInfo.pOldFont = NULL; } if (FontInfo.pRenderFont != NULL) { delete FontInfo.pRenderFont; FontInfo.pRenderFont = NULL; } // Create the font and select it into the DC FontInfo.pRenderFont = new wxFont; if (!FontInfo.pRenderFont) return FALSE; // Work out the font weight - bold or normal? INT32 FontWeight = Bold ? FW_BOLD : FW_NORMAL; // Get the typeface name of the font ENUMLOGFONT *pEnumLogFont = FONTMANAGER->GetEnumLogFont(Typeface); if (pEnumLogFont == NULL) // Error return FALSE; // Work out how big the font is, in logical pixels FIXED16 fxPixWidth, fxPixHeight; pView->GetScaledPixelSize(&fxPixWidth, &fxPixHeight); INT32 FontWidth = (INT32) (Width / fxPixWidth.MakeDouble()); INT32 FontHeight = (INT32) (Height / fxPixHeight.MakeDouble()); if (FontHeight == FontWidth) { // Aspect ratio is 100% - use width of 0, and the GDI font engine gives us 100% // ratio automatically FontWidth = 0; } else { // Aspect ratio is not 100% - we need to do some clever stuff to work out // how wide we want the font to be. Because fonts are generally much taller // than they are wide, we can't just pass in FontWidth directly - we must // transform it to the correct width. // BODGETEXT: ideally, we should use a NEWTEXTMETRIC structure here, to work out // the correct width, but this involves calling EnumLogFontFamily() or // whatever, which is too slow. As the text code caches the LOGFONT // for each font, it could also cache the NEWTEXTMETRIC structure, // which this routine could then use. // Having said all that, this code seems to work! // Create the font - the first time is to find out how wide the characters are, // so we can scale the width correctly. (So we give a width of 0 to get the normal // width for the given height) if (FontInfo.pRenderFont->CreateFont(-100, 0, 0, 0, FontWeight, Italic, FALSE, FALSE, DEFAULT_CHARSET, OUT_TT_PRECIS, CLIP_TT_ALWAYS, PROOF_QUALITY, DEFAULT_PITCH | FF_DONTCARE, pEnumLogFont->elfLogFont.lfFaceName) == 0) { // Can't create font - do it as curves delete FontInfo.pRenderFont; FontInfo.pRenderFont = NULL; EndOSOutput(); return FALSE; } if (FALSE)//TRUE) { FontInfo.pOldFont = SelectObject(FontInfo.pRenderFont); // Get the outlines to see how big the font should be... INT32 Widths[30]; // First for lower case GetOutputCharWidth('a', 'z', Widths); INT32 AveCharWidth = 0; for (INT32 i = 0; i < 26; i++) AveCharWidth += Widths[i]; // Now for upper case GetOutputCharWidth('A', 'Z', Widths); for (i = 0; i < 26; i++) AveCharWidth += Widths[i]; // Ok, get average width AveCharWidth /= 52; // Scale the width by the font's aspect ratio: // ActualWidth = (RealWidth / Height) * Width FontWidth = MulDiv(AveCharWidth, FontWidth, 100); // Select old font back into DC SelectObject(FontInfo.pOldFont); } else { // Get the metrics TEXTMETRIC Metrics; if (TRUE) //RFlags.Metafile) { // Metafile - we need to use the screen DC to do this CNativeDC *pDesktopDC = CWnd::GetDesktopWindow()->GetDC(); // Get the metrics FontInfo.pOldFont = pDesktopDC->SelectObject(FontInfo.pRenderFont); pDesktopDC->GetTextMetrics(&Metrics); // Select old font back into screen DC pDesktopDC->SelectObject(FontInfo.pOldFont); CWnd::GetDesktopWindow()->ReleaseDC(pDesktopDC); } else { FontInfo.pOldFont = SelectObject(FontInfo.pRenderFont); GetTextMetrics(&Metrics); // Select old font back into DC SelectObject(FontInfo.pOldFont); } // Scale the width by the font's aspect ratio: // ActualWidth = (RealWidth / Height) * Width FontWidth = MulDiv(Metrics.tmAveCharWidth, FontWidth, 100); } // Delete the font delete FontInfo.pRenderFont; // Create the 'proper' font and select it into the DC TRY { FontInfo.pRenderFont = new CFont; } CATCH (CMemoryException, e) { return FALSE; } END_CATCH } // Work out the rotation of the font, in tenths of degrees. INT32 lfRotation; if (Rotation == FIXED16(0)) lfRotation = 0; else lfRotation = (INT32) ( (Rotation.MakeDouble() * 360.0 * 10.0) / (2 * PI) ); // Create the font with the correct width and rotation if (FontInfo.pRenderFont->CreateFont(-FontHeight, FontWidth, lfRotation, 0, FontWeight, Italic, FALSE, FALSE, DEFAULT_CHARSET, OUT_TT_PRECIS, CLIP_TT_ALWAYS, PROOF_QUALITY, DEFAULT_PITCH | FF_DONTCARE, pEnumLogFont->elfLogFont.lfFaceName) == 0) { // Can't create font (device may not support rotation). delete FontInfo.pRenderFont; FontInfo.pRenderFont = NULL; EndOSOutput(); return FALSE; } // Select the real font into the DC. FontInfo.pOldFont = SelectObject(FontInfo.pRenderFont); // Validate the cache FontInfo.Typeface = Typeface; FontInfo.Bold = Bold; FontInfo.Italic = Italic; FontInfo.Width = Width; FontInfo.Height = Height; FontInfo.Rotation = Rotation; // End of GDI operations if (!EndOSOutput()) return FALSE; // Font created and selected ok return TRUE; #else return FALSE; // hopefully it will print as curves #endif }

BOOL PSPrintDC::SetClipping (  BOOL  newstate  )

Set the use of a clip region. Author: Mike_Kenny (Xara Group Ltd) <camelotdev@xara.com> Date: 09/09/96 Returns: The old state of the clipping flag Definition at line 1090 of file psdc.cpp. { BOOL oldstate = UsePSLevelClipping; UsePSLevelClipping = newstate; return oldstate; }

void PSPrintDC::SetDCTransforms (  Matrix  NewRenderMatrix, View *  pNewView )

Inform the DC how to transform user space values when performing output via OutputCoord. and OutputUserSpaceValue(). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 29/04/95 Parameters: The  matrix and view to transform user space values with. [INPUTS] See also: PSPrintDC::OutputCoord; PSPrintDC::OutputUserSpaceValue Definition at line 732 of file psdc.cpp. { // Remember these values RenderMatrix = NewRenderMatrix; pView = pNewView; // Get the pixel size from the view FIXED16 fxPixelWidth, fxPixelHeight; pView->GetScaledPixelSize(&fxPixelWidth, &fxPixelHeight); PixelSize = (MILLIPOINT) fxPixelWidth.MakeLong(); }

BOOL PSPrintDC::StartOSOutput (   )

Restore the PostScript DC to the context expected by the host OS (GDI), so we can use OS (GDI) functions. You must call EndOSOutput() before calling any Camelot rendering functions. There may be nested calls to this function. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 04/30/95 Returns: TRUE if ok; FALSE if not (e.g. file/printer/driver error). Errors: File/printer error See also: PSPrintDC::EndOSOutput Definition at line 791 of file psdc.cpp. { if ((SafeToUseGDI == 0) && !GDIContextIsCurrent) { // We need to restore the GDI context - this involves removing our dictionary // from the dictionary stack, and calling restore. if (!OutputToken(_T("end restore")) || !OutputNewLine()) // Error return FALSE; // Flush our buffer so Camelot PS syncs correctly with GDI PS. if (!FlushPSBuffer()) // Error return FALSE; GDIContextIsCurrent = TRUE; } // Increment GDI count SafeToUseGDI++; // Ok to use GDI now return TRUE; }

WinCoord PSPrintDC::TransformCoord (  const DocCoord &  Coord  )

Transform a DocCoord to a WinCoord, using this DC's transformations, as set up by SetDCTransforms(). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 30/6/95 Parameters: Coord  - the co-ordinate to transform. [INPUTS] Returns: The transformed co-ordinate. See also: PSPrintDC::SetDCTransforms Definition at line 759 of file psdc.cpp. { // Use the rendering matrix of our parent render region to transform // the co-ordinate to device units before proceeding. OilCoord NewCoord(Coord.x, Coord.y); RenderMatrix.transform(&NewCoord); // Convert to Windows device units. WinCoord PSCoord = NewCoord.ToWin(pView); // Return to caller return PSCoord; }

void PSPrintDC::WritePSchar (  char *  pBuf, INT32  nBytes )  [protected]

Writes nBytes of TCHAR to the output stream. Uses Buffer.chardata as a scratch area. Max of MAX_PSBUF can be written at a time. Author: Alex Bligh Date: 23/06/2006 Returns: - See also: - Definition at line 545 of file psdc.cpp. { if ((nBytes>MAX_PSBUF) || (nBytes<=0)) { ERROR3("Bad PSPrintDC write"); return; } #ifdef _DEBUG INT32 i; for (i=0; i<nBytes; i++) { if (!pBuf[i]) { ERROR3("Zero byte in PS Buffer!"); break; } } #endif // Need to copy it so we can safely zero terminate it memcpy(Buffer.CharData, pBuf, nBytes); Buffer.CharData[nBytes]=0; // safe as chardata one larger than MAX_PSBUF ((wxPostScriptDC *)GetDC())->PsPrint(Buffer.CharData); }

void PSPrintDC::WritePSTCHAR (  TCHAR *  pBuf, INT32  nBytes )  [protected]

Writes nBytes of TCHAR to the output stream. Uses Buffer.chardata as a scratch area. Max of MAX_PSBUF can be written at a time. Author: Alex Bligh Date: 23/06/2006 Returns: - See also: - Definition at line 507 of file psdc.cpp. { if ((nBytes>MAX_PSBUF) || (nBytes<=0)) { ERROR3("Bad PSPrintDC write"); return; } if (sizeof(TCHAR) == sizeof(char)) { WritePSchar((char *)pBuf, nBytes); return; } INT32 i; for (i=0; i<nBytes; i++) { ERROR3IF(!pBuf[i], "Zero byte in PS buffer"); Buffer.CharData[i]=pBuf[i]; // 1:1 copy } Buffer.CharData[nBytes]=0; // safe as chardata one larger than MAX_PSBUF ((wxPostScriptDC *)GetDC())->PsPrint(Buffer.CharData); }

---

Member Data Documentation

PassThruBuffer PSPrintDC::Buffer [protected]

Definition at line 209 of file psdc.h.

PSDCFontInfo PSPrintDC::FontInfo [protected]

Definition at line 235 of file psdc.h.

BOOL PSPrintDC::GDIContextIsCurrent [protected]

Definition at line 228 of file psdc.h.

MILLIPOINT PSPrintDC::PixelSize [protected]

Definition at line 215 of file psdc.h.

PrintPSRenderRegion* PSPrintDC::pPSRegion [protected]

Definition at line 238 of file psdc.h.

View* PSPrintDC::pView [protected]

Definition at line 216 of file psdc.h.

Matrix PSPrintDC::RenderMatrix [protected]

Definition at line 214 of file psdc.h.

INT32 PSPrintDC::SafeToUseGDI [protected]

Definition at line 219 of file psdc.h.

BOOL PSPrintDC::StartOfPage [protected]

Definition at line 224 of file psdc.h.

BOOL PSPrintDC::UsePSLevelClipping [protected]

Definition at line 232 of file psdc.h.

---

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

• wxOil/psdc.h (r1785/r1354)
• wxOil/psdc.cpp (r1785/r1389)

---