Class PixelPicture

java.lang.Object

PixelPicture

public class PixelPicture
extends java.lang.Object

An image represented by a 2D array of Pixels. PixelPictures are immutable. Although they provide access to a 2D array of pixels, this array is a copy of the one stored in the NewPic. The original image cannot be modified.

Constructor Summary

Constructors

Constructor and Description
PixelPicture(Pixel[][] bmp) Creates a picture given a bitmap.
PixelPicture(PixelPicture other) Copies a NewPic.
PixelPicture(java.lang.String filename) Creates a NewPic by loading the given file or URL.

Method Summary

Modifier and Type	Method and Description
static int	diff(PixelPicture p0, PixelPicture p1) Compute the difference between two images.
Pixel[][]	getBitmap() Gets a bitmap (i.e., matrix of pixels) of the image.
int	getHeight() Get the height of the image.
int	getWidth() Get the width of the image.
void	print() Print all of the pixels in the image to the console.
void	save(java.lang.String filename)
javax.swing.ImageIcon	toImageIcon() Creates an ImageIcon, suitable for display by Swing components.

Methods inherited from class java.lang.Object

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

Constructor Detail

PixelPicture

public PixelPicture(PixelPicture other)

Copies a NewPic.

Parameters:

other - NewPic the other NewPic to copy

PixelPicture

public PixelPicture(java.lang.String filename)

Creates a NewPic by loading the given file or URL.

Parameters:

filename - the location of the image file to read

PixelPicture

public PixelPicture(Pixel[][] bmp)

Creates a picture given a bitmap. The bitmap should be in left-to-right, top-to-bottom ordering.

Parameters:

bmp - The bitmap

Method Detail

getWidth

public int getWidth()

Get the width of the image.

getHeight

public int getHeight()

Get the height of the image.

getBitmap

public Pixel[][] getBitmap()

Gets a bitmap (i.e., matrix of pixels) of the image. This method returns a copy of the image's contents---editing the returned bitmap will not affect the NewPic. The bitmap is in a left-to-right, top-to-bottom order. The first index is the row, the second index is the column.

Returns:

a left-to-right, top-to-bottom array of arrays of Pixels

toImageIcon

public javax.swing.ImageIcon toImageIcon()

Creates an ImageIcon, suitable for display by Swing components.

Returns:

ImageIcon pointing at a copy of this image

diff

public static int diff(PixelPicture p0,
                       PixelPicture p1)

Compute the difference between two images. This difference sums the pixel-by-pixel differences between components of a pixel. It is most useful for SMALL images.

print

public void print()

Print all of the pixels in the image to the console. This is debugging aid. Only use this method for SMALL images.

save

public void save(java.lang.String filename)