https://github.com/ubleipzig/image
A collection of utilities for image metadata processing
https://github.com/ubleipzig/image
exif iiif image-processing jackson java json
Last synced: 2 months ago
JSON representation
A collection of utilities for image metadata processing
- Host: GitHub
- URL: https://github.com/ubleipzig/image
- Owner: ubleipzig
- License: gpl-3.0
- Created: 2018-04-18T08:49:01.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-05-19T07:06:01.000Z (about 8 years ago)
- Last Synced: 2026-01-14T04:36:43.843Z (5 months ago)
- Topics: exif, iiif, image-processing, jackson, java, json
- Language: Java
- Homepage:
- Size: 41.7 MB
- Stars: 0
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Image
A collection of image processing utilities
### Image Metadata
A utility that generates JSON objects that contain image metadata.
[](https://travis-ci.org/ubleipzig/image)
[](https://codecov.io/gh/ubleipzig/image)
[](https://ubleipzig.github.io/image/apidocs/)
[](https://mvnrepository.com/artifact/de.ubleipzig/image.metadata/0.1.0)
#### Install
`./gradlew clean distTar`
* extract `image.metadata-0.2.0-SNAPSHOT.tar`
## Sequenced Image Filename Specification
This tool assumes that all images will have integer filenames in accordance with their sequence in the image collection.
## JPEG2000 Conversion
This tool recognizes files with the extensions ".jpx" or ".jp2" and will read their dimensions.
This requires the host to have the ImageMagick `identify` utility compiled with JP2 support available in the PATH.
To install this utility, check the [releases](https://github.com/uclouvain/openjpeg/releases)
## Usage
```bash
image.metadata -i image_source_directory -o dimension_manifest [-z] metadata_manifest
```
| Argument | Description | Example |
| -------- | ----------- | ----------- |
| image_source_directory_path | the file path to the image sources | /images |
| dimension_manifest | a file path to the manifest outputfile | /output.json |
| metadata_manifest (optional) | a file path to the metadata manifest outputfile | /manifest.json |
#### Use in Java:
```groovy
compile group: 'de.ubleipzig', name: 'image.metadata', version: '0.1.0'
```
* Generate an image dimension manifest with :
```java
/**
* @param String imageSourceDir
*/
```
```java
ImageMetadataServiceConfig config = new ImageMetadataServiceConfig();
config.setImageSourceDir(imageSourceDir);
final ImageMetadataService generator = new ImageMetadataServiceImpl(config);
final ImageDimensionManifest dimManifest = generator.build();
```
The dimension manifest when serialized looks like this:
```json
{
"collection" : "/some-image-collection",
"images" : [
{
"filename" : "00000001.jpg",
"digest" : "jeUrOCoqaYw/89LmIo3gQlxhipE=",
"height" : 2130,
"width" : 1705
},
{
"filename" : "00000002.jpg",
"digest" : "5t/uKe+X1vTe0fR2YAGYj4OzgiI=",
"height" : 2130,
"width" : 1705
},
{
"filename" : "00000003.jpg",
"digest" : "8caG/XPRwwAZSU3Pldcsl7ZEtoA=",
"height" : 2130,
"width" : 1705
}
]
}
```
The `ImageDimensionManifest` is a `List` where each `ImageDimension` has setter and getters available
for subsequent processing.
Also available is the complete list of `ImageMetadataTag`. This `ImageMetadataManifest` can be built like this:
```java
ImageMetadataServiceConfig config = new ImageMetadataServiceConfig();
config.setImageSourceDir(imageSourceDir);
final ImageMetadataService generator = new ImageMetadataServiceImpl(config);
final ImageDimensionManifest dimManifest = generator.buildImageMetadataManifest();
```
An typical JPEG image produces this:
```json
{
"filename" : "00000001.jpg",
"digest" : "jeUrOCoqaYw/89LmIo3gQlxhipE=",
"directories" : [
{
"directory" : "JPEG",
"tags" : [
{
"tagName" : "Compression Type",
"tagDescription" : "Baseline"
},
{
"tagName" : "Data Precision",
"tagDescription" : "8 bits"
},
{
"tagName" : "Image Height",
"tagDescription" : "2130 pixels"
},
{
"tagName" : "Image Width",
"tagDescription" : "1705 pixels"
},
{
"tagName" : "Number of Components",
"tagDescription" : "3"
},
{
"tagName" : "Component 1",
"tagDescription" : "Y component: Quantization table 0, Sampling factors 2 horiz/2 vert"
},
{
"tagName" : "Component 2",
"tagDescription" : "Cb component: Quantization table 1, Sampling factors 1 horiz/1 vert"
},
{
"tagName" : "Component 3",
"tagDescription" : "Cr component: Quantization table 1, Sampling factors 1 horiz/1 vert"
}
]
},
{
"directory" : "JpegComment",
"tags" : [
{
"tagName" : "JPEG Comment",
"tagDescription" : "Generated by IIPImage"
}
]
},
{
"directory" : "JFIF",
"tags" : [
{
"tagName" : "Version",
"tagDescription" : "1.1"
},
{
"tagName" : "Resolution Units",
"tagDescription" : "none"
},
{
"tagName" : "X Resolution",
"tagDescription" : "1 dot"
},
{
"tagName" : "Y Resolution",
"tagDescription" : "1 dot"
},
{
"tagName" : "Thumbnail Width Pixels",
"tagDescription" : "0"
},
{
"tagName" : "Thumbnail Height Pixels",
"tagDescription" : "0"
}
]
},
{
"directory" : "Huffman",
"tags" : [
{
"tagName" : "Number of Tables",
"tagDescription" : "4 Huffman tables"
}
]
},
{
"directory" : "File Type",
"tags" : [
{
"tagName" : "Detected File Type Name",
"tagDescription" : "JPEG"
},
{
"tagName" : "Detected File Type Long Name",
"tagDescription" : "Joint Photographic Experts Group"
},
{
"tagName" : "Detected MIME Type",
"tagDescription" : "image/jpeg"
},
{
"tagName" : "Expected File Name Extension",
"tagDescription" : "jpg"
}
]
}
]
}
```
## Credits
This library depends on the [com.drewnoakes:metadata-extractor](https://github.com/drewnoakes/metadata-extractor)