1 files changed, 28 insertions, 7 deletions
diff --git a/drawinglayer/inc/drawinglayer/primitive2d/graphicprimitive2d.hxx b/drawinglayer/inc/drawinglayer/primitive2d/graphicprimitive2d.hxx
index ec18e98106..aa1c12d66f 100644
--- a/drawinglayer/inc/drawinglayer/primitive2d/graphicprimitive2d.hxx
+++ b/drawinglayer/inc/drawinglayer/primitive2d/graphicprimitive2d.hxx
@@ -46,18 +46,39 @@ namespace drawinglayer
 {
     namespace primitive2d
     {
-        class GraphicPrimitive2D : public BasePrimitive2D
+        /** GraphicPrimitive2D class
+
+            Primitive to hold graphics defined by GraphicObject and GraphicAttr
+            combination. This includes MetaFiles and diverse pixel-oriented graphic 
+            formats. It even includes animated GIFs, Croppings and other changes
+            defined in GraphicAttr.
+
+            This makes the decomposition contain a wide variety of possibilites,
+            too. From a simple BitmapPrimitive over AnimatedSwitchPrimitive2D,
+            MetafilePrimitive2D (with and without embedding in a masking when e.g.
+            the Metafile is bigger than the geometry) and embeddings in
+            TransformPrimitive2D and MaskPrimitive2D for croppings.
+
+            The primitive geometry area is defined by Transform.
+         */
+        class GraphicPrimitive2D : public BufferedDecompositionPrimitive2D
         {
         private:
+            /// the geometric definition
             basegfx::B2DHomMatrix						maTransform;
+
+            /// the GraphicObject with all it's content possibilities
             GraphicObject								maGraphicObject;
+
+            /// The GraphicAttr with all it's modification possibilities
             GraphicAttr									maGraphicAttr;
 
         protected:
-            // local decomposition
-            virtual Primitive2DSequence createLocalDecomposition(const geometry::ViewInformation2D& rViewInformation) const;
+            /// local decomposition
+            virtual Primitive2DSequence create2DDecomposition(const geometry::ViewInformation2D& rViewInformation) const;
 
         public:
+            /// constructor(s)
             GraphicPrimitive2D(
                 const basegfx::B2DHomMatrix& rTransform, 
                 const GraphicObject& rGraphicObject,
@@ -66,19 +87,19 @@ namespace drawinglayer
                 const basegfx::B2DHomMatrix& rTransform, 
                 const GraphicObject& rGraphicObject);
 
-            // get data
+            /// data read access
             const basegfx::B2DHomMatrix& getTransform() const { return maTransform; }
             const GraphicObject& getGraphicObject() const { return maGraphicObject; }
             const GraphicAttr& getGraphicAttr() const { return maGraphicAttr; }
             bool isTransparent() const;
 
-            // compare operator
+            /// compare operator
             virtual bool operator==(const BasePrimitive2D& rPrimitive) const;
 
-            // get range
+            /// get range
             virtual basegfx::B2DRange getB2DRange(const geometry::ViewInformation2D& rViewInformation) const;
 
-            // provide unique ID
+            /// provide unique ID
             DeclPrimitrive2DIDBlock()
         };
     } // end of namespace primitive2d