Home Page Toolkit Overview Using GML   User Input Services     Finger Tracker     Calibrator     Frame Grabber     Service protocol Obtaining GML   Installing GML   Licence Developer Documentation   Tcl/Tk API     The GML Canvas     Image processing   Tcl Scripts Library     List of Classes     List of Files   C/C++ API     List of Classes     List of Files

gml_HSVColor.h // gml_HSVColor.h -- // // Defines the gml_TColor_HSV class template // // Copyright (c) 2004 CLIPS-IMAG // // See the file "gml_LicenseTerms.txt" for information on usage and redistribution // of this file, and for a DISCLAIMER OF ALL WARRANTIES. // // Created on January 9, 2004 (JL). #ifndef __GML_HSVCOLOR__ #define __GML_HSVCOLOR__ #include <assert.h> #include "gml/base/gml_Types.h" #include "gml/base/gml_Attributes.h" #include "gml/math/gml_Math.h" /// /// gml_TColor_HSV_FFF -- /// A union type used to represent HSV-encoded color pixels. /// HSV is Smith's Hue, Saturation, Value colorspace. /// The type (and bitwidth) used for each channel is the template parameter. /// /// Some of this code is adapted from section 15.3.4 of "Computer Graphics: /// Principles and Practice", by J.D. Foley and A. van Dam. /// class gml_TColor_HSV_FFF { public: /// /// Constructor -- /// Convert a 24-bit RGB triplet into HSV and fill in the object. /// gml_TColor_HSV_FFF (UInt8 const r, UInt8 const g, UInt8 const b) { UInt32 min = Min (r, g, b); UInt32 max = Max (r, g, b); Float32 delta, h, s, v; v = Divide (max , 255.0F); s = (max == 0) ? 0.0F : (Divide ((max-min) , max)); if (s == 0.0F) { // achromatic case h = 0.0F; } else { delta = max - min; if (r == max) { h = Divide (Float32(g) - Float32(b), delta); if (h < 0.0) h += 6.0; } else if (g == max) { h = 2.0F + Divide (Float32(b) - Float32(r), delta); } else /*if (b == max)*/ { h = 4.0F + Divide (Float32(r) - Float32(g), delta); } } H = (1.0F / 6.0F) * h; S = s; V = v; assert (H >= 0.0F && H <= 1.0F); assert (S >= 0.0F && S <= 1.0F); assert (V >= 0.0F && V <= 1.0F); } /// /// Constructor -- /// Fill the structure from data in memory /// gml_TColor_HSV_FFF (const void * const ptr) { *this = *((gml_TColor_HSV_FFF*)ptr); } /// /// Constructor -- /// Leave the structure `as is'. /// I.e. probably zero. /// gml_TColor_HSV_FFF () {} /// /// Print -- /// Dump a representation of the pixel to stdout: channels in hex and /// in degrees, percent, percent format. /// @warning no newline appended ! /// void Print () { printf ("%f %f %f (%3d %3d%% %3d%%)", H, S, V, (int) LRound (fmod(360.0 * H + 360.0, 360.0)), (int) LRound (100 * S), (int) LRound (100 * V) ); } /// /// Store -- /// Place the structure's data in memory /// void Store (void * const ptr) { *((gml_TColor_HSV_FFF*)ptr) = *this; } /// /// Convert -- /// Convert the HSV data in this object to a 24 bit RGB triplet. /// void Convert (UInt8 &r, UInt8 &g, UInt8 &b) { Float32 fr = 0.0f; Float32 fg = 0.0f; Float32 fb = 0.0f; if (S == 0.0F) { r = g = b = (UInt8) LRound (V * 255.0); } else { Float32 i = Floor (6.0F * H); Float32 f = 6.0F * H - i; Float32 p = V * (1.0F - S); Float32 q = V * (1.0F - S * f); Float32 t = V * (1.0F - S * (1.0F - f)); assert (p >= 0.0F && p <= 1.0F); assert (q >= 0.0F && q <= 1.0F); assert (t >= 0.0F && t <= 1.0F); assert (V >= 0.0F && V <= 1.0F); switch ((int) i) { case 0: fr = V; fg = t; fb = p; break; case 1: fr = q; fg = V; fb = p; break; case 2: fr = p; fg = V; fb = t; break; case 3: fr = p; fg = q; fb = V; break; case 4: fr = t; fg = p; fb = V; break; case 5: fr = V; fg = p; fb = q; break; } assert (fr <= 255.0 && fr >= 0.0); assert (fg <= 255.0 && fg >= 0.0); assert (fb <= 255.0 && fb >= 0.0); r = (UInt8) LRound (fr * 255.0); g = (UInt8) LRound (fg * 255.0); b = (UInt8) LRound (fb * 255.0); } } /// /// Distance -- /// Compute the 16-bit distance to another HSV pixel. /// The euclidian distance in the hue, saturation disc is used. /// UInt16 Distance (const gml_TColor_HSV_FFF other) { const Float32 pi = 3.14159265358979323846F; Float32 x0, x1, y0, y1, res; x0 = S * Cos (2.0F * pi * H); y0 = S * Sin (2.0F * pi * H); x1 = other.S * Cos (2.0F * pi * other.H); y1 = other.S * Sin (2.0F * pi * other.H); res = Min (1.0F, Norm (x0, y0, x1, y1)); assert (res >= 0.0F && res <= 1.0F); return (UInt16) LFloor (res * 65535.0F); } struct { ///< structure for transparent channel access #if BYTE_ORDER == BIG_ENDIAN Float32 H; ///< hue channel Float32 S; ///< saturation channel Float32 V; ///< value channel #else Float32 V; ///< value channel Float32 S; ///< saturation channel Float32 H; ///< hue channel #endif } GML_PACKED; }; /// /// gml_TColor_HSV -- /// A union type used to represent HSV-encoded color pixels. /// HSV is Smith's Hue, Saturation, Value colorspace. /// The type (and bitwidth) used for each channel is the template parameter. /// template <typename Channel> class gml_TColor_HSV { public: /// /// Constructor -- /// Convert a 24-bit RGB triplet into HSV and fill in the object. /// gml_TColor_HSV (UInt8 const r, UInt8 const g, UInt8 const b) { gml_TColor_HSV_FFF const pix (r, g, b); H = LFloor (pix.H * sChannelMax); S = LFloor (pix.S * sChannelMax); V = LFloor (pix.V * sChannelMax); } /// /// Constructor -- /// Fill the structure from data in memory /// gml_TColor_HSV (const void * const ptr) { *this = *((gml_TColor_HSV<Channel>*)ptr); } /// /// Constructor -- /// Leave the structure `as is'. /// I.e. probably zero. /// gml_TColor_HSV () {} /// /// Print -- /// Dump a representation of the pixel to stdout: channels in hex and /// in degrees, percent, percent format. /// @warning no newline appended ! /// void Print () { printf ("% 8X % 8X % 8X (%3d %3d%% %3d%%)", H, S, V, (UInt32) round (fmod(360.0 * H / sChannelMax + 360.0, 360.0)), 100 * S / sChannelMax, 100 * V / sChannelMax ); } /// /// Store -- /// Place the structure's data in memory /// void Store (void * const ptr) { *((gml_TColor_HSV<Channel>*)ptr) = *this; } /// /// Convert -- /// Convert the HSV data in this object to a 24 bit RGB triplet. /// void Convert (UInt8 &r, UInt8 &g, UInt8 &b) { gml_TColor_HSV_FFF pix; pix.H = Divide (H, sChannelMax); pix.S = Divide (S, sChannelMax); pix.V = Divide (V, sChannelMax); pix.Convert (r, g, b); } /// /// Distance -- /// Compute the 16-bit distance to another HSV pixel. /// The euclidian distance in the hue, saturation disc is used. /// UInt16 Distance (const gml_TColor_HSV<Channel> other) { gml_TColor_HSV_FFF pix0, pix1; pix0.H = Divide ( H, sChannelMax); pix0.S = Divide ( S, sChannelMax); pix0.V = Divide ( V, sChannelMax); pix1.H = Divide (other.H, other.sChannelMax); pix1.S = Divide (other.S, other.sChannelMax); pix1.V = Divide (other.V, other.sChannelMax); return pix0.Distance (pix1); } static UInt8 const sChannelBits = 8 * sizeof (Channel); ///< bits per channel static UInt64 const sChannelMax = (1 << sChannelBits) - 1; ///< max channel value struct { ///< structure for transparent channel access #if BYTE_ORDER == BIG_ENDIAN Channel H; ///< hue channel Channel S; ///< saturation channel Channel V; ///< value channel #else Channel V; ///< value channel Channel S; ///< saturation channel Channel H; ///< hue channel #endif } GML_PACKED; }; // // gml_TColor_HSV_888, gml_TColor_HSV_SSS, gml_TColor_HSV_LLL -- // typedef gml_TColor_HSV<UInt8> gml_TColor_HSV_888; typedef gml_TColor_HSV<UInt16> gml_TColor_HSV_SSS; typedef gml_TColor_HSV<UInt32> gml_TColor_HSV_LLL; #endif /* __GML_HSVCOLOR__ */ Generated on Tue Jun 12 14:03:27 2007 for gml by Doxygen 1.5.2.

Contact: julien (dot) letessier (at) gmail (dot) com. Copyright (c) 2000-2007 CLIPS-IMAG Laboratory, Grenoble, France. All rights reserved. W3CXHTML 1.0 W3CCSS 2.0