ucar.unidata.ui

Class ImageUtils

java.lang.Object

ucar.unidata.ui.ImageUtils

public class ImageUtils
extends java.lang.Object

Provides a set of image manipulation utilities

Author:

IDV development team

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	debug debug flag

Constructor Summary

Constructors

Constructor and Description
ImageUtils()

Method Summary

Modifier and Type	Method and Description
static java.awt.image.BufferedImage	clip(java.awt.image.BufferedImage image, int[] ul, int[] lr) Clip the image
static java.lang.String	convertImageTo(java.lang.String file, java.lang.String newType) Convert an image to a new type
static int	getColumnCountFromComps(java.util.List<? extends java.awt.Component> views) Gets the column count from the components.
static javax.swing.JEditorPane	getEditor(javax.swing.JEditorPane editor, java.lang.String html, int width, java.awt.Color transparentColor, java.awt.Font font) Make a editor pane from the html
static javax.swing.JEditorPane	getEditor(java.lang.String html, int width, java.awt.Color transparentColor, java.awt.Font font) Make a editor pane from the html
static java.awt.Image	getImage(java.awt.Component component) Get the screen image from the component
static java.awt.Image	getImage(javax.swing.JEditorPane editor, java.awt.Color transparentColor) Get an image from the component
static java.awt.Image	getImageFile(java.lang.String file) Read in the image from the given filename or url
static java.awt.Image	gridImages(java.util.List images, int space, java.awt.Color bg, int columns) Merge images
static java.awt.Image	gridImages2(java.util.List<? extends java.awt.Image> images, int space, java.awt.Color bg, int columns) Merge Images.
static boolean	hasAlpha(java.awt.Image image) Check to see if the image has alpha
static java.awt.image.BufferedImage	horizontalflip(java.awt.image.BufferedImage img) Flip the image horizontally From: Josiah Hester - http://www.javalobby.org/articles/ultimate-image
static boolean	isImage(java.lang.String file) Is the file name an image
static void	main(java.lang.String[] args) Read in the image.
static java.awt.image.BufferedImage	makeColorTransparent(java.awt.Image im, java.awt.Color c) Make a color in the image transparent
static java.awt.image.BufferedImage	makeColorTransparent(java.awt.Image im, int[] redRange, int[] greenRange, int[] blueRange) Set the colors taht are within the given red, green and blue ranges to be transparent.
static java.awt.image.BufferedImage	matte(java.awt.image.BufferedImage image, int top, int bottom, int left, int right, java.awt.Color bg) Add a matte border around the image
static java.awt.Image	mergeHorizontal(java.util.List<? extends java.awt.Image> images) Merge the images horizontally.
static java.awt.Image	mergeImages(java.util.List images, int space, java.awt.Color bg) Merge images
static java.awt.Image	mergeVertical(java.util.List<? extends java.awt.Image> images) Merge the images vertically.
static java.awt.Image	padImage(java.awt.Image image, int space, java.awt.Color color) Pad the image.
static java.awt.Point	parsePoint(java.lang.String s, java.awt.Rectangle r) Parse the string specification of a point with respect to the rectangle.
static java.awt.Image	readImage(java.lang.String imagePath) Read and image
static java.awt.Image	readImage(java.lang.String imagePath, boolean cache) Read and image
static java.awt.Image	readImage(java.lang.String imagePath, boolean cache, boolean returnNullIfNotFound) Read and image
static java.awt.image.BufferedImage	removeRedeye(java.awt.Image im, int x1, int y1, int x2, int y2) Remove the brighter red from the image
static java.awt.Image	renderHtml(java.lang.String html, int width, java.awt.Color transparentColor, java.awt.Font font) Render the given html and return an image
static java.awt.Image	resize(java.awt.Image image, int width, int height) Resize an image
static java.awt.image.BufferedImage	rotate90(java.awt.image.BufferedImage img, boolean left) Rotate the image 90 degrees
static java.awt.image.BufferedImage	setAlpha(java.awt.Image im, double percent) Set the alpha channel to the given transparency percent
static int	toAlpha(double percent) Change the transparency percentage into an int alpha value
static java.awt.image.BufferedImage	toBufferedImage(java.awt.Image image) This method returns a buffered image with the contents of an image
static java.awt.image.BufferedImage	toBufferedImage(java.awt.Image image, boolean force) This method returns a buffered image with the contents of an image
static java.awt.image.BufferedImage	toBufferedImage(java.awt.Image image, int type) Create a BufferedImage from the given image
static java.awt.Point	toPoint(java.awt.geom.Point2D p) convenience to convert to a Point
static java.awt.image.BufferedImage	verticalflip(java.awt.image.BufferedImage img) Flip the image vertically From: Josiah Hester - http://www.javalobby.org/articles/ultimate-image
static java.awt.Image	waitOnImage(java.awt.Image image) Wait until it is loaded in.
static void	writeAvi(java.util.List imageFiles, double frameRateInFPS, java.io.File outFile) Write an AVI file
static boolean	writeImage(javax.swing.JDialog window, java.lang.String file) Make a screen capture of the window.
static boolean	writeImage(javax.swing.JFrame window, java.lang.String file) Make a screen capture of the window.
static void	writeImageToFile(java.awt.Component component, java.lang.String saveFile) Take a screen snapshot of the component.
static void	writeImageToFile(java.awt.Image image, java.io.File saveFile) Write a Buffered image to a file
static void	writeImageToFile(java.awt.Image image, java.lang.String saveFile) Write a Buffered image to a file
static void	writeImageToFile(java.awt.Image image, java.lang.String saveFile, float quality) Write a Buffered image to a file at a particular quality
static void	writeImageToFile(java.awt.Image image, java.lang.String saveFile, java.io.OutputStream os, float quality) Write a Buffered image to a file at a particular quality
static void	writePDF(java.io.OutputStream out, javax.swing.JComponent comp) test code

Methods inherited from class java.lang.Object

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

Field Detail

debug

public static boolean debug

debug flag

Constructor Detail

ImageUtils

public ImageUtils()

Method Detail

matte

public static java.awt.image.BufferedImage matte(java.awt.image.BufferedImage image,
                                                 int top,
                                                 int bottom,
                                                 int left,
                                                 int right,
                                                 java.awt.Color bg)

Add a matte border around the image

Parameters:

image - The image

top - top space

bottom - bottom space

left - left space

right - right space

bg - Background color

Returns:

The matted image

clip

public static java.awt.image.BufferedImage clip(java.awt.image.BufferedImage image,
                                                int[] ul,
                                                int[] lr)

Clip the image

Parameters:

image - The image

ul - upper left

lr - lower right

Returns:

The clipped image

readImage

public static java.awt.Image readImage(java.lang.String imagePath)

Read and image

Parameters:

imagePath - the path to the image

Returns:

the Image

readImage

public static java.awt.Image readImage(java.lang.String imagePath,
                                       boolean cache)

Read and image

Parameters:

imagePath - the path to the image

cache - Cache the image

Returns:

the Image

readImage

public static java.awt.Image readImage(java.lang.String imagePath,
                                       boolean cache,
                                       boolean returnNullIfNotFound)

Read and image

Parameters:

imagePath - the path to the image

cache - Cache the image

returnNullIfNotFound - if true, return null if the image does not exist

Returns:

the Image

waitOnImage

public static java.awt.Image waitOnImage(java.awt.Image image)

Wait until it is loaded in.

Parameters:

image - the image

Returns:

The image

makeColorTransparent

public static java.awt.image.BufferedImage makeColorTransparent(java.awt.Image im,
                                                                java.awt.Color c)

Make a color in the image transparent

Parameters:

im - image

c - the color to make transparent

Returns:

a new image with the color transparent.

makeColorTransparent

public static java.awt.image.BufferedImage makeColorTransparent(java.awt.Image im,
                                                                int[] redRange,
                                                                int[] greenRange,
                                                                int[] blueRange)

Set the colors taht are within the given red, green and blue ranges to be transparent.

Parameters:

im - The image

redRange - red range

greenRange - green range

blueRange - blue range

Returns:

munged image

removeRedeye

public static java.awt.image.BufferedImage removeRedeye(java.awt.Image im,
                                                        int x1,
                                                        int y1,
                                                        int x2,
                                                        int y2)

Remove the brighter red from the image

Parameters:

im - image

x1 - bounds

y1 - bounds

x2 - bounds

y2 - bounds

Returns:

new image

toAlpha

public static int toAlpha(double percent)

Change the transparency percentage into an int alpha value

Parameters:

percent - the percent transparent 0-1.0

Returns:

the alpha value

setAlpha

public static java.awt.image.BufferedImage setAlpha(java.awt.Image im,
                                                    double percent)

Set the alpha channel to the given transparency percent

Parameters:

im - image

percent - Percent transparent 0-1.0

Returns:

munged image

toPoint

public static java.awt.Point toPoint(java.awt.geom.Point2D p)

convenience to convert to a Point

Parameters:

p - point

Returns:

point

parsePoint

public static java.awt.Point parsePoint(java.lang.String s,
                                        java.awt.Rectangle r)

Parse the string specification of a point with respect to the rectangle. The spec can look like: "rectpoint,offsetx,offsety" where rectpoint can be:

 ul    um    ur
 ml    mm    mr
 ll    lm    lr

Where u=upper,m=middle,l=lower r=right,l=left

Parameters:

s - String specification

r - Reference rectangle

Returns:

The point

toBufferedImage

public static java.awt.image.BufferedImage toBufferedImage(java.awt.Image image)

This method returns a buffered image with the contents of an image

Parameters:

image - the image

Returns:

a buffered image

toBufferedImage

public static java.awt.image.BufferedImage toBufferedImage(java.awt.Image image,
                                                           boolean force)

This method returns a buffered image with the contents of an image

Parameters:

image - the image

force - If false then just return the image argument if its a BufferedImage

Returns:

a buffered image

mergeImages

public static java.awt.Image mergeImages(java.util.List images,
                                         int space,
                                         java.awt.Color bg)

Merge images

Parameters:

images - list of images

space - space between images

bg - background color

Returns:

merged image

gridImages

public static java.awt.Image gridImages(java.util.List images,
                                        int space,
                                        java.awt.Color bg,
                                        int columns)

Merge images

Parameters:

images - list of images

space - space between images

bg - background color

columns - number of columns

Returns:

merged image

gridImages2

public static java.awt.Image gridImages2(java.util.List<? extends java.awt.Image> images,
                                         int space,
                                         java.awt.Color bg,
                                         int columns)

Merge Images. The heuristic is not the same as gridImages(List, int, Color, int) so the results can be different.

Parameters:

images - the images that will be gridded

space - the space padding around each image.

bg - the background color "behind" the image.

columns - how many columns in the grid

Returns:

the image that has been gridded

padImage

public static java.awt.Image padImage(java.awt.Image image,
                                      int space,
                                      java.awt.Color color)

Pad the image.

Parameters:

image - the image

space - the space

color - the color

Returns:

the image

mergeHorizontal

public static java.awt.Image mergeHorizontal(java.util.List<? extends java.awt.Image> images)

Merge the images horizontally.

Parameters:

images - the images

Returns:

the image

mergeVertical

public static java.awt.Image mergeVertical(java.util.List<? extends java.awt.Image> images)

Merge the images vertically.

Parameters:

images - the images

Returns:

the image

toBufferedImage

public static java.awt.image.BufferedImage toBufferedImage(java.awt.Image image,
                                                           int type)

Create a BufferedImage from the given image

Parameters:

image - The image

type - BufferedImage type

Returns:

The BufferedImage

hasAlpha

public static boolean hasAlpha(java.awt.Image image)

Check to see if the image has alpha

Parameters:

image - the image

Returns:

true if has alpha

getImage

public static java.awt.Image getImage(java.awt.Component component)
                               throws java.lang.Exception

Get the screen image from the component

Parameters:

component - The component.

Returns:

Its image

Throws:

java.lang.Exception

writeImageToFile

public static void writeImageToFile(java.awt.Image image,
                                    java.io.File saveFile)
                             throws java.lang.Exception

Write a Buffered image to a file

Parameters:

image - image to write

saveFile - file to write to

Throws:

java.lang.Exception - problem writing file

writeImageToFile

public static void writeImageToFile(java.awt.Image image,
                                    java.lang.String saveFile)
                             throws java.lang.Exception

Write a Buffered image to a file

Parameters:

image - image to write

saveFile - file to write to

Throws:

java.lang.Exception - problem writing file

horizontalflip

public static java.awt.image.BufferedImage horizontalflip(java.awt.image.BufferedImage img)

Flip the image horizontally From: Josiah Hester - http://www.javalobby.org/articles/ultimate-image

Parameters:

img - image

Returns:

flipped image

verticalflip

public static java.awt.image.BufferedImage verticalflip(java.awt.image.BufferedImage img)

Flip the image vertically From: Josiah Hester - http://www.javalobby.org/articles/ultimate-image

Parameters:

img - image

Returns:

flipped image

rotate90

public static java.awt.image.BufferedImage rotate90(java.awt.image.BufferedImage img,
                                                    boolean left)

Rotate the image 90 degrees

Parameters:

img - image

left - rotate counter clockwise

Returns:

rotated image

convertImageTo

public static java.lang.String convertImageTo(java.lang.String file,
                                              java.lang.String newType)

Convert an image to a new type

Parameters:

