-pdfscale

-pdfscale ScaleOptions [xScale yScale]

The -pdfscale option allows scaling of the resulting image when converted to PDF.  For some cases, scaling of the image within the PDF page may be necessary to not allow distortion of the image.

The ScaleOptions should be one of the following:

The fitpage option fits the acquired images to the size of the page.  The effect will be the "stretching" or contraction of the image in the x and y direction to fit the page.  This is desirable if you have acquired using standard size paper (Letter, A4, etc.) and you would like to see the entire page filled with the image.

The noscale option does not fit the image to the page.  When placing an image within a PDF page, each pixel of the image corresponds to a point of the PDF page.  For example, if an image is 600 x 800, and the PDF page is letter (612 x 792 points), the image will fit within the width of the PDF file (600 < 612), but the height will not fit ( 800 > 792).  If the image is too large to fit the width or height, the image is clipped.  Use the noscale option if you are acquiring very small images, but you do not want these images to be stretched to fit the page.

To specifiy a custom scaling, the custom scaling option is used, along with the scaling factor of the width and height of the image.  The xScale and yScale arguments specify the scaling in the width and height, respectively.  The xScale and yScale arguments must be in percent and must be greater than 0.0.  This means that a value of 100.0 is essentially no scaling.

Example:

Fits the image to the page.

DTWAIN_TwainSave("-F pdf -pdfscale fitpage (..other options..)");

Scales the image to half its original size, both in the width and the height:

DTWAIN_TwainSave("-F pdf -pdfscale \"custom 50 50\" (..other options..)");

Scales the image to half its original size in the width, and 75% in the height

DTWAIN_TwainSave("-F pdf -pdfscale \"custom 50 75\" (..other options..))

If fitpage or noscale is specified, the xScale and yScale arguments are ignored.

Note that in the example above, C/C++ escape sequences are used to embed double quotes in the string.  Please consult your language as to the proper way to insert double quotes within quoted strings.

Default Setting:

fitpage