00001 /** \file
00002  * \brief HSI Color Manipulation
00003  *
00004  * See Copyright Notice in im_lib.h
00005  * $Id: Exp $
00006  */
00007 
00008 #ifndef __IM_COLORHSI_H
00009 #define __IM_COLORHSI_H
00010 
00011 #if defined(__cplusplus)
00012 extern "C" {
00013 #endif
00014 
00015 
00016 /** \defgroup hsi HSI Color Coordinate System Conversions
00017  *
00018  * \par
00019  * HSI is just the RGB color space written in a different coordinate system.
00020  * \par
00021  * "I" is the cube diagonal. HS is a polar coordinates of a plane normal to "I". 
00022  * "S" is the distance from the diagonal. "H" is the angle from red vector.
00023  * \par
00024  * This is not a new color space, this is exactly the same gammut as RGB. \n
00025  * Since it is still a cube, Smax depends on H. 
00026  * \par
00027  * See \ref im_colorhsi.h
00028  * \ingroup color */
00029 
00030 
00031 /** Returns the maximum S for H (in radians) and I.
00032  * \ingroup hsi */
00033 float imColorHSI_Smax(float h, double cosh, double sinh, float i);
00034 
00035 /** Returns I where S is maximum given H (in radians).
00036  * \ingroup hsi */
00037 float imColorHSI_ImaxS(float h, double cosh, double sinh);
00038 
00039 /** Converts from RGB to HSI.
00040  * \ingroup hsi */
00041 void imColorRGB2HSI(float r, float g, float b, float *h, float *s, float *i);
00042 
00043 /** Converts from RGB (byte) to HSI.
00044  * \ingroup hsi */
00045 void imColorRGB2HSIbyte(unsigned char r, unsigned char g, unsigned char b, float *h, float *s, float *i);
00046 
00047 /** Converts from HSI to RGB.
00048  * \ingroup hsi */
00049 void imColorHSI2RGB(float h, float s, float i, float *r, float *g, float *b);
00050 
00051 /** Converts from HSI to RGB (byte).
00052  * \ingroup hsi */
00053 void imColorHSI2RGBbyte(float h, float s, float i, unsigned char *r, unsigned char *g, unsigned char *b);
00054 
00055 
00056 #if defined(__cplusplus)
00057 }
00058 #endif
00059 
00060 #endif