DLI Implementation and Reference Guide - Datalogics

DLI Reference Guide A.19
dlpdfcontentreferenceimage (DLPDFCONTENT *Content,
DLPDFIMAGE *Image, ASFixed X, ASFixed Y, ASFixed Rotate,
ASFixed ScaleX, ASFixed ScaleY)
Return Value: void
Description
Parameters
Return Value
This procedure places a copy of the referenced image into the
current content.
• DLPDFCONTENT *Content: Represents the content
element. These structures are destroyed when associated
with a page or form, and pointers to them should not be
used after that time.
• DLPDFIMAGE *Image
• ASFixed X: The X-axis location of the rotation point
• ASFixed Y: The Y-axis location of the rotation point
• ASFixed Rotate: Amount of counterclockwise rotation in
degrees
• ASFixed ScaleX: X-axis Scale Factor
• ASFixed ScaleY: Y-axis Scale Factor
void
Exceptions
Header
Related Methods
Availability
dli.h
dlpdfimagegetsize (New in DLI v2.2.5)
All DLI-supported platforms.
Technical Notes
1 The image will be placed so as to align its lower left hand corner with the given (X,Y) location, scaled
as per ScaleX and ScaleY, and rotated as per Rotate.
2 Image rotation, if any, always occurs about its origin, typically the lower-left corner of the image, and
the point of rotation is located by the given (X,Y) location.
3 The Scale Factors will determine the resulting size of the image. You need to know the original image
resolution and its intended size in order to determine whether a Scale Factor on either axis is required.
In DLI v2.2.5 or higher, the dlpdfimagegetsize method can retrieve image sizing data for you,
and dividing the intended print size by the file size for each dimension (delivered by
dlpdfimagegetsize) will yield a Scale Factor ratio which dlpdfcontentreferenceimage uses
to calculate the final output image size.
4 The typical scaling calculation using values returned by dlpdfimagegetsize would be to divide the
intended print size by the image size on each axis (e.g.
"dlpdfcontentreferenceimage(Content, Image, Int32ToFixed(72),