22.03.2015 Views

DLI Implementation and Reference Guide - Datalogics

DLI Implementation and Reference Guide - Datalogics

DLI Implementation and Reference Guide - Datalogics

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

11.12 <strong>DLI</strong> <strong>Implementation</strong> <strong>and</strong> <strong>Reference</strong> <strong>Guide</strong><br />

The parameter containing the graphic list file name is the DDName of the crossreference<br />

file, as in:<br />

Concepts <strong>and</strong> Facilities: <strong>Guide</strong> to the DL Pager Composition System<br />

LoadGraphicList(“graphics”);<br />

with the associated JCL line:<br />

//GRAPHICS DD<br />

DSN=ADOBE.PDFLIB.RESOURCE.GRPHLIST(GRPIDX),DISP=SHR<br />

GetGraphicFromList<br />

This method is available on OS/390 only. It accepts a DLPDFDOC pointer <strong>and</strong> graphic<br />

key string, <strong>and</strong> returns the appropriate DLPDFIMAGE pointer. Multiple usage of the<br />

same graphic key within a document is tracked by <strong>DLI</strong>, resulting in only one instance<br />

of the graphic being placed in the document.<br />

NOTE: The graphic key must be passed as an ASCII string.<br />

Creating Transparent Graphics<br />

A PDF file may contain imagemasks. These are images which are used to mask, or<br />

block, the painting of areas beneath the mask, in the manner of a stencil. Imagemasks<br />

are one-bit graphics, where a value of 0 means that the pixel beneath the image is not<br />

to show through, <strong>and</strong> a value of 1 means that the pixel beneath is visible.<br />

<strong>DLI</strong> will automatically set any bitmap image created with the<br />

dlpdfimagecreatefrombmp function, having one bit per pixel <strong>and</strong> no color space<br />

(a CosNull object for the ColorSpace parameter), to be an imagemask. The mask<br />

will paint marked regions with the current fill color, <strong>and</strong> will leave unmarked regions<br />

untouched; page marks below these regions will be visible <strong>and</strong> not painted over.<br />

To change an image into a mask, simply insert the Imagemask key, with the value of<br />

TRUE as a Boolean, into the image’s dictionary. Then, remove the ColorSpace key

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!