Added two simple tooling Primitives for easy/common cases

Added three simple tooling Primitives:

(1) SingleLinePrimitive2D:
Just a Line from Point A to B with a BColor, decomposes
to a PolygonHairlinePrimitive2D (and to a PointArrayPrimitive2D
if only a single point aka A == B)

(2) LineRectanglePrimitive2D:
(3) FilledRectanglePrimitive2D:
Rectangles that support fill or line, gets decomposed
to maybe PolyPolygonColorPrimitive2D (if filled) and a
PolygonHairlinePrimitive2D (if line) or nothing if the
B2DRange is empty

NOTE: If using these despite being hor/ver aligned due to
their nature as B2DRange(s) (aka 'non rotated/sheared')
these may have to be transformed if the current
transformation context you are working in is rotated
or sheared, so *ensure* to handle these correctly if
you do handle them yourself. This is not needed with
the Polygon-based ones - that's why these are - and
stay - the common case(s).

Both are hairline primitives themselves, so are potentially
*view-dependent* (see comment in *.cxx and *.hxx). They will be
useful as very simple primitives for small renderers, e.g. to
avoid conversion from rectangles or just lines to polygons.

The more general Primitives are always the polygon-based ones,
so these new ones get decomposed to these (decomposition direction,
complex -> simpler). This assures that a processor/renderer has
minimally to support the polygon-based ones, but *can* use these
simple tooling ones directly if he wants to.

This will come in handy for future System-Dependent PrimitiveRenderers,
which I am currently working on one to offer as example - this leads
to identifying helpful upstream things that will come in handy in that
regard - like these ones.

Change-Id: Ie5039e6cfad6c9914c165cae6f8b59abecc38302
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/144543
Tested-by: Jenkins
Reviewed-by: Armin Le Grand <Armin.Le.Grand@me.com>

2 files changed, 185 insertions, 12 deletions

diff --git a/drawinglayer/source/primitive2d/PolyPolygonColorPrimitive2D.cxx b/drawinglayer/source/primitive2d/PolyPolygonColorPrimitive2D.cxx
index ff5578104374..6c7cf4bb365a 100644
--- a/drawinglayer/source/primitive2d/PolyPolygonColorPrimitive2D.cxx
+++ b/drawinglayer/source/primitive2d/PolyPolygonColorPrimitive2D.cxx
@@ -20,6 +20,7 @@
 #include <drawinglayer/primitive2d/PolyPolygonColorPrimitive2D.hxx>
 
 #include <basegfx/polygon/b2dpolypolygontools.hxx>
+#include <basegfx/polygon/b2dpolygontools.hxx>
 #include <drawinglayer/primitive2d/drawinglayer_primitivetypes2d.hxx>
 #include <utility>
 
@@ -61,6 +62,54 @@ sal_uInt32 PolyPolygonColorPrimitive2D::getPrimitive2DID() const
     return PRIMITIVE2D_ID_POLYPOLYGONCOLORPRIMITIVE2D;
 }
 
+FilledRectanglePrimitive2D::FilledRectanglePrimitive2D(const basegfx::B2DRange& rB2DRange,
+                                                       const basegfx::BColor& rBColor)
+    : BasePrimitive2D()
+    , maB2DRange(rB2DRange)
+    , maBColor(rBColor)
+{
+}
+
+bool FilledRectanglePrimitive2D::operator==(const BasePrimitive2D& rPrimitive) const
+{
+    if (BasePrimitive2D::operator==(rPrimitive))
+    {
+        const FilledRectanglePrimitive2D& rCompare(
+            static_cast<const FilledRectanglePrimitive2D&>(rPrimitive));
+
+        return (getB2DRange() == rCompare.getB2DRange() && getBColor() == rCompare.getBColor());
+    }
+
+    return false;
+}
+
+basegfx::B2DRange FilledRectanglePrimitive2D::getB2DRange(
+    const geometry::ViewInformation2D& /*rViewInformation*/) const
+{
+    return getB2DRange();
+}
+
+sal_uInt32 FilledRectanglePrimitive2D::getPrimitive2DID() const
+{
+    return PRIMITIVE2D_ID_FILLEDRECTANGLEPRIMITIVE2D;
+}
+
+void FilledRectanglePrimitive2D::get2DDecomposition(
+    Primitive2DDecompositionVisitor& rVisitor,
+    const geometry::ViewInformation2D& /*rViewInformation*/) const
+{
+    if (getB2DRange().isEmpty())
+    {
+        // no geometry, done
+        return;
+    }
+
+    const basegfx::B2DPolygon aPolygon(basegfx::utils::createPolygonFromRect(getB2DRange()));
+    Primitive2DContainer aSequence
+        = { new PolyPolygonColorPrimitive2D(basegfx::B2DPolyPolygon(aPolygon), getBColor()) };
+    rVisitor.visit(aSequence);
+}
+
 } // end drawinglayer::primitive2d namespace
 
 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/drawinglayer/source/primitive2d/polygonprimitive2d.cxx b/drawinglayer/source/primitive2d/polygonprimitive2d.cxx
