PDF2IMG

Running the PDF2IMG Software

PDF2IMG is a Datalogics application designed to convert a selected PDF or XPS document file into one or more image files, including BMP, EPS, GIF, JPEG, PNG, RAW or TIFF. You can also select PDF itself as an output format, and thus use PDF2IMG to export a PDF document to a series of other PDF documents, one PDF export file per page.

Only PDF2IMG Pro and Premium accept XPS as a file input format and support creating EPS or RAW output files.

The product offers several options for controlling Resolution, Color Model, Color Bit Depth and other settings, depending on output format selected.

For details on working with the PDF2IMGLIB library APIs, see the Appendix.

Command Line Syntax

The basic command line syntax for PDF2IMG is:

pdf2img [options] <inputFile> <outputForm>

Only the inputFile and outputForm arguments are required.

We provide many other optional arguments that you can use to create your own custom command line statements, to generate just the output you are looking for.

The PDF2IMG Pro and Premium versions of the software include the source code for the command line interpreter, pdf2img.cpp. You can use this source code with the enclosed Microsoft Visual C++ Project file (pdf2img.vcxproj) to do your own product development based on PDF2IMG.

Command Line Summary

Required Arguments

Only two command line arguments are required, <inputFile> and <outputForm>. All the rest are optional. The optional arguments can appear in any order in the command line argument, but they must come before <inputFile> and <outputForm>.

For details see Arguments and Options.

Argument name Description
inputFile Input PDF file name
outputForm Output graphic format, BMP, EPS, GIF, JPG, PDF, PNG, RAW, or TIF

Only PDF2IMG Pro and Premium support creating EPS or RAW output files.

Optional Arguments

Use the following optional arguments in any order, preceding the required <inputFile> and <outputForm> arguments. For example:

pdf2img -firstonly -colormodel=gray -bpc=1 -jpegquality=40 -resolution=72 input.pdf jpg

The two required arguments appear at the end, “input.pdf” as the file name (inputFile) and “jpg” as the output format (outputForm). Note that you don’t actually enter “inputFile” or “outputForm” as arguments in the command line statement, just the name of the input file and the type of output format you want.

Argument name Description
asprinted If specified, reverse the Annotation handling to suppress Image-only annotations and allow Print-only annotations

This command is only available with PDF2IMG Pro and Premium.

blackisone If specified, reverse the PhotometricInterpretation setting to be black=1 or white=0. Tiff only.
blendingspace Specify a blending color space by naming a profile description or providing a name and path of the profile (.icc) file. Default=CMYK

This command is only available with PDF2IMG Pro and Premium.

bpc Provide the number of bits used to represent each output color channel.
Default=8
colormodel Define the color model, cmyk, gray, lab, rgb, or rgba Default=rgb

The CMYK and Lab color spaces are only available with PDF2IMG Pro and Premium.

colorprofile Define the output ICC color profile Default determined by color space

This command is only available with PDF2IMG Pro and Premium.

compression Define the compression method, no, jpg, lzw, g3, g4
Default=lzw
digits If provided, use to specify the number of digits to use in the sequential output filename counter.
firstonly Convert only the first page of the input file
Default=all pages
fontlist If specified, a quoted semicolon-delimited list of alternate directories for font resources
help If specified, provide a list of available commands
ignoredefaultfonts If specified, ignore default font resource locations when searching for fonts at start up (default directories and current directory)
ignorewarn If specified, suppress warnings for non-renderable content.
intent Define the goal or priority for rendering intent for colors: perceptual, relative, saturation, absolute, profile Default=profile if color profile is specified, otherwise perceptual

This command is only available with PDF2IMG Pro and Premium.

jpegquality JPEG compression quality from 1 to 100. Higher values produce a better image but also a larger output file size.
JPG only, Default=75
maxbandmem Maximum memory to use per band of multiband conversion output in bytes.
JPG or TIFF only, Default=300000000
multipage If specified, produce one multipage TIFF output file of the requested name rather than the default of single-page sequentially-named output files.
TIFF only
noannot If specified, suppress viewable annotations
nocmm If specified, suppress Color Management Module

This command is only available with PDF2IMG Pro and Premium.

noenhancethinlines If specified, do not enhance thin lines when rendering
OPP If specified, enable Overprint Preview (OPP) in output

This command is only available with PDF2IMG Pro and Premium.

output Provide a prefix for output filename(s) to be created
Default=Input PDF filename plus sequence number
outputintent If specified, use the output intent dictionary value found in the source PDF document to define the output color profile to use when rasterizing a document.

This command is only available with PDF2IMG Pro and Premium.

pages If specified, a page or range of pages to process; such as 14-last or 2-9
password If specified, enter password string required to open the document for conversion.
pdfregion Define the region of PDF page to rasterize.
Options include art, bleed, bounding, crop, media, trim
Default=crop
pixelcount If specified, define an absolute picture size expressed as horizontal by vertical number of pixels. This can be used to specify a fixed number of pixels for the width and/or height of an output image, and thus scale the image up or down as needed to a specific output size and dimension.
profileCMYK Provide the name and location of the CMYK color profile or description of the color profile to use for CMYK values specified in uncalibrated (device) color values in the input PDF file. Default=Adobe Reader 9 CMYK

This command is only available with PDF2IMG Pro and Premium.

profileGray If specified, provide the name and location of the grayscale color profile or description of the color profile to use for grayscale values specified in uncalibrated (device) color values in the input PDF file. Default=Gray Gamma 2.2

This command is only available with PDF2IMG Pro and Premium.

profileRGB If specified, provide the name and location of the RGB color profile or description of the color profile to use for grayscale values specified in uncalibrated (device) color values in the input PDF file. Default=sRGB

This command is only available with PDF2IMG Pro and Premium.

removewhitespace If specified, direct PDF2IMG to remove the white space margins around the content on a page in the PDF document.
resampler Apply bicubic resampling: auto bicubic or none.
Default=auto
resolution Define the output resolution from 12 to 2400 in Dots per Inch.
Default=300
reverse If specified, use to create a negative image.
Grayscale output formats only
smoothing Specify to apply image antialiasing. Options include none, text, line, image, or all.