DynaPDF Manual - Page 622

Previous Page 621   Index   Next Page 623

Function Reference
Page 622 of 839
LBOOL pdfPlaceImage(
const PPDF* IPDF,
// Instance pointer
SI32 ImgHandle,
// Image handle
double PosX,
// X-Coordinate of destination rectangle
double PosY,
// Y-Coordinate of destination rectangle
double ScaleWidth,
// Scaled width of destination rectangle
double ScaleHeight) // Scaled height of destination rectangle
Images can be used multiple times on different positions and with different sizes. This function
places an image onto a page or template that was already inserted beforehand by an image function.
The image can be placed in the same way as by every other image function. However, if the size of
the image will be changed, the image is not rescaled physically to the current resolution. Insert the
largest version of an image first to avoid up-scaling.
The width and height can be calculated as follows:
If ScaleWidth or ScaleHeight is -1 the function uses the original width or height from the
image. If both parameters are -1 the image will be inserted with a resolution 72 DPI.
If ScaleWidth or ScaleHeight is 0, the missing value is calculated in relation to the given value
of ScaleHeight or ScaleWidth to preserve the image's aspect ratio. The resulting output is an
image with exact proportions relative to its original size.
If ScaleWidth and ScaleHeight are 0, the original size is used (same effect as -1).
A negative value of Width or Height mirrors the image on the x- and or y-axis.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
LBOOL pdfPlaceSigFieldValidateIcon(
const PPDF* IPDF, // Instance pointer
UI32 SigField,
// Handle of a signature field
double PosX,
// X-Coordinate of the icon
double PosY,
// Y-Coordinate of the icon
double Width,
// Icon width
double Height)
// Icon height
The function places the validation icon within a signature field to the wished position. By default,
the validation icon is scaled to the width or height of the signature field and it is horizontally and
vertically centered. When creating a user defined appearance for a signature field it is sometimes

Previous topic: Vector Graphics

Next topic: PlaceTemplate