PrintControl Class Reference

This class encapsulates all the print settings for a document, and controls how the document pages are printed on the paper. More...

#include <printctl.h>

List of all members.

Public Member Functions
	PrintControl ()
	Default constructor.
	~PrintControl ()
	Default deconstructor.
BOOL	SetUp (Spread *pSpread, BOOL RedrawPrintBorders=TRUE)
	This function sets up the print control to print the given spread.
String_256	BuildPrintInfoStr ()
	This uses the print control's settings to build the string displayed in the print info field of a print dlg.
String_256	BuildPaperSizeStr ()
	This uses the printer settings to build the string displayed in the paper size field of a print options tab.
BOOL	IsWholeSpread ()
void	SetWholeSpread (BOOL State)
	Sets the WholeSpread state, altering dependants automatically (unless importing).
BOOL	IsDoublePageSpread ()
void	SetDoublePageSpread (BOOL State)
FIXED16	GetScale ()
void	SetScale (FIXED16 NewScale)
	Sets the scale percentage, altering dependants automatically (unless importing) Dependants are: ScaledWidth ScaledHeight.
PrintOrient	GetPrintOrient ()
void	SetPrintOrient (PrintOrient NewOrient)
	Sets the print orientatio, altering dependants automatically (unless importing).
PrintFitType	GetFitType ()
void	SetFitType (PrintFitType NewFitType)
	Sets the fit type, altering dependants automatically (unless importing).
TypesetInfo *	GetTypesetInfo ()
INT32	GetTopMargin ()
void	SetTopMargin (INT32 NewVal)
INT32	GetLeftMargin ()
void	SetLeftMargin (INT32 NewVal)
INT32	GetWidth ()
void	SetWidth (INT32 NewVal)
	Sets the page width, altering dependants automatically (unless importing) Dependants are: Scale ScaledHeight.
INT32	GetHeight ()
void	SetHeight (INT32 NewVal)
	Sets the page height, altering dependants automatically (unless importing) Dependants are: Scale ScaledWidth.
INT32	GetRows ()
BOOL	SetRows (INT32 NewVal)
	Adjust the printing variables to allow for typesetting marks to be positioned What happens here is that we adjust the X,Y translations so that we ensure a patch is moved into a position where we can get the crop marks between the patch and the papers edges.Sets the number of pages in each printed column, altering dependants automatically (unless importing) Dependants are: Scale ScaledWidth ScaledHeight Columns.
INT32	GetColumns ()
BOOL	SetColumns (INT32 NewVal)
	Sets the number of pages in each printed column, altering dependants automatically (unless importing) Dependants are: Scale ScaledWidth ScaledHeight Rows.
INT32	GetGutter ()
BOOL	SetGutter (INT32 NewVal)
	Sets the gutter measurement, altering dependants automatically (unless importing).
PrintLayers	GetPrintLayers ()
void	SetPrintLayers (PrintLayers NewVal)
PSLevel	GetPSLevel ()
void	SetPSLevel (PSLevel NewVal)
PrintMethodType	GetPrintMethod ()
	Returns the app's print method. This is stored in the global var AppPrintMethod.
void	SetPrintMethod (PrintMethodType NewVal)
	Sets the app's print method to be NewVal This is stored in the global var AppPrintMethod.
BitmapResMethod	GetBitmapResMethod ()
void	SetBitmapResMethod (BitmapResMethod BRM)
INT32	GetDotsPerInch ()
	If the bitmap res setting is manual then the value the user entered is returned. If the bitmap res setting is automatic, then base the DPI on the printer's DPI.
void	SetDotsPerInch (INT32 NewVal)
	Ensures the NewVal is not < MINBITMAPDPI.
PrintFillQuality	GetFillQuality ()
void	SetFillQuality (PrintFillQuality Qual)
PrintTextOptions	GetTextOptions ()
void	SetTextOptions (PrintTextOptions pto)
BOOL	IsCollated ()
void	SetCollated (BOOL NewVal)
INT32	GetNumCopies ()
void	SetNumCopies (INT32 NewVal)
BOOL	GetPrintToFile ()
void	SetPrintToFile (BOOL NewVal)
PrintRangeObj	GetObjPrintRange ()
	Find out the object range the user wants to print to.
