de.ipcon.tools

Class Thumbnailer

java.lang.Object

de.ipcon.tools.Thumbnailer

public class Thumbnailer
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
static void	main(java.lang.String[] args)
static java.awt.Image	readImage(java.io.File infile)
static java.awt.image.BufferedImage	scaleImage(java.awt.Image image, int width, int height)
static byte[]	scaleUserGivenImageToConstraints(java.awt.image.BufferedImage image, int maxWidth, int maxHeight, int maxLength) Scales the provided BufferedImage to meet specified constraints and returns the result as a byte array.
static byte[]	scaleUserGivenImageToConstraints(java.awt.image.BufferedImage image, int maxWidth, int maxHeight, int maxLength, java.lang.String imageFormat)
static byte[]	scaleUserGivenImageToConstraints(java.io.File infile, int maxWidth, int maxHeight, int maxLength) Returns the given image file as a byte array with the following policy: - If the file is not an image, not found, or encounters any other problem, a runtime exception will be thrown
static void	thumbnail(java.io.File infile, java.io.File outfile, int width, int height, float quality)
static java.awt.image.BufferedImage	thumbnail(java.awt.Image image, int width, int height, float quality)
static void	thumbnail(java.lang.String infile, java.lang.String outfile, int width, int height, float quality)
static void	writeImage(java.awt.image.RenderedImage image, java.io.File outfile, float quality)
static void	writeImage(java.awt.image.RenderedImage image, java.io.File outfile, float quality, java.lang.String imageFormat)
static void	writeImage(java.awt.image.RenderedImage image, javax.imageio.stream.ImageOutputStream ios, float quality)
static void	writeImage(java.awt.image.RenderedImage image, javax.imageio.stream.ImageOutputStream ios, float quality, java.lang.String imageFormat)
static void	writeImage(java.awt.image.RenderedImage image, java.io.OutputStream outstream, float quality)
static void	writeImage(java.awt.image.RenderedImage image, java.io.OutputStream outstream, float quality, java.lang.String imageFormat)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

main

public static void main(java.lang.String[] args)

thumbnail

public static void thumbnail(java.lang.String infile,
                             java.lang.String outfile,
                             int width,
                             int height,
                             float quality)

thumbnail

public static void thumbnail(java.io.File infile,
                             java.io.File outfile,
                             int width,
                             int height,
                             float quality)

thumbnail

public static java.awt.image.BufferedImage thumbnail(java.awt.Image image,
                                                     int width,
                                                     int height,
                                                     float quality)

readImage

public static java.awt.Image readImage(java.io.File infile)

scaleImage

public static java.awt.image.BufferedImage scaleImage(java.awt.Image image,
                                                      int width,
                                                      int height)

writeImage

public static void writeImage(java.awt.image.RenderedImage image,
                              java.io.File outfile,
                              float quality)

writeImage

public static void writeImage(java.awt.image.RenderedImage image,
                              java.io.File outfile,
                              float quality,
                              java.lang.String imageFormat)

writeImage

public static void writeImage(java.awt.image.RenderedImage image,
                              java.io.OutputStream outstream,
                              float quality)

writeImage

public static void writeImage(java.awt.image.RenderedImage image,
                              java.io.OutputStream outstream,
                              float quality,
                              java.lang.String imageFormat)

writeImage

public static void writeImage(java.awt.image.RenderedImage image,
                              javax.imageio.stream.ImageOutputStream ios,
                              float quality)

writeImage

public static void writeImage(java.awt.image.RenderedImage image,
                              javax.imageio.stream.ImageOutputStream ios,
                              float quality,
                              java.lang.String imageFormat)

scaleUserGivenImageToConstraints

public static byte[] scaleUserGivenImageToConstraints(java.io.File infile,
                                                      int maxWidth,
                                                      int maxHeight,
                                                      int maxLength)

Returns the given image file as a byte array with the following policy: - If the file is not an image, not found, or encounters any other problem, a runtime exception will be thrown. - If the image dimensions are within the specified bounds, the original file content is retained. - If the image dimensions exceed the specified bounds, a scaled version of the image in JPEG format is returned.

Parameters:

infile - The input image file to be processed.

maxWidth - The maximum width allowed for the image.

maxHeight - The maximum height allowed for the image.

maxLength - The maximum length (file size) allowed for the image.

Returns:

A byte array containing the processed image data.

Throws:

java.lang.RuntimeException - If the input file is not found, is not an image, or encounters other issues.

scaleUserGivenImageToConstraints

public static byte[] scaleUserGivenImageToConstraints(java.awt.image.BufferedImage image,
                                                      int maxWidth,
                                                      int maxHeight,
                                                      int maxLength)

Scales the provided BufferedImage to meet specified constraints and returns the result as a byte array. This method enforces the following policy: - If the dimensions of the input image are within the specified bounds (maxWidth and maxHeight), and the resulting image size (in bytes) is less than or equal to maxLength, the original image is retained. - If the input image dimensions or resulting image size exceed the specified bounds, a scaled version of the image in the specified image format is returned.

Parameters:

image - The input BufferedImage to be processed.

maxWidth - The maximum width allowed for the scaled image.

maxHeight - The maximum height allowed for the scaled image.

maxLength - The maximum size (in bytes) allowed for the resulting image.

imageFormat - The format in which the scaled image should be encoded (e.g., "jpeg", "png", "gif"). Defaults to "jpeg" if not specified.

Returns:

A byte array containing the processed image data.

Throws:

java.lang.IllegalArgumentException - If the provided image format is not supported or any of the constraints (maxWidth, maxHeight, maxLength) are invalid (e.g., negative values).

scaleUserGivenImageToConstraints

public static byte[] scaleUserGivenImageToConstraints(java.awt.image.BufferedImage image,
                                                      int maxWidth,
                                                      int maxHeight,
                                                      int maxLength,
                                                      java.lang.String imageFormat)