xref: /aoo41x/main/drawinglayer/inc/drawinglayer/primitive2d/sceneprimitive2d.hxx (revision 4f506f19)

/**************************************************************
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 *
 *************************************************************/



#ifndef INCLUDED_DRAWINGLAYER_PRIMITIVE2D_SCENEPRIMITIVE2D_HXX
#define INCLUDED_DRAWINGLAYER_PRIMITIVE2D_SCENEPRIMITIVE2D_HXX

#include <drawinglayer/drawinglayerdllapi.h>
#include <drawinglayer/primitive2d/baseprimitive2d.hxx>
#include <drawinglayer/primitive3d/baseprimitive3d.hxx>
#include <drawinglayer/geometry/viewinformation3d.hxx>
#include <basegfx/matrix/b2dhommatrix.hxx>
#include <vcl/bitmapex.hxx>
#include <drawinglayer/attribute/sdrsceneattribute3d.hxx>
#include <drawinglayer/attribute/sdrlightingattribute3d.hxx>
#include <drawinglayer/attribute/sdrlightattribute3d.hxx>

//////////////////////////////////////////////////////////////////////////////

namespace drawinglayer
{
	namespace primitive2d
	{
        /** ScenePrimitive2D class

            This primitive defines a 3D scene as a 2D primitive and is the anchor point
            for a 3D visualisation. The decomposition is view-dependent and will try to
            re-use already rendered 3D content.

            The rendering is done using the default-3D renderer from basegfx which supports
            AntiAliasing.

            The 2D primitive's geometric range is defined completely by the
            ObjectTransformation combined with evtl. 2D shadows from the 3D objects. The
            shadows of 3D objects are 2D polygons, projected with the 3D transformation.

            This is the class a renderer may process directly when he wants to implement
            an own (e.g. system-specific) 3D renderer.
         */
		class DRAWINGLAYER_DLLPUBLIC ScenePrimitive2D : public BufferedDecompositionPrimitive2D
		{
		private:
            /// the 3D geometry definition
			primitive3d::Primitive3DSequence					mxChildren3D;

            /// 3D scene attribute set
			attribute::SdrSceneAttribute						maSdrSceneAttribute;

            /// lighting attribute set
            attribute::SdrLightingAttribute						maSdrLightingAttribute;

            /// object transformation for scene for 2D definition
			basegfx::B2DHomMatrix								maObjectTransformation;

            /// scene transformation set and object transformation
			geometry::ViewInformation3D							maViewInformation3D;

			/// the primitiveSequence for on-demand created shadow primitives (see mbShadow3DChecked)
			Primitive2DSequence									maShadowPrimitives;

			/// bitfield
			/** flag if given 3D geometry is already cheched for shadow definitions and 2d shadows
			    are created in maShadowPrimitives
             */
			unsigned											mbShadow3DChecked : 1;

			/// the last used NewDiscreteSize and NewUnitVisiblePart definitions for decomposition
			double												mfOldDiscreteSizeX;
			double												mfOldDiscreteSizeY;
			basegfx::B2DRange									maOldUnitVisiblePart;

            /** the last created BitmapEx, e.g. for fast HitTest. This does not really need
                memory since BitmapEx is internally RefCounted
             */
            BitmapEx                                            maOldRenderedBitmap;

			/// private helpers
			bool impGetShadow3D(const geometry::ViewInformation2D& rViewInformation) const;
			void calculateDiscreteSizes(
				const geometry::ViewInformation2D& rViewInformation,
				basegfx::B2DRange& rDiscreteRange,
				basegfx::B2DRange& rVisibleDiscreteRange,
				basegfx::B2DRange& rUnitVisibleRange) const;

		protected:
			/// local decomposition.
			virtual Primitive2DSequence create2DDecomposition(const geometry::ViewInformation2D& rViewInformation) const;

		public:
			/// public helpers
			/** Geometry extractor. Shadow will be added as in create2DDecomposition, but
			    the 3D content is not converted to a bitmap visualisation but to projected 2D gemetry. This
			    helper is useful e.g. for Contour extraction or HitTests.
              */
			Primitive2DSequence getGeometry2D() const;
			Primitive2DSequence getShadow2D(const geometry::ViewInformation2D& rViewInformation) const;

            /** Fast HitTest which uses the last buffered BitmapEx from the last
                rendered area if available. The return value describes if the check
                could be done with the current information, so do NOT use o_rResult
                when it returns false. o_rResult will be changed on return true and
                then contains a definitive answer if content of this scene is hit or
                not. On return false, it is normally necessary to use the geometric
                HitTest (see CutFindProcessor usages). The given HitPoint
                has to be in logic coordinates in scene's ObjectCoordinateSystem.
             */
            bool tryToCheckLastVisualisationDirectHit(const basegfx::B2DPoint& rLogicHitPoint, bool& o_rResult) const;

			/// constructor
			ScenePrimitive2D(
				const primitive3d::Primitive3DSequence& rxChildren3D,
				const attribute::SdrSceneAttribute& rSdrSceneAttribute,
				const attribute::SdrLightingAttribute& rSdrLightingAttribute,
				const basegfx::B2DHomMatrix& rObjectTransformation,
				const geometry::ViewInformation3D& rViewInformation3D);

			/// data read access
			const primitive3d::Primitive3DSequence& getChildren3D() const { return mxChildren3D; }
			const attribute::SdrSceneAttribute& getSdrSceneAttribute() const { return maSdrSceneAttribute; }
			const attribute::SdrLightingAttribute& getSdrLightingAttribute() const { return maSdrLightingAttribute; }
			const basegfx::B2DHomMatrix& getObjectTransformation() const { return maObjectTransformation; }
			const geometry::ViewInformation3D& getViewInformation3D() const { return maViewInformation3D; }

			/// compare operator
			virtual bool operator==(const BasePrimitive2D& rPrimitive) const;

			/// get range
			virtual basegfx::B2DRange getB2DRange(const geometry::ViewInformation2D& rViewInformation) const;

			/// provide unique ID
			DeclPrimitrive2DIDBlock()

			/// get local decomposition. Overloaded since this decomposition is view-dependent
			virtual Primitive2DSequence get2DDecomposition(const geometry::ViewInformation2D& rViewInformation) const;
		};
	} // end of namespace primitive2d
} // end of namespace drawinglayer

//////////////////////////////////////////////////////////////////////////////

#endif //INCLUDED_DRAWINGLAYER_PRIMITIVE2D_SCENEPRIMITIVE2D_HXX

//////////////////////////////////////////////////////////////////////////////
// eof