convertPageToBitmap2

Convert a page to a raw bitmap.

convertPageToBitmap2([in] int page, [in] double hDPI, [in] double vDPI, [in] int color, [out] int *width, [out] int *height, [out] int *stride, [out, retval] HGLOBAL *data)

This function converts a PDF page to a raw bitmap. It is identical to convertPageToPicture2, except that it returns a raw bitmap instead of an OLE IPicture object.

The arguments are:

page = page number
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
- imageDevNToRGB: 8-bit RGB, rasterized in DeviceN and then converted to RGB
- imageDevNToCMYK: 8-bit CMYK, rasterized in DeviceN and then converted to CMYK
- imageGrayToMono: 1-bit monochrome, rasterized in 8-bit grayscale and then converted to 1-bit
width = bitmap width (output argument)
height = bitmap height (output argument)
stride = bitmap stride, i.e., bytes per row (output argument)

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

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

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

NB: The returned value is an HGLOBAL (i.e., XpdfRasterizer allocates it with GlobalAlloc), and the caller is responsible for calling GlobalFree (or Marshal.FreeHGBlobal) to free it.

C#:

int width, height, stride; IntPtr bitmapData = pdf.convertPageToBitmap2(5, 120, 120, pdf.imageRGB, out width, out height, out stride); Bitmap bmp = new Bitmap(width, height, stride, PixelFormat.Format24bppRgb, bitmapData); // ... use bmp ... Marshal.FreeHGlobal(bitmapData);

convertPageToPicture2
convertRegionToBitmap2