xref: /AOO41X/main/basegfx/inc/basegfx/pixel/bpixel.hxx (revision 7024eca93be2e0c3654aa8f286feedace76da6ff)
1 /**************************************************************
2  *
3  * Licensed to the Apache Software Foundation (ASF) under one
4  * or more contributor license agreements.  See the NOTICE file
5  * distributed with this work for additional information
6  * regarding copyright ownership.  The ASF licenses this file
7  * to you under the Apache License, Version 2.0 (the
8  * "License"); you may not use this file except in compliance
9  * with the License.  You may obtain a copy of the License at
10  *
11  *   http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing,
14  * software distributed under the License is distributed on an
15  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16  * KIND, either express or implied.  See the License for the
17  * specific language governing permissions and limitations
18  * under the License.
19  *
20  *************************************************************/
21 
22 
23 
24 #ifndef _BGFX_PIXEL_BPIXEL_HXX
25 #define _BGFX_PIXEL_BPIXEL_HXX
26 
27 #include <sal/types.h>
28 #include <basegfx/numeric/ftools.hxx>
29 #include <basegfx/color/bcolor.hxx>
30 
31 //////////////////////////////////////////////////////////////////////////////
32 // predeclarations
33 
34 //////////////////////////////////////////////////////////////////////////////
35 
36 namespace basegfx
37 {
38     class BPixel
39     {
40     protected:
41         union
42         {
43             struct
44             {
45                 // bitfield
46                 unsigned                                mnR : 8;        // red intensity
47                 unsigned                                mnG : 8;        // green intensity
48                 unsigned                                mnB : 8;        // blue intensity
49                 unsigned                                mnO : 8;        // opacity, 0 == full transparence
50             } maRGBO;
51 
52             struct
53             {
54                 // bitfield
55                 unsigned                                mnValue : 32;   // all values
56             } maCombinedRGBO;
57         } maPixelUnion;
58 
59     public:
BPixel()60         BPixel()
61         {
62             maPixelUnion.maCombinedRGBO.mnValue = 0L;
63         }
64 
65         // use explicit here to make sure everyone knows what he is doing. Values range from
66         // 0..255 integer here.
BPixel(sal_uInt8 nRed,sal_uInt8 nGreen,sal_uInt8 nBlue,sal_uInt8 nOpacity)67         explicit BPixel(sal_uInt8 nRed, sal_uInt8 nGreen, sal_uInt8 nBlue, sal_uInt8 nOpacity)
68         {
69             maPixelUnion.maRGBO.mnR = nRed;
70             maPixelUnion.maRGBO.mnG = nGreen;
71             maPixelUnion.maRGBO.mnB = nBlue;
72             maPixelUnion.maRGBO.mnO = nOpacity;
73         }
74 
75         // constructor from BColor which uses double precision color, so change it
76         // to local integer format. It will also be clamped here.
BPixel(const BColor & rColor,sal_uInt8 nOpacity)77         BPixel(const BColor& rColor, sal_uInt8 nOpacity)
78         {
79             maPixelUnion.maRGBO.mnR = sal_uInt8((rColor.getRed() * 255.0) + 0.5);
80             maPixelUnion.maRGBO.mnG = sal_uInt8((rColor.getGreen() * 255.0) + 0.5);
81             maPixelUnion.maRGBO.mnB = sal_uInt8((rColor.getBlue() * 255.0) + 0.5);
82             maPixelUnion.maRGBO.mnO = nOpacity;
83         }
84 
85         // copy constructor
BPixel(const BPixel & rPixel)86         BPixel(const BPixel& rPixel)
87         {
88             maPixelUnion.maCombinedRGBO.mnValue = rPixel.maPixelUnion.maCombinedRGBO.mnValue;
89         }
90 
~BPixel()91         ~BPixel()
92         {}
93 
94         // assignment operator
operator =(const BPixel & rPixel)95         BPixel& operator=( const BPixel& rPixel )
96         {
97             maPixelUnion.maCombinedRGBO.mnValue = rPixel.maPixelUnion.maCombinedRGBO.mnValue;
98             return *this;
99         }
100 
101         // data access read
getRed() const102         sal_uInt8 getRed() const { return maPixelUnion.maRGBO.mnR; }
getGreen() const103         sal_uInt8 getGreen() const { return maPixelUnion.maRGBO.mnG; }
getBlue() const104         sal_uInt8 getBlue() const { return maPixelUnion.maRGBO.mnB; }
getOpacity() const105         sal_uInt8 getOpacity() const { return maPixelUnion.maRGBO.mnO; }
getRedGreenBlueOpacity() const106         sal_uInt32 getRedGreenBlueOpacity() const { return maPixelUnion.maCombinedRGBO.mnValue; }
107 
108         // data access write
setRed(sal_uInt8 nNew)109         void setRed(sal_uInt8 nNew) { maPixelUnion.maRGBO.mnR = nNew; }
setGreen(sal_uInt8 nNew)110         void setGreen(sal_uInt8 nNew) { maPixelUnion.maRGBO.mnG = nNew; }
setBlue(sal_uInt8 nNew)111         void setBlue(sal_uInt8 nNew) { maPixelUnion.maRGBO.mnB = nNew; }
setOpacity(sal_uInt8 nNew)112         void setOpacity(sal_uInt8 nNew) { maPixelUnion.maRGBO.mnO = nNew; }
setRedGreenBlueOpacity(sal_uInt32 nRedGreenBlueOpacity)113         void setRedGreenBlueOpacity(sal_uInt32 nRedGreenBlueOpacity) { maPixelUnion.maCombinedRGBO.mnValue = nRedGreenBlueOpacity; }
setRedGreenBlue(sal_uInt8 nR,sal_uInt8 nG,sal_uInt8 nB)114         void setRedGreenBlue(sal_uInt8 nR, sal_uInt8 nG, sal_uInt8 nB) { maPixelUnion.maRGBO.mnR = nR; maPixelUnion.maRGBO.mnG = nG; maPixelUnion.maRGBO.mnB = nB; }
115 
116         // comparators
isInvisible() const117         bool isInvisible() const { return (0 == maPixelUnion.maRGBO.mnO); }
isVisible() const118         bool isVisible() const { return (0 != maPixelUnion.maRGBO.mnO); }
isEmpty() const119         bool isEmpty() const { return isInvisible(); }
isUsed() const120         bool isUsed() const { return isVisible(); }
121 
operator ==(const BPixel & rPixel) const122         bool operator==( const BPixel& rPixel ) const
123         {
124             return (rPixel.maPixelUnion.maCombinedRGBO.mnValue == maPixelUnion.maCombinedRGBO.mnValue);
125         }
126 
operator !=(const BPixel & rPixel) const127         bool operator!=( const BPixel& rPixel ) const
128         {
129             return (rPixel.maPixelUnion.maCombinedRGBO.mnValue != maPixelUnion.maCombinedRGBO.mnValue);
130         }
131 
132         // empty element
133         static const BPixel& getEmptyBPixel();
134     };
135 
136     //////////////////////////////////////////////////////////////////////////
137     // external operators
138 
minimum(const BPixel & rTupA,const BPixel & rTupB)139     inline BPixel minimum(const BPixel& rTupA, const BPixel& rTupB)
140     {
141         return BPixel(
142             std::min(rTupB.getRed(), rTupA.getRed()),
143             std::min(rTupB.getGreen(), rTupA.getGreen()),
144             std::min(rTupB.getBlue(), rTupA.getBlue()),
145             std::min(rTupB.getOpacity(), rTupA.getOpacity()));
146     }
147 
maximum(const BPixel & rTupA,const BPixel & rTupB)148     inline BPixel maximum(const BPixel& rTupA, const BPixel& rTupB)
149     {
150         return BPixel(
151             std::max(rTupB.getRed(), rTupA.getRed()),
152             std::max(rTupB.getGreen(), rTupA.getGreen()),
153             std::max(rTupB.getBlue(), rTupA.getBlue()),
154             std::max(rTupB.getOpacity(), rTupA.getOpacity()));
155     }
156 
interpolate(const BPixel & rOld1,const BPixel & rOld2,double t)157     inline BPixel interpolate(const BPixel& rOld1, const BPixel& rOld2, double t)
158     {
159         if(rOld1 == rOld2)
160         {
161             return rOld1;
162         }
163         else if(0.0 >= t)
164         {
165             return rOld1;
166         }
167         else if(1.0 <= t)
168         {
169             return rOld2;
170         }
171         else
172         {
173             const sal_uInt32 nFactor(fround(256.0 * t));
174             const sal_uInt32 nNegFac(256L - nFactor);
175 
176             return BPixel(
177                 (sal_uInt8)(((sal_uInt32)rOld1.getRed() * nNegFac + (sal_uInt32)rOld2.getRed() * nFactor) >> 8L),
178                 (sal_uInt8)(((sal_uInt32)rOld1.getGreen() * nNegFac + (sal_uInt32)rOld2.getGreen() * nFactor) >> 8L),
179                 (sal_uInt8)(((sal_uInt32)rOld1.getBlue() * nNegFac + (sal_uInt32)rOld2.getBlue() * nFactor) >> 8L),
180                 (sal_uInt8)(((sal_uInt32)rOld1.getOpacity() * nNegFac + (sal_uInt32)rOld2.getOpacity() * nFactor) >> 8L));
181         }
182     }
183 
average(const BPixel & rOld1,const BPixel & rOld2)184     inline BPixel average(const BPixel& rOld1, const BPixel& rOld2)
185     {
186         return BPixel(
187             rOld1.getRed() == rOld2.getRed() ? rOld1.getRed() : (sal_uInt8)(((sal_uInt32)rOld1.getRed() + (sal_uInt32)rOld2.getRed()) >> 1L),
188             rOld1.getGreen() == rOld2.getGreen() ? rOld1.getGreen() : (sal_uInt8)(((sal_uInt32)rOld1.getGreen() + (sal_uInt32)rOld2.getGreen()) >> 1L),
189             rOld1.getBlue() == rOld2.getBlue() ? rOld1.getBlue() : (sal_uInt8)(((sal_uInt32)rOld1.getBlue() + (sal_uInt32)rOld2.getBlue()) >> 1L),
190             rOld1.getOpacity() == rOld2.getOpacity() ? rOld1.getOpacity() : (sal_uInt8)(((sal_uInt32)rOld1.getOpacity() + (sal_uInt32)rOld2.getOpacity()) >> 1L));
191     }
192 
average(const BPixel & rOld1,const BPixel & rOld2,const BPixel & rOld3)193     inline BPixel average(const BPixel& rOld1, const BPixel& rOld2, const BPixel& rOld3)
194     {
195         return BPixel(
196             (rOld1.getRed() == rOld2.getRed() && rOld2.getRed() == rOld3.getRed()) ? rOld1.getRed() : (sal_uInt8)(((sal_uInt32)rOld1.getRed() + (sal_uInt32)rOld2.getRed() + (sal_uInt32)rOld3.getRed()) / 3L),
197             (rOld1.getGreen() == rOld2.getGreen() && rOld2.getGreen() == rOld3.getGreen()) ? rOld1.getGreen() : (sal_uInt8)(((sal_uInt32)rOld1.getGreen() + (sal_uInt32)rOld2.getGreen() + (sal_uInt32)rOld3.getGreen()) / 3L),
198             (rOld1.getBlue() == rOld2.getBlue() && rOld2.getBlue() == rOld3.getBlue()) ? rOld1.getBlue() : (sal_uInt8)(((sal_uInt32)rOld1.getBlue() + (sal_uInt32)rOld2.getBlue() + (sal_uInt32)rOld3.getBlue()) / 3L),
199             (rOld1.getOpacity() == rOld2.getOpacity() && rOld2.getOpacity() == rOld3.getOpacity()) ? rOld1.getOpacity() : (sal_uInt8)(((sal_uInt32)rOld1.getOpacity() + (sal_uInt32)rOld2.getOpacity() + (sal_uInt32)rOld3.getOpacity()) / 3L));
200     }
201 } // end of namespace basegfx
202 
203 #endif /* _BGFX_PIXEL_BPIXEL_HXX */
204