{"id":14988128,"url":"https://github.com/apache/xmlgraphics-fop-pdf-images","last_synced_at":"2025-10-19T12:30:41.652Z","repository":{"id":23003266,"uuid":"26353925","full_name":"apache/xmlgraphics-fop-pdf-images","owner":"apache","description":"Apache XML Graphics FOP PDF Images","archived":false,"fork":false,"pushed_at":"2025-01-27T11:01:49.000Z","size":115734,"stargazers_count":13,"open_issues_count":2,"forks_count":6,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-01-27T12:25:41.043Z","etag":null,"topics":["apache","fop"],"latest_commit_sha":null,"homepage":"https://xmlgraphics.apache.org/fop/","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apache.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-11-08T08:00:07.000Z","updated_at":"2025-01-27T11:01:53.000Z","dependencies_parsed_at":"2023-01-14T01:00:18.035Z","dependency_job_id":"bb23dbe1-4c98-414c-981c-51b723246f16","html_url":"https://github.com/apache/xmlgraphics-fop-pdf-images","commit_stats":{"total_commits":218,"total_committers":7,"mean_commits":"31.142857142857142","dds":"0.16972477064220182","last_synced_commit":"dba4a31384998e8517dce4cedd074182d4cb80f9"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fxmlgraphics-fop-pdf-images","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fxmlgraphics-fop-pdf-images/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fxmlgraphics-fop-pdf-images/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fxmlgraphics-fop-pdf-images/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/xmlgraphics-fop-pdf-images/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237125547,"owners_count":19259303,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apache","fop"],"created_at":"2024-09-24T14:16:07.771Z","updated_at":"2025-10-19T12:30:41.640Z","avatar_url":"https://github.com/apache.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"$Id: README 1433 2011-07-01 15:12:30Z jeremias $\n\n==============================================================================\n  PDF IMAGE SUPPORT FOR APACHE FOP  -  README\n==============================================================================\n\nContents of this file:\n - What's in here?\n - Requirements\n - Legal Information\n - Where to get help?\n - How do I enable PDF image support in FOP?\n - Notes on PDF image support for output formats other than PDF\n - Known Issues\n - Contributors\n - Release Notes\n\n==============================================================================\n\n\nWhat's in here?\n---------------\n\nThis package contains classes which add support using PDF images in\nfo:external-graphic elements when you generate PDF files. This means you can\nwrite something like:\n\n\u003cfo:external-graphic src=\"my-doc.pdf\"/\u003e\n\nImplementation notes:\n\n* This package uses the Apache PDFBox PDF library for parsing the PDF\n  files as FOP's PDF library is a write-only library.\n\n* PDF image support is done differently for PDF output than for the \n  other output formats. For PDF output, the plug-in tries to transfer \n  the various PDF objects 1:1 to the target PDF. For the other output \n  formats, Apache PDFBox is used to render the PDF to a Graphics2D \n  object (Java2D). PDFBox still has some problems with rendering certain \n  PDFs. \n  Rather, consider helping out in the PDFBox project to improve the \n  code. This plug-in only plays the adapter between FOP and PDFBox. It \n  is not responsible for correct rendering of the PDF.\n\n* Individual pages inside a multi-page PDF can be accessed by using a URI\n  fragment in the following form: \u003curi\u003e#page=\u003cnr\u003e\n  Example: http://localhost/mydoc.pdf#page=7\n  Note: this only works on URIs, not plain file names in which case you'll\n  get an error. Plain file names are illegal in XSL-FO anyway, strictly\n  speaking.\n  \n* If you enable PDF/A or PDF/X functionality, the resulting PDF may not be\n  a compliant file since the code isn't sophisticated enough to ensure that\n  the rules of PDF/A and PDF/X are respected when the PDF file is embedded.\n  So if you enable PDF/A and/or PDF/X, you should refrain from using this\n  package.\n\n* If the PDF you want to embed has annotations, be prepared that they may\n  not be transferred correctly.\n\n* Apache FOP currently generates PDF 1.4. If you include a PDF with a\n  higher PDF version, the results may be unpredictable.\n\n* This package does not work with FOP 0.93, 0.94 or any earlier version.\n  You will need a later release or the code from FOP Trunk.\n\n* Some PDF may not be processed correctly with FOP 0.95 due to bugs in\n  its PDF library. You may need to upgrade Apache FOP in this case.\n\n* Using PDF files is NOT supported inside SVG, only in XSL-FO.\n\n\n    \nRequirements\n----------------\n\nThis plug-in has the following requirements:\n- Apache PDFBox 3.0 or later\n- Apache XML Graphics Commons 2.11 or later (for the image converter)\n- Apache XML FOP 2.11 or later (for the FOP functionality)\n- Java 1.8 or later\n\nNote: for some problems related to the PDF plug-in, Apache FOP 2.11 or later\nis required. A number of bugs had to be fixed in FOP's PDF library.\n\n\nLegal Information\n---------------------\n\nThis package is published under the Apache License version 2.0. For the license\ntext, please see the following files:\n- LICENSE\n- NOTICE\n\nLegal information on third-party libraries used by this plug-in can be\nfound in the \"lib/README.txt\" file.\n\n    \nWhere to get help?\n---------------------    \n\nSee: http://xmlgraphics.apache.org/fop/gethelp.html\n\n\nHow do I enable PDF image support in FOP?\n-----------------------------------------\n\nJust add the fop-pdf-images.jar and lib/pdfbox-*.jar (including the other\nminimal dependencies for PDFBox) to the classpath on the same classpath\nlevel as you put fop.jar.\n\nYou can then use URIs referring to PDF files inside fo:external-graphic and\nfox:external-document elements.\n\n\nNotes on PDF image support for output formats other than PDF\n------------------------------------------------------------\n\nPlease note that this plug-in was written mostly for PDF production. For\nother FOP output formats, the PDF is converted to a vector or bitmap image\nusing Apache PDFBox which is not yet a full-fledged PDF viewer. There may\nbe limitations concerning the quality. If you run into a problem displaying\nPDF for any output format other than PDF, you will need to ask the PDFBox\ncommunity for help. Or you can help the Apache PDFBox project to improve\ntheir PDF interpreter.\n\nThe Apache PDFBox website: http://pdfbox.apache.org/\n\n\nKnown Issues\n---------------\n\n- If Acrobat fails to open the generated PDF, it maybe be due to a bug in FOP\n  that was fixed in revision 833375. \n\n- When importing multiple pages from the same PDF, the same PDF objects from\n  the original may be imported anew for each page. There is currently no\n  easy way to avoid this.\n\nContributors\n---------------\n\n- Jeremias Maerki (original author)\n- Krister Wicksell\n- Vincent Hennebert\n- Simon Steiner\n- Luis Bernardo\n- Athanasios-Dimitrios Giannimaras\n- Dave Roxburgh\n\nVersions prior to 2.1 (i.e. prior to the move to the Apache XML Graphics\nproject) can be downloaded from here:\nhttp://www.jeremias-maerki.ch/development/fop/index.html\n\n\n==============================================================================\n  RELEASE NOTES\n==============================================================================\n\nVersion 2.11\n=========================\n\nChanges:\nFOP-3203: Upgrade to PDFBox 3\nFOP-3210: Correct position when merging pdfs\nFOP-3213: Sort dict hash to find more duplicates\nFOP-3227: Draw softmask without rasterizing page\nFOP-3230: Fix PDF/UA compliance issues when attaching a PDF/UA file\nFOP-3233: Avoid merging fonts without mac cmap\nFOP-3234: Use unique value for glyph index for font merging\nFOP-3235: Correct PS transform for gradients and mask for images\nFOP-3237: Use DPI to set resolution of PDFBox images\nFOP-3240: Use glyph from fonts where is exists for font merge\n\nVersion 2.10\n=========================\n\nChanges:\nFOP-3149: Don't merge fonts when ascent is different\nFOP-3155: Use format 12 for unicode cmap\nFOP-3158: Switch to spotbugs\nFOP-3183: Disable pattern modification using xobjforms\nFOP-3200: Correct end of start code for merging ttf cmap\n\nVersion 2.9\n=========================\n\nChanges:\nFOP-3107: Update to PDFBox 2.0.27\nFOP-3108: Gradient component not displayed correctly after scaling\nFOP-3112: Rotate annotations\nFOP-3123: Modified stream should be used in the cache key\nFOP-3124: Subrs data missing from font merging\nFOP-3136: Softmask dictionary preserved\nFOP-3138: NPE when no fields\nFOP-3140: Merge form fields\n\nVersion 2.8\n=========================\n\nChanges:\nFOP-3051: Upgrade to Commons IO 2.11\nFOP-3073: Preserve bytes when cloning string\nFOP-3089: Switch cmap format to support iPhone\nFOP-3102: Move composite glyphs to the end\n\nVersion 2.7\n=========================\n\nChanges:\nFOP-3034: Update PDFBox to 2.0.24\nFOP-3032: Allow to embed native PDF in AFP\nFOP-3020: Add space to standard position for font merge\nFOP-3009: Avoid merging fonts with different number of cmap formats\nFOP-3001: Deduplicate streams in arrays\n\nVersion 2.6\n=========================\n\nChanges:\nFOP-2951: Add uniquename to xobj form\nFOP-2965: Keep streams with DCT compression\nFOP-2971: Update unique name inside patterns\nFOP-2974: Handle space in COSName\nFOP-2979: Update PDFBox to 2.0.19\n\nVersion 2.5\n=========================\n\nChanges:\nFOP-2904: Handle object for boundingbox\nFOP-2922: Syntax error after writing content stream\nFOP-2933: PDF to PDF checkbox missing\n\nVersion 2.4\n=========================\n\nChanges:\nFOP-2802: Java 10 PDF/SVG to Image box not shown\nFOP-2812: Update PDFBox to 2.0.11\nFOP-2836: Update PDFBox to 2.0.13\nFOP-2840: Image mask in PDF not rendered to PS\nFOP-2841: PDF to PDF with merge-fonts checkbox misaligned\nFOP-2856: Support compile on Java 12\nFOP-2873: Update to PDFBox 2.0.16\nFOP-2879: Add caching to avoid parsing content stream\nFOP-2882: Allow PDFFormXObject to improve performance\n\nVersion 2.3\n=========================\n\nChanges:\nFOP-2251: PDF to Postscript not showing transparency\nFOP-2715: Optimise PDFWriter writing out floats\nFOP-2719: PDF to PS NPE when encode param not set\nFOP-2720: PDF to PCL exception on clipping\nFOP-2723: PDF to PDF deduplicate more types of streams\nFOP-2739: Upgrade to PDFBox 2.0.7\nFOP-2739: Avoid rastering PDF with Smask to image\nFOP-2746: PDF to PDF NPE during structuretree merge\nFOP-2750: Use streams for OTF subsetting\nFOP-2753: PDF to PS allow fop fonts as fallback\nFOP-2754: Error when merging True Type font with CFF PDF font\n\nVersion 2.2\n=========================\n\nChanges:\n- Move to PDFBox 2\n- Deduplicate PDF streams\n- PDF to PS deduplication of images\n- Remove xobj type=form\n- Merge fonts (off by default)\n- Support PDF shading to PS\n- Merging of Tagged (Accessible) PDF\n- Bugfix for handling of strings (the check method for US-ASCII had a bug)\n\nVersion 2.0 (2010-10-28)\n=========================\n\nChanges:\n- Moved from PDFBox (org.pdfbox) to Apache PDFBox (org.apache.pdfbox). Note\n  that Apache PDFBox is currently in incubation at the ASF. More info at:\n  http://incubator.apache.org/pdfbox/\n- Added support for \"null\" objects in PDF.\n- Added support for FOP's new intermediate format (and the new output\n  implementations).\n- Fixed transfer of untouched streams.\n- Added an ImageConverter that extends Apache XML Graphics Commons' image\n  loader framework with a converter from PDFBox to Java2D. This enables PDF\n  display for all of FOP's output formats. See the restrictions mentioned above.\n- Fix re-encoding problem for binary strings (for example lookup tables for\n  /Indexed color spaces).\n- Taken advantage of https://issues.apache.org/jira/browse/PDFBOX-507 to\n  avoid warning messages in COSDocument's finalizer method.\n- Fixed NullPointerException if a page has no content stream (empty page).\n- Added limited support for AcroForms (PDF forms).\n- Using CropBox instead of MediaBox, if available, to define the portion of the\n  PDF to display.\n- Added support for the /Rotation entry in the Page dictionary.\n- Handled the case where the Resources dict of a page is missing and therefore\n  inherited.\n- Fixed a problem with Crop/MediaBox dictionaries not starting at coordinate 0,0.\n- Added on-load hook to decrypt a PDF, for example.\n- Added support for merging AcroForms (Thanks to Vincent Hennebert)\n- Updated Apache PDFBox to version 0.8.0 to 1.3.1. The plug-in now requires at\n  least J2SE 1.5!\n\n\nVersion 1.3 (2008-11-28)\n=========================\n\nChanges:\n- Fixed a NullPointerException when the MediaBox is inherited.\n- An invalid page number is now properly handled.\n\n\nVersion 1.2 (2008-04-04)\n=========================\n\nChanges:\n- Fixed handling of rotated pages (Thanks to Krister Wicksell)\n- Fixed \"PDFObject already has an object number\" error occurring with certain\nPDFs.\n\nVersion 1.1a (2008-01-22)\n=========================\n\nChanges:\n- Disabled the in-memory caching of PDF files due to an intermittent bug that\nappeared due to reuse of a PDDocument. This needs to be fixed in PDFBox.\n- Change in PDFBox: Don't warn about that COSDocument isn't closed. Instead,\nthe object is closed automatically when it's collected.\n\nVersion 1.1 (2008-01-14)\n=========================\n\nChanges:\n- Adjustments to changes in FOP Trunk after the introduction of a new image\nloading package (in Apache XML Graphics Commons).\n- Support for addressing every single page in a PDF, not just the first.\n\nNote: This version will only work with FOP Trunk (revision 611768 or later) or\nwith FOP 0.95 when it is released.\n\nVersion 1.0 (2007-08-06)\n=========================\n\nThis is the initial release. Feedback is welcome as this is very new code.\n\nNote: Version 1.0 contains a modified version of PDFBox! I'll send a patch\nwith the change to the PDFBox project so hopefully the next version of PDFBox\nwill not need such a modification.\n\nNote: Version 1.0 contains a development version of Apache FOP from the\nfollowing branch:\nhttps://svn.apache.org/repos/asf/xmlgraphics/fop/branches/Temp_PDF_in_PDF/\nAs soon as the code is stabilized this will be merged into the Trunk.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fxmlgraphics-fop-pdf-images","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fxmlgraphics-fop-pdf-images","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fxmlgraphics-fop-pdf-images/lists"}