DLI Implementation and Reference Guide - Datalogics

11.10 DLI Implementation and Reference Guide
dlpdfimagecreatefromfile
This method invokes various conversion routines to allow a user to simply specify the
Concepts and Facilities: Guide to the DL Pager Composition System
file name and obtain a valid DLPDFIMAGE object. All conversions are done internally
to DLI.
NOTE: The public-domain graphic-conversion libraries used on Unix and Windows
are not available on OS/390 and OS/400 platforms. Consequently some image
creation procedures are not available under OS/390 and OS/400.
This method accepts only 2 parameters:
• a handle to a document in which the image is to be placed
• a file name which should contain the image
Currently, this method will support JPEG/JPG, GIF, TIFF, PNG and PDF files on the
NT and UNIX platforms, and PDF only on OS/390.
From the complete DLI sample of inserting graphic images, this segment inserts a PDF
image via dlpdfimagecreatefromfile:
"C" Example: Inserting a PDF image with dlpdfimagecreatefromfile
Image = dlpdfimagecreatefromfile (Doc, "math.pdf");
/* "Paste" the image into the container, centered over the
* red box */
dlpdfcontentreferenceimage (Content, Image,
(fixedFour * 72) - ((Image->BBox.left + Image->BBox.right)/2),
(fixedFour * 72) - ((Image->BBox.top + Image->BBox.bottom)/2),
0, fixedOne, fixedOne);
The DLPDFIMAGE objects contains an ASFixedRect object called BBox (Bounding
Box), which is set to the actual size and displacement of the image, as defined by its
originator. This may be used in decisions about positioning and scaling the image.