Media

Class Pixel

java.lang.Object

Media.Pixel

public class Pixel
extends java.lang.Object

A pixel is a single point (picture element) in a Picture. A Pixel stores its red, green, blue, and transparency values. When on a BasicForm Canvas, the pixel will inform the Canvas of a change so that pixel changes occur in real time. In the current implementation only the last canvas the picture is placed on will be informed.

Version:

1.0 Date (06/06/02), 2.0 2007, 3.0 June 2008, 4.0 (08/08/26), 5.0 (09/05/04), 6.0 (10/06/14)

Author:

Michael Pickard, Mark Elgersma, Andrew Cheesman, David Hughes, David Hughes, David Hughes

Method Summary

Modifier and Type	Method and Description
void	darken() This method darkens a pixel by taking the red, green, and blue values and decreasing them.
int	getBlue() This method returns the blue value of the pixel.
java.awt.Color	getColor() This method returns all three colours of the pixel as a Colour object
double	getDistance(java.awt.Color c) This method returns the color distance between this pixel and a specified color.
double	getDistance(int r, int g, int b) This method returns the color distance between this pixel and a specified color.
double	getDistance(Pixel p) This method returns the color distance between this and another Pixel's color.
int	getGreen() This method returns the green value of the pixel.
int	getRed() This method returns the red value of the pixel.
byte	getTransparency() This method returns the transparency value of the pixel.
void	lighten() This method lightens a pixel by taking the red, green, and blue values and increasing them
void	setBlue(int b) This method sets the blue value of the pixel.
void	setColor(java.awt.Color c) This method changes all three colours in one method by accepting a Colour object as a paramter
void	setColor(int r, int g, int b) This method changes all three colours in one method
void	setGreen(int g) This method sets the green value of the pixel.
void	setRed(int r) This method sets the red value of the pixel.
void	setTransparency(byte t) This method sets the transparency value of the pixel.
java.lang.String	toString() This method returns a string representation of the Pixel object

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getDistance

public double getDistance(int r,
                          int g,
                          int b)

This method returns the color distance between this pixel and a specified color.

Parameters:

r - the red of the color

g - the green of the color

b - the blue of the color

Returns:

int the color distance

getDistance

public double getDistance(java.awt.Color c)

This method returns the color distance between this pixel and a specified color.

Parameters:

c - a Colour

Returns:

int the color distance

getDistance

public double getDistance(Pixel p)

This method returns the color distance between this and another Pixel's color.

Parameters:

p - the other pixel

Returns:

int the color distance

getRed

public int getRed()

This method returns the red value of the pixel. As the pixel is stored as a Byte, it needs to be modified slightly for a 0-255 range instead of -128 to 127

Returns:

int (the red value in the range 0-255)

getGreen

public int getGreen()

This method returns the green value of the pixel. As the pixel is stored as a Byte, it needs to be modified slightly for a 0-255 range instead of -128 to 127

Returns:

int (the green value in the range 0-255)

getBlue

public int getBlue()

This method returns the blue value of the pixel. As the pixel is stored as a Byte, it needs to be modified slightly for a 0-255 range instead of -128 to 127

Returns:

int (the blue value in the range 0-255)

getTransparency

public byte getTransparency()

This method returns the transparency value of the pixel.

Returns:

byte (the transparency value of the pixel)

setRed

public void setRed(int r)

This method sets the red value of the pixel. It treats the 0-255 range as a continuum (thus a value of 256 would be set to 0).

Parameters:

r - (the new red value)

setGreen

public void setGreen(int g)

This method sets the green value of the pixel. It treats the 0-255 range as a continuum (thus a value of 256 would be set to 0).

Parameters:

g - (the new green value)

setBlue

public void setBlue(int b)

This method sets the blue value of the pixel. It treats the 0-255 range as a continuum (thus a value of 256 would be set to 0).

Parameters:

b - (the new blue value)

setTransparency

public void setTransparency(byte t)

This method sets the transparency value of the pixel.

Parameters:

t - (the new transparency value)

getColor

public java.awt.Color getColor()

This method returns all three colours of the pixel as a Colour object

Returns:

Colour (the 3 colours stored as a Colour object)

setColor

public void setColor(int r,
                     int g,
                     int b)

This method changes all three colours in one method

Parameters:

r - (the new red value)

g - (the new green value)

b - (the new blue value)

setColor

public void setColor(java.awt.Color c)

This method changes all three colours in one method by accepting a Colour object as a paramter

Parameters:

c - (the Colour object representation of red, green, blue)

lighten

public void lighten()

This method lightens a pixel by taking the red, green, and blue values and increasing them

darken

public void darken()

This method darkens a pixel by taking the red, green, and blue values and decreasing them.

toString

public java.lang.String toString()

This method returns a string representation of the Pixel object

Overrides:

toString in class java.lang.Object

Returns:

String (the Pixel as a String of data)