The SEDRIS Data Representation Model
APPENDIX C - Types
SE_HSV_Data
/*
 * STRUCT: SE_HSV_Data
 *
 *   This data type is used for Hue Saturation Value colour model's data.
 *
 *   If Value has a value of 0, then the values of Hue and Saturation
 *   are meaningless, because the colour will be black. If Saturation
 *   has a value of 0, then the value of Hue is meaningless, and the
 *   value of Value will determine the shade of a grey colour,
 *   somewhere between white and black. Hue is expected to have a
 *   value between 0.0 and 360.0 (not including 360.0). If the value
 *   of Hue is 'undefined' (because the value of Value or Saturation
 *   is 0), then the value of Hue can be represented as
 *   SE_POSITIVE_INFINITY, but this is not required. Basically, if
 *   Value == 0.0, then the values of Hue and Saturation should be
 *   ignored, and if Saturation == 0.0, then the value of Hue should
 *   be ignored. The Hue Saturation Value colour model represents the
 *   colour space as a hexagonal cone. The Hue of the colour
 *   determines the 'colour' of the colour. The Saturation of the colour
 *   determines the 'intensity' of the colour, differentiating a
 *   'strong' red from a 'weak' red, for example. And the Value of
 *   the colour is the difference between a light colour and a dark
 *   colour. Decreasing the Value of a colour adds black to the colour.
 */
typedef struct
{
SE_Long_Float hue; (notes)
SE_Long_Float saturation; (notes)
SE_Long_Float value; (notes)
} SE_HSV_Data;


Field Notes


hue

  angle in degrees about the HSV hexcone
          0 degrees = red
        120 degrees = green
        240 degrees = blue
        (expected values are between 0.0 and 360.0)
        (  0.0 is included                        )
        (360.0 will automatically be reduced to   )
        (  0.0 by the functions in this API       )

saturation

  Saturation, which ranges from 0.0 to 1.0 (0 percent to 100 percent)

value

 Value, sometimes called brightness, which ranges from 0.0 to 1.0



Prev: SE_HS_Multiplicity_Code. Next: SE_ID.


Return to: Top of this Page, Type Index

Last updated: May 15, 2003 Copyright © 2003 SEDRIS™