DLI Implementation and Reference Guide - Datalogics

DLI Reference Guide A.25
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), Int32ToFixed(92), 0,
ASFixedDiv(xPoints,Int32ToFixed(xRasters)),
ASFixedDiv(yPoints,Int32ToFixed(yRasters)));").
5 An image in which each pixel of each raster line represents one PDF unit of output
will return the same values for both image dimension (xRasters and yRasters)
and print size (xPoints and yPoints), and thus a Scale Factor of 1 on both
axes.