org.das2.util

Class ImageUtil

java.lang.Object

org.das2.util.ImageUtil

public class ImageUtil
extends java.lang.Object

Utilities for image files and images.

Constructor Summary

Constructors

Constructor and Description
ImageUtil()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getJSONMetadata(java.io.File file) return the node containing JSON metadata showing where the plots are in images produced by the Autoplot Das2 library, or null.
static java.awt.image.BufferedImage	getScaledInstance(java.awt.image.BufferedImage img, int thumbSize) convenient typical use.
static java.awt.image.BufferedImage	getScaledInstance(java.awt.image.BufferedImage img, int width, int height, boolean pad) convenient typical use, returns the biggest scaled instance which would fit in a box.
static java.awt.image.BufferedImage	getScaledInstance(java.awt.image.BufferedImage img, int targetWidth, int targetHeight, java.lang.Object hint, boolean higherQuality) Convenience method that returns a scaled instance of the provided BufferedImage.
static java.lang.String	getScriptURI(java.io.File file) return the value of the text node apscript, if it is found, so the image could be recreated.

Methods inherited from class java.lang.Object

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

Constructor Detail

ImageUtil

public ImageUtil()

Method Detail

getJSONMetadata

public static java.lang.String getJSONMetadata(java.io.File file)
                                        throws java.io.IOException

return the node containing JSON metadata showing where the plots are in images produced by the Autoplot Das2 library, or null.

Parameters:

file - the png file.

Returns:

null or the JSON describing the image. See http://autoplot.org/developer.richPng

Throws:

java.io.IOException

getScriptURI

public static java.lang.String getScriptURI(java.io.File file)
                                     throws java.io.IOException

return the value of the text node apscript, if it is found, so the image could be recreated.

Parameters:

file - png file, produced by Autoplot using the Run Batch Tool.

Returns:

null or the script.

Throws:

java.io.IOException

getScaledInstance

public static java.awt.image.BufferedImage getScaledInstance(java.awt.image.BufferedImage img,
                                                             int thumbSize)

convenient typical use.

Parameters:

img - image to resize.

thumbSize - corner-to-corner size, preserving aspect ratio.

Returns:

buffered image that is thumbSize across.

getScaledInstance

public static java.awt.image.BufferedImage getScaledInstance(java.awt.image.BufferedImage img,
                                                             int width,
                                                             int height,
                                                             boolean pad)

convenient typical use, returns the biggest scaled instance which would fit in a box. The returned image will have the same aspect ratio.

Parameters:

img - image to resize.

width - the width

height - the height

pad - pad the image so that width and height are used.

Returns:

buffered image that is thumbSize across.

getScaledInstance

public static java.awt.image.BufferedImage getScaledInstance(java.awt.image.BufferedImage img,
                                                             int targetWidth,
                                                             int targetHeight,
                                                             java.lang.Object hint,
                                                             boolean higherQuality)

Convenience method that returns a scaled instance of the provided BufferedImage. first from http://today.java.net/pub/a/today/2007/04/03/perils-of-image-getscaledinstance.html resize taken from http://www.componenthouse.com/article-20

Parameters:

img - the original image to be scaled

targetWidth - the desired width of the scaled instance, in pixels

targetHeight - the desired height of the scaled instance, in pixels

hint - one of the rendering hints that corresponds to RenderingHints.KEY_INTERPOLATION (e.g. RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR, RenderingHints.VALUE_INTERPOLATION_BILINEAR, RenderingHints.VALUE_INTERPOLATION_BICUBIC)

higherQuality - if true, this method will use a multi-step scaling technique that provides higher quality than the usual one-step technique (only useful in downscaling cases, where targetWidth or targetHeight is smaller than the original dimensions, and generally only when the BILINEAR hint is specified)

Returns:

a scaled version of the original BufferedImage