dragon66/icafe

Java library for reading, writing, converting and manipulating images and metadata

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.dragon66:icafe:icafe4j-v0.2'
	}

	dependencies {
		implementation("com.github.dragon66:icafe:icafe4j-v0.2")
	}

	<dependency>
	    <groupId>com.github.dragon66</groupId>
	    <artifactId>icafe</artifactId>
	    <version>icafe4j-v0.2</version>
	</dependency>


                            
    libraryDependencies += "com.github.dragon66" % "icafe" % "icafe4j-v0.2"


                            
    :dependencies [[com.github.dragon66/icafe "icafe4j-v0.2"]]

Readme

ICAFE

What is ICAFE? ICAFE is a pure Java library for:

Reading, writing images of popular formats - such as JPG, TIFF, GIF, PNG, BMP etc.
Converting between different image formats.
Extracting, inserting, and removing image metadata such as EXIF, Photoshop IRB, ICC_Profile, IPTC, XMP, thumbnail etc.
Manipulating images - such as creating animated GIF, merging or splitting multipage TIFF, removing or adding chunks to PNG and lots more.

Read format support:

Windows BITMAP
CompuServe GIF - Backed by a from-scratch tree-based LZW decoder (no hash, no string table, quick and clean); transparency support; Frame extraction for animated GIF.
ZSoft's PCX - Hard to find decoder for this dinosaur type of image.
Truevision TGA - Support all kinds of scan line mode, bit depth, and even transparency (alpha channel)
Portable Network Graphics (PNG) - Support both 8 bit and 16 bit, all color depth; single color transparency and alpha channel support; gamma support, ICC_Profile support.
Adobe TIFF - Support for RGB, Palette, CMYK, YCbCr Color image with LZW, Deflate, and Packbits compression. Support for both stripped and tiled format TIFF (From 1 bitPerPixel up to 64 bitPerPixel). Floating point samples are also supported (Half precision - 16 bit, single precision - 32 bit, double precision - 64 bit). Binary formats and JPEG compression are still under development.
IJG JPEG - Currently delegate to Java ImageIO - under development.

Write format support:

Windows BITMAP - Non-compressed RGB or 256 color image with the help of "icafe" color quantization utility.
CompuServe GIF - In-house tree-based LZW encoder; color quantization and diffusion dithering; inverse color map for colors to indexes mapping; transparency support.
IJG JPEG - Support 8 bit grayscale and full color; support both YCbCr and YCCK (CMYK) color spaces and embedded ICC_Profile, EXIF thumbnail; ANN fast forward DCT from scratch.
Adobe TIFF - Compression types supported: LZW, Deflate, CCITTRLE, CCITTGROUP3, CCITTGROUP4, JPEG, PACKBITS; extra sample suport for CMYK and transparent RGB; Horizontal differencing predictor support to reduce image size; optional ICC_Profile support for CMYK color space.
Portable Network Graphics (PNG) - Support indexed, grayscale, and RGB colors; support configurable adaptive filter.

Image convertion and management:

Image conversion to any of the supported format
Multipage TIFF support
- Create multiple page TIFF from a series of BufferedImages.
- Split multipage TIFF image into individual TIFF images without decompressing the images.
- Insert into or remove pages from multipage TIFF images.
- Merge multipage TIFF images togeter without decompressing (Support for any BitsPerSample TIFF).
Animated GIF support
- Create animated GIF from a series of BufferedImages.
- split animated GIF to individual images in any of the supported writing formats - keeping transparency etc.
JPEG and TIFF thumbnail support
- Insert thumbnails into JPEG image.
- Remove thumbnails from JPEG image.
- Extract thumbnails from JPEG (the extracted thumbnail is either in JPEG or TIFF format depending on whether or not it is in JPEG or Raw format and the inserted thumbnail could be completely different from the original image).
- Insert thumbnail to TIFF image.
- Extract thumbnail from TIFF Photoshop IRB tag.
- Extract Photoshop thumbnail from Photoshop APP13 (Photoshop IRB)
PNG chunk manipulation
- Remove chunks from or add chunks to existing PNG.
- Extract text chunk from PNG.
- Insert text chunk to PNG.
- Extract ICC profile from PNG.
- Insert ICC_Profile to PNG.
- Merge or split IDAT chunks.

Image metadata manipulation:

JPEG, TIFF, PNG EXIF data manipulation
- Insert EXIF data into JPEG.
- Extract EXIF data from JPEG.
- Remove EXIF data and other insignificant APPn segments from JPEG.
- Insert EXIF data into TIFF.
- Read EXIF data embedded in TIFF.
- Read EXIF embedded in PNG zTXt chunk as well as stand alone eXIf chunk.
JPEG, TIFF, PNG ICC Profile support
- Insert ICC profile to JPEG and TIFF.
- Extract ICC profile from JPEG, TIFF and PNG.
JPEG, TIFF, PNG IPTC metadata support
- Insert IPTC directly to TIFF via RichTiffIPTC tag.
- Insert IPTC to JPEG via APP13 Photoshop IRB
- Extract IPTC from JPEG, TIFF and PNG zTXt chunk.
JPEG and TIFF Photoshop IRB metadata support
- Insert IRB into JPEG via APP13 segment
- Insert IRB into TIFF via tag PHOTOSHOP.
- Extract IRB data from both JPEG and TIFF.
JPEG, GIF, PNG, TIFF XMP metadata support
- Insert XMP metada into JPEG, GIF, PNG, and TIFF image
- Extract XMP metadata from JPEG, GIF, PNG, and TIFF image
- In case of JPEG, handle normal XMP and extendedXMP which cannot fit into one APP1 segment
- JPEG and TIFF bulk metadata insertion support - insert more than one metadata types with a single method call
- JPEG XMP auto-split into standard and extended XMP in case the XMP data size exceeds JPEG APP1 segment limit

NOTE: The metadata related part of icafe has become another repository "pixymeta" which has no dependency on reading and writing function of "icafe". There is also an Android version called "pixymeta-android".

Who is using ICAFE

I know a lot of you are using this library even for commercial purpose. That's totally fine to me as that is my intention from day one of this library. Let me know if you want your name or company to be added here to show your appreciation.

Where can I get the latest release?

There is currently no stable release of ICAFE. However you can pull the latest SNAPSHOT from Sonatype SNAPSHOT repository by adding the snapshot repository to your pom.xml:

<repository>
  <id>oss.sonatype.org</id>
  <name>Sonatype Snapshot Repository</name>
  <url>https://oss.sonatype.org/content/repositories/snapshots</url>
  <releases>
    <enabled>false</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

Then you can use the SNAPSHOT version of ICAFE in your pom.xml:

<dependency>
  <groupId>com.github.dragon66</groupId>
  <artifactId>icafe</artifactId>
  <version>1.1-SNAPSHOT</version>
</dependency>

Suggestions? custom requirements? Open an issue or send email to me directly: yuwen_66@yahoo.com

Go to the wiki page to see this library in action or grab the "icafe.jar" from the lib folder and try it yourself!

Just in case you want to show your support and appreciation, here is a Paypal link: https://www.paypal.com/donate/?hosted_button_id=S8JZDYYMQQWCC