Skip to content

topobyte/ico4j

Repository files navigation

ico4j

Overview

The ico4j library allows you to read and write ICO image files in 100% pure Java.

Currently the following formats are supported:

  • ICO (Microsoft icon format - 1, 4, 8, 24 and 32 bit [XP uncompressed, Vista compressed])

Purpose

This project aims to provide:

  • an open source library for handling ICO image files in Java
  • with a commercial-friendly license
  • using only Java code, ie. without using any JNI hacks
  • with no dependencies on third-party libraries (where possible)

License

The ico4j library is licensed under the GNU LGPL v2.1 so you are free to use it in your Free Software and Open Source projects, as well as commercial projects, under the terms of the LGPL v2.1.

History

This library has been forked from imcdonagh/image4j, refactored and then reduced in scope to only focus on ICO images.

The original author states:

This project began after I spent hours searching for a library that would meet the above criteria and found that there is probably no such thing - or at least, not any more. The only support I could find for the ICO format was read-only, so doing cool stuff - like generating favicons on the fly - using only Java code was not possible.

QuickStart

It is possible to decode/encode ICO files with just one line of code!

The ico4j library consists of only Java code and has no dependencies on third-party libraries, so you just add it to the classpath and you're good to go.

Although the code is compatible with Java 1.5.0 or later, it should be relatively simple to port the code to an older version, eg. 1.4.2.

Decode

List<BufferedImage> image = ICODecoder.read(new File("input.ico"));

Encode

ICOEncoder.write(images, new File("output.ico"));

Credits

Disclaimer

To my knowledge, there are no patents on either the BMP or ICO formats.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages