b2dcubicbezier.hxx

Go to the documentation of this file.

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   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 .
 */
 
#pragma once
 
#include <basegfx/point/b2dpoint.hxx>
#include <basegfx/range/b2drange.hxx>
#include <basegfx/basegfxdllapi.h>
 
namespace basegfx
{
    class B2DPolygon;
}
 
namespace basegfx
{
    class BASEGFX_DLLPUBLIC B2DCubicBezier
    {
    private:
        B2DPoint                                        maStartPoint;
        B2DPoint                                        maEndPoint;
        B2DPoint                                        maControlPointA;
        B2DPoint                                        maControlPointB;
 
    public:
        B2DCubicBezier();
        B2DCubicBezier(const B2DCubicBezier& rBezier);
        B2DCubicBezier(const B2DPoint& rStart, const B2DPoint& rControlPointA, const B2DPoint& rControlPointB, const B2DPoint& rEnd);
 
        // assignment operator
        B2DCubicBezier& operator=(const B2DCubicBezier& rBezier);
 
        // compare operators
        bool operator==(const B2DCubicBezier& rBezier) const;
        bool operator!=(const B2DCubicBezier& rBezier) const;
        bool equal(const B2DCubicBezier& rBezier) const;
 
        // test if vectors are used
        bool isBezier() const;
 
        // test if contained bezier is trivial and reset vectors accordingly
        void testAndSolveTrivialBezier();
 
        double getLength(double fDeviation = 0.01) const;
 
        // get distance between start and end point
        SAL_DLLPRIVATE double getEdgeLength() const;
 
        // get length of control polygon
        SAL_DLLPRIVATE double getControlPolygonLength() const;
 
        // data interface
        const B2DPoint& getStartPoint() const { return maStartPoint; }
        void setStartPoint(const B2DPoint& rValue) { maStartPoint = rValue; }
 
        const B2DPoint& getEndPoint() const { return maEndPoint; }
        void setEndPoint(const B2DPoint& rValue) { maEndPoint = rValue; }
 
        const B2DPoint& getControlPointA() const { return maControlPointA; }
        void setControlPointA(const B2DPoint& rValue) { maControlPointA = rValue; }
 
        const B2DPoint& getControlPointB() const { return maControlPointB; }
        void setControlPointB(const B2DPoint& rValue) { maControlPointB = rValue; }
 
        B2DVector getTangent(double t) const;
 
        SAL_DLLPRIVATE void adaptiveSubdivideByAngle(B2DPolygon& rTarget, double fAngleBound) const;
 
        SAL_DLLPRIVATE void adaptiveSubdivideByCount(B2DPolygon& rTarget, sal_uInt32 nCount) const;
 
        void adaptiveSubdivideByDistance(B2DPolygon& rTarget, double fDistanceBound, int nRecurseLimit = 30) const;
 
        // get point at given relative position
        B2DPoint interpolatePoint(double t) const;
 
        // calculate the smallest distance from given point to this cubic bezier segment
        // and return the value. The relative position on the segment is returned in rCut.
        SAL_DLLPRIVATE double getSmallestDistancePointToBezierSegment(const B2DPoint& rTestPoint, double& rCut) const;
 
        // do a split at position t and fill both resulting segments
        void split(double t, B2DCubicBezier* pBezierA, B2DCubicBezier* pBezierB) const;
 
        // extract snippet from fStart to fEnd from this bezier
        SAL_DLLPRIVATE B2DCubicBezier snippet(double fStart, double fEnd) const;
 
        // get range including control points
        B2DRange getRange() const;
 
        SAL_DLLPRIVATE bool getMinimumExtremumPosition(double& rfResult) const;
 
        SAL_DLLPRIVATE void getAllExtremumPositions(::std::vector< double >& rResults) const;
 
        void transform(const basegfx::B2DHomMatrix& rMatrix);
 
        SAL_DLLPRIVATE void fround();
    };
} // end of namespace basegfx
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */