Class Pixel

java.lang.Object
  Pixel

public class Pixel
extends Object

Class that references a pixel in a picture. Pixel stands for picture element where picture is abbreviated pix. A pixel has a column (x) and row (y) location in a picture. A pixel knows how to get and set the red, green, blue, and alpha values in the picture. A pixel also knows how to get and set the color using a Color object.

Author:

Barb Ericson ericson@cc.gatech.edu

Constructor Summary

Pixel(DigitalPicture picture, int x, int y)
A constructor that takes the x and y location for the pixel and the picture the pixel is coming from

Method Summary

double	colorDistance(Color testColor) Method to get the distance between this pixel's color and the passed color
static double	colorDistance(Color color1, Color color2) Method to compute the color distances between two color objects
int	getAlpha() Method to get the amount of alpha (transparency) at this pixel.
double	getAverage() Method to get the average of the colors of this pixel
int	getBlue() Method to get the amount of blue at this pixel.
static int	getBlue(int value) Method to get the blue value from a pixel represented as an int
int	getCol() Method to get the column (x value)
Color	getColor() Method to get a color object that represents the color at this pixel.
int	getGreen() Method to get the amount of green at this pixel.
static int	getGreen(int value) Method to get the green value from a pixel represented as an int
int	getRed() Method to get the amount of red at this pixel.
static int	getRed(int value) Method to get the red value from a pixel represented as an int
int	getRow() Method to get the row (y value)
int	getX() Method to get the x location of this pixel.
int	getY() Method to get the y location of this pixel.
void	setAlpha(int value) Method to set the alpha (transparency) to a new alpha value
void	setBlue(int value) Method to set the blue to a new blue value
void	setColor(Color newColor) Method to set the pixel color to the passed in color object.
void	setGreen(int value) Method to set the green to a new green value
void	setRed(int value) Method to set the red to a new red value
String	toString() Method to return a string with information about this pixel
void	updatePicture(int alpha, int red, int green, int blue) Method to update the picture based on the passed color values for this pixel

Methods inherited from class java.lang.Object

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

Constructor Detail

Pixel

public Pixel(DigitalPicture picture,
             int x,
             int y)

A constructor that takes the x and y location for the pixel and the picture the pixel is coming from

Parameters:

picture - the picture that the pixel is in

x - the x location of the pixel in the picture

y - the y location of the pixel in the picture

Method Detail

colorDistance

public double colorDistance(Color testColor)

Method to get the distance between this pixel's color and the passed color

Parameters:

testColor - the color to compare to

Returns:

the distance between this pixel's color and the passed color

colorDistance

public static double colorDistance(Color color1,
                                   Color color2)

Method to compute the color distances between two color objects

Parameters:

color1 - a color object

color2 - a color object

Returns:

the distance between the two colors

getAlpha

public int getAlpha()

Method to get the amount of alpha (transparency) at this pixel. It will be from 0-255.

Returns:

the amount of alpha (transparency)

getAverage

public double getAverage()

Method to get the average of the colors of this pixel

Returns:

the average of the red, green, and blue values

getBlue

public int getBlue()

Method to get the amount of blue at this pixel. It will be from 0-255 with 0 being no blue and 255 being as much blue as you can have.

Returns:

the amount of blue from 0 for none to 255 for max

getBlue

public static int getBlue(int value)

Method to get the blue value from a pixel represented as an int

Parameters:

value - the color value as an int

Returns:

the amount of blue

getCol

public int getCol()

Method to get the column (x value)

Returns:

the column (x value) of the pixel

getColor

public Color getColor()

Method to get a color object that represents the color at this pixel.

Returns:

a color object that represents the pixel color

getGreen

public int getGreen()

Method to get the amount of green at this pixel. It will be from 0-255 with 0 being no green and 255 being as much green as you can have.

Returns:

the amount of green from 0 for none to 255 for max

getGreen

public static int getGreen(int value)

Method to get the green value from a pixel represented as an int

Parameters:

value - the color value as an int

Returns:

the amount of green

getRed

public int getRed()

Method to get the amount of red at this pixel. It will be from 0-255 with 0 being no red and 255 being as much red as you can have.

Returns:

the amount of red from 0 for none to 255 for max

getRed

public static int getRed(int value)

Method to get the red value from a pixel represented as an int

Parameters:

value - the color value as an int

Returns:

the amount of red

getRow

public int getRow()

Method to get the row (y value)

Returns:

the row (y value) of the pixel in the picture

getX

public int getX()

Method to get the x location of this pixel.

Returns:

the x location of the pixel in the picture

getY

public int getY()

Method to get the y location of this pixel.

Returns:

the y location of the pixel in the picture

setAlpha

public void setAlpha(int value)

Method to set the alpha (transparency) to a new alpha value

Parameters:

value - the new value to use

setBlue

public void setBlue(int value)

Method to set the blue to a new blue value

Parameters:

value - the new value to use

setColor

public void setColor(Color newColor)

Method to set the pixel color to the passed in color object.

Parameters:

newColor - the new color to use

setGreen

public void setGreen(int value)

Method to set the green to a new green value

Parameters:

value - the value to use

setRed

public void setRed(int value)

Method to set the red to a new red value

Parameters:

value - the new value to use

toString

public String toString()

Method to return a string with information about this pixel

Overrides:

toString in class Object

Returns:

a string with information about this pixel

updatePicture

public void updatePicture(int alpha,
                          int red,
                          int green,
                          int blue)

Method to update the picture based on the passed color values for this pixel

Parameters:

alpha - the alpha (transparency) at this pixel

red - the red value for the color at this pixel

green - the green value for the color at this pixel

blue - the blue value for the color at this pixel