void	SetObjPrintRange (PrintRangeObj NewVal)
PrintRangeDPS	GetDPSPrintRange ()
void	SetDPSPrintRange (PrintRangeDPS NewVal)
INT32	GetNumPrintablePages ()
	This tells you how many individual pages are printable, given the current settings.
PrintControl &	operator= (PrintControl &other)
	The assignment operator for PrintControl.
BOOL	StartPrinting ()
	This informs the print info object that you are about to do some printing.
BOOL	MorePaper ()
	Call this for each piece of paper to be printed to.
BOOL	GetNextPaper ()
	Call this for each piece of paper to be printed to. NB: You must call StartPrinting() before calling this func as part of your print loop.
BOOL	ReprintPaper ()
	This allows you to print on the same piece of paper again.
BOOL	GetNextPatch (PrintPatchInfo *pPatchInfo)
	Each time this func returns TRUE, print the page using the data set up by this call.
BOOL	EndPrinting ()
	This informs the print info object that you have finished printing.
BOOL	StartPlatePrinting (PrintView *pPrintView, UINT32 *const errID)
	This function makes sure the plate printing loop is initialised for the next set of pages on a single sheet of paper to pass through the driver. It sets up an appropriate ColourPlate and ColourCOntextCMYK for the given PrintView.
BOOL	MorePlates ()
	Call this to determin whether there are more plates to print during this separation.
BOOL	SetNextPlate (PrintView *pPrintView)
	Call this to set up the view related data ready for the next plate rendering.
void	EndPlatePrinting (PrintView *pPrintView)
	This function makes sure the plate printing loop is shut down correctly. We need to make sure that the last plate is detached from the colour context inside the print view, otherwise when the print view is destroyed the plate in the colour context in the print view will be destroyed. As our printer dialogue keeps this in its list, we need to make sure it only gets deleted once during that lists destruction.
void	StartImport ()
	Tells the object that it's data is being imported.
void	EndImport ()
	Tells the object that it's data is no longer being imported.
void	RenderPrintBorder (RenderRegion *pRRegion)
	Renders the printable area on the spread according to the current print layout method.
Static Public Member Functions
static BOOL	RedrawPrintableArea (DocView *pDocView)
	This func can be passed as a param to Document::ForceRedraw() and hence can control which views get redraw. This func ensures that only views that are showing print borders get redrawn.
Static Public Attributes
static PrintMethodType	AppPrintMethod = PRINTMETHOD_NORMAL
Private Member Functions
BOOL	CalcNumPaper ()
	This works out how many pieces of paper we will print to. NB: This can be different to the number of pieces of paper that comes out of the printer when the printer can do multiple copies and we are in a position to exploit this.
void	SetScaleFactor (double ScaleFactor)
	Sets the scale percentage using the given scale factor This alters dependants automatically (unless importing) Dependants are: ScaledWidth ScaledHeight.
BOOL	CalcPrintAreaVars (BOOL RedrawPrintBorders=TRUE)
	This function calcs member vars dependant on the total print area. The print area can be set up using SetUp().
BOOL	CalcFit ()
	Recalcs the scale factor needed to fit the current page in the specified orientation, using the currently set fit type.
void	CalcMultipleFit (INT32 NumRows, INT32 NumColumns, INT32 GutterVal, INT32 Wd, INT32 Ht, INT32 Extra)
	Recalcs the scale factor required for each page to fit the specified number of rows and columns, and gutter distance, to the paper.
INT32	GetCropAdjust () const
	Return the size of the extra area we need to take into account when fitting pages onto the printable paper. Currently the bleed size and crop area size is used.
double	CalcPatchWidth (INT32 PaperWidth, INT32 NumColumns, INT32 GutterVal)
	The patch width = (width of the paper / num columns) - gutter.
double	CalcPatchHeight (INT32 PaperHeight, INT32 NumRows, INT32 GutterVal)
	The patch Height = (Height of the paper / num rows) - gutter.
