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	Description
PixelPicture(java.lang.String filename)	Creates a NewPic by loading the given file or URL.
PixelPicture(Pixel[][] bmp)	Creates a picture given a bitmap.
PixelPicture(PixelPicture other)	Copies a NewPic.

Method Summary

Modifier and Type	Method	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()
int	getWidth()
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()

Returns:

the width of the image.

getHeight

public int getHeight()

Returns:

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 top-to-bottom, left-to-right order. The first index is the row, the second index is the column. That way, a pixel at coordinate (x,y) can be accessed as bmp[y][x].

Returns:

a top-to-bottom, left-to-right order 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.

Parameters:

p0 - first image to compare

p1 - second image to compare

Returns:

sum of all differences between pixel components

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)