color.cpp

Go to the documentation of this file.

//----------------------------------------------------------------------------
// Borland WinSys Library
// Copyright (c) 1992, 1996 by Borland International, All Rights Reserved
//
/// \file
/// Implementation of color classes
//----------------------------------------------------------------------------
 
#include <owl/pch.h>
#include <owl/defs.h>
#include <owl/color.h>
#include <owl/system.h>
 
 
 
namespace owl {
 
/// \class TColor
///
///  TColor is a support class used in conjunction with the classes TPalette,
///  TPaletteEntry, TRgbQuad, and TRgbTriple to simplify all color operations.
///  TColor has ten static data members representing the standard RGB COLORREF values,
///  from Black to White. Constructors are provided to create TColor objects from
///  COLORREF and RGB values, palette indexes, palette entries, and RGBQUAD and RGBTRIPLE values.
///
///  See the entries for NBits and NColors for a description of TColor-related functions.
//
 
 
 
// Few constants only defined when WINVER >= 0x0400
//
#if !defined(COLOR_3DDKSHADOW)
# define COLOR_3DDKSHADOW        21
#endif
#if !defined(COLOR_3DLIGHT)
# define COLOR_3DLIGHT           22
#endif
#if !defined(COLOR_INFOTEXT)
# define COLOR_INFOTEXT          23
#endif
#if !defined(COLOR_INFOBK)
# define COLOR_INFOBK            24
#endif
 
const TColor TColor::Black(0, 0, 0);         ///< Static TColor object with fixed Value set by RGB(0, 0, 0).
const TColor TColor::LtGray(192, 192, 192);  ///< Static TColor object with fixed Value set by RGB(192, 192, 192).
const TColor TColor::Gray(128, 128, 128);    ///< Static TColor object with fixed Value set by RGB(128, 128, 128).
const TColor TColor::LtRed(255, 0, 0);       ///< Static TColor object with fixed Value set by RGB(255, 0, 0).
const TColor TColor::LtGreen(0, 255, 0);     ///< Static TColor object with fixed Value set by RGB(0, 255, 0).
const TColor TColor::LtYellow(255, 255, 0);  ///< Static TColor object with fixed Value set by RGB(255, 255, 0).
const TColor TColor::LtBlue(0, 0, 255);      ///< Static TColor object with fixed Value set by RGB(0, 0, 255).
const TColor TColor::LtMagenta(255, 0, 255); ///< Static TColor object with fixed Value set by RGB(255, 0, 255).
const TColor TColor::LtCyan(0, 255, 255);    ///< Static TColor object with fixed Value set by RGB(0, 255, 255).
const TColor TColor::White(255, 255, 255);   ///< Static TColor object with fixed Value set by RGB(255, 255, 255).
 
//
// Special marker colors using flag bit pattern. Value never really used.
// Value must not change for streaming compatibility w/ OWL's TWindow
//
const TColor TColor::None((COLORREF) 0xFF000000l);
const TColor TColor::Transparent((COLORREF) 0xFE000000l);
 
//
// Symbolic system colors looked up on evaluation or conversion
//
#define Symbolic 0x80000000UL
/// The symbolic system color value for what is usually the gray area of scrollbars.
/// This is the region that the scrollbar slider slides upon.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysScrollbar          ((COLORREF) (Symbolic | COLOR_SCROLLBAR));
 
/// The symbolic system color value for the desktop.
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysDesktop            ((COLORREF) (Symbolic | COLOR_BACKGROUND));
 
/// The symbolic system color value for the caption of the active window.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysActiveCaption      ((COLORREF) (Symbolic | COLOR_ACTIVECAPTION));
 
/// The symbolic system color value for the caption background of every inactive window.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysInactiveCaption    ((COLORREF) (Symbolic | COLOR_INACTIVECAPTION));
 
/// The symbolic system color value for the background of menus.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysMenu               ((COLORREF) (Symbolic | COLOR_MENU));
 
/// The symbolic system color value for the background of each window.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysWindow             ((COLORREF) (Symbolic | COLOR_WINDOW));
 
/// The symbolic system color value for the frame around each window. The frame is not the same as the border.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysWindowFrame        ((COLORREF) (Symbolic | COLOR_WINDOWFRAME));
 
/// The symbolic system color value for the text shown on menus.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysMenuText           ((COLORREF) (Symbolic | COLOR_MENUTEXT));
 
/// The symbolic system color value for text in every window.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysWindowText         ((COLORREF) (Symbolic | COLOR_WINDOWTEXT));
 
/// The symbolic system color value for text in captions and size boxes, and for the arrow boxes on scroll bars.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysCaptionText        ((COLORREF) (Symbolic | COLOR_CAPTIONTEXT));
 
/// The symbolic system color value for the borders of the active window.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysActiveBorder       ((COLORREF) (Symbolic | COLOR_ACTIVEBORDER));
 
/// The symbolic system color value for the borders of every inactive window.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysInactiveBorder     ((COLORREF) (Symbolic | COLOR_INACTIVEBORDER));
 
/// The symbolic system color value for the background of multiple document interface (MDI) applications.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysAppWorkspace       ((COLORREF) (Symbolic | COLOR_APPWORKSPACE));
 
/// The symbolic system color value for items selected in a control.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysHighlight          ((COLORREF) (Symbolic | COLOR_HIGHLIGHT));
 
/// The symbolic system color value for text selected in a control.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysHighlightText      ((COLORREF) (Symbolic | COLOR_HIGHLIGHTTEXT));
 
/// The symbolic system color value for the face color of 3-dimensional display elements.
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::Sys3dFace             ((COLORREF) (Symbolic | COLOR_BTNFACE));
 
/// The symbolic system color value for the shadow regions of 3-dimensional display elements (for edges facing away from the light source).
///
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::Sys3dShadow           ((COLORREF) (Symbolic | COLOR_BTNSHADOW));
 
/// The symbolic system color value for grayed (disabled) text.
///
/// This color is set to 0 if the current display driver does not support a solid gray color.
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysGrayText           ((COLORREF) (Symbolic | COLOR_GRAYTEXT));
 
/// The symbolic system color value for the text on buttons.
/// Performs GetSysColor() on conversion to COLORREF.
const TColor TColor::SysBtnText            ((COLORREF) (Symbolic | COLOR_BTNTEXT));
 
// NOTE: WINVER >= 0x030a
//
/// The symbolic system color value for the caption text of every inactive window.
const TColor TColor::SysInactiveCaptionText((COLORREF) (Symbolic | COLOR_INACTIVECAPTIONTEXT));
/// The symbolic system color value for highlighted 3-dimensional display elements (for edges facing the light source).
const TColor TColor::Sys3dHilight          ((COLORREF) (Symbolic | COLOR_BTNHIGHLIGHT));
 
// NOTE: WINVER >= 0x0400
//
/// The symbolic system color value for dark shadow regions of 3-dimensional display elements.
const TColor TColor::Sys3dDkShadow((COLORREF) (Symbolic | COLOR_3DDKSHADOW));
/// The symbolic system color value for the light color for 3-dimensional display elements (for edges facing the light source).
const TColor TColor::Sys3dLight   ((COLORREF) (Symbolic | COLOR_3DLIGHT));
/// The symbolic system color value for text shown on tooltip controls.
const TColor TColor::SysInfoText  ((COLORREF) (Symbolic | COLOR_INFOTEXT));
/// The symbolic system color value for the background of tooltip controls.
const TColor TColor::SysInfoBk    ((COLORREF) (Symbolic | COLOR_INFOBK));
 
//
/// Convert a bit count into a color count for color table use, verifying that
/// the bit count is one that is supported by Windows, ie 1, 4, 8, 16, 24, 32.
//
/// If the bit count is not supported, -1 is returned.
//
_OWLFUNC(long)
NColors(uint16 bitCount)
{
  if (bitCount == 1 || bitCount == 4 || bitCount == 8)
    return 1 << bitCount;
  if (bitCount == 16 || bitCount == 24 || bitCount == 32)
    return 0;
  return -1;
}
NColors(uint16 bitCount) {…}
 
//
/// Return the number of bits required to represent a given number of colors
//
_OWLFUNC(uint16)
NBits(long colors)
{
  if (colors <= 2)
    return 1;
  if (colors <= 16)
    return 4;
  if (colors <= 256)
    return 8;
  if (colors <= 65536L)
    return 16;
  if (colors <= 16777216L)
    return 24;
  return 32;
}
NBits(long colors) {…}
 
//
/// Get a 32bit COLORREF type from this color object.
//
/// Performs a GetSysColor() lookup if the object represents a symbolic sys-color index.
//
COLORREF
TColor::GetValue() const
{
  return IsSysColor() ? ::GetSysColor(Index()) : Value;
}
TColor::GetValue() const {…}
 
// copied from old unix owl (JAM 04-16-01)
//DLN UNIX added MwGetTrueRGBValue conversion calls
#if defined(UNIX) && !defined(WINELIB)
#include <mainwin.h>
#endif
 
 
//
/// Return the color's red component
//
uint8
TColor::Red() const
{
  return (uint8)(uint16)GetValue();
}
TColor::Red() const {…}
 
//
/// Return the color's green component
//
uint8
TColor::Green() const
{
  return (uint8)(uint16)(((uint16)GetValue()) >> 8);
}
TColor::Green() const {…}
 
//
/// Return the color's blue component
//
uint8
TColor::Blue() const
{
  return (uint8)(uint16)(GetValue()>>16);
}
TColor::Blue() const {…}
 
////////////////////////////////////////////////////////////////////////////////
 
void
TColor::Lighten(uint8 val)
{
  uint r = Red();
  uint g = Green();
  uint b = Blue();
 
  r = (r > (uint)(255 - val)) ? 255 : r + val;
  g = (g > (uint)(255 - val)) ? 255 : g + val;
  b = (b > (uint)(255 - val)) ? 255 : b + val;
 
  Value = RGB(r, g, b);
}
TColor::Lighten(uint8 val) {…}
 
void
TColor::Darken(uint8 val)
{
  uint r = Red();
  uint g = Green();
  uint b = Blue();
 
  r = (r < (uint)val) ? 0 : r - val;
  g = (g < (uint)val) ? 0 : g - val;
  b = (b < (uint)val) ? 0 : b - val;
 
  Value = RGB(r, g, b);
}
TColor::Darken(uint8 val) {…}
 
void
TColor::Merge(const TColor& other)
{
  Value = MkRGB(
    (static_cast<int>(Red()) + static_cast<int>(other.Red())) / 2,
    (static_cast<int>(Green()) + static_cast<int>(other.Green())) / 2,
    (static_cast<int>(Blue()) + static_cast<int>(other.Blue())) / 2);
}
TColor::Merge(const TColor& other) {…}
 
////////////////////////////////////////////////////////////////////////////////
 
HLSCOLOR
TColor::Rgb2Hls() const
{
  uint8 minval = Red();
  uint8 maxval = Red();
 
  if (minval > Green())
    minval = Green();
  if (maxval < Green())
    maxval = Green();
 
  if (minval > Blue())
    minval = Blue();
  if (maxval < Blue())
    maxval = Blue();
 
  float mdiff  = float(maxval) - float(minval);
  float msum   = float(maxval) + float(minval);
 
  float luminance = msum / 510.0f;
  float saturation = 0.0f;
  float hue = 0.0f;
 
  if (maxval != minval)
  {
      float rnorm = (maxval - Red()) / mdiff;
      float gnorm = (maxval - Green()) / mdiff;
      float bnorm = (maxval - Blue()) / mdiff;
 
      saturation = (luminance <= 0.5f) ? (mdiff / msum) : (mdiff / (510.0f - msum));
 
      if (Red() == maxval)
        hue = 60.0f * (6.0f + bnorm - gnorm);
 
      if (Green() == maxval)
        hue = 60.0f * (2.0f + rnorm - bnorm);
 
      if (Blue() == maxval)
        hue = 60.0f * (4.0f + gnorm - rnorm);
 
      if (hue > 360.0f)
        hue = hue - 360.0f;
  }
 
  return HLS ((hue * 255) / 360, luminance * 255, saturation * 255);
}
TColor::Rgb2Hls() const {…}
 
static uint8
_ToRgb(float rm1, float rm2, float rh)
{
  if (rh > 360.0f)
    rh -= 360.0f;
  else if (rh < 0.0f)
    rh += 360.0f;
 
  if (rh <  60.0f)
    rm1 = rm1 + (rm2 - rm1) * rh / 60.0f;
  else if (rh < 180.0f)
    rm1 = rm2;
  else if (rh < 240.0f)
    rm1 = rm1 + (rm2 - rm1) * (240.0f - rh) / 60.0f;
 
  return (BYTE)(rm1 * 255);
}
 
void
TColor::Hls2Rgb(HLSCOLOR hls)
{
  float hue        = ((int)HLS_H(hls)*360)/255.0f;
  float luminance  = HLS_L(hls)/255.0f;
  float saturation = HLS_S(hls)/255.0f;
 
  if (saturation == 0.0f)
  {
    SetValue(RGB(HLS_L(hls), HLS_L(hls), HLS_L(hls)));
    return;
  }
 
  float rm1, rm2;
 
  if (luminance <= 0.5f)
    rm2 = luminance + luminance * saturation;
  else
    rm2 = luminance + saturation - luminance * saturation;
 
  rm1 = 2.0f * luminance - rm2;
  BYTE red   = _ToRgb(rm1, rm2, hue + 120.0f);
  BYTE green = _ToRgb(rm1, rm2, hue);
  BYTE blue  = _ToRgb(rm1, rm2, hue - 120.0f);
 
  SetValue(RGB(red, green, blue));
}
TColor::Hls2Rgb(HLSCOLOR hls) {…}
 
void
TColor::HlsTransform(int percent_L, int percent_S)
{
  HLSCOLOR hls = Rgb2Hls();
  BYTE h = HLS_H(hls);
  BYTE l = HLS_L(hls);
  BYTE s = HLS_S(hls);
 
  if (percent_L > 0)
  {
    l = BYTE(l + ((255 - l) * percent_L) / 100);
  }
  else if (percent_L < 0)
  {
    l = BYTE((l * (100 + percent_L)) / 100);
  }
 
  if (percent_S > 0)
  {
    s = BYTE(s + ((255 - s) * percent_S) / 100);
  }
  else if (percent_S < 0)
  {
    s = BYTE((s * (100 + percent_S)) / 100);
  }
 
  Hls2Rgb(HLS(h, l, s));
}
TColor::HlsTransform(int percent_L, int percent_S) {…}
 
 
 
} // OWL namespace
/* ========================================================================== */