PageRenderTime 40ms CodeModel.GetById 10ms RepoModel.GetById 1ms app.codeStats 0ms

/trunk/contribs/fop-1.0/docs/trunk/pdfx.html

https://bitbucket.org/ianmayo/debrief
HTML | 384 lines | 307 code | 15 blank | 62 comment | 0 complexity | 14a0bc046e71d4e29482c9b8238ce78f MD5 | raw file
    

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3. <head>
    4. 

  4. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
    5. 

  5. <meta content="Apache Forrest" name="Generator">
    6. 

  6. <meta name="Forrest-version" content="0.8">
    7. 

  7. <meta name="Forrest-skin-name" content="pelt">
    8. 

  8. <title>PDF/X (ISO 15930)</title>
    9. 

  9. <link type="text/css" href="../skin/basic.css" rel="stylesheet">
    10. 

  10. <link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
    11. 

  11. <link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
    12. 

  12. <link type="text/css" href="../skin/profile.css" rel="stylesheet">
    13. 

  13. <script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
    14. 

  14. <link rel="shortcut icon" href="../">
    15. 

  15. </head>
    16. 

  16. <body onload="init()">
    17. 

  17. <script type="text/javascript">ndeSetTextSize();</script>
    18. 

  18. <div id="top">
    19. 

  19. <!--+
    20. 

  20.     |header
    21. 

  21.     +-->
    22. 

  22. <div class="header">
    23. 

  23. <!--+
    24. 

  24.     |start group logo
    25. 

  25.     +-->
    26. 

  26. <div class="grouplogo">
    27. 

  27. <a href="http://xmlgraphics.apache.org/"><img class="logoImage" alt="Apache XML Graphics" src="../images/group-logo.gif" title="Apache XML Graphics is responsible for the creation and maintenance of software for managing the conversion of XML formats to graphical output, and the creation and maintenance of related software components, based on software licensed to the Foundation"></a>
    28. 

  28. </div>
    29. 

  29. <!--+
    30. 

  30.     |end group logo
    31. 

  31.     +-->
    32. 

  32. <!--+
    33. 

  33.     |start Project Logo
    34. 

  34.     +-->
    35. 

  35. <div class="projectlogo">
    36. 

  36. <a href="http://xmlgraphics.apache.org/fop/"><img class="logoImage" alt="Apache FOP" src="../images/logo.jpg" title="Apache FOP (Formatting Objects Processor) is the world's first output independent formatter. Output formats currently supported include PDF, PCL, PS, SVG, XML (area tree representation), Print, AWT, MIF and TXT. The primary output target is PDF."></a>
    37. 

  37. </div>
    38. 

  38. <!--+
    39. 

  39.     |end Project Logo
    40. 

  40.     +-->
    41. 

  41. <!--+
    42. 

  42.     |start Search
    43. 

  43.     +-->
    44. 

  44. <div class="searchbox">
    45. 

  45. <form action="http://www.google.com/search" method="get" class="roundtopsmall">
    46. 

  46. <input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp; 
    47. 

  47.                     <input name="Search" value="Search" type="submit">
    48. 

  48. </form>
    49. 

  49. </div>
    50. 

  50. <!--+
    51. 

  51.     |end search
    52. 

  52.     +-->
    53. 

  53. <!--+
    54. 

  54.     |start Tabs
    55. 

  55.     +-->
    56. 

  56. <ul id="tabs">
    57. 

  57. <li>
    58. 

  58. <a class="unselected" href="../index.html">Home</a>
    59. 

  59. </li>
    60. 

  60. <li>
    61. 

  61. <a class="unselected" href="../0.95/index.html">Version 0.95</a>
    62. 

  62. </li>
    63. 

  63. <li>
    64. 

  64. <a class="unselected" href="../1.0/index.html">Version 1.0</a>
    65. 

  65. </li>
    66. 

  66. <li class="current">
    67. 

  67. <a class="selected" href="../trunk/index.html">FOP Trunk</a>
    68. 

  68. </li>
    69. 

  69. <li>
    70. 

  70. <a class="unselected" href="../dev/index.html">Development</a>
    71. 

  71. </li>
    72. 

  72. </ul>
    73. 

  73. <!--+
    74. 

  74.     |end Tabs
    75. 

  75.     +-->
    76. 

  76. </div>
    77. 

  77. </div>
    78. 

  78. <div id="main">
    79. 

  79. <div id="publishedStrip">
    80. 

  80. <!--+
    81. 

  81.     |start Subtabs
    82. 

  82.     +-->
    83. 

  83. <div id="level2tabs"></div>
    84. 

  84. <!--+
    85. 

  85.     |end Endtabs
    86. 

  86.     +-->
    87. 

  87. <script type="text/javascript"><!--
    88. 

  88. document.write("Last Published: " + document.lastModified);
    89. 

  89. //  --></script>
    90. 

  90. </div>
    91. 

  91. <!--+
    92. 

  92.     |breadtrail
    93. 

  93.     +-->
    94. 

  94. <div class="breadtrail">
    95. 

  95. <a href="http://www.apache.org/">apache.org</a> &gt; <a href="http://xml.apache.org/">XML Federation</a> &gt; <a href="http://xmlgraphics.apache.org/">xmlgraphics.apache.org</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
    96. 

  96. </div>
    97. 

  97. <!--+
    98. 

  98.     |start Menu, mainarea
    99. 

  99.     +-->
    100. 

  100. <!--+
    101. 

  101.     |start Menu
    102. 

  102.     +-->
    103. 

  103. <div id="menu">
    104. 

  104. <div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">FOP Trunk (dev)</div>
    105. 

  105. <div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
    106. 

  106. <div class="menuitem">
    107. 

  107. <a href="../trunk/index.html">About</a>
    108. 

  108. </div>
    109. 

  109. <div class="menuitem">
    110. 

  110. <a href="../trunk/upgrading.html">Upgrading</a>
    111. 

  111. </div>
    112. 

  112. <div onclick="SwitchMenu('menu_1.1.3', '../skin/')" id="menu_1.1.3Title" class="menutitle">Using FOP</div>
    113. 

  113. <div id="menu_1.1.3" class="menuitemgroup">
    114. 

  114. <div class="menuitem">
    115. 

  115. <a href="../trunk/compiling.html">Build</a>
    116. 

  116. </div>
    117. 

  117. <div class="menuitem">
    118. 

  118. <a href="../trunk/configuration.html">Configure</a>
    119. 

  119. </div>
    120. 

  120. <div class="menuitem">
    121. 

  121. <a href="../trunk/running.html">Run</a>
    122. 

  122. </div>
    123. 

  123. <div class="menuitem">
    124. 

  124. <a href="../trunk/embedding.html">Embed</a>
    125. 

  125. </div>
    126. 

  126. <div class="menuitem">
    127. 

  127. <a href="../trunk/servlets.html">Servlets</a>
    128. 

  128. </div>
    129. 

  129. <div class="menuitem">
    130. 

  130. <a href="../trunk/anttask.html">Ant Task</a>
    131. 

  131. </div>
    132. 

  132. </div>
    133. 

  133. <div onclick="SwitchMenu('menu_selected_1.1.4', '../skin/')" id="menu_selected_1.1.4Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Features</div>
    134. 

  134. <div id="menu_selected_1.1.4" class="selectedmenuitemgroup" style="display: block;">
    135. 

  135. <div class="menuitem">
    136. 

  136. <a href="../trunk/output.html">Output Targets</a>
    137. 

  137. </div>
    138. 

  138. <div class="menuitem">
    139. 

  139. <a href="../trunk/intermediate.html">Intermediate Format</a>
    140. 

  140. </div>
    141. 

  141. <div class="menuitem">
    142. 

  142. <a href="../trunk/pdfencryption.html">PDF Encryption</a>
    143. 

  143. </div>
    144. 

  144. <div class="menuitem">
    145. 

  145. <a href="../trunk/pdfa.html">PDF/A</a>
    146. 

  146. </div>
    147. 

  147. <div class="menupage">
    148. 

  148. <div class="menupagetitle">PDF/X</div>
    149. 

  149. </div>
    150. 

  150. <div class="menuitem">
    151. 

  151. <a href="../trunk/graphics.html">Graphics</a>
    152. 

  152. </div>
    153. 

  153. <div class="menuitem">
    154. 

  154. <a href="../trunk/fonts.html">Fonts</a>
    155. 

  155. </div>
    156. 

  156. <div class="menuitem">
    157. 

  157. <a href="../trunk/hyphenation.html">Hyphenation</a>
    158. 

  158. </div>
    159. 

  159. <div class="menuitem">
    160. 

  160. <a href="../trunk/extensions.html">Extensions</a>
    161. 

  161. </div>
    162. 

  162. <div class="menuitem">
    163. 

  163. <a href="../trunk/events.html">Events</a>
    164. 

  164. </div>
    165. 

  165. <div class="menuitem">
    166. 

  166. <a href="../trunk/metadata.html">Metadata</a>
    167. 

  167. </div>
    168. 

  168. <div class="menuitem">
    169. 

  169. <a href="../trunk/accessibility.html">Accessibility</a>
    170. 

  170. </div>
    171. 

  171. </div>
    172. 

  172. </div>
    173. 

  173. <div id="credit"></div>
    174. 

  174. <div id="roundbottom">
    175. 

  175. <img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
    176. 

  176. <!--+
    177. 

  177.   |alternative credits
    178. 

  178.   +-->
    179. 

  179. <div id="credit2"></div>
    180. 

  180. </div>
    181. 

  181. <!--+
    182. 

  182.     |end Menu
    183. 

  183.     +-->
    184. 

  184. <!--+
    185. 

  185.     |start content
    186. 

  186.     +-->
    187. 

  187. <div id="content">
    188. 

  188. <div title="raw XML" class="xmllink">
    189. 

  189. <a class="dida" href="pdfx.xml"><img alt="XML - icon" src="../skin/images/xmldoc.gif" class="skin"><br>
    190. 

  190.         XML</a>
    191. 

  191. </div>
    192. 

  192. <div title="Portable Document Format" class="pdflink">
    193. 

  193. <a class="dida" href="pdfx.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
    194. 

  194.         PDF</a>
    195. 

  195. </div>
    196. 

  196. <div class="trail">Font size: 
    197. 

  197. 	          &nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">      
    198. 

  198. 	          &nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
    199. 

  199. 	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
    200. 

  200. </div>
    201. 

  201. <h1>PDF/X (ISO 15930)</h1>
    202. 

  202. <div id="minitoc-area">
    203. 

  203. <ul class="minitoc">
    204. 

  204. <li>
    205. 

  205. <a href="#overview">Overview</a>
    206. 

  206. </li>
    207. 

  207. <li>
    208. 

  208. <a href="#status">Implementation Status</a>
    209. 

  209. </li>
    210. 

  210. <li>
    211. 

  211. <a href="#command-line">Usage (command line)</a>
    212. 

  212. </li>
    213. 

  213. <li>
    214. 

  214. <a href="#embedded">Usage (embedded)</a>
    215. 

  215. </li>
    216. 

  216. <li>
    217. 

  217. <a href="#rules">PDF/X in Action</a>
    218. 

  218. </li>
    219. 

  219. <li>
    220. 

  220. <a href="#profile-compatibility">PDF profile compatibility</a>
    221. 

  221. </li>
    222. 

  222. </ul>
    223. 

  223. </div>
    224. 

  224.     
    225. 

  225. <a name="N10018"></a><a name="overview"></a>
    226. 

  226. <h2 class="underlined_10">Overview</h2>
    227. 

  227. <div class="section">
    228. 

  228. <div class="warning">
    229. 

  229. <div class="label">Warning</div>
    230. 

  230. <div class="content">
    231. 

  231.         Support for PDF/X is available beginning with version 0.93. This feature is new and
    232. 

  232.         may not be 100% complete, yet. Feedback is welcome.
    233. 

  233.       </div>
    234. 

  234. </div>
    235. 

  235. <p>
    236. 

  236.         PDF/X is a standard which faciliates prepress digital data exchange using PDF.
    237. 

  237.         Currently, only PDF/X-3:2003 is implemented out of the many different flavours of PDF/X
    238. 

  238.         profiles. PDF/X-3:2003 is documented in 
    239. 

  239.         <a class="external" href="http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=39940&ICS1=37&ICS2=100&ICS3=99">ISO 15930-6:2003(E)</a>. 
    240. 

  240.         More info on PDF/X can be found on the  
    241. 

  241.         <a class="external" href="http://www.pdfx.info/">PDF/X info site</a>.
    242. 

  242.       </p>
    243. 

  243. </div>
    244. 

  244.     
    245. 

  245. <a name="N1002D"></a><a name="status"></a>
    246. 

  246. <h2 class="underlined_10">Implementation Status</h2>
    247. 

  247. <div class="section">
    248. 

  248. <p>
    249. 

  249.         
    250. 

  250. <strong>PDF/X-3:2003</strong> is implemented to the degree that FOP supports 
    251. 

  251.         the creation of the elements described in ISO 15930-6. 
    252. 

  252.       </p>
    253. 

  253. <p>
    254. 

  254.         An important restriction of the current implementation is that all normal 
    255. 

  255.         RGB colors specified in XSL-FO and SVG are left unchanged in the sRGB color
    256. 

  256.         space (XSL-FO and SVG both use sRGB as their default color space).
    257. 

  257.         There's no conversion to a CMYK color space. Although sRGB is a
    258. 

  258.         calibrated color space, its color space has a different size than a CMYK
    259. 

  259.         color space which makes the conversion a lossy conversion and can lead to
    260. 

  260.         unwanted results. Although the use of the calibrated sRGB has been promoted
    261. 

  261.         for years, print shops usually prefer to convert an sRGB PDF to CMYK prior
    262. 

  262.         to production. Until there's full CMYK support in FOP you will have to
    263. 

  263.         work closely with your print service provider to make sure you get the 
    264. 

  264.         intended result.
    265. 

  265.       </p>
    266. 

  266. <p>
    267. 

  267.         Tests have been performed against Adobe Acrobat 7.0.7 (Preflight function).
    268. 

  268.         Note that there are bugs in Adobe Acrobat which cause false alarms if both
    269. 

  269.         PDF/A-1b and PDF/X-3:2003 are activated at the same time.
    270. 

  270.       </p>
    271. 

  271. </div>
    272. 

  272.     
    273. 

  273. <a name="N10040"></a><a name="command-line"></a>
    274. 

  274. <h2 class="underlined_10">Usage (command line)</h2>
    275. 

  275. <div class="section">
    276. 

  276. <p>
    277. 

  277.         To activate PDF/X-3:2003 from the command-line, specify "-pdfprofile PDF/X-3:2003" 
    278. 

  278.         as a parameter. If there is a violation of one of the validation rules for 
    279. 

  279.         PDF/X, an error message is presented and the processing stops.
    280. 

  280.       </p>
    281. 

  281. </div>
    282. 

  282.     
    283. 

  283. <a name="N1004A"></a><a name="embedded"></a>
    284. 

  284. <h2 class="underlined_10">Usage (embedded)</h2>
    285. 

  285. <div class="section">
    286. 

  286. <p>
    287. 

  287.         When FOP is embedded in another Java application you can set a special option
    288. 

  288.         on the renderer options in the user agent to activate the PDF/A-1b profile.
    289. 

  289.         Here's an example:
    290. 

  290.       </p>
    291. 

  291. <pre class="code">
    292. 

  292. FOUserAgent userAgent = fopFactory.newFOUserAgent();
    293. 

  293. userAgent.getRendererOptions().put("pdf-x-mode", "PDF/X-3:2003");
    294. 

  294. Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, userAgent);
    295. 

  295. [..]</pre>
    296. 

  296. <p>
    297. 

  297.         If one of the validation rules of PDF/X is violated, an PDFConformanceException
    298. 

  298.         (descendant of RuntimeException) is thrown.
    299. 

  299.       </p>
    300. 

  300. </div>
    301. 

  301.     
    302. 

  302. <a name="N1005B"></a><a name="rules"></a>
    303. 

  303. <h2 class="underlined_10">PDF/X in Action</h2>
    304. 

  304. <div class="section">
    305. 

  305. <p>
    306. 

  306.         There are a number of things that must be looked after if you activate a PDF/X
    307. 

  307.         profile. If you receive a PDFConformanceException, have a look at the following
    308. 

  308.         list (not necessarily comprehensive):
    309. 

  309.       </p>
    310. 

  310. <ul>
    311. 

  311.         
    312. 

  312. <li>
    313. 

  313.           Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica)
    314. 

  314.           you need to obtain a license for them and embed them like any other font.
    315. 

  315.         </li>
    316. 

  316.         
    317. 

  317. <li>
    318. 

  318.           Don't use PDF encryption. PDF/X doesn't allow it.
    319. 

  319.         </li>
    320. 

  320.         
    321. 

  321. <li>
    322. 

  322.           Don't use CMYK images without an ICC color profile. PDF/X doesn't allow mixing
    323. 

  323.           color spaces and FOP currently only properly supports the sRGB color space. However,
    324. 

  324.           you will need to specify an 
    325. 

  325.           <a href="configuration.html#pdf-renderer">output device profile</a>
    326. 

  326.           (usually a CMYK profile) in the configuration. sRGB won't work here since it's a 
    327. 

  327.           display device profile, not an output device profile.
    328. 

  328.         </li>
    329. 

  329.         
    330. 

  330. <li>
    331. 

  331.           Don't use non-RGB colors in SVG images. Same issue as with CMYK images.
    332. 

  332.         </li>
    333. 

  333.         
    334. 

  334. <li>
    335. 

  335.           Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF
    336. 

  336.           is deprecated since PDF 1.4 and prohibited by PDF/X-3:2003.
    337. 

  337.         </li>
    338. 

  338.         
    339. 

  339. <li>
    340. 

  340.           PDF is forced to version 1.4 if PDF/X-3:2003 is activated.
    341. 

  341.         </li>
    342. 

  342.       
    343. 

  343. </ul>
    344. 

  344. </div>
    345. 

  345.     
    346. 

  346. <a name="N1007E"></a><a name="profile-compatibility"></a>
    347. 

  347. <h2 class="underlined_10">PDF profile compatibility</h2>
    348. 

  348. <div class="section">
    349. 

  349. <p>
    350. 

  350.         The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" are compatible and can both be 
    351. 

  351.         activated at the same time.
    352. 

  352.       </p>
    353. 

  353. </div>
    354. 

  354.   
    355. 

  355. <p align="right">
    356. 

  356. <font size="-2">by&nbsp;Jeremias M&auml;rki</font>
    357. 

  357. </p>
    358. 

  358. <span class="version">
    359. 

  359.           version 627324</span>
    360. 

  360. </div>
    361. 

  361. <!--+
    362. 

  362.     |end content
    363. 

  363.     +-->
    364. 

  364. <div class="clearboth">&nbsp;</div>
    365. 

  365. </div>
    366. 

  366. <div id="footer">
    367. 

  367. <!--+
    368. 

  368.     |start bottomstrip
    369. 

  369.     +-->
    370. 

  370. <div class="lastmodified">
    371. 

  371. <script type="text/javascript"><!--
    372. 

  372. document.write("Last Published: " + document.lastModified);
    373. 

  373. //  --></script>
    374. 

  374. </div>
    375. 

  375. <div class="copyright">
    376. 

  376.         Copyright &copy;
    377. 

  377.          1999-2009 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
    378. 

  378. </div>
    379. 

  379. <!--+
    380. 

  380.     |end bottomstrip
    381. 

  381.     +-->
    382. 

  382. </div>
    383. 

  383. </body>
    384. 

  384. </html>
    385. 

  385.