pdfConvertPageToBitmap3

The arguments are:

• page = page number
• hDPI = horizontal resolution (dots per inch)
• vDPI = vertical resolution (dots per inch)
• color = color setting - one of:
  • pdfImageMono: 1-bit monochrome
  • pdfImageGray: 8-bit grayscale
  • pdfImageRGB: 8-bit RGB
  • pdfImageCMYK: 8-bit CMYK
  • pdfImageDevNToRGB: 8-bit RGB, rasterized in DeviceN and then converted to RGB
  • pdfImageDevNToCMYK: 8-bit CMYK, rasterized in DeviceN and then converted to CMYK
  • pdfImageGrayToMono: 1-bit monochrome, rasterized in 8-bit grayscale and then converted to 1-bit
• reverseBytes = non-zero to store RGB color data in BGR order (this argument has no effect for pdfImageMono or pdfImageGray)
• rowPad = each row will be padded out to a multiple of this number of bytes (typically 1 for no padding, or 4 to pad to a 32-bit boundary)
• upsideDown = non-zero to store the bitmap with the bottom row first
• imgHdr = a struct describing the output bitmap, with the following fields:
  • width = image width
  • height = image height
  • color = the color argument passed to pdfConvertPageToBitmap2
• bits = pointer to the returned bitmap data

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

The pdfImageGrayToMono 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.

The pdfConvertPageToBitmap2 function returns pdfOk if successful, otherwise an error code.

The caller is responsible for freeing the bits pointer after using it, by calling pdfFreeMemory.