/////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2004, Industrial Light & Magic, a division of Lucas // Digital Ltd. LLC // // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Industrial Light & Magic nor the names of // its contributors may be used to endorse or promote products derived // from this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////// #ifndef INCLUDED_IMATHCOLOR_H #define INCLUDED_IMATHCOLOR_H //---------------------------------------------------- // // A three and four component color class template. // //---------------------------------------------------- #include "ImathVec.h" #include "half.h" namespace Imath { template class Color3: public Vec3 { public: //------------- // Constructors //------------- Color3 (); // no initialization explicit Color3 (T a); // (a a a) Color3 (T a, T b, T c); // (a b c) //--------------------------------- // Copy constructors and assignment //--------------------------------- Color3 (const Color3 &c); template Color3 (const Vec3 &v); const Color3 & operator = (const Color3 &c); //------------------------ // Component-wise addition //------------------------ const Color3 & operator += (const Color3 &c); Color3 operator + (const Color3 &c) const; //--------------------------- // Component-wise subtraction //--------------------------- const Color3 & operator -= (const Color3 &c); Color3 operator - (const Color3 &c) const; //------------------------------------ // Component-wise multiplication by -1 //------------------------------------ Color3 operator - () const; const Color3 & negate (); //------------------------------ // Component-wise multiplication //------------------------------ const Color3 & operator *= (const Color3 &c); const Color3 & operator *= (T a); Color3 operator * (const Color3 &c) const; Color3 operator * (T a) const; //------------------------ // Component-wise division //------------------------ const Color3 & operator /= (const Color3 &c); const Color3 & operator /= (T a); Color3 operator / (const Color3 &c) const; Color3 operator / (T a) const; }; template class Color4 { public: //------------------- // Access to elements //------------------- T r, g, b, a; T & operator [] (int i); const T & operator [] (int i) const; //------------- // Constructors //------------- Color4 (); // no initialization explicit Color4 (T a); // (a a a a) Color4 (T a, T b, T c, T d); // (a b c d) //--------------------------------- // Copy constructors and assignment //--------------------------------- Color4 (const Color4 &v); template Color4 (const Color4 &v); const Color4 & operator = (const Color4 &v); //---------------------- // Compatibility with Sb //---------------------- template void setValue (S a, S b, S c, S d); template void setValue (const Color4 &v); template void getValue (S &a, S &b, S &c, S &d) const; template void getValue (Color4 &v) const; T * getValue(); const T * getValue() const; //--------- // Equality //--------- template bool operator == (const Color4 &v) const; template bool operator != (const Color4 &v) const; //------------------------ // Component-wise addition //------------------------ const Color4 & operator += (const Color4 &v); Color4 operator + (const Color4 &v) const; //--------------------------- // Component-wise subtraction //--------------------------- const Color4 & operator -= (const Color4 &v); Color4 operator - (const Color4 &v) const; //------------------------------------ // Component-wise multiplication by -1 //------------------------------------ Color4 operator - () const; const Color4 & negate (); //------------------------------ // Component-wise multiplication //------------------------------ const Color4 & operator *= (const Color4 &v); const Color4 & operator *= (T a); Color4 operator * (const Color4 &v) const; Color4 operator * (T a) const; //------------------------ // Component-wise division //------------------------ const Color4 & operator /= (const Color4 &v); const Color4 & operator /= (T a); Color4 operator / (const Color4 &v) const; Color4 operator / (T a) const; //---------------------------------------------------------- // Number of dimensions, i.e. number of elements in a Color4 //---------------------------------------------------------- static unsigned int dimensions() {return 4;} //------------------------------------------------- // Limitations of type T (see also class limits) //------------------------------------------------- static T baseTypeMin() {return limits::min();} static T baseTypeMax() {return limits::max();} static T baseTypeSmallest() {return limits::smallest();} static T baseTypeEpsilon() {return limits::epsilon();} //-------------------------------------------------------------- // Base type -- in templates, which accept a parameter, V, which // could be a Color4, you can refer to T as // V::BaseType //-------------------------------------------------------------- typedef T BaseType; }; //-------------- // Stream output //-------------- template std::ostream & operator << (std::ostream &s, const Color4 &v); //---------------------------------------------------- // Reverse multiplication: S * Color4 //---------------------------------------------------- template Color4 operator * (S a, const Color4 &v); //------------------------- // Typedefs for convenience //------------------------- typedef Color3 Color3f; typedef Color3 Color3h; typedef Color3 Color3c; typedef Color3 C3h; typedef Color3 C3f; typedef Color3 C3c; typedef Color4 Color4f; typedef Color4 Color4h; typedef Color4 Color4c; typedef Color4 C4f; typedef Color4 C4h; typedef Color4 C4c; typedef unsigned int PackedColor; //------------------------- // Implementation of Color3 //------------------------- template inline Color3::Color3 (): Vec3 () { // empty } template inline Color3::Color3 (T a): Vec3 (a) { // empty } template inline Color3::Color3 (T a, T b, T c): Vec3 (a, b, c) { // empty } template inline Color3::Color3 (const Color3 &c): Vec3 (c) { // empty } template template inline Color3::Color3 (const Vec3 &v): Vec3 (v) { //empty } template inline const Color3 & Color3::operator = (const Color3 &c) { *((Vec3 *) this) = c; return *this; } template inline const Color3 & Color3::operator += (const Color3 &c) { *((Vec3 *) this) += c; return *this; } template inline Color3 Color3::operator + (const Color3 &c) const { return Color3 (*(Vec3 *)this + (const Vec3 &)c); } template inline const Color3 & Color3::operator -= (const Color3 &c) { *((Vec3 *) this) -= c; return *this; } template inline Color3 Color3::operator - (const Color3 &c) const { return Color3 (*(Vec3 *)this - (const Vec3 &)c); } template inline Color3 Color3::operator - () const { return Color3 (-(*(Vec3 *)this)); } template inline const Color3 & Color3::negate () { ((Vec3 *) this)->negate(); return *this; } template inline const Color3 & Color3::operator *= (const Color3 &c) { *((Vec3 *) this) *= c; return *this; } template inline const Color3 & Color3::operator *= (T a) { *((Vec3 *) this) *= a; return *this; } template inline Color3 Color3::operator * (const Color3 &c) const { return Color3 (*(Vec3 *)this * (const Vec3 &)c); } template inline Color3 Color3::operator * (T a) const { return Color3 (*(Vec3 *)this * a); } template inline const Color3 & Color3::operator /= (const Color3 &c) { *((Vec3 *) this) /= c; return *this; } template inline const Color3 & Color3::operator /= (T a) { *((Vec3 *) this) /= a; return *this; } template inline Color3 Color3::operator / (const Color3 &c) const { return Color3 (*(Vec3 *)this / (const Vec3 &)c); } template inline Color3 Color3::operator / (T a) const { return Color3 (*(Vec3 *)this / a); } //----------------------- // Implementation of Color4 //----------------------- template inline T & Color4::operator [] (int i) { return (&r)[i]; } template inline const T & Color4::operator [] (int i) const { return (&r)[i]; } template inline Color4::Color4 () { // empty } template inline Color4::Color4 (T x) { r = g = b = a = x; } template inline Color4::Color4 (T x, T y, T z, T w) { r = x; g = y; b = z; a = w; } template inline Color4::Color4 (const Color4 &v) { r = v.r; g = v.g; b = v.b; a = v.a; } template template inline Color4::Color4 (const Color4 &v) { r = T (v.r); g = T (v.g); b = T (v.b); a = T (v.a); } template inline const Color4 & Color4::operator = (const Color4 &v) { r = v.r; g = v.g; b = v.b; a = v.a; return *this; } template template inline void Color4::setValue (S x, S y, S z, S w) { r = T (x); g = T (y); b = T (z); a = T (w); } template template inline void Color4::setValue (const Color4 &v) { r = T (v.r); g = T (v.g); b = T (v.b); a = T (v.a); } template template inline void Color4::getValue (S &x, S &y, S &z, S &w) const { x = S (r); y = S (g); z = S (b); w = S (a); } template template inline void Color4::getValue (Color4 &v) const { v.r = S (r); v.g = S (g); v.b = S (b); v.a = S (a); } template inline T * Color4::getValue() { return (T *) &r; } template inline const T * Color4::getValue() const { return (const T *) &r; } template template inline bool Color4::operator == (const Color4 &v) const { return r == v.r && g == v.g && b == v.b && a == v.a; } template template inline bool Color4::operator != (const Color4 &v) const { return r != v.r || g != v.g || b != v.b || a != v.a; } template inline const Color4 & Color4::operator += (const Color4 &v) { r += v.r; g += v.g; b += v.b; a += v.a; return *this; } template inline Color4 Color4::operator + (const Color4 &v) const { return Color4 (r + v.r, g + v.g, b + v.b, a + v.a); } template inline const Color4 & Color4::operator -= (const Color4 &v) { r -= v.r; g -= v.g; b -= v.b; a -= v.a; return *this; } template inline Color4 Color4::operator - (const Color4 &v) const { return Color4 (r - v.r, g - v.g, b - v.b, a - v.a); } template inline Color4 Color4::operator - () const { return Color4 (-r, -g, -b, -a); } template inline const Color4 & Color4::negate () { r = -r; g = -g; b = -b; a = -a; return *this; } template inline const Color4 & Color4::operator *= (const Color4 &v) { r *= v.r; g *= v.g; b *= v.b; a *= v.a; return *this; } template inline const Color4 & Color4::operator *= (T x) { r *= x; g *= x; b *= x; a *= x; return *this; } template inline Color4 Color4::operator * (const Color4 &v) const { return Color4 (r * v.r, g * v.g, b * v.b, a * v.a); } template inline Color4 Color4::operator * (T x) const { return Color4 (r * x, g * x, b * x, a * x); } template inline const Color4 & Color4::operator /= (const Color4 &v) { r /= v.r; g /= v.g; b /= v.b; a /= v.a; return *this; } template inline const Color4 & Color4::operator /= (T x) { r /= x; g /= x; b /= x; a /= x; return *this; } template inline Color4 Color4::operator / (const Color4 &v) const { return Color4 (r / v.r, g / v.g, b / v.b, a / v.a); } template inline Color4 Color4::operator / (T x) const { return Color4 (r / x, g / x, b / x, a / x); } template std::ostream & operator << (std::ostream &s, const Color4 &v) { return s << '(' << v.r << ' ' << v.g << ' ' << v.b << ' ' << v.a << ')'; } //----------------------------------------- // Implementation of reverse multiplication //----------------------------------------- template inline Color4 operator * (S x, const Color4 &v) { return Color4 (x * v.r, x * v.g, x * v.b, x * v.a); } } // namespace Imath #endif