INT32	CalcMaxRows (INT32 GutterVal)
	Dynamically calcs the max num rows possible, given the current paper width and gutter setting.
INT32	CalcMaxColumns (INT32 GutterVal)
	Dynamically calcs the max num columns possible, given the current paper height and gutter setting.
INT32	CalcMaxGutter (INT32 NumRows, INT32 NumColumns)
	Dynamically calcs the max gutter value based on the given number of rows and columns, and the current paper size.
void	RenderRect (RenderRegion *pRRegion, DocRect Rect, BOOL Fill)
	Renders the rect given.
Private Attributes
BOOL	Printing
BOOL	SelectionPresent
DocRect	PatchClipRect
INT32	NumPrintablePages
INT32	NumPaper
INT32	PaperNumber
INT32	MaxPaperNumber
BOOL	Reprint
INT32	NumPatches
INT32	PatchNumber
INT32	MaxPatchNumber
INT32	PatchRow
INT32	PatchColumn
MILLIPOINT	SectionWidth
MILLIPOINT	SectionHeight
BOOL	PrintAreaSetUp
BOOL	SetUpFailed
Spread *	pSpread
DocRect	TotalPrintArea
DocRect	PrintableArea
INT32	PALeftMargin
INT32	PATopMargin
DocCoord	Origin
INT32	PageWidth
INT32	PageHeight
INT32	PaperWidth
INT32	PaperHeight
INT32	OrigPageWidth
INT32	OrigPageHeight
BOOL	DPS
MILLIPOINT	Bleed
MILLIPOINT	CropArea
BOOL	WholeSpread
FIXED16	Scale
PrintOrient	Orient
PrintFitType	FitType
INT32	TopMargin
INT32	LeftMargin
INT32	ScaledWidth
INT32	ScaledHeight
INT32	CropTopMargin
INT32	CropLeftMargin
INT32	Rows
INT32	Columns
INT32	Gutter
TypesetInfo	Typesetting
PrintLayers	Layers
PSLevel	PSLangLevel
BitmapResMethod	BitmapResolutionMethod
INT32	DotsPerInch
PrintFillQuality	FillQuality
PrintTextOptions	TextOptions
BOOL	Collated
INT32	NumCopies
BOOL	PrintToFile
PrintRangeObj	ObjPrintRange
PrintRangeDPS	DPSPrintRange
BOOL	UpdateDependants

---

Detailed Description

This class encapsulates all the print settings for a document, and controls how the document pages are printed on the paper.

Author:

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

Date:

27/3/95

See also:

OptionsTabs; AppPrefsDlg; DocPrefsDlg;

Definition at line 309 of file printctl.h.

---

Constructor & Destructor Documentation

PrintControl::PrintControl (   )

