Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nackily/imglib
A lightweight image processing library of JAVA for simplifying development.
https://github.com/nackily/imglib
image-processing java thumbnails
Last synced: 27 days ago
JSON representation
A lightweight image processing library of JAVA for simplifying development.
- Host: GitHub
- URL: https://github.com/nackily/imglib
- Owner: nackily
- License: apache-2.0
- Created: 2022-11-09T07:27:09.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-11-30T02:59:34.000Z (about 1 year ago)
- Last Synced: 2024-11-07T10:20:52.589Z (about 1 month ago)
- Topics: image-processing, java, thumbnails
- Language: Java
- Homepage:
- Size: 7.34 MB
- Stars: 229
- Watchers: 1
- Forks: 18
- Open Issues: 1
-
Metadata Files:
- Readme: README.en.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome - nackily/imglib - processing,java,thumbnails pushed_at:2023-11 star:0.2k fork:0.0k A lightweight image processing library of JAVA for simplifying development. (Java)
README
# Imglib: lightweight *Im*a*g*e processing *lib*rary
[](https://search.maven.org/artifact/io.github.nackily/imglib-all)
[](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html)
[](https://www.apache.org/licenses/LICENSE-2.0)
[](README.md)
## What is *imglib*?
*Imglib* is a lightweight image processing library for JAVA, which committed to simplifying frequently image processing.
## What can *imglib* do?
*Imglib* mainly provides three capabilities:
* **Image Collection**
*Imglib* provides the ability to collect images, allowing developers to create images from nothing, such as creating
transparent image, hash image, and capturing screenshot. At the same time, developers can extract images from files,
such as extract whole page as image from PDF file or extract frame as image from GIF file.
* **Image Processing**
With *Thumbnailator*, we can easily implement the basic operations of images, including scaling, cropping, rotation,
image watermarking and format conversion. On this basis, *imglib* extends processors such as adding border, lossless
magnification, mosaics, rounded corner, graying, binarization, and drawing shapes on image.
* **Merging and Splitting**
*Imglib* provides merging and splitting capabilities, including merging multiple images into a single image and
splitting image into multiple images. It supports cutting and jigsaw of images according to grid, and encode multiple
images into GIF file. Developers can also expand freely according to actual needs.
## How simple is *imglib*?
Like *Thumbnailator*, *imglib* shields developers from complex I/O operations and eliminates the need to manually
manipulate images through Graphics2D objects. *imglib* has done all this for you. It's chained API allows you to
configure and execute a complex image processing task step by step.
> For example, the task of create a hash avatar for the user, the avatar setting to 8px\*8px, the image size setting
> to 300px\*300px, and add a border with a margin of 20px. This image generation task can be completed through the
> following code fragments:
```java
ImagePipes.ofEmptySource()
.register(new HashImageGenerator.Builder("Imglib") // add a hash image generator
.gridVerticalNum(8) // number of lattice in horizontal direction
.bgColor(ColorUtils.of(240, 240, 240)) // the background color of hash image
.fgColor(ColorUtils.of(50, 150, 50)) // the foreground color of hash image
.build())
.toThumbnails() // get object of Thumbnails
.addFilter(new HighQualityExpandHandler.Builder() // add a filter of lossless expansion handler
.finalWidth(150) // the final width after expanded
.keepAspectRatio(true) // setting of keep the aspect ratio
.build())
.addFilter(new BorderHandler.Builder() // add a filter of border handler
.fillColor(ColorUtils.of(240, 240, 240)) // fill color of the border
.vMargins(15) // vertical margin
.hMargins(15) // horizontal margin
.alpha(1.0f) // the transparency of the border
.build())
.scale(1.0)
.toFile(".../avatar.png");
```
> By executing the above code fragment, we will get the following user avatar.
## How to use *imglib*?
**Maven**
Add the following maven dependencies in the pom.xml of your project.
```xml
io.github.nackily
imglib-all
{*.*.*}
```
**Jar**
You can also visit [**maven-repository**](https://repo1.maven.org/maven2/io/github/nackily/imglib-all/),
download the corresponding version of `imglib-all-*.*.*.jar` and import it into your project.
**Tips**
It is worth mentioning that *imglib* is not a project started from nothing, it just stands on the shoulders
of giants! *imglib* is based on [Thumbnailator](https://github.com/coobird/thumbnailator) in image processing,
relies on [pdfbox](https://github.com/apache/pdfbox) in PDF document parsing, and references
[animated-gif-lib-for-java](https://github.com/rtyley/animated-gif-lib-for-java) in GIF document processing.
Although *imglib* relies on these excellent third-party dependencies in some image processing capabilities,
*imglib* does not include relevant dependencies after packaging. If necessary, you should add corresponding
dependencies to the project independently.Please refer to [Dependencies](/docs/Dependencies.md) for detailed
lists.
## See more
Get more information about *imglib* by visit the following links:
+ [**Examples**](/docs/Examples.en.md)
+ [**Dependencies**](/docs/Dependencies.en.md)
+ [**API Documentation**](/docs/APIs.en.md)
+ [**Frequently Asked Questions**](/docs/FAQ.en.md)