Project

imageutils

0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
imageutilsnandosola/imageutilsHomepageDocumentationSource CodeBug TrackerWiki
This gem wraps a Java Library to transform scanned image docs (PDF, TIF, GIF, JPG, PNG) into PDF/A-1b. It has some extra features too
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
14,821
Stars
7
Forks
6
Watchers
3
 Releases
Current version
0.0.5
Total releases
5
First release
2013-03-19
Latest release
2013-11-08
 Issues
Open Issues
0
Closed Issues
2
Total Issues
2
Issue Closure Rate
100%
 Pull Requests
Open Pull Requests
1
Closed Pull Requests
0
Merged Pull Requests
2
Pull Request Acceptance Rate
66%
 Development
Primary Language
Java
Licenses
GNU Lesser General Public License, Version 3.0
Average date of last 50 commits
2013-11-24
Reverse Dependencies
0

 Dependencies
 Project Readme

PDF Image Utils

This library allows you to import scanned TIFF files and convert them into PDF 1.4 format. Additionally, a PNG thumbnail is generated. It can import image PDFs too. As the development goes on, more image formats (GIF, PNG, JPEG) are going to be accepted and converted to PDF. In any case, the minimum resolution for the files to be accepted is 300dpi. Thumbnails are generated at a resolution of 72 dpi.

For now, this is a work in progress for an internal JRuby project. However, the information on the Internet is so scarce and spread, that this code might help you.

The main goal is achieving PDF/a1-b compliance in order to store these images in a document archive.

Usage

  1. Make sure you have at least Open/Oracle JDK 1.7.0_15
  2. Clone the project.
  3. The dependency named image-filters is fetched froum our local Nexus repository. If you don't have a local Maven repo, please download them to a known directory and change the dependency scope to system.
  4. Execute mvn clean install.
  • The JRuby gem is ready to be generated from target/ruby-gem. There is an experimental gem already deployed at RubyGems
  • For Java users: the artifact is located under the target/ directory. Its dependencies are located under target/ruby-gem/lib. The binary extensions and their JNI adapters are located under target/ruby-gem/lib.

Note that, if you want to use the artifacts from pure Java, the binary dependencies (.so files) require the following environmental variables to be set:

  1. JAIHOME must point to the directory where libclib_jiio.so and libmlib_jai.so are located.
  2. Add JAIHOME to your CLASSPATH too.
  3. LD_LIBRARY_PATH (or LD_RUN_PATH if not executed from commandline or script) must include JAIHOME.

Thus, any Java application using imageutils should declare the variables above. The JRuby gem declares the variables above automatically when required.

Known issues

  • AFAIK, there is a bug up to JRuby 1.7.3 that prevents pushing gems to RubyGems. So if you want to publish your own gem, at least 1.7.4-dev should be used. In my case, the gem was pushed via MRI 1.9.3.
  • PDF conversion tests will fail under OS X with JDK7. See this post on StackOverflow.
  • On OS X, it might me necessary to create the symlink: soffice.bin -> ./soffice under /Applications/LibreOffice.app/Contents/MacOS. Just execute the integration tests and check the error messages.

TODO

  • Improve PDF image extraction.
  • Generate ISO 216-A page sizes dinamically.
  • Generate PDF/A-1b from scanned image PDF
    • Insert RDF & metadata into target PDFs.
  • Deploy as a Maven artifact.
  • JavaDocs.
  • Tests:

Licenses

  • GNU Lesser General Public License, version 3. See LICENSE file for the whole enchilada.
  • See the licenses/ directory for additional software licenses and terms of service notices.