Default constructor. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 27/3/95 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Definition at line 179 of file printctl.cpp. { PrintAreaSetUp = FALSE; // We haven't set the control up with a print area yet SetUpFailed = FALSE; // We haven't called SetUp yet, so we haven't failed yet pSpread = NULL; TotalPrintArea = DocRect(0,0,A4_WIDTH,A4_HEIGHT); PrintableArea = TotalPrintArea; PALeftMargin = 0; PATopMargin = 0; Origin = DocCoord(0,A4_HEIGHT); PageWidth = A4_WIDTH; PageHeight = A4_HEIGHT; PaperWidth = A4_WIDTH; PaperHeight = A4_HEIGHT; DPS = FALSE; Bleed = 0; CropArea = CROPAREA_SIZE+OUTSIDEBLEEDWIDTH; CropTopMargin = 0; CropLeftMargin = 0; // Print layout vars WholeSpread = FALSE; Scale = FIXED16(100); Orient = PRINTORIENTATION_UPRIGHT; FitType = PRINTFIT_BESTPAPER; TopMargin = 0; LeftMargin = 0; ScaledWidth = A4_WIDTH; ScaledHeight= A4_HEIGHT; Rows = 1; Columns = 1; Gutter = 0; // Print output vars Layers = PRINTLAYERS_VISIBLEFOREGROUND; // Job 10463: remove PS Level bits - default to Level 2 PSLangLevel = PSLEVEL_2; // PrintMethod = CurrentPrintMethod; BitmapResolutionMethod = BITMAPRES_AUTO; DotsPerInch = 150; FillQuality = PRINTFILLQUALITY_MEDIUM; TextOptions = PRINTTEXTOPTIONS_NORMAL; // General print vars Collated = FALSE; NumCopies = 1; PrintToFile = FALSE; ObjPrintRange = PRINTRANGEOBJ_ALL; DPSPrintRange = PRINTRANGEDPS_BOTH; // Misc UpdateDependants = TRUE; // Print layout var initialisation Printing = FALSE; };

PrintControl::~PrintControl (   )

Default deconstructor. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 27/3/95 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: PrintControl()PrintControl() Definition at line 259 of file printctl.cpp. { // Does nowt as yet }

---

Member Function Documentation

String_256 PrintControl::BuildPaperSizeStr (   )

This uses the printer settings to build the string displayed in the paper size field of a print options tab. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 7/4/95 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: Returns the paper size string Errors: - See also: - Definition at line 415 of file printctl.cpp. { String_256 Str = TEXT(""); String_256 TempStr = TEXT(""); // If no print area set up, then assume we have no printer connected if (!PrintAreaSetUp) return Str; DimScale* pDimScale = NULL; if (pSpread != NULL) pDimScale = DimScale::GetPtrDimScale(pSpread); if (pDimScale != NULL) { BOOL ActiveState = pDimScale->IsActive(); pDimScale->SetActiveState(FALSE); pDimScale->ConvertToUnits(PaperWidth,&TempStr); Str += TempStr; Str += String_32(_R(IDS_NUM_BY_NUM)); pDimScale->ConvertToUnits(PaperHeight,&TempStr); Str += TempStr; // WEBSTER-ranbirr-13/11/96 #ifndef WEBSTER INT32 PrScale; if (CCPrintDialog::GetScale(&PrScale)) { if (PrScale != 100) { Str += String_256(_R(IDS_PRINT_PRINTERSCALING)); TCHAR s[100]; String_32 jcf(_R(IDS_PERCENT_FORMAT)); camSprintf(s, jcf, (INT32) PrScale); Str += s; } } #endif //webster pDimScale->SetActiveState(ActiveState); } return Str; }

String_256 PrintControl::BuildPrintInfoStr (   )

This uses the print control's settings to build the string displayed in the print info field of a print dlg. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 7/4/95 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: Returns the print info string Errors: - See also: - Definition at line 280 of file printctl.cpp. { String_256 Str; switch (FitType) { case PRINTFIT_BEST: Str = String_256(_R(IDS_PRINT_BESTFIT)); break; case PRINTFIT_CUSTOM: Str = String_256(_R(IDS_PRINT_CUSTOMFIT)); break; case PRINTFIT_MULTIPLE: Str = String_256(_R(IDS_PRINT_MULTIPLEFIT));break; case PRINTFIT_BESTPAPER:Str = String_256(_R(IDS_PRINT_BESTFITPAPER)); break; default: ERROR3_PF(("Unknown fit type (%d)",FitType)); break; } TCHAR* format = _T("%.2lf%%"); double fScale = Scale.MakeDouble(); INT32 n = INT32((fScale*100)+0.5); if (n % 100 == 0) format = _T("%.0lf%%"); else if (n % 10 == 0) format = _T("%.1lf%%"); TCHAR s[100]; camSprintf(s,format,fScale); Str += s; switch (Orient) { case PRINTORIENTATION_UPRIGHT: Str += String_256(_R(IDS_PRINT_UPRIGHT)); break; case PRINTORIENTATION_SIDEWAYS: Str += String_256(_R(IDS_PRINT_SIDEWAYS)); break; default: ERROR3_PF(("Unknown orientation (%d)",Orient)); break; } // If no print area set up, then assume we have no printer connected if (!PrintAreaSetUp) { Str += String_256(_R(IDS_PRINT_NOPRINTER)); return Str; } // Work out how many pages will get completely printed UINT32 NumPages = 1; UINT32 IDSPlural = _R(IDS_PRINT_PAGES); UINT32 IDSSingular = _R(IDS_PRINT_PAGE); switch (FitType) { case PRINTFIT_BEST: case PRINTFIT_BESTPAPER: NumPages = 1; break; case PRINTFIT_MULTIPLE: NumPages = 0; if (StartPrinting()) { GetNextPaper(); PrintPatchInfo PatchInfo; while (GetNextPatch(&PatchInfo)) { DocRect Rect = PatchInfo.GetClipRect(FALSE,FALSE); double ScaleFactor = PatchInfo.Scale.MakeDouble() / 100; INT32 w = Rect.Width(); INT32 h = Rect.Height(); if (PatchInfo.Rotate) { INT32 t = w; w = h; h = t; } Rect.lo.x = PatchInfo.XTrans; Rect.lo.y = PatchInfo.YTrans; Rect.hi.x = Rect.lo.x + (INT32((double(w) * ScaleFactor)+0.5)); Rect.hi.y = Rect.lo.y + (INT32((double(h) * ScaleFactor)+0.5)); if (PrintableArea.ContainsRect(Rect)) NumPages++; } EndPrinting(); } IDSPlural = _R(IDS_PRINT_TILES); IDSSingular = _R(IDS_PRINT_TILE); break; case PRINTFIT_CUSTOM: { DocRect Rect(0,PaperHeight-ScaledHeight,ScaledWidth,PaperHeight); INT32 CropAdj = GetCropAdjust(); INT32 TransX = LeftMargin + CropAdj; INT32 TransY = TopMargin + CropAdj; Rect.Translate(TransX,-TransY); if (PrintableArea.ContainsRect(Rect)) NumPages = 1; else NumPages = 0; } break; } if (NumPages >= 1) { camSprintf(s, TEXT("%ld") ,NumPages); Str += s; if (NumPages == 1) Str += String_256(IDSSingular); else Str += String_256(IDSPlural); } else Str += String_256(_R(IDS_PRINT_NOPAGESFIT)); return Str; }

BOOL PrintControl::CalcFit (   )  [private]

Recalcs the scale factor needed to fit the current page in the specified orientation, using the currently set fit type. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/95 Parameters: -  [INPUTS] Returns: TRUE if a recalc took place, FALSE if nothing has been recalced This will only do anything when UpdateDependants is TRUE See also: CalcMultipleFit() Definition at line 1126 of file printctl.cpp. { static BOOL IgnoreCall = FALSE; if (!UpdateDependants) return FALSE; if (IgnoreCall) // Stop re-entrant calls to this function return TRUE; IgnoreCall = TRUE; // Set these value to absolutely ziltch CropTopMargin=0; CropLeftMargin=0; switch (FitType) { case PRINTFIT_MULTIPLE: { INT32 PAWidth = PaperWidth; INT32 PAHeight = PaperHeight; INT32 CropAdjust = GetCropAdjust(); PAWidth -= (CropAdjust<<1); PAHeight -= (CropAdjust<<1); CalcMultipleFit(Rows,Columns,Gutter,PAWidth,PAHeight,0); // these settings just show to the user whats happening in the dialogue // they do not get used explicitly to position the pages. if ((Rows==1) && (Columns==1)) { LeftMargin = (PaperWidth -ScaledWidth) /2; TopMargin = (PaperHeight-ScaledHeight)/2; } } break; case PRINTFIT_BEST: { INT32 PAWidth = PrintableArea.Width(); INT32 PAHeight = PrintableArea.Height(); INT32 CropAdjust = GetCropAdjust(); PAWidth -= (CropAdjust<<1); PAHeight -= (CropAdjust<<1); BOOL PAOrient = ((double(PAWidth) / double(PAHeight)) <= 1.0); BOOL PageOrient = ((double(OrigPageWidth) / double(OrigPageHeight ))<= 1.0); PrintOrient NewOrient; if (PAOrient == PageOrient) NewOrient = PRINTORIENTATION_UPRIGHT; else NewOrient = PRINTORIENTATION_SIDEWAYS; if (NewOrient != Orient) SetPrintOrient(NewOrient); CalcMultipleFit(1,1,0,PAWidth,PAHeight,0); PAWidth += (CropAdjust<<1); PAHeight += (CropAdjust<<1); LeftMargin = PALeftMargin+((PAWidth -ScaledWidth) /2); TopMargin = PATopMargin +((PAHeight-ScaledHeight)/2); } break; case PRINTFIT_CUSTOM: { INT32 CropAdjust = GetCropAdjust(); CropLeftMargin = CropAdjust; CropTopMargin = CropAdjust; SetScale(Scale); } break; case PRINTFIT_BESTPAPER: // Best fit the document paper size onto the printed page // without scaling, distortion or clipping { INT32 PAWidth = PaperWidth; INT32 PAHeight = PaperHeight; INT32 CropAdjust = GetCropAdjust(); PAWidth -= (CropAdjust<<1); PAHeight -= (CropAdjust<<1); // Compute aspect of document and aspect of printed page // TRUE means rect is portrait orientation, taller than it is wide... BOOL PAOrient = (double(PAWidth) <= double(PAHeight)); BOOL PageOrient = (double(OrigPageWidth) <= double(OrigPageHeight)); PrintOrient NewOrient; if (PAOrient == PageOrient) NewOrient = PRINTORIENTATION_UPRIGHT; else NewOrient = PRINTORIENTATION_SIDEWAYS; if (NewOrient != Orient) SetPrintOrient(NewOrient); CropLeftMargin = CropAdjust; CropTopMargin = CropAdjust; SetScale(100.0); // PAWidth += (CropAdjust<<1); // PAHeight += (CropAdjust<<1); // Centre document page within printed page LeftMargin = (PAWidth - ScaledWidth) / 2; TopMargin = (PAHeight - ScaledHeight) / 2; } break; default: ERROR3_PF(("Unknown fit type (%d)",FitType)); IgnoreCall = FALSE; return FALSE; } IgnoreCall = FALSE; return TRUE; }

INT32 PrintControl::CalcMaxColumns (  INT32  GutterVal  )  [private]

Dynamically calcs the max num columns possible, given the current paper height and gutter setting. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/95 Parameters: GutterVal  = the gutter value to use [INPUTS] Returns: Max num columns for the current paper height and gutter setting This is based on the min scale factor allowed See also: - Definition at line 995 of file printctl.cpp. { INT32 MaxColumns = 0; double MinScaleFactor = double(MinPrintScale)/100; double PatchWidth,ScaleFactor; do { MaxColumns += 1; PatchWidth = CalcPatchWidth(PaperWidth,MaxColumns,GutterVal); ScaleFactor = PatchWidth / PageWidth; } while (ScaleFactor >= MinScaleFactor); if (MaxColumns > 1) MaxColumns -= 1; return MaxColumns; }

INT32 PrintControl::CalcMaxGutter (  INT32  NumRows, INT32  NumColumns )  [private]

Dynamically calcs the max gutter value based on the given number of rows and columns, and the current paper size. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/95 Parameters: NumRows  = num rows to base calc on [INPUTS] NumColumns = num columns to base calc on Returns: Max gutter value See also: - Definition at line 1029 of file printctl.cpp. { double MinScaleFactor = double(MinPrintScale)/100; double PatchWidth = CalcPatchWidth(PaperWidth,NumColumns,0); double PatchHeight = CalcPatchHeight(PaperHeight,NumRows,0); INT32 MaxGutterWidth = INT32((PatchWidth - (double(PageWidth) *MinScaleFactor))+0.5); INT32 MaxGutterHeight = INT32((PatchHeight - (double(PageHeight)*MinScaleFactor))+0.5); if (MaxGutterWidth < MaxGutterHeight) return MaxGutterWidth; else return MaxGutterHeight; }

INT32 PrintControl::CalcMaxRows (  INT32  GutterVal  )  [private]

Dynamically calcs the max num rows possible, given the current paper width and gutter setting. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/95 Parameters: GutterVal  = the gutter value to use [INPUTS] Returns: Max num rows for the current paper width and gutter setting This is based on the min scale factor allowed See also: - Definition at line 960 of file printctl.cpp. { INT32 MaxRows = 0; double MinScaleFactor = double(MinPrintScale)/100; double PatchHeight,ScaleFactor; do { MaxRows += 1; PatchHeight = CalcPatchHeight(PaperHeight,MaxRows,GutterVal); ScaleFactor = PatchHeight / PageHeight; } while (ScaleFactor >= MinScaleFactor); if (MaxRows > 1) MaxRows -= 1; return MaxRows; }

void PrintControl::CalcMultipleFit (  INT32  NumRows, INT32  NumColumns, INT32  GutterVal, INT32  Wd, INT32  Ht, INT32  Extra )  [private]

Recalcs the scale factor required for each page to fit the specified number of rows and columns, and gutter distance, to the paper. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/95 Parameters: NumRows  = num rows to fit on paper [INPUTS] NumColumns = num columns to fit on paper GutterVal = gutter distance between each page Wd = Width of paper Ht = Height of paper Extra = An adjustment made to the page size (usually 0) Returns: - Dependants are: Scale ScaledWidth ScaledHeight See also: StartImport() & EndImport() Definition at line 1070 of file printctl.cpp. { // Calc the width and height of each patch on the page, taking into account the given gutter value double PatchWidth = CalcPatchWidth(Wd,NumColumns,GutterVal); double PatchHeight = CalcPatchHeight(Ht,NumRows,GutterVal); // Work out the scale factor required to get the width of the page into this patch double ScaleFactor = PatchWidth / double(PageWidth+Extra); // Calc the new width and height of each page by applying the scale factor double NewWidth = PageWidth * ScaleFactor; double NewHeight= PageHeight * ScaleFactor; // If the scale factor made using the page width and patch width means that the page does NOT entirely // fit into a multiple-fit patch, then use the scale factor generated using the patch height and page height // // (NB: We add 1.0 to these values so that the '>' comparisons don't fail due to insignificant floating point errors). // if ((NewWidth > (PatchWidth+1.0)) || (NewHeight > (PatchHeight+1.0))) ScaleFactor = PatchHeight / double(PageHeight+Extra); #ifdef _DEBUG { // In theory, when the scale factor is applied to the page width and height, the page will fit // entirely into a patch. However, we still better check this is true when in debug builds NewWidth = PageWidth * ScaleFactor; NewHeight= PageHeight * ScaleFactor; if ((NewWidth > (PatchWidth+1.0)) || (NewHeight > (PatchHeight+1.0))) { ERROR3("Multiple fit scale factor does not fit page into patch"); } } #endif SetScaleFactor(ScaleFactor); // Use SetScaleFactor() to recalc ScaledWidth and ScaledHeight }

BOOL PrintControl::CalcNumPaper (   )  [private]

This works out how many pieces of paper we will print to. NB: This can be different to the number of pieces of paper that comes out of the printer when the printer can do multiple copies and we are in a position to exploit this. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 18/4/95 Parameters: -  [INPUTS] NumPaper  = The number of pieces of paper we will print to [OUTPUTS] Returns: TRUE if it was able to cal num paper to print to, FALSE otherwise It takes into account DPS, whole spread & left or right-only settings. It also takes into account the collated flag & the ability of the printer to do multiple copies. The number of pieces of paper that the printer will produce at the end of the print job = number of printable pages * num copies If the output is colla See also: GetDotsPerInch() Definition at line 1753 of file printctl.cpp. { BOOL CanMultiCopy=TRUE; // WEBSTER-ranbirr-13/11/96 #ifndef WEBSTER // Can the printer do multiple copies? if (!CCPrintDialog::CanMultiCopy(&CanMultiCopy)) return FALSE; #endif //webster INT32 NumActualPiecesOfPaper = NumPrintablePages * NumCopies; // Num pieces of paper that will come out of printer // NumPaper will be the number of pieces of paper we will print to // Default to the number printable of pages NumPaper = NumPrintablePages; if (NumPrintablePages == 1) { // If the printer can't cope with multiple copies, we'll have to do them all if (!CanMultiCopy) NumPaper = NumActualPiecesOfPaper; } else { // If the printer can't cope with multiple copies OR we need to collate the output // we'll have to do them all if (Collated || !CanMultiCopy) NumPaper = NumActualPiecesOfPaper; } return TRUE; }

double PrintControl::CalcPatchHeight (  INT32  Ht, INT32  NumRows, INT32  GutterVal )  [private]

The patch Height = (Height of the paper / num rows) - gutter. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/95 Parameters: Ht  = Height of paper [INPUTS] NumRows = number of rows across the paper Gutter = gutter distance between each page Returns: The Height of each patch for multiple fit printing See also: - Definition at line 939 of file printctl.cpp. { return ((double(Ht) / double(NumRows)) - double(GutterVal)); }

double PrintControl::CalcPatchWidth (  INT32  Wd, INT32  NumColumns, INT32  GutterVal )  [private]

The patch width = (width of the paper / num columns) - gutter. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/95 Parameters: Wd  = Width of paper [INPUTS] NumColumns = number of columns down the paper Gutter = gutter distance between each page Returns: The width of each patch for multiple fit printing See also: - Definition at line 919 of file printctl.cpp. { return ((double(Wd) / double(NumColumns)) - double(GutterVal)); }

BOOL PrintControl::CalcPrintAreaVars (  BOOL  RedrawPrintBorders = TRUE  )  [private]

This function calcs member vars dependant on the total print area. The print area can be set up using SetUp(). Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/95 Parameters: RedrawPrintBorders  - True if want a force redraw of associated docs (Defaults to TRUE) [INPUTS] -  [OUTPUTS] Returns: TRUE if able to recalc Dependants are: PageWidth PageHeight Origin PrintableArea It takes into account orientation, and whether its a double page spread (DPS). If it's a DPS, it also takes the WholeSpread setting into account NOTE: This func also finds out the width and height of the printer's paper using CCPrintDialog::GetPaperSize(), and calcs the paper's area too Returns: Errors: - See also: SetUp() Definition at line 619 of file printctl.cpp. { // Calc the print area origin Origin.x = TotalPrintArea.lo.x; Origin.y = TotalPrintArea.hi.y; //------------------------- // Find out the dimensions of the printer's paper (in MILLIPOINTS) wxSize PaperSize; // WEBSTER-ranbirr-13/11/96 #ifndef WEBSTER if (!CCPrintDialog::GetPaperSize(&PaperSize, RedrawPrintBorders)) return FALSE; #endif //webster PaperWidth = PaperSize.GetWidth(); PaperHeight = PaperSize.GetHeight(); // ------------------------ // Get the printable area on the paper (defined relative to a origin at the bottom left of paper) // and the top & left margins of the printable area // WEBSTER-ranbirr-13/11/96 #ifndef WEBSTER if (!CCPrintDialog::GetPrintableArea(&PrintableArea)) return FALSE; if (!CCPrintDialog::GetPrintMargins(&PALeftMargin,&PATopMargin)) return FALSE; #endif //webster //------------------------- // Calc the width and height of the print area PageWidth = TotalPrintArea.hi.x - TotalPrintArea.lo.x; PageHeight = TotalPrintArea.hi.y - TotalPrintArea.lo.y; // If double page spread AND printing single pages, half the width for each page printed if (DPS && !WholeSpread) (PageWidth) /= 2; // Save the orig values in case PageWidth & PageHeight need to be swapped due to sideways orientation OrigPageWidth = PageWidth; OrigPageHeight = PageHeight; // If printing sideways, the width and height of the printed page should be swapped if (Orient == PRINTORIENTATION_SIDEWAYS) Swap(PageWidth,PageHeight); return TRUE; }

void PrintControl::EndImport (   )

Tells the object that it's data is no longer being imported. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 10/4/95 Parameters: -  [INPUTS] See also: