The OutputExtensions library extends the core output functionality with more advanced output capabilities. The ArcPress printer engine is implemented by this library.  For an example of how to use the ArcPress printer engine, see the PrintActiveViewArcPress sample.

 

This library is not extended by developers.

The following ArcPress Printer Engine functionality is described in more detail below:

 

Autoselecting the ArcPress driver

The ArcPress printer engine has several drivers that are meant for different makes and models of large-format printers.  To automatically select the appropriate driver for the given printer, pass the printer's name to the IArcPressPrinter.AutoSelectDriverByName method as shown in the following code.

 

//Autoselect the driver based on the printer's name.
pArcPressPrinter.AutoSelectDriverByName(m_MxApp.Paper.PrinterName);

After the call to AutoSelectDriverByName, check that a driver was selected using the SelectedDriverId property as shown in the following code.  If it is null, then the printer is not compatible with the ArcPress printer engine.

//If the printer cannot be autoselected, exit.
if (pArcPressPrinter.SelectedDriverId == null)
{
MessageBox.Show("Could not autoselect ArcPress driver for printer");
return;
}

Cast the IArcPressPrinter object onto the IPrinter object as shown in the following code.

 

 

//Transfer the ArcPress printer properties into pPrinter.
pPrinter = pArcPressPrinter as IPrinter;

Setting color options

The ArcPress printer driver contains several color-adjustment options such as Gamma, Brightness, Contrast, and Saturation.  These can be set using the SetColorAdjustment method.  To get the current color adjustment parameters, use the GetColorAdjustment method.  Note that lgammax100 is the decimal gamma value, multiplied by 1000; the default value of 2.2 becomes 220.  lbrightness defaults to zero.  The integer value can vary between -256 and 256.  Lastly, lcontrast and lsaturation default to 256 (which corresponds to the middle position on the slider), the value can vary between 0 and 512.  The values are internally limited, so if a value above the maximum or below the minimum is selected, they will be automatically set to the maximum or minimum value.

 

Setting the SavePaper option

The ArcPress printer driver can autorotate the print to save paper.  This property can be set to True to enable autorotation, or False to disable it.  ArcPress will only autorotate the print if the maximum printable area of the printer's largest page size will contain the rotated print job.