MagicImage is a Java library for image processing. It can support many formats of images in Java programs and provide common functions to make adjustments to the image in post. After you finish adjusting your images, you can export them to many formats, too. MagicImage uses Mson library to load the metadata of images, MagicCommand library to integrate ImageMagick tool, Commons Imaging library to import the image files, java-image-scaling library to scale images with high quality, and ICAFE library to import and export image files.
ImageMetadata class is in the org.magiclen.magicimage package.
You don't need to do initialize when you use ImageMetadata class. Just use its static methods to do what you want.
You can use readMetadataFromFile static method to read the metadata from an image file. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final JSONObject jsonImg = ImageMetadata.readMetadataFromFile(imageFile);
System.out.println(jsonImg.toString(true));
The result is,
{
"Basic" : {
"Bits Per Pixel" : 24,
"Width DPI" : 300,
"Compression Algorithm" : "JPEG",
"Format Details" : "Jpeg/DCM",
"Width Inch" : 12.58666706085205,
"Height DPI" : 300,
"Format" : "JPEG",
"Height Inch" : 8.399999618530273,
"Height" : 2520,
"Mime Type" : "image/jpeg",
"Color Type" : "YCbCr",
"Width" : 3776,
"Number of Images" : 1
},
"Metadata" : [
{
"name" : "Make",
"id" : 271,
"type" : "String",
"value" : "Panasonic"
},
{
"name" : "Model",
"id" : 272,
"type" : "String",
"value" : "DMC-LX7"
},
{
"name" : "Orientation",
"id" : 274,
"type" : "Integer",
"value" : 1
},
{
"name" : "XResolution",
"id" : 282,
"type" : "Real",
"value" : 300.0
},
{
"name" : "YResolution",
"id" : 283,
"type" : "Real",
"value" : 300.0
},
{
"name" : "ResolutionUnit",
"id" : 296,
"type" : "Integer",
"value" : 2
},
{
"name" : "Software",
"id" : 305,
"type" : "String",
"value" : "Adobe Photoshop CC (Windows)"
},
{
"name" : "DateTime",
"id" : 306,
"type" : "String",
"value" : "2014:02:16 23:26:53"
},
{
"name" : "ExifOffset",
"id" : 34665,
"type" : "Integer",
"value" : 208
},
{
"name" : "ExposureTime",
"id" : 33434,
"type" : "Real",
"value" : 0.1
},
{
"name" : "FNumber",
"id" : 33437,
"type" : "Real",
"value" : 2.1
},
{
"name" : "ExposureProgram",
"id" : 34850,
"type" : "Integer",
"value" : 3
},
{
"name" : "PhotographicSensitivity",
"id" : 34855,
"type" : "Integer",
"value" : 200
},
{
"name" : "ExifVersion",
"id" : 36864,
"type" : "Byte Array",
"value" : [
48,
50,
51,
48
]
},
{
"name" : "DateTimeOriginal",
"id" : 36867,
"type" : "String",
"value" : "2014:02:16 17:47:32"
},
{
"name" : "DateTimeDigitized",
"id" : 36868,
"type" : "String",
"value" : "2014:02:16 17:47:32"
},
{
"name" : "ShutterSpeedValue",
"id" : 37377,
"type" : "Real",
"value" : 3.321928
},
{
"name" : "ApertureValue",
"id" : 37378,
"type" : "Real",
"value" : 2.140779
},
{
"name" : "ExposureCompensation",
"id" : 37380,
"type" : "Real",
"value" : 0.0
},
{
"name" : "MaxApertureValue",
"id" : 37381,
"type" : "Real",
"value" : 2.140625
},
{
"name" : "MeteringMode",
"id" : 37383,
"type" : "Integer",
"value" : 5
},
{
"name" : "LightSource",
"id" : 37384,
"type" : "Integer",
"value" : 0
},
{
"name" : "Flash",
"id" : 37385,
"type" : "Integer",
"value" : 16
},
{
"name" : "FocalLength",
"id" : 37386,
"type" : "Real",
"value" : 13.7
},
{
"name" : "ColorSpace",
"id" : 40961,
"type" : "Integer",
"value" : -1
},
{
"name" : "ExifImageWidth",
"id" : 40962,
"type" : "Integer",
"value" : 3776
},
{
"name" : "ExifImageLength",
"id" : 40963,
"type" : "Integer",
"value" : 2520
},
{
"name" : "FocalPlaneXResolution",
"id" : 41486,
"type" : "Real",
"value" : 4903.225799560547
},
{
"name" : "FocalPlaneYResolution",
"id" : 41487,
"type" : "Real",
"value" : 4903.225799560547
},
{
"name" : "FocalPlaneResolutionUnit",
"id" : 41488,
"type" : "Integer",
"value" : 3
},
{
"name" : "SensingMethod",
"id" : 41495,
"type" : "Integer",
"value" : 2
},
{
"name" : "FileSource",
"id" : 41728,
"type" : "Byte Array",
"value" : [
3
]
},
{
"name" : "SceneType",
"id" : 41729,
"type" : "Byte Array",
"value" : [
1
]
},
{
"name" : "CustomRendered",
"id" : 41985,
"type" : "Integer",
"value" : 0
},
{
"name" : "ExposureMode",
"id" : 41986,
"type" : "Integer",
"value" : 0
},
{
"name" : "WhiteBalance",
"id" : 41987,
"type" : "Integer",
"value" : 0
},
{
"name" : "DigitalZoomRatio",
"id" : 41988,
"type" : "Real",
"value" : 0.0
},
{
"name" : "FocalLengthIn35mmFormat",
"id" : 41989,
"type" : "Integer",
"value" : 70
},
{
"name" : "SceneCaptureType",
"id" : 41990,
"type" : "Integer",
"value" : 0
},
{
"name" : "GainControl",
"id" : 41991,
"type" : "Integer",
"value" : 1
},
{
"name" : "Contrast",
"id" : 41992,
"type" : "Integer",
"value" : 0
},
{
"name" : "Saturation",
"id" : 41993,
"type" : "Integer",
"value" : 0
},
{
"name" : "Sharpness",
"id" : 41994,
"type" : "Integer",
"value" : 0
},
{
"name" : "Compression",
"id" : 259,
"type" : "Integer",
"value" : 6
},
{
"name" : "XResolution",
"id" : 282,
"type" : "Real",
"value" : 72.0
},
{
"name" : "YResolution",
"id" : 283,
"type" : "Real",
"value" : 72.0
},
{
"name" : "ResolutionUnit",
"id" : 296,
"type" : "Integer",
"value" : 2
},
{
"name" : "JpgFromRawStart",
"id" : 513,
"type" : "Integer",
"value" : 838
},
{
"name" : "JpgFromRawLength",
"id" : 514,
"type" : "Integer",
"value" : 8060
}
]
}
You are able to download my sample image here.
ImageBuffer class is in the org.magiclen.magicimage package.
You don't need to do initialize when you use ImageBuffer class. Just use its static methods to do what you want.
You can use getBufferedImages static method to load images from an image file. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
There may be more than 1 images in an image file, so the getBufferedImages static method returns BufferedImage array.
You can use cloneBufferedImage static method to copy BufferedImage. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage cloneBi = ImageBuffer.cloneBufferedImage(bi);
ImageExport class is in the org.magiclen.magicimage package.
You don't need to do initialize when you use ImageExport class. Just use its static methods to do what you want.
You can use exportToJPEG static method to export BufferedImage to JPEG format file. You can also decide its quality to compress the file size. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final File outputFile = new File("/home/magiclen/MyCat.jpg");
System.out.println(ImageExport.exportToJPEG(bi, outputFile, 0.8f, true));
The size of the original JPEG file is 7.1MB. But after exportToJPEG static method called, the size of the output JPEG file is 1.4MB. The output size is very smaller than the original, but it is only lost a little details.
You can use exportToPNG static method to export BufferedImage to PNG format file. You can also decide its compression quality to decrease the file size. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final File outputFile = new File("/home/magiclen/MyCat1.png");
System.out.println(ImageExport.exportToPNG(bi, outputFile, 1f, true));
final File outputFile2 = new File("/home/magiclen/MyCat0.png");
System.out.println(ImageExport.exportToPNG(bi, outputFile2, 0f, true));
You should know that the compression of PNG is lossless. It means that although you decrease the file size, the quality of this image is the same. You can see the MyCat1.png and MyCat0.png files. They have different compression quality. The file size of MyCat1.png is 38.1MB, but the file size of MyCat0.png is only 18.4MB.
You can use exportToBMP static method to export BufferedImage to BMP format file. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final File outputFile = new File("/home/magiclen/MyCat.bmp");
System.out.println(ImageExport.exportToBMP(bi, outputFile, true));
You can use exportToGIF static method to export BufferedImage to GIF format file. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final File outputFile = new File("/home/magiclen/MyCat.gif");
System.out.println(ImageExport.exportToGIF(bi, outputFile, true));
You can use exportToTIFF static method to export BufferedImage to TIFF format file. You can also decide its compression quality to decrease the file size, and lossless or lossy. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final File outputFile = new File("/home/magiclen/MyCat.tiff");
System.out.println(ImageExport.exportToTIFF(bi, outputFile, 0.8f, false, true));
final File outputFile2 = new File("/home/magiclen/MyCat-lossless.tiff");
System.out.println(ImageExport.exportToTIFF(bi, outputFile2, 0.8f, true, true));
The file size of MagicCat.tiff is 1.4MB, but the file size of MyCat-lossless.tiff is 23.4MB. If you want to use lossless compression, we suggest you use PNG format.
ImageSharpen class is in the org.magiclen.magicimage package.
You don't need to do initialize when you use ImageSharpen class. Just use its static methods to do what you want.
You can use sharpen static method to export BufferedImage to sharpen an image. You can also decide how much you want to sharpen. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage result = ImageSharpen.sharpen(bi, 3);
final File outputFile = new File("/home/magiclen/MyCat-sharpen.jpg");
System.out.println(ImageExport.exportToJPEG(result, outputFile, 0.8f, true));
We suggest the sharpen value should be between 0 and 1.5.
ImageBlurring class is in the org.magiclen.magicimage package.
You don't need to do initialize when you use ImageBlurring class. Just use its static methods to do what you want.
You can use blur static method or gaussianBlur static method to blur an image. You can also decide how much you want to blur. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage result = ImageBlurring.blur(bi, 20);
final File outputFile = new File("/home/magiclen/MyCat-blur.jpg");
System.out.println(ImageExport.exportToJPEG(result, outputFile, 0.8f, true));
final BufferedImage result2 = ImageBlurring.gaussianBlur(bi, 20);
final File outputFile2 = new File("/home/magiclen/MyCat-gaussian-blur.jpg");
System.out.println(ImageExport.exportToJPEG(result2, outputFile2, 0.8f, true));
Gaussian Blur is smoother than blur.
ImageResize class is in the org.magiclen.magicimage package.
You don't need to do initialize when you use ImageResize class. Just use its static methods to do what you want.
You can use crop static method to crop an image. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage result = ImageResize.crop(bi, 900, 900, 1250, 160);
final File outputFile = new File("/home/magiclen/MyCat-crop.jpg");
System.out.println(ImageExport.exportToJPEG(result, outputFile, 0.8f, true));
You can use resize static method to resize an image. It can also sharpen the image resized automatically. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage result = ImageResize.resize(bi, 4000, -1, false, false);
final File outputFile = new File("/home/magiclen/MyCat-4000.jpg");
System.out.println(ImageExport.exportToJPEG(result, outputFile, 0.8f, true));
You can use shrink static method to resize an image. It can also sharpen the image resized automatically. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage result = ImageResize.shrink(bi, 1920, 720, -1); // Limit the width and height
final File outputFile = new File("/home/magiclen/MyCat-h720.jpg");
System.out.println(ImageExport.exportToJPEG(result, outputFile, 0.8f, true));
If you don't want to sharpen, set the sharpen value to 0.
ImageColor class is in the org.magiclen.magicimage package.
You don't need to do initialize when you use ImageColor class. Just use its static methods to do what you want.
You can use grayscale static method to create a grayscale image. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage result = ImageColor.gray(bi);
final File outputFile = new File("/home/magiclen/MyCat-gray.png");
System.out.println(ImageExport.exportToPNG(result, outputFile, true));
You can use binary static method to create a binary image. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage result = ImageColor.binary(bi);
final File outputFile = new File("/home/magiclen/MyCat-binary.png");
System.out.println(ImageExport.exportToPNG(result, outputFile, true));
You can use negative static method to create a negative image. For example,
final File imageFile = new File("/home/magiclen/MagicCat.jpg");
final BufferedImage bi = ImageBuffer.getBufferedImages(imageFile)[0];
final BufferedImage result = ImageColor.negative(bi);
final File outputFile = new File("/home/magiclen/MyCat-negative.jpg");
System.out.println(ImageExport.exportToJPEG(result, outputFile, 0.8f, true));
You can use union static method to create the union of two images.
You can use distinct static method to find the distinct pixels of two images.
You can use maximize static method to create a maximized image.
ImageInterlacer class is in the org.magiclen.magicimage package.
It needs ImageMagick's support. You need to assign the path of a magick binary file to MAGICK_PATH static variable.
ImageInterlacer.MAGICK_PATH = "/path/to/magick";
Before you use a magick binary file, you should check ity availability. You can use isAvailable static method to valadate.
if(ImageInterlacer.isAvailable()){
}
You can use isInterlaced static method to check a file if it is an interlaced image.
final boolean interlace = ImageInterlacer.isInterlaced(file);
You can use setInterlace static method to set a file's interlace type.
final boolean success = ImageInterlacer.setInterlace(file, ImageInterlacer.Interlace.PLANE);
Copyright 2015-2017 magiclen.org
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Please check out our web page at