writeRegionBitmap2

This function converts a rectangular region of a PDF page to an image file on disk. This can be useful if the page is too large to fit in memory at the desired resolution, or if only part of the page is needed for some purpose. It is identical to writeRegionBitmap, except that it allows the horizontal and vertical resolutions to be controlled independently.

The rectangular region is specified by the x,y coordinates of its upper-left corner and its width and height - in bitmap coordinates, not PDF coordinates. That is, if the whole-page bitmap would have been 1000 pixels wide and 2000 pixels high, and you request a region with (x,y) = (0,0) and (w,h) = (1000,500), the resulting bitmap will be the top fourth of the page.

The arguments are:

• page = page number
• regionX, regionY = upper-left corner of region
• regionW, regionH = width and height of region
• dpi = resolution (dots per inch)
• color = color setting - one of:
  • imageMono: 1-bit monochrome
  • imageGray: 8-bit grayscale
  • imageRGB: 8-bit RGB
  • imageCMYK: 8-bit CMYK
  • imageDevNToCMYK: 8-bit CMYK, rasterized in DeviceN and then converted to CMYK
  • imageDevNToRGB: 8-bit RGB, rasterized in DeviceN and then converted to RGB
  • imageGrayToMono: 1-bit monochrome, rasterized in 8-bit grayscale and then converted to 1-bit
• format = image file format - one of:
  • imageFileBMP: Windows BMP format
    (available for mono, gray, RGB, DevNToRGB, GrayToMono)
  • imageFileTIFF: uncompressed TIFF format
    (available for mono, gray, RGB, CMYK, DevNToCMYK, DevNToRGB, GrayToMono)
  • imageFileJPEG: JPEG format
    (available for gray, RGB, CMYK, DevNToCMYK, DevNToRGB)
  • imageFilePNG: PNG format
    (available for mono, gray, RGB, DevNToRGB, GrayToMono)
  • imageFilePNM: PBM (monochrome), PGM (grayscale), or PPM (RGB) file - these formats are more commonly used on Unix
    (available for mono, gray, RGB, DevNToRGB, GrayToMono)
• fileName = image file name

Note that the color settings and image file formats are read-only properties on the COM component, so you'll need to use pdf.imageMono, pdf.imageFileBMP, etc.

The imageDevNToCMYK mode produces CMYK output like imageCMYK, but does the rasterization in DeviceN (CMYK + spot colors) so overprint previews will be more accurate.

The imageDevNToRGB mode is similar to imageDevNToCMYK, but converts to RGB output.

The imageGrayToMono mode does the rasterization in 8-bit grayscale and converts to 1-bit monochrome at the end. This is useful for files that use transparency – because 1-bit monochrome mode doesn't support transparency.

CMYK output is only available in TIFF format.