Main Page | Modules | Namespace List | Class Hierarchy | Class List | Namespace Members | Class Members

VIEW::ColorUnit Class Reference
[Format conversion classes used by the color classes]

ColorUnit class. More...

#include <colorUnit.h>

List of all members.

Public Member Functions

Constructors
 ColorUnit () throw ()
 Default Constructor.
 ColorUnit (const ColorUnit &color_unit) throw ()
 Copy constructor.
 ColorUnit (const char *value) throw (Exception::InvalidRange, NotInHexFormat)
 Constructor with Parameter char*, representing a value in hex format (00 - FF, or 00 - ff).
 ColorUnit (const String &value) throw (Exception::InvalidRange, NotInHexFormat)
 Constructor with Parameter String.
 ColorUnit (const unsigned char value) throw ()
 Constructor with Parameter unsigned char.
 ColorUnit (const short value) throw (Exception::InvalidRange)
 Constructor with Parameter short.
 ColorUnit (const unsigned short value) throw (Exception::InvalidRange)
 Constructor with Parameter unsigned short.
 ColorUnit (const int value) throw (Exception::InvalidRange)
 Constructor with Parameter int.
 ColorUnit (const unsigned int value) throw (Exception::InvalidRange)
 Constructor with Parameter unsigned int.
 ColorUnit (const long value) throw (Exception::InvalidRange)
 Constructor with Parameter long.
 ColorUnit (const unsigned long value) throw (Exception::InvalidRange)
 Constructor with Parameter unsigned long.
 ColorUnit (const float value) throw (Exception::InvalidRange)
 Constructor with Parameter float.
 ColorUnit (const double value) throw (Exception::InvalidRange)
 Constructor with Parameter double.
Destructors
virtual ~ColorUnit () throw ()
 Destructor.
void clear () throw ()
 Explicit default initialization.
Converters
 operator String () const throw ()
 Conversion to string.
 operator char () const throw ()
 Conversion to char.
 operator unsigned char () const throw ()
 Conversion to unsigned char.
 operator short () const throw ()
 Conversion to short.
 operator unsigned short () const throw ()
 Conversion to unsigned short.
 operator int () const throw ()
 Conversion to int.
 operator unsigned int () const throw ()
 Conversion to unsigned int.
 operator long () const throw ()
 Conversion to long.
 operator unsigned long () const throw ()
 Conversion to unsigned long.
 operator float () const throw ()
 Conversion to float.
 operator double () const throw ()
 Conversion to double.
Assignment methods
void set (const ColorUnit &color_unit) throw ()
 Assignment.
const ColorUnitoperator= (const ColorUnit &color_unit) throw ()
 Assignment operator.
void swap (ColorUnit &color_unit) throw ()
 Swapping of colorUnits.
Accessors: inspectors and mutators
void set (const char *value) throw (Exception::InvalidRange, NotInHexFormat)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const char *value) throw (Exception::InvalidRange, NotInHexFormat)
 Assignment operator with char*.
void get (char *value) const throw ()
 Inspection of the colorUnit's value.
void set (const String &value) throw (Exception::InvalidRange, NotInHexFormat)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const String &value) throw (Exception::InvalidRange, NotInHexFormat)
 Assignment operator with string.
void get (String &value) const throw ()
 Inspection of the colorUnit's value.
void set (const unsigned char value) throw ()
 Changes the value of the colorUnit.
const ColorUnitoperator= (const unsigned char value) throw ()
 Assignment operator with unsigned char.
void get (unsigned char &value) const throw ()
 Inspection of the colorUnit's value.
void set (const short value) throw (Exception::InvalidRange)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const short value) throw (Exception::InvalidRange)
 Assignment operator with short.
void get (short &value) const throw ()
 Inspection of the colorUnit's value.
void set (const unsigned short value) throw (Exception::InvalidRange)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const unsigned short value) throw (Exception::InvalidRange)
 Assignment operator with unsigned short.
void get (unsigned short &value) const throw ()
 Inspection of the colorUnit's value.
void set (const int value) throw (Exception::InvalidRange)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const int value) throw (Exception::InvalidRange)
 Assignment operator with int.
void get (int &value) const throw ()
 Inspection of the colorUnit's value.
void set (const unsigned int value) throw (Exception::InvalidRange)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const unsigned int value) throw (Exception::InvalidRange)
 Assignment operator with unsigned int.
void get (unsigned int &value) const throw ()
 Inspection of the colorUnit's value.
