NewPageFromCanvasDC

Vector graphics, Page manipulation

Description

Adds a new page to the selected document from the drawing operations applied to the DC returned by the GetCanvasDC function.

When the Options parameter is set to 3 or 4, use the NoEmbedFontListAdd function to add fonts to the no embed font list.

Syntax

Delphi

function TPDFlib.NewPageFromCanvasDC(DPI: Double; Options: Integer): Integer;

ActiveX

Function PDFlib::NewPageFromCanvasDC(DPI As Double, Options As Long) As Long

DLL

int DLNewPageFromCanvasDC(int InstanceID, double DPI, int Options);

Parameters

DPI	The DPI to use for the new document. For example, if the canvas was created with a width and height of 96 and the DPI is specified as 192, the resulting document will be 0.5 inches in width and height.
Options	-1 = Convert the drawing commands to a single image using GDI+ 0 = Process the drawing commands as vector graphics, fonts are not embedded 1 = Process the drawing commands as vector graphics, fonts are embedded but not compressed 2 = Process the drawing commands as vector graphics, fonts are embedded and compressed 3 = Process the drawing commands as vector graphics, fonts not in the no embed font list are embedded and compressed 4 = Same as 3 but fonts already added during previous calls to this function or the LoadFromCanvasDC function are reused

DPI

The DPI to use for the new document. For example, if the canvas was created with a width and height of 96 and the DPI is specified as 192, the resulting document will be 0.5 inches in width and height.

Options

-1 = Convert the drawing commands to a single image using GDI+ 0 = Process the drawing commands as vector graphics, fonts are not embedded 1 = Process the drawing commands as vector graphics, fonts are embedded but not compressed 2 = Process the drawing commands as vector graphics, fonts are embedded and compressed 3 = Process the drawing commands as vector graphics, fonts not in the no embed font list are embedded and compressed 4 = Same as 3 but fonts already added during previous calls to this function or the LoadFromCanvasDC function are reused

Return values

0	A canvas has not been created
1	The canvas DC was processed correctly and a new document has been created