2001-09-26 04:16:04 +04:00
|
|
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
|
|
/* ***** BEGIN LICENSE BLOCK *****
|
2004-04-18 01:52:36 +04:00
|
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
1999-01-26 01:16:47 +03:00
|
|
|
*
|
2004-04-18 01:52:36 +04:00
|
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
|
|
* the License. You may obtain a copy of the License at
|
|
|
|
* http://www.mozilla.org/MPL/
|
1999-01-26 01:16:47 +03:00
|
|
|
*
|
2001-09-26 04:16:04 +04:00
|
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
|
|
* for the specific language governing rights and limitations under the
|
|
|
|
* License.
|
1999-01-26 01:16:47 +03:00
|
|
|
*
|
1999-11-06 06:43:54 +03:00
|
|
|
* The Original Code is mozilla.org code.
|
|
|
|
*
|
2004-04-18 01:52:36 +04:00
|
|
|
* The Initial Developer of the Original Code is
|
2001-09-26 04:16:04 +04:00
|
|
|
* Netscape Communications Corporation.
|
|
|
|
* Portions created by the Initial Developer are Copyright (C) 1998
|
|
|
|
* the Initial Developer. All Rights Reserved.
|
1999-11-06 06:43:54 +03:00
|
|
|
*
|
2001-09-26 04:16:04 +04:00
|
|
|
* Contributor(s):
|
|
|
|
*
|
|
|
|
* Alternatively, the contents of this file may be used under the terms of
|
2004-04-18 01:52:36 +04:00
|
|
|
* either of the GNU General Public License Version 2 or later (the "GPL"),
|
|
|
|
* or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
2001-09-26 04:16:04 +04:00
|
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
2004-04-18 01:52:36 +04:00
|
|
|
* use your version of this file under the terms of the MPL, indicate your
|
2001-09-26 04:16:04 +04:00
|
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
|
|
* the provisions above, a recipient may use your version of this file under
|
2004-04-18 01:52:36 +04:00
|
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
2001-09-26 04:16:04 +04:00
|
|
|
*
|
|
|
|
* ***** END LICENSE BLOCK ***** */
|
1999-01-26 01:16:47 +03:00
|
|
|
|
|
|
|
#ifndef nsColor_h___
|
|
|
|
#define nsColor_h___
|
|
|
|
|
2004-05-18 22:09:16 +04:00
|
|
|
#include "gfxCore.h"
|
2005-11-17 23:06:22 +03:00
|
|
|
#include "nscore.h"
|
2004-11-30 03:57:24 +03:00
|
|
|
|
|
|
|
class nsAString;
|
|
|
|
class nsString;
|
|
|
|
class nsCString;
|
1999-07-18 04:06:12 +04:00
|
|
|
|
1999-01-26 01:16:47 +03:00
|
|
|
// A color is a 32 bit unsigned integer with four components: R, G, B
|
|
|
|
// and A.
|
|
|
|
typedef PRUint32 nscolor;
|
|
|
|
|
|
|
|
// Make a color out of r,g,b values. This assumes that the r,g,b values are
|
|
|
|
// properly constrained to 0-255. This also assumes that a is 255.
|
|
|
|
#define NS_RGB(_r,_g,_b) \
|
|
|
|
((nscolor) ((255 << 24) | ((_b)<<16) | ((_g)<<8) | (_r)))
|
|
|
|
|
|
|
|
// Make a color out of r,g,b,a values. This assumes that the r,g,b,a
|
|
|
|
// values are properly constrained to 0-255.
|
|
|
|
#define NS_RGBA(_r,_g,_b,_a) \
|
|
|
|
((nscolor) (((_a) << 24) | ((_b)<<16) | ((_g)<<8) | (_r)))
|
|
|
|
|
|
|
|
// Extract color components from nscolor
|
|
|
|
#define NS_GET_R(_rgba) ((PRUint8) ((_rgba) & 0xff))
|
|
|
|
#define NS_GET_G(_rgba) ((PRUint8) (((_rgba) >> 8) & 0xff))
|
|
|
|
#define NS_GET_B(_rgba) ((PRUint8) (((_rgba) >> 16) & 0xff))
|
|
|
|
#define NS_GET_A(_rgba) ((PRUint8) (((_rgba) >> 24) & 0xff))
|
|
|
|
|
2001-01-03 02:41:07 +03:00
|
|
|
// Fast approximate division by 255. It has the property that
|
|
|
|
// for all 0 <= n <= 255*255, FAST_DIVIDE_BY_255(n) == n/255.
|
|
|
|
// But it only uses two adds and two shifts instead of an
|
|
|
|
// integer division (which is expensive on many processors).
|
|
|
|
//
|
|
|
|
// equivalent to target=v/255
|
|
|
|
#define FAST_DIVIDE_BY_255(target,v) \
|
|
|
|
PR_BEGIN_MACRO \
|
|
|
|
unsigned tmp_ = v; \
|
|
|
|
target = ((tmp_ << 8) + tmp_ + 255) >> 16; \
|
|
|
|
PR_END_MACRO
|
|
|
|
|
|
|
|
// Blending macro
|
|
|
|
//
|
|
|
|
// equivalent to target=(bg*(255-alpha)+fg*alpha)/255
|
|
|
|
#define MOZ_BLEND(target, bg, fg, alpha) \
|
|
|
|
FAST_DIVIDE_BY_255(target, (bg)*(255-(alpha)) + (fg)*(alpha))
|
|
|
|
|
1999-01-26 01:16:47 +03:00
|
|
|
// Translate a hex string to a color. Return true if it parses ok,
|
|
|
|
// otherwise return false.
|
2008-03-14 19:27:14 +03:00
|
|
|
// This accepts only 3 or 6 digits
|
2006-04-17 21:33:42 +04:00
|
|
|
NS_GFX_(PRBool) NS_HexToRGB(const nsString& aBuf, nscolor* aResult);
|
1999-01-26 01:16:47 +03:00
|
|
|
|
2005-05-20 01:28:58 +04:00
|
|
|
// Compose one NS_RGB color onto another. The result is what you get
|
|
|
|
// if you draw aBG onto RGBA(0,0,0,0) and then aFG on top of that,
|
|
|
|
// with operator OVER.
|
2006-04-17 21:33:42 +04:00
|
|
|
NS_GFX_(nscolor) NS_ComposeColors(nscolor aBG, nscolor aFG);
|
2005-05-20 01:28:58 +04:00
|
|
|
|
1999-01-26 01:16:47 +03:00
|
|
|
// Translate a hex string to a color. Return true if it parses ok,
|
|
|
|
// otherwise return false.
|
|
|
|
// This version accepts 1 to 9 digits (missing digits are 0)
|
2006-04-17 21:33:42 +04:00
|
|
|
NS_GFX_(PRBool) NS_LooseHexToRGB(const nsString& aBuf, nscolor* aResult);
|
1999-01-26 01:16:47 +03:00
|
|
|
|
2004-03-04 05:06:28 +03:00
|
|
|
// Translate a color to a hex string and prepend a '#'.
|
|
|
|
// The returned string is always 7 characters including a '#' character.
|
2006-04-17 21:33:42 +04:00
|
|
|
NS_GFX_(void) NS_RGBToHex(nscolor aColor, nsAString& aResult);
|
2004-03-04 05:06:28 +03:00
|
|
|
|
1999-01-26 01:16:47 +03:00
|
|
|
// Translate a color name to a color. Return true if it parses ok,
|
|
|
|
// otherwise return false.
|
2006-04-17 21:33:42 +04:00
|
|
|
NS_GFX_(PRBool) NS_ColorNameToRGB(const nsAString& aBuf, nscolor* aResult);
|
1999-01-26 01:16:47 +03:00
|
|
|
|
2003-03-18 08:43:12 +03:00
|
|
|
// function to convert from HSL color space to RGB color space
|
|
|
|
// the float parameters are all expected to be in the range 0-1
|
2006-04-17 21:33:42 +04:00
|
|
|
NS_GFX_(nscolor) NS_HSL2RGB(float h, float s, float l);
|
2003-03-18 08:43:12 +03:00
|
|
|
|
1999-01-26 01:16:47 +03:00
|
|
|
#endif /* nsColor_h___ */
|