void set (const long value) throw (Exception::InvalidRange)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const long value) throw (Exception::InvalidRange)
 Assignment operator with long.
void get (long &value) const throw ()
 Inspection of the colorUnit's value.
void set (const unsigned long value) throw (Exception::InvalidRange)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const unsigned long value) throw (Exception::InvalidRange)
 Assignment operator with unsigned long.
void get (unsigned long &value) const throw ()
 Inspection of the colorUnit's value.
void set (const float value) throw (Exception::InvalidRange)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const float value) throw (Exception::InvalidRange)
 Assignment operator with float.
void get (float &value) const throw ()
 Inspection of the colorUnit's value.
void set (const double value) throw (Exception::InvalidRange)
 Changes the value of the colorUnit.
const ColorUnitoperator= (const double value) throw (Exception::InvalidRange)
 Assignment operator with double.
void get (double &value) const throw ()
 Inspection of the colorUnit's value.
Predicates
bool operator== (const ColorUnit &color_unit) const throw ()
 Equality test.
bool operator!= (const ColorUnit &color_unit) const throw ()
 Unequality test.
bool operator< (const ColorUnit &color_unit) const throw ()
 Smaller test.
bool operator<= (const ColorUnit &color_unit) const throw ()
 Smaller or equal test.
bool operator> (const ColorUnit &color_unit) const throw ()
 Greater test.
bool operator>= (const ColorUnit &color_unit) const throw ()
 Greater or equal test.
debuggers and diagnostics
void dump (std::ostream &s=std::cout, Size depth=0) const throw ()
 Internal value dump.

Friends

Storers
std::istream & operator>> (std::istream &s, ColorUnit &color_unit)
 Friendly stream input.
std::ostream & operator<< (std::ostream &s, const ColorUnit &color_unit)
 Friendly stream output.


Detailed Description

ColorUnit class.

An instance of ColorUnit can represent a value for the red, green, blue and alpha component of the class ColorRGBA. Furthermore this class is used for the value and saturation component of the class ColorHSV. The class handles the many possible variations a color value can be set (e.g. integer, float, string values can be given as parameter). The integer values are of range 0-255, the float values are of range 0-1.0 and the strings given are in hex format "00"-"FF". ColorUnit provides certain conversion functions as well, that will convert its value to the needed type. This class is used by the class ColorRGBA and ColorHSV.


Constructor & Destructor Documentation

VIEW::ColorUnit::ColorUnit  )  throw ()
 

Default Constructor.

Its value will be set to zero (0).

VIEW::ColorUnit::ColorUnit const ColorUnit color_unit  )  throw ()
 

Copy constructor.

VIEW::ColorUnit::ColorUnit const char *  value  )  throw (Exception::InvalidRange, NotInHexFormat)
 

Constructor with Parameter char*, representing a value in hex format (00 - FF, or 00 - ff).

Parameters:
value the pointer to a string (00 - FF, or 00 - ff)
Exceptions:
InvalidRange if string length != 2
NotInHexFormat if string contains characters g-z or G-Z

VIEW::ColorUnit::ColorUnit const String value  )  throw (Exception::InvalidRange, NotInHexFormat)
 

Constructor with Parameter String.

Parameters:
value a string (00 - FF, or 00 - ff)
Exceptions:
InvalidRange if string length != 2
NotInHexFormat if string contains characters g-z or G-Z

VIEW::ColorUnit::ColorUnit const unsigned char  value  )  throw ()
 

Constructor with Parameter unsigned char.

Parameters:
value a char (0 - 255)

VIEW::ColorUnit::ColorUnit const short  value  )  throw (Exception::InvalidRange)
 

Constructor with Parameter short.

Parameters:
value a short (0 - 255)
Exceptions:
InvalidRange if value < 0 || value > 255

VIEW::ColorUnit::ColorUnit const unsigned short  value  )  throw (Exception::InvalidRange)
 

Constructor with Parameter unsigned short.

Parameters:
value a unsigned short (0 - 255)
Exceptions:
InvalidRange if value > 255

VIEW::ColorUnit::ColorUnit const int  value  )  throw (Exception::InvalidRange)
 

Constructor with Parameter int.

Parameters:
value an int (0 - 255)
Exceptions:
InvalidRange if value < 0 || value > 255

VIEW::ColorUnit::ColorUnit const unsigned int  value  )  throw (Exception::InvalidRange)
 

Constructor with Parameter unsigned int.