index 2fdb535f61d9..fb6a8ed369d2 100644
--- a/drawinglayer/source/primitive2d/polygonprimitive2d.cxx
+++ b/drawinglayer/source/primitive2d/polygonprimitive2d.cxx
@@ -24,6 +24,7 @@
 #include <drawinglayer/primitive2d/PolygonMarkerPrimitive2D.hxx>
 #include <drawinglayer/primitive2d/PolygonStrokeArrowPrimitive2D.hxx>
 #include <drawinglayer/primitive2d/PolygonWavePrimitive2D.hxx>
+#include <drawinglayer/primitive2d/pointarrayprimitive2d.hxx>
 #include <drawinglayer/primitive2d/drawinglayer_primitivetypes2d.hxx>
 #include <drawinglayer/geometry/viewinformation2d.hxx>
 #include <basegfx/polygon/b2dlinegeometry.hxx>
@@ -32,6 +33,26 @@
 
 using namespace com::sun::star;
 
+namespace
+{
+void implGrowHairline(basegfx::B2DRange& rRange,
+                      const drawinglayer::geometry::ViewInformation2D& rViewInformation)
+{
+    if (!rRange.isEmpty())
+    {
+        // Calculate view-dependent hairline width
+        const basegfx::B2DVector aDiscreteSize(
+            rViewInformation.getInverseObjectToViewTransformation() * basegfx::B2DVector(1.0, 0.0));
+        const double fDiscreteHalfLineWidth(aDiscreteSize.getLength() * 0.5);
+
+        if (basegfx::fTools::more(fDiscreteHalfLineWidth, 0.0))
+        {
+            rRange.grow(fDiscreteHalfLineWidth);
+        }
+    }
+}
+}
+
 namespace drawinglayer::primitive2d
 {
 PolygonHairlinePrimitive2D::PolygonHairlinePrimitive2D(basegfx::B2DPolygon aPolygon,
@@ -61,18 +82,8 @@ PolygonHairlinePrimitive2D::getB2DRange(const geometry::ViewInformation2D& rView
     // as base size
     basegfx::B2DRange aRetval(getB2DPolygon().getB2DRange());
 
-    if (!aRetval.isEmpty())
-    {
-        // Calculate view-dependent hairline width
-        const basegfx::B2DVector aDiscreteSize(
-            rViewInformation.getInverseObjectToViewTransformation() * basegfx::B2DVector(1.0, 0.0));
-        const double fDiscreteHalfLineWidth(aDiscreteSize.getLength() * 0.5);
-
-        if (basegfx::fTools::more(fDiscreteHalfLineWidth, 0.0))
-        {
-            aRetval.grow(fDiscreteHalfLineWidth);
-        }
-    }
+    // Calculate and grow by view-dependent hairline width
+    implGrowHairline(aRetval, rViewInformation);
 
     // return range
     return aRetval;
@@ -84,6 +95,119 @@ sal_uInt32 PolygonHairlinePrimitive2D::getPrimitive2DID() const
     return PRIMITIVE2D_ID_POLYGONHAIRLINEPRIMITIVE2D;
 }
 
+SingleLinePrimitive2D::SingleLinePrimitive2D(const basegfx::B2DPoint& rStart,
+                                             const basegfx::B2DPoint& rEnd,
+                                             const basegfx::BColor& rBColor)
+    : BasePrimitive2D()
+    , maStart(rStart)
+    , maEnd(rEnd)
+    , maBColor(rBColor)
+{
+}
+
+bool SingleLinePrimitive2D::operator==(const BasePrimitive2D& rPrimitive) const
+{
+    if (BasePrimitive2D::operator==(rPrimitive))
+    {
+        const SingleLinePrimitive2D& rCompare(
+            static_cast<const SingleLinePrimitive2D&>(rPrimitive));
+
+        return (getStart() == rCompare.getStart() && getEnd() == rCompare.getEnd()
+                && getBColor() == rCompare.getBColor());
+    }
+
+    return false;
+}
+
+basegfx::B2DRange
+SingleLinePrimitive2D::getB2DRange(const geometry::ViewInformation2D& rViewInformation) const
+{
+    basegfx::B2DRange aRetval(getStart(), getEnd());
+
+    // Calculate and grow by view-dependent hairline width
+    implGrowHairline(aRetval, rViewInformation);
+
+    return aRetval;
+}
+
+sal_uInt32 SingleLinePrimitive2D::getPrimitive2DID() const
+{
+    return PRIMITIVE2D_ID_SINGLELINEPRIMITIVE2D;
+}
+
+void SingleLinePrimitive2D::get2DDecomposition(
+    Primitive2DDecompositionVisitor& rVisitor,
+    const geometry::ViewInformation2D& /*rViewInformation*/) const
+{
+    if (getStart() == getEnd())
+    {
+        // single point
+        std::vector<basegfx::B2DPoint> aPoints = { getStart() };
+        Primitive2DContainer aSequence
+            = { new PointArrayPrimitive2D(std::move(aPoints), getBColor()) };
+        rVisitor.visit(aSequence);
+    }
+    else
+    {
+        // line
+        basegfx::B2DPolygon aPolygon{ getStart(), getEnd() };
+        Primitive2DContainer aSequence = { new PolygonHairlinePrimitive2D(aPolygon, getBColor()) };
+        rVisitor.visit(aSequence);
+    }
+}
+
+LineRectanglePrimitive2D::LineRectanglePrimitive2D(const basegfx::B2DRange& rB2DRange,
+                                                   const basegfx::BColor& rBColor)
+    : BasePrimitive2D()
+    , maB2DRange(rB2DRange)
+    , maBColor(rBColor)
+{
+}
+
+bool LineRectanglePrimitive2D::operator==(const BasePrimitive2D& rPrimitive) const
+{
+    if (BasePrimitive2D::operator==(rPrimitive))
+    {
+        const LineRectanglePrimitive2D& rCompare(
+            static_cast<const LineRectanglePrimitive2D&>(rPrimitive));
+
+        return (getB2DRange() == rCompare.getB2DRange() && getBColor() == rCompare.getBColor());
+    }
+
+    return false;
+}
+
+basegfx::B2DRange
+LineRectanglePrimitive2D::getB2DRange(const geometry::ViewInformation2D& rViewInformation) const
+{
+    basegfx::B2DRange aRetval(getB2DRange());
+
+    // Calculate and grow by view-dependent hairline width
+    implGrowHairline(aRetval, rViewInformation);
+
+    return aRetval;
+}
+
+sal_uInt32 LineRectanglePrimitive2D::getPrimitive2DID() const
+{
+    return PRIMITIVE2D_ID_LINERECTANGLEPRIMITIVE2D;
+}
+
+void LineRectanglePrimitive2D::get2DDecomposition(
+    Primitive2DDecompositionVisitor& rVisitor,
+    const geometry::ViewInformation2D& /*rViewInformation*/) const
+{
+    if (getB2DRange().isEmpty())
+    {
+        // no geometry, done
+        return;
+    }
+
+    const basegfx::B2DPolygon aPolygon(basegfx::utils::createPolygonFromRect(getB2DRange()));
+    Primitive2DContainer aSequence = { new PolygonHairlinePrimitive2D(aPolygon, getBColor()) };
+    rVisitor.visit(aSequence);
+}
+
 void PolygonMarkerPrimitive2D::create2DDecomposition(
     Primitive2DContainer& rContainer, const geometry::ViewInformation2D& rViewInformation) const
 {