file - image file

newType - new image type

Returns:

name of the new file

writeImageToFile

public static void writeImageToFile(java.awt.Image image,
                                    java.lang.String saveFile,
                                    float quality)
                             throws java.lang.Exception

Write a Buffered image to a file at a particular quality

Parameters:

image - image to write

saveFile - file to write to

quality - image quality (if supported)

Throws:

java.lang.Exception - problem writing file

writeImageToFile

public static void writeImageToFile(java.awt.Image image,
                                    java.lang.String saveFile,
                                    java.io.OutputStream os,
                                    float quality)
                             throws java.lang.Exception

Write a Buffered image to a file at a particular quality

Parameters:

image - image to write

saveFile - _more_

os - output stream

quality - image quality (if supported)

Throws:

java.lang.Exception - problem writing file

isImage

public static boolean isImage(java.lang.String file)

Is the file name an image

Parameters:

file - file

Returns:

is image

writeImage

public static boolean writeImage(javax.swing.JDialog window,
                                 java.lang.String file)
                          throws java.lang.Exception

Make a screen capture of the window. Write it to the file.

Parameters:

window - The window

file - The file

Returns:

Successful

Throws:

java.lang.Exception

writeImage

public static boolean writeImage(javax.swing.JFrame window,
                                 java.lang.String file)
                          throws java.lang.Exception

Make a screen capture of the window. Write it to the file.

Parameters:

window - The window

file - The file

Returns:

Successful

Throws:

java.lang.Exception

writeImageToFile

public static void writeImageToFile(java.awt.Component component,
                                    java.lang.String saveFile)
                             throws java.lang.Exception

Take a screen snapshot of the component. Write it to the file.

Parameters:

component - The component.

saveFile - The file.

Throws:

java.lang.Exception

writeAvi

public static void writeAvi(java.util.List imageFiles,
                            double frameRateInFPS,
                            java.io.File outFile)
                     throws java.io.IOException

Write an AVI file

Parameters:

imageFiles - list of files

frameRateInFPS - frame rate

outFile - output file

Throws:

java.io.IOException - problem writing AVI

resize

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

Resize an image

Parameters:

image - the image

width - new width

height - new height

Returns:

resized image

getImage

public static java.awt.Image getImage(javax.swing.JEditorPane editor,
                                      java.awt.Color transparentColor)
                               throws java.lang.Exception

Get an image from the component

Parameters:

editor - component

transparentColor - if non null then set this color to be transparent

Returns:

image

Throws:

java.lang.Exception - on badness

renderHtml

public static java.awt.Image renderHtml(java.lang.String html,
                                        int width,
                                        java.awt.Color transparentColor,
                                        java.awt.Font font)
                                 throws java.lang.Exception

Render the given html and return an image

Parameters:

html - html to render

width - image width

transparentColor - if non null set this color in the image to be transparent

font - font to render with

Returns:

image

Throws:

java.lang.Exception - on badness

getEditor

public static javax.swing.JEditorPane getEditor(java.lang.String html,
                                                int width,
                                                java.awt.Color transparentColor,
                                                java.awt.Font font)
                                         throws java.lang.Exception

Make a editor pane from the html

Parameters:

html - html

width - width

transparentColor - what color to set as transparent

font - font

Returns:

editor pane

Throws:

java.lang.Exception - on badness

getEditor

public static javax.swing.JEditorPane getEditor(javax.swing.JEditorPane editor,
                                                java.lang.String html,
                                                int width,
                                                java.awt.Color transparentColor,
                                                java.awt.Font font)
                                         throws java.lang.Exception

Make a editor pane from the html

Parameters:

editor - Initial editor

html - html

width - width

transparentColor - what color to set as transparent

font - font

Returns:

editor pane

Throws:

java.lang.Exception - on badness

writePDF

public static void writePDF(java.io.OutputStream out,
                            javax.swing.JComponent comp)
                     throws java.io.IOException

test code

Parameters:

out - test

comp - test

Throws:

java.io.IOException - test

main

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

Read in the image. Wait util it is loaded in.

Parameters:

args - args

Throws:

java.lang.Exception - problem with this

getImageFile

public static java.awt.Image getImageFile(java.lang.String file)
                                   throws java.lang.Exception

Read in the image from the given filename or url

Parameters:

file - File or url

Returns:

The image

Throws:

java.lang.Exception - On badness

getColumnCountFromComps

public static int getColumnCountFromComps(java.util.List<? extends java.awt.Component> views)

Gets the column count from the components.

Parameters:

views - the views

Returns:

the column from comp