Parameters:
value an unsigned int (0 - 255)
Exceptions:
InvalidRange if value > 255

VIEW::ColorUnit::ColorUnit const long  value  )  throw (Exception::InvalidRange)
 

Constructor with Parameter long.

Parameters:
value an long (0 - 255)
Exceptions:
InvalidRange if value < 0 || value > 255

VIEW::ColorUnit::ColorUnit const unsigned long  value  )  throw (Exception::InvalidRange)
 

Constructor with Parameter unsigned long.

Parameters:
value an unsigned long (0 - 255)
Exceptions:
InvalidRange if value > 255

VIEW::ColorUnit::ColorUnit const float  value  )  throw (Exception::InvalidRange)
 

Constructor with Parameter float.

Parameters:
value a float (0 - 1.0)
Exceptions:
InvalidRange if value < 0.0 || value > 1.0

VIEW::ColorUnit::ColorUnit const double  value  )  throw (Exception::InvalidRange)
 

Constructor with Parameter double.

Parameters:
value a double (0 - 1.0)
Exceptions:
InvalidRange if value < 0.0 || value > 1.0

virtual VIEW::ColorUnit::~ColorUnit  )  throw () [virtual]
 

Destructor.


Member Function Documentation

void VIEW::ColorUnit::clear  )  throw ()
 

Explicit default initialization.

Sets the value of this colorUnit to the default value. The value of this colorUnit is:

  • value is zero (0)

void VIEW::ColorUnit::dump std::ostream &  s = std::cout,
Size  depth = 0
const throw ()
 

Internal value dump.

Dumps the current value of this colorUnit to the output ostream s with dumping depth depth. The value will be outputed as an integer of range 0-255.

Parameters:
s output stream where to output the value of this colorUnit
depth the dumping depth (depth is irrelevant here)

void VIEW::ColorUnit::get double &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value a double receiving the value of this colorUnit (range: 0-1.0)

void VIEW::ColorUnit::get float &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value a float receiving the value of this colorUnit (range: 0-1.0)

void VIEW::ColorUnit::get unsigned long &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value an unsigned long receiving the value of this colorUnit (range: 0-255)

void VIEW::ColorUnit::get long &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value a long receiving the value of this colorUnit (range: 0-255)

void VIEW::ColorUnit::get unsigned int &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value an unsigned int receiving the value of this colorUnit (range: 0-255)

void VIEW::ColorUnit::get int &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value an int receiving the value of this colorUnit (range: 0-255)

void VIEW::ColorUnit::get unsigned short &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value an unsigned short receiving the value of this colorUnit (range: 0-255)

void VIEW::ColorUnit::get short &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value a short receiving the value of this colorUnit (range: 0-255)

void VIEW::ColorUnit::get unsigned char &  value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value an unsigned char receiving the value of this colorUnit (range: 0-255)

void VIEW::ColorUnit::get String value  )  const throw ()
 

Inspection of the colorUnit's value.

Parameters:
value a string receiving the value of this colorUnit in hex format ( "00"-"FF" or "00"-"ff")

void VIEW::ColorUnit::get char *  value  )  const throw ()
 

Inspection of the colorUnit's value.

Memory must be allocated for this parameter. The memory must be at least the size of 3 bytes.

Parameters:
value a char* receiving the value of this colorUnit in hex format ( "00"-"FF" or "00"-"ff")

VIEW::ColorUnit::operator char  )  const throw ()
 

Conversion to char.

Returns:
char with a value of range 0 - 255

VIEW::ColorUnit::operator double  )  const throw ()
 

Conversion to double.

Returns:
double with a value of range 0 - 1.0

VIEW::ColorUnit::operator float  )  const throw ()
 

Conversion to float.

Returns:
float with a value of range 0 - 1.0

VIEW::ColorUnit::operator int  )  const throw ()
 

Conversion to int.

Returns:
int with a value of range 0 - 255

VIEW::ColorUnit::operator long  )  const throw ()
 

Conversion to long.

Returns:
long with a value of range 0 - 255

VIEW::ColorUnit::operator short  )  const throw ()
 

Conversion to short.

Returns:
short with a value of range 0 - 255

VIEW::ColorUnit::operator String  )  const throw ()
 

Conversion to string.

Returns:
string with format "00"-"FF" or "00"-"ff"

VIEW::ColorUnit::operator unsigned char  )  const throw ()
 

Conversion to unsigned char.

Returns:
unsigned char with a value of range 0 - 255

