DLI Implementation and Reference Guide - Datalogics

More documents

Recommendations

Info

1.2 DLI Implementation and Reference Guide An Introduction to DLI The Datalogics Interface (DLI) facilitates the rapid creation of PDF documents and improves performance, throughput and graphics handling. It does this by bypassing many of the functions of the PDF Edit layer and eliminating redundant calls to the COS layer used in the Adobe® PDF Library. For information on the various layers of Adobe PDF Library please see the Acrobat Core API Overview. How to Create a PDF Document with DLI The DLI package exists at the output end of the page creation process. As such, most of the intricacies of line breaking, page breaking and general composition are outside of its scope. The process of writing pages is where this package fits into an application. An overview of this process follows: 1 Initialize DLI. (start of all processing) 2 Define the document. 3 Define fonts: i.e. Identify and describe each font to be used in the job to DLI. These can be done as encountered, if so desired. 4 Define forms: i.e. Identify and describe each form to be used in the job to DLI. These can be done as encountered, if so desired. 5 Define graphics: i.e. Identify and define each graphic to be used multiple times to DLI. These can be done as encountered, if so desired. 6 For each page: • Create a dlpdfpage object. • Create a dlpdfcontent object. 7 Generate the content of a single page: • For each graphic reference on the page, create the graphic in content. • For each text line on the page, create the text in content. 8 End the content and inform DLI that the content is complete. 9 End the page and inform DLI that the page is complete. 10 End the document. 11 End the job. Error handling during application execution is handled through the raising and handling of exceptions, as defined by the Adobe PDF Library. These are similar to operation exceptions in C++. For details on handling exceptions, please see the chapter “Error Testing and Recovery” on page 16.1.
Getting Started 1.3 What You Should Know This document is intended for programmers who are familiar with text composition and the creation of output drivers, or by application designers who are constructing an application based on the DLI package. You should have access to the Adobe PDF Library Applications Programming Interface (API) manual and the Adobe PDF Specifications manual for your system. For Adobe PDF Library v6.x releases, Adobe PDF Specification 1.5 is appropriate.For Adobe PDF Library v7.x releases, Adobe PDF Specification 1.6 is appropriate. NOTE: Some structures permitted in Adobe PDF Specification 1.6 may not be permitted in Adobe PDF Specification 1.5, and some structures defined in Adobe PDF Specification 1.5 are not available in Adobe PDF Specification 1.4. The explanations, assumptions and samples provided in this guide refer to Adobe PDF Library v7.0.0Plus and DLI v7.0 or higher. DLI Initialization Required Starting with DLI v2.1, the initialization process was simplified to enable initialization of the Adobe PDF Library automatically when DLI itself was initialized. Though it may be functionally possible to bypass the initialization of DLI for versions 2.1 and higher, an application should not do so. Using the DLI initialization and termination routines not only simplifies application programming but also allows the use of the Datalogics Files In Memory (FIM) System, and the enabling of certain optimizations in jobs which span multiple documents. NOTE: The Adobe PDF Library and DLI are not intended to be initialized more than once within a single instance of an application. Doing so can produce undesirable results. Versions of Adobe PDF Library prior to v6.1 are not thread-safe. gcc Compilation Version Adobe compiles their PDF Library components with gcc 3.2 on the Solaris® and Linux® operating systems, and with Visual Age (xlC) 6.0 on the AIX® system. Datalogics does not recompile Adobe components on any other compiler on these operating systems. This information is subject to change at any time, so for the latest details on supported operating-system compilers and versions, please see the readme.txt file of last-minute updates accompanying your software release files, or the Datalogics website System Requirements page at http://www.datalogics.com/pdflibraryrequirements.asp.
Page 1: Implementation and Reference Guide
Page 4 and 5: This guide is part of the Adobe® P
Page 6 and 7: TOC.ii DLI Implementation and Refer
Page 8 and 9: TOC.iv DLI Implementation and Refer
Page 12 and 13: 1.4 DLI Implementation and Referenc
Page 18 and 19: 1.10 DLI Implementation and Referen
Page 60 and 61:
4.12 DLI Implementation and Referen
Page 62 and 63:
5.2 DLI Implementation and Referenc
Page 64 and 65:
Page 66 and 67:
Page 68 and 69:
Page 70 and 71:
Page 72 and 73:
Page 74 and 75:
Page 76 and 77:
Page 78 and 79:
Page 80 and 81:
Page 82 and 83:
Page 84 and 85:
Page 86 and 87:
Page 88 and 89:
Page 90 and 91:
Page 92 and 93:
Page 94 and 95:
Page 96 and 97:
Page 98 and 99:
Page 100 and 101:
Page 102 and 103:
Page 104 and 105:
Page 106 and 107:
Page 108 and 109:
Page 110 and 111:
Page 112 and 113:
10.10 DLI Implementation and Refere
Page 114 and 115:
Page 116 and 117:
Page 118 and 119:
Page 120 and 121:
Page 122 and 123:
Page 124 and 125:
Page 126 and 127:
Page 128 and 129:
Page 130 and 131:
Page 132 and 133:
Page 134 and 135:
Page 136 and 137:
Page 138 and 139:
Page 140 and 141:
Page 142 and 143:
Page 144 and 145:
Page 146 and 147:
Page 148 and 149:
Page 150 and 151:
Page 152 and 153:
Page 154 and 155:
Page 156 and 157:
Page 158 and 159:
Page 160 and 161:
Page 162 and 163:
Page 164 and 165:
Page 166 and 167:
Page 168 and 169:
Page 170 and 171:
Page 172 and 173:
Page 174 and 175:
Page 176 and 177:
Page 178 and 179:
Page 180 and 181:
Page 182 and 183:
Page 184 and 185:
Page 186 and 187:
A.2 DLI Implementation and Referenc
Page 188 and 189:
Page 190 and 191:
Page 192 and 193:
Page 194 and 195:
A.10 DLI Implementation and Referen
Page 196 and 197:
Page 198 and 199:
Page 200 and 201:
Page 202 and 203:
Page 204 and 205:
Page 206 and 207:
Page 208 and 209:
Page 210 and 211:
Page 212 and 213:
Page 214 and 215:
Page 216 and 217:
Page 218 and 219:
Page 220 and 221:
Page 222 and 223:
Page 224 and 225:
Page 226 and 227:
Page 228 and 229:
Page 230 and 231:
Page 232 and 233:
Page 234 and 235:
Page 236 and 237:
Page 238 and 239:
Page 240 and 241:
Page 242 and 243:
Page 244 and 245:
Page 246 and 247:
Page 248 and 249:
Page 250 and 251:
Page 252 and 253:
Page 254 and 255:
Page 256 and 257:
Page 258 and 259:
Page 260 and 261:
Page 262 and 263:
Page 264 and 265:
Page 266 and 267:
Page 268 and 269:
Page 270 and 271:
Page 272 and 273:
Page 274 and 275:
Page 276 and 277:
Page 278 and 279:
Page 280 and 281:
Page 282 and 283:
Page 284 and 285:
A.100 DLI Implementation and Refere
Page 286 and 287:
Page 288 and 289:
Page 290 and 291:
Page 292 and 293:
Page 294 and 295:
Page 296 and 297:
Page 298 and 299:
Page 300 and 301:
Page 302 and 303:
Page 304 and 305:
Page 306 and 307:
Page 308 and 309:
Page 310 and 311:
Page 312 and 313:
Page 314 and 315:
Page 316 and 317:
Page 318 and 319:
Page 320 and 321:
Page 322 and 323:
Page 324 and 325:
Page 326 and 327:
Page 328 and 329:
Page 330 and 331:
Page 332 and 333:
Page 334 and 335:
Page 336 and 337:
Page 338 and 339:
Page 340 and 341:
Page 342 and 343:
Page 344 and 345:
Page 346 and 347:
I.ii DLI Implementation and Referen
Page 348 and 349:
I.iv DLI Implementation and Referen
Page 350 and 351:
I.vi DLI Implementation and Referen
Page 352 and 353:
I.viii DLI Implementation and Refer
Page 354 and 355:
I.x DLI Implementation and Referenc
Page 356 and 357:
I.xii DLI Implementation and Refere
Page 358 and 359:
I.xiv DLI Implementation and Refere
Page 360 and 361:
I.xvi DLI Implementation and Refere
Page 362 and 363:
I.xviii DLI Implementation and Refe
Page 364 and 365:
I.xx DLI Implementation and Referen
show all

DLI Implementation and Reference Guide - Datalogics

Create successful ePaper yourself

Delete template?

Save as template?