1*b1cdbd2cSJim Jagielski /**************************************************************
2*b1cdbd2cSJim Jagielski  *
3*b1cdbd2cSJim Jagielski  * Licensed to the Apache Software Foundation (ASF) under one
4*b1cdbd2cSJim Jagielski  * or more contributor license agreements.  See the NOTICE file
5*b1cdbd2cSJim Jagielski  * distributed with this work for additional information
6*b1cdbd2cSJim Jagielski  * regarding copyright ownership.  The ASF licenses this file
7*b1cdbd2cSJim Jagielski  * to you under the Apache License, Version 2.0 (the
8*b1cdbd2cSJim Jagielski  * "License"); you may not use this file except in compliance
9*b1cdbd2cSJim Jagielski  * with the License.  You may obtain a copy of the License at
10*b1cdbd2cSJim Jagielski  *
11*b1cdbd2cSJim Jagielski  *   http://www.apache.org/licenses/LICENSE-2.0
12*b1cdbd2cSJim Jagielski  *
13*b1cdbd2cSJim Jagielski  * Unless required by applicable law or agreed to in writing,
14*b1cdbd2cSJim Jagielski  * software distributed under the License is distributed on an
15*b1cdbd2cSJim Jagielski  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16*b1cdbd2cSJim Jagielski  * KIND, either express or implied.  See the License for the
17*b1cdbd2cSJim Jagielski  * specific language governing permissions and limitations
18*b1cdbd2cSJim Jagielski  * under the License.
19*b1cdbd2cSJim Jagielski  *
20*b1cdbd2cSJim Jagielski  *************************************************************/
21*b1cdbd2cSJim Jagielski 
22*b1cdbd2cSJim Jagielski #ifndef INCLUDED_DRAWINGLAYER_PRIMITIVE2D_TRANSPARENCEPRIMITIVE2D_HXX
23*b1cdbd2cSJim Jagielski #define INCLUDED_DRAWINGLAYER_PRIMITIVE2D_TRANSPARENCEPRIMITIVE2D_HXX
24*b1cdbd2cSJim Jagielski 
25*b1cdbd2cSJim Jagielski #include <drawinglayer/drawinglayerdllapi.h>
26*b1cdbd2cSJim Jagielski #include <drawinglayer/primitive2d/groupprimitive2d.hxx>
27*b1cdbd2cSJim Jagielski 
28*b1cdbd2cSJim Jagielski //////////////////////////////////////////////////////////////////////////////
29*b1cdbd2cSJim Jagielski 
30*b1cdbd2cSJim Jagielski namespace drawinglayer
31*b1cdbd2cSJim Jagielski {
32*b1cdbd2cSJim Jagielski 	namespace primitive2d
33*b1cdbd2cSJim Jagielski 	{
34*b1cdbd2cSJim Jagielski         /** TransparencePrimitive2D class
35*b1cdbd2cSJim Jagielski 
36*b1cdbd2cSJim Jagielski             This is the basic primitive for applying freely defined transparence
37*b1cdbd2cSJim Jagielski             to freely defined content. The basic idea is to associate a content
38*b1cdbd2cSJim Jagielski             which is defined as a sequence of primitives and hold as child content
39*b1cdbd2cSJim Jagielski             in the GroupPrimitive2D with a transparence channel also defined as a sequence
40*b1cdbd2cSJim Jagielski             of primitives and hold in the transparence member.
41*b1cdbd2cSJim Jagielski 
42*b1cdbd2cSJim Jagielski             The basic definition is to use the transparence content as transparence-Mask by
43*b1cdbd2cSJim Jagielski             interpreting the transparence-content not as RGB, but as Luminance transparence mask
44*b1cdbd2cSJim Jagielski             using the common RGB_to_luminance definition as e.g. used by VCL.
45*b1cdbd2cSJim Jagielski 
46*b1cdbd2cSJim Jagielski             The defining geometry is the Range of the child primitive sequence,
47*b1cdbd2cSJim Jagielski             this means the renderers will/shall use this geometric information for
48*b1cdbd2cSJim Jagielski             rendering, not the transparent one. The transparent one should/will be clipped
49*b1cdbd2cSJim Jagielski             accordingly.
50*b1cdbd2cSJim Jagielski          */
51*b1cdbd2cSJim Jagielski 		class DRAWINGLAYER_DLLPUBLIC TransparencePrimitive2D : public GroupPrimitive2D
52*b1cdbd2cSJim Jagielski 		{
53*b1cdbd2cSJim Jagielski 		private:
54*b1cdbd2cSJim Jagielski             /// The transparence-Mask who's RGB-Values are interpreted as Luminance
55*b1cdbd2cSJim Jagielski 			Primitive2DSequence						maTransparence;
56*b1cdbd2cSJim Jagielski 
57*b1cdbd2cSJim Jagielski 		public:
58*b1cdbd2cSJim Jagielski             /** constructor
59*b1cdbd2cSJim Jagielski 
60*b1cdbd2cSJim Jagielski                 @param rChildren
61*b1cdbd2cSJim Jagielski                 The content which is defined to have a transparency. The
62*b1cdbd2cSJim Jagielski                 range of this primitive is defined by this content
63*b1cdbd2cSJim Jagielski 
64*b1cdbd2cSJim Jagielski                 @param rTransparence
65*b1cdbd2cSJim Jagielski                 The definition of the Transparence-channel for this primitive. It
66*b1cdbd2cSJim Jagielski                 will be interpreted as mask by interpreting as gray values
67*b1cdbd2cSJim Jagielski                 using the common RGB_to_luminance definitions
68*b1cdbd2cSJim Jagielski              */
69*b1cdbd2cSJim Jagielski 			TransparencePrimitive2D(
70*b1cdbd2cSJim Jagielski 				const Primitive2DSequence& rChildren,
71*b1cdbd2cSJim Jagielski 				const Primitive2DSequence& rTransparence);
72*b1cdbd2cSJim Jagielski 
73*b1cdbd2cSJim Jagielski 			/// data read access
getTransparence() const74*b1cdbd2cSJim Jagielski 			const Primitive2DSequence& getTransparence() const { return maTransparence; }
75*b1cdbd2cSJim Jagielski 
76*b1cdbd2cSJim Jagielski 			/// compare operator
77*b1cdbd2cSJim Jagielski 			virtual bool operator==(const BasePrimitive2D& rPrimitive) const;
78*b1cdbd2cSJim Jagielski 
79*b1cdbd2cSJim Jagielski 			/// provide unique ID
80*b1cdbd2cSJim Jagielski 			DeclPrimitrive2DIDBlock()
81*b1cdbd2cSJim Jagielski 		};
82*b1cdbd2cSJim Jagielski 	} // end of namespace primitive2d
83*b1cdbd2cSJim Jagielski } // end of namespace drawinglayer
84*b1cdbd2cSJim Jagielski 
85*b1cdbd2cSJim Jagielski //////////////////////////////////////////////////////////////////////////////
86*b1cdbd2cSJim Jagielski 
87*b1cdbd2cSJim Jagielski #endif //INCLUDED_DRAWINGLAYER_PRIMITIVE2D_TRANSPARENCEPRIMITIVE2D_HXX
88*b1cdbd2cSJim Jagielski 
89*b1cdbd2cSJim Jagielski //////////////////////////////////////////////////////////////////////////////
90*b1cdbd2cSJim Jagielski // eof
91