Constructor
VipsImagepdfload
Declaration [src]
int
vips_pdfload (
const char* filename,
VipsImage** out,
...
)
Description [src]
Render a PDF file into a VIPS image.
The output image is always RGBA — CMYK PDFs will be
converted. If you need CMYK bitmaps, you should use vips_magickload() instead.
Use page to select a page to render, numbering from zero.
Use n to select the number of pages to render. The default is 1. Pages are
rendered in a vertical column, with each individual page aligned to the
left. Set to -1 to mean “until the end of the document”. Use
vips_grid() to change page layout.
Use dpi to set the rendering resolution. The default is 72. Additionally,
you can scale by setting scale. If you set both, they combine.
Use background to set the background RGBA colour. The default is 255
(solid white), use eg. 0 for a transparent background.
Use password to supply a decryption password.
The operation fills a number of header fields with metadata, for example “pdf-author”. They may be useful.
This function only reads the image header and does not render any pixel data. Rendering occurs when pixels are accessed.
Optional arguments
page:gint, load this page, numbered from zeron:gint, load this many pagesdpi:gdouble, render at this DPIscale:gdouble, scale render by this factorbackground:VipsArrayDouble, background colour
See also
This constructor is not directly available to language bindings.
Parameters
filename-
Type:
const char*File to load.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. out-
Type:
VipsImageOutput image.
The argument will be set by the function. The caller of the function takes ownership of the returned data, and is responsible for freeing it. ...-
Type:
NULL-terminated list of optional named arguments.