VIEW::ColorUnit::operator unsigned int  )  const throw ()
 

Conversion to unsigned int.

Returns:
unsigned int with a value of range 0 - 255

VIEW::ColorUnit::operator unsigned long  )  const throw ()
 

Conversion to unsigned long.

Returns:
unsigned long with a value of range 0 - 255

VIEW::ColorUnit::operator unsigned short  )  const throw ()
 

Conversion to unsigned short.

Returns:
unsigned short with a value of range 0 - 255

bool VIEW::ColorUnit::operator!= const ColorUnit color_unit  )  const throw ()
 

Unequality test.

Unequality means that the internals value (floats) of the colorUnit's are unequal.

bool VIEW::ColorUnit::operator< const ColorUnit color_unit  )  const throw ()
 

Smaller test.

Smaller means that the internal value (float) this is smaller than the internal value (float) of color_unit colorUnit.

bool VIEW::ColorUnit::operator<= const ColorUnit color_unit  )  const throw ()
 

Smaller or equal test.

Smaller or equal means that the internal value (float) this is smaller or equal than the internal value (float) of color_unit colorUnit.

const ColorUnit& VIEW::ColorUnit::operator= const double  value  )  throw (Exception::InvalidRange)
 

Assignment operator with double.

Calls set.

Parameters:
value a double containing a value of range 0-1.0
Exceptions:
InvalidRange if value < 0.0 || value > 1.0

const ColorUnit& VIEW::ColorUnit::operator= const float  value  )  throw (Exception::InvalidRange)
 

Assignment operator with float.

Calls set.

Parameters:
value a float containing a value of range 0-1.0
Exceptions:
InvalidRange if value < 0.0 || value > 1.0

const ColorUnit& VIEW::ColorUnit::operator= const unsigned long  value  )  throw (Exception::InvalidRange)
 

Assignment operator with unsigned long.

Calls set.

Parameters:
value an unsigned long containing a value of range 0-255
Exceptions:
InvalidRange if value > 255

const ColorUnit& VIEW::ColorUnit::operator= const long  value  )  throw (Exception::InvalidRange)
 

Assignment operator with long.

Calls set.

Parameters:
value a long containing a value of range 0-255
Exceptions:
InvalidRange if value < 0 || value > 255

const ColorUnit& VIEW::ColorUnit::operator= const unsigned int  value  )  throw (Exception::InvalidRange)
 

Assignment operator with unsigned int.

Calls set.

Parameters:
value an unsigned int containing a value of range 0-255
Exceptions:
InvalidRange if value > 255

const ColorUnit& VIEW::ColorUnit::operator= const int  value  )  throw (Exception::InvalidRange)
 

Assignment operator with int.

Calls set.

Parameters:
value an int containing a value of range 0-255
Exceptions:
InvalidRange if value < 0 || value > 255

const ColorUnit& VIEW::ColorUnit::operator= const unsigned short  value  )  throw (Exception::InvalidRange)
 

Assignment operator with unsigned short.

Calls set.

Parameters:
value an unsigned short containing a value of range 0-255
Exceptions:
InvalidRange if value > 255

const ColorUnit& VIEW::ColorUnit::operator= const short  value  )  throw (Exception::InvalidRange)
 

Assignment operator with short.

Calls set.

Parameters:
value a short containing a value of range 0-255
Exceptions:
InvalidRange if value < 0 || value > 255

const ColorUnit& VIEW::ColorUnit::operator= const unsigned char  value  )  throw ()
 

Assignment operator with unsigned char.

Calls set.

Parameters:
value an unsigned char containing a value of range 0-255

const ColorUnit& VIEW::ColorUnit::operator= const String value  )  throw (Exception::InvalidRange, NotInHexFormat)
 

Assignment operator with string.

Calls set.

Parameters:
value a string containing a value in hex format ( "00"-"FF" or "00"-"ff")
Exceptions:
InvalidRange if string length != 2
NotInHexFormat if string contains characters g-z or G-Z

const ColorUnit& VIEW::ColorUnit::operator= const char *  value  )  throw (Exception::InvalidRange, NotInHexFormat)
 

Assignment operator with char*.

Calls set.

Parameters:
value the pointer to a string containing a value in hex format ( "00"-"FF" or "00"-"ff")
Exceptions:
InvalidRange if string length != 2
NotInHexFormat if string contains characters g-z or G-Z

const ColorUnit& VIEW::ColorUnit::operator= const ColorUnit color_unit  )  throw ()
 

