xref: /trunk/main/drawinglayer/inc/drawinglayer/primitive3d/hiddengeometryprimitive3d.hxx (revision 914d351e5f5b84e4342a86d6ab8d4aca7308b9bd)
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 #ifndef INCLUDED_DRAWINGLAYER_PRIMITIVE3D_HIDDENGEOMETRYPRIMITIVE3D_HXX
23 #define INCLUDED_DRAWINGLAYER_PRIMITIVE3D_HIDDENGEOMETRYPRIMITIVE3D_HXX
24 
25 #include <drawinglayer/drawinglayerdllapi.h>
26 #include <drawinglayer/primitive3d/groupprimitive3d.hxx>
27 
28 //////////////////////////////////////////////////////////////////////////////
29 
30 namespace drawinglayer
31 {
32     namespace primitive3d
33     {
34         // This primitive is used to represent geometry for non-visible objects,
35         // e.g. a 3D cube without fill attributes. To still be able to use
36         // primitives for HitTest functionality, the 3d decompositions produce
37         // an as much as possible simplified fill geometry encapsulated in this
38         // primitive when there is no fill geometry. Currently, the 3d hit test
39         // uses only areas, so maybe in a further enhanced version this will change
40         // to 'if neither filled nor lines' creation criteria. The whole primitive
41         // decomposes to nothing, so no one not knowing it will be influenced. Only
42         // helper processors for hit test (and maybe BoundRect extractors) will
43         // use it and it's children subcontent.
44         class DRAWINGLAYER_DLLPUBLIC HiddenGeometryPrimitive3D : public GroupPrimitive3D
45         {
46         public:
47             HiddenGeometryPrimitive3D(const Primitive3DSequence& rChildren);
48 
49             // despite returning an empty decomposition since it's no visualisation data,
50             // range calculation is intended to use hidden geometry, so
51             // the local implementation will return the children's range
52             virtual basegfx::B3DRange getB3DRange(const geometry::ViewInformation3D& rViewInformation) const;
53 
54             /// The default implementation returns an empty sequence
55             virtual Primitive3DSequence get3DDecomposition(const geometry::ViewInformation3D& rViewInformation) const;
56 
57             // provide unique ID
58             DeclPrimitrive3DIDBlock()
59         };
60     } // end of namespace primitive3d
61 } // end of namespace drawinglayer
62 
63 //////////////////////////////////////////////////////////////////////////////
64 
65 #endif //INCLUDED_DRAWINGLAYER_PRIMITIVE3D_HIDDENGEOMETRYPRIMITIVE3D_HXX
66 
67 //////////////////////////////////////////////////////////////////////////////
68 // eof
69