A PDF page may contain a /Rotate attribute set to 90, 180 or 270 (degrees), which makes this page appear in the landscape mode or upside-down. By default, the ToImage method takes the Rotate value into account to orient the image appropriately. If, for whatever reason, the Rotate value needs to be ignored, the parameter IgnoreRotate should be set to True.

Set Preview = Page.ToImage( "...; IgnoreRotate=True" )

Also, some PDF pages contain /MediaBox and /CropBox attributes which are different from each other. By default, the ToImage method uses the CropBox attribute to calculate the dimensions of the resultant image, which is consistent with the behavior of all major PDF viewers. If, for whatever reason, the MediaBox attribute needs to be used instead (which usually covers a larger area than the CropBox), the parameter IgnoreCropBox should be set to True. This may cause the image to include areas of the page that are normally invisible when viewed in a PDF viewer.

Set Preview = Page.ToImage( "...; IgnoreCropBox=True" )

As an additional bonus, the PdfPreview object is capable of extracting images from a PDF page. The method PdfPreview.ExtractImage returns a new instance of the PdfPreview object representing an image specified by a 1-based index. This image can then be saved the regular way, via the methods Save, SaveToMemory or SaveHttp. If the specified index exceeds the number of images on the page, ExtractImage returns Nothing (or null in C#.)

The images are always saved as PNGs as this is PdfPreview's format of choice.

The following code snippet opens a PDF documents and saves all of the images from page 1 to disk:

VBScript

Set PDF = Server.CreateObject("Persits.PDF") Set Doc = PDF.OpenDocument("c:\path\document.pdf") Set Page = Doc.Pages(1) Set Preview = Page.ToImage i = 1 Do While True    Set Image = Preview.ExtractImage(i)    If Image Is Nothing Then       Exit Do    Else       Image.Save "c:\path\image.png", False    End If    i = i + 1 Loop

C#

IPdfManager objPDF = new PdfManager(); IPdfDocument objDoc = objPDF.OpenDocument( @"c:\path\document.pdf", Missing.Value ); IPdfPreview objPreview = objDoc.Pages[1].ToImage(Missing.Value); int i = 1; IPdfPreview objImage; while( ( objImage = objPreview.ExtractImage(i++) ) != null ) {    objImage.Save( @"c:\myprojects\aspdf\asp\files\image.png", false ); }

As of Version 2.1, the PdfPreview object offers automatic printing functionality via the method SendToPrinter. This method sends the image of a page contained in this PdfPreview object to a printer.

The SendToPrinter method accepts two arguments: the network name of the printer and, optionally, a parameter list adjusting the appearance of the printout.

The print quality is determined by the resolution of the image being printed. It is therefore recommended that the ResolutionX and ResolutionY parameters to the ToImage method be set to at least 300 or, better yet, 600.

By default, the SendToPrinter method prints the image as it is, without stretching it. If the parameter Stretch is set to True, the image is stretched to cover the entire print area. Additionaly, you can use the parameters ScaleX and ScaleY to scale the image up or down. For example, the values "ScaleX = 0.5; ScaleY= 0.5" scales the image down by 50%.

The following code sample sends page 2 of c:\path\document.pdf to the printer. The image is stretched to cover the entire print area.

VBScript

Set PDF = Server.CreateObject("Persits.PDF") Set Doc = PDF.OpenDocument("c:\path\document.pdf") Set Page = Doc.Pages(2) Set Preview = Page.ToImage("ResolutionX=600; ResolutionY=600") Preview.SendToPrinter "\\192.168.1.2\HP LaserJet 6P", "Stretch=true"

C#

IPdfManager objPDF = new PdfManager(); IPdfDocument objDoc = objPDF.OpenDocument( @"c:\path\document.pdf", Missing.Value ); IPdfPage objPage = objDoc.Pages[2]; IPdfPreview objPreview = objPage.ToImage("ResolutionX=600; ResolutionY=600"); objPreview.SendToPrinter( @"\\192.168.1.2\HP LaserJet 6P", "Stretch=true" );

You may encounter the error "Access is denied" when attempting to send the image to a network printer. To avoid the error, you need to impersonate an interactive user account with the LogonUser method of the PdfManager object, as follows:

VBScript

... PDF.LogonUser "domain", "username", "password" Preview.SendToPrinter "\\192.168.1.2\HP LaserJet 6P", "Stretch=true"

C#

... objPDF.LogonUser( "domain", "username", "password", Missing.Value ); objPreview.SendToPrinter( @"\\192.168.1.2\HP LaserJet 6P", "Stretch=true" );

The LogonUser method was added in Version 2.1 as well. The first argument is a Windows domain and can be an empty string. The 2nd and 3rd arguments are the username and password of the account to be impersonated. The 4th argument is the login type and usually omitted.