Assignment operator.

See also:
set

bool VIEW::ColorUnit::operator== const ColorUnit color_unit  )  const throw ()
 

Equality test.

Equality means that the internals value (floats) of the colorUnit's are equal.

bool VIEW::ColorUnit::operator> const ColorUnit color_unit  )  const throw ()
 

Greater test.

Greater means that the internal value (float) this is greater than the internal value (float) of color_unit colorUnit.

bool VIEW::ColorUnit::operator>= const ColorUnit color_unit  )  const throw ()
 

Greater or equal test.

Greater or equal means that the internal value (float) this is greater or equal than the internal value (float) of color_unit colorUnit.

void VIEW::ColorUnit::set const double  value  )  throw (Exception::InvalidRange)
 

Changes the value of the colorUnit.

Parameters:
value a double of range 0-1.0
Exceptions:
InvalidRange if value < 0.0 || value > 1.0

void VIEW::ColorUnit::set const float  value  )  throw (Exception::InvalidRange)
 

Changes the value of the colorUnit.

Parameters:
value a float of range 0-1.0
Exceptions:
InvalidRange if value < 0.0 || value > 1.0

void VIEW::ColorUnit::set const unsigned long  value  )  throw (Exception::InvalidRange)
 

Changes the value of the colorUnit.

Parameters:
value an unsigned long of range 0-255
Exceptions:
InvalidRange if value > 255

void VIEW::ColorUnit::set const long  value  )  throw (Exception::InvalidRange)
 

Changes the value of the colorUnit.

Parameters:
value a long of range 0-255
Exceptions:
InvalidRange if value < 0 || value > 255

void VIEW::ColorUnit::set const unsigned int  value  )  throw (Exception::InvalidRange)
 

Changes the value of the colorUnit.

Parameters:
value an unsigned int of range 0-255
Exceptions:
InvalidRange if value > 255

void VIEW::ColorUnit::set const int  value  )  throw (Exception::InvalidRange)
 

Changes the value of the colorUnit.

Parameters:
value an int of range 0-255
Exceptions:
InvalidRange if value < 0 || value > 255

void VIEW::ColorUnit::set const unsigned short  value  )  throw (Exception::InvalidRange)
 

Changes the value of the colorUnit.

Parameters:
value an unsigned short of range 0-255
Exceptions:
InvalidRange if value > 255

void VIEW::ColorUnit::set const short  value  )  throw (Exception::InvalidRange)
 

Changes the value of the colorUnit.

Parameters:
value a short of range 0-255
Exceptions:
InvalidRange if value < 0 || value > 255

void VIEW::ColorUnit::set const unsigned char  value  )  throw ()
 

Changes the value of the colorUnit.

Parameters:
value an unsigned char of range 0-255

void VIEW::ColorUnit::set const String value  )  throw (Exception::InvalidRange, NotInHexFormat)
 

Changes the value of the colorUnit.

Changes the value of this colorUnit to the value represented by a string value.

Parameters:
value a string (in the format "00"-"FF" or "00"-"ff")
Exceptions:
InvalidRange if string length != 2
NotInHexFormat if string contains characters g-z or G-Z

void VIEW::ColorUnit::set const char *  value  )  throw (Exception::InvalidRange, NotInHexFormat)
 

Changes the value of the colorUnit.

Parameters:
value the new value of this colorUnit (a string in the format "00"-"FF" or "00"-"ff")
Exceptions:
InvalidRange if string length != 2
NotInHexFormat if string contains characters g-z or G-Z

void VIEW::ColorUnit::set const ColorUnit color_unit  )  throw ()
 

Assignment.

void VIEW::ColorUnit::swap ColorUnit color_unit  )  throw ()
 

Swapping of colorUnits.


Friends And Related Function Documentation

std::ostream& operator<< std::ostream &  s,
const ColorUnit color_unit
[friend]
 

Friendly stream output.

Writes colorUnit data to the output stream s and store the value of this. The value will be stored in integer format of range 0-255.

Parameters:
s output stream to where the value of this colorUnit will be stored
color_unit the colorUnit from which the value will be stored

std::istream& operator>> std::istream &  s,
ColorUnit color_unit
[friend]
 

Friendly stream input.

Reads colorUnit data from the input stream s and restore the value of this. The value will be needed in integer format of range 0-255. This method is provided for convienience.

Parameters:
s input stream from where to restore the value of this colorUnit
color_unit the colorUnit to which the value will be restored