KoShapeMeshGradientHandles Class Reference

#include <KoShapeMeshGradientHandles.h>

Classes
struct	Handle

Public Member Functions
QPointF	getAttachedCorner (const Handle &bezierHandle) const
	get the attached corner node of the bezierHandle
QVector< QPainterPath >	getConnectedPath (const Handle &handle) const
Handle	getHandle (SvgMeshPosition position) const
	convenience method to get a handle by its position in the mesharray
QVector< Handle >	handles () const
	get all nodes in the mesh, don't use this for drawing the path but use path()
	KoShapeMeshGradientHandles (KoFlake::FillVariant fillVariant, KoShape *shape)
KUndo2Command *	moveGradientHandle (const Handle &handle, const QPointF &newPos)
QPainterPath	path () const

Private Member Functions
QTransform	absoluteTransformation (KoFlake::CoordinateSystem system) const
QVector< Handle >	getBezierHandles (const SvgMeshArray *mesharray, SvgMeshPatch::Type type, int row, int col) const
QVector< Handle >	getHandles (const SvgMeshArray *mesharray, SvgMeshPatch::Type type, int row, int col) const
	get handles including the corner
const SvgMeshGradient *	gradient () const

Private Attributes
KoFlake::FillVariant	m_fillVariant {KoFlake::Fill}
KoShape *	m_shape {0}

Detailed Description

Definition at line 18 of file KoShapeMeshGradientHandles.h.

Constructor & Destructor Documentation

KoShapeMeshGradientHandles()

KoShapeMeshGradientHandles::KoShapeMeshGradientHandles	(	KoFlake::FillVariant	fillVariant,
		KoShape *	shape )

Definition at line 14 of file KoShapeMeshGradientHandles.cpp.

    : m_fillVariant(fillVariant)
    , m_shape(shape)
{
}

Member Function Documentation

absoluteTransformation()

QTransform KoShapeMeshGradientHandles::absoluteTransformation ( KoFlake::CoordinateSystem system ) const

private

Definition at line 205 of file KoShapeMeshGradientHandles.cpp.

{
    QTransform t;
    if (system == KoFlake::UserSpaceOnUse) {
        t = m_shape->absoluteTransformation();
    } else {
        const QTransform gradientToUser = KisAlgebra2D::mapToRect(m_shape->outlineRect());
        t = gradientToUser * m_shape->absoluteTransformation();
    }
    return t;
}

References KoShape::absoluteTransformation(), m_shape, KisAlgebra2D::mapToRect(), KoShape::outlineRect(), and KoFlake::UserSpaceOnUse.

getAttachedCorner()

QPointF KoShapeMeshGradientHandles::getAttachedCorner

(

const Handle &

bezierHandle

)

const

get the attached corner node of the bezierHandle

Definition at line 156 of file KoShapeMeshGradientHandles.cpp.

{
    KIS_ASSERT(bezierHandle.type == Handle::BezierHandle);
 
    const SvgMeshArray *mesharray = gradient()->getMeshArray().data();
    const SvgMeshPath path = mesharray->getPath(bezierHandle.getPosition());
    const QTransform t = (gradient()->gradientUnits() == KoFlake::ObjectBoundingBox)
                           ? KisAlgebra2D::mapToRect(m_shape->outlineRect())
                           : QTransform();
    if (bezierHandle.index == Handle::First) {
        return t.map(path[bezierHandle.index - 1]);
    } else {
        return t.map(path[bezierHandle.index + 1]);
    }
}

References KoShapeMeshGradientHandles::Handle::BezierHandle, KoShapeMeshGradientHandles::Handle::First, SvgMeshGradient::getMeshArray(), SvgMeshArray::getPath(), KoShapeMeshGradientHandles::Handle::getPosition(), gradient(), SvgMeshGradient::gradientUnits(), KoShapeMeshGradientHandles::Handle::index, KIS_ASSERT, m_shape, KisAlgebra2D::mapToRect(), KoFlake::ObjectBoundingBox, KoShape::outlineRect(), and KoShapeMeshGradientHandles::Handle::type.

getBezierHandles()

QVector< KoShapeMeshGradientHandles::Handle > KoShapeMeshGradientHandles::getBezierHandles ( const SvgMeshArray * mesharray, SvgMeshPatch::Type type, int row, int col ) const

private

Definition at line 192 of file KoShapeMeshGradientHandles.cpp.

{
    QVector<Handle> buffer;
    std::array<QPointF, 4> path = mesharray->getPath(type, row, col);
    buffer << Handle(Handle::BezierHandle, path[1], row, col, type, Handle::First);
    buffer << Handle(Handle::BezierHandle, path[2], row, col, type, Handle::Second);
 
    return buffer;
}

References KoShapeMeshGradientHandles::Handle::BezierHandle, KoShapeMeshGradientHandles::Handle::First, SvgMeshArray::getPath(), and KoShapeMeshGradientHandles::Handle::Second.

getConnectedPath()

QVector< QPainterPath > KoShapeMeshGradientHandles::getConnectedPath

(

const Handle &

handle

)

const

Definition at line 122 of file KoShapeMeshGradientHandles.cpp.

{
    KIS_ASSERT(handle.type != Handle::None);
 
    QVector<QPainterPath> result;
 
    // TODO(sh_zam): Handle OBB and user mode in and only in SvgMeshPatch
    const QTransform t = (gradient()->gradientUnits() == KoFlake::ObjectBoundingBox)
                           ? KisAlgebra2D::mapToRect(m_shape->outlineRect())
                           : QTransform();
    const SvgMeshArray *mesharray = gradient()->getMeshArray().data();
    QPainterPath painterPath;
 
    if (handle.type == Handle::BezierHandle) {
        SvgMeshPath path = mesharray->getPath(handle.getPosition());
        std::transform(path.begin(), path.end(), path.begin(), [&t](QPointF &point) { return t.map(point); });
        painterPath.moveTo(path[0]);
        painterPath.cubicTo(path[1], path[2], path[3]);
        result << painterPath;
    } else {
        QVector<SvgMeshPosition> positions = mesharray->getConnectedPaths(handle.getPosition());
        for (const auto &position: positions) {
            SvgMeshPath path = mesharray->getPath(position);
            std::transform(path.begin(), path.end(), path.begin(), [&t](QPointF &point) { return t.map(point); });
            painterPath = QPainterPath();
            painterPath.moveTo(path[0]);
            painterPath.cubicTo(path[1], path[2], path[3]);
            result << painterPath;
        }
    }
 
    return result;
}

References KoShapeMeshGradientHandles::Handle::BezierHandle, SvgMeshArray::getConnectedPaths(), SvgMeshGradient::getMeshArray(), SvgMeshArray::getPath(), KoShapeMeshGradientHandles::Handle::getPosition(), gradient(), SvgMeshGradient::gradientUnits(), KIS_ASSERT, m_shape, KisAlgebra2D::mapToRect(), KoShapeMeshGradientHandles::Handle::None, KoFlake::ObjectBoundingBox, KoShape::outlineRect(), and KoShapeMeshGradientHandles::Handle::type.

getHandle()

KoShapeMeshGradientHandles::Handle KoShapeMeshGradientHandles::getHandle

(

SvgMeshPosition

position

)

const

convenience method to get a handle by its position in the mesharray

Definition at line 63 of file KoShapeMeshGradientHandles.cpp.

{
    const SvgMeshGradient *g = gradient();
    if (!g) return Handle();
 
    Handle handle = getHandles(g->getMeshArray().data(), position.segmentType, position.row, position.col)[0];
 
    QTransform t = absoluteTransformation(g->gradientUnits());
    handle.pos = t.map(handle.pos);
 
    return handle;
}

References absoluteTransformation(), SvgMeshPosition::col, getHandles(), SvgMeshGradient::getMeshArray(), gradient(), SvgMeshGradient::gradientUnits(), KoShapeMeshGradientHandles::Handle::pos, SvgMeshPosition::row, and SvgMeshPosition::segmentType.

getHandles()

QVector< KoShapeMeshGradientHandles::Handle > KoShapeMeshGradientHandles::getHandles ( const SvgMeshArray * mesharray, SvgMeshPatch::Type type, int row, int col ) const

private

get handles including the corner

Definition at line 178 of file KoShapeMeshGradientHandles.cpp.

{
    QVector<Handle> buffer;
    std::array<QPointF, 4> path = mesharray->getPath(type, row, col);
    buffer << Handle(Handle::Corner, path[0], row, col, type);
    buffer << Handle(Handle::BezierHandle, path[1], row, col, type, Handle::First);
    buffer << Handle(Handle::BezierHandle, path[2], row, col, type, Handle::Second);
 
    return buffer;
}

References KoShapeMeshGradientHandles::Handle::BezierHandle, KoShapeMeshGradientHandles::Handle::Corner, KoShapeMeshGradientHandles::Handle::First, SvgMeshArray::getPath(), and KoShapeMeshGradientHandles::Handle::Second.

gradient()

const SvgMeshGradient * KoShapeMeshGradientHandles::gradient ( ) const

private

Definition at line 172 of file KoShapeMeshGradientHandles.cpp.

{
    KoShapeFillWrapper wrapper(m_shape, m_fillVariant);
    return wrapper.meshgradient();
}

References m_fillVariant, m_shape, and KoShapeFillWrapper::meshgradient().

handles()

QVector< KoShapeMeshGradientHandles::Handle > KoShapeMeshGradientHandles::handles

(

)

const

get all nodes in the mesh, don't use this for drawing the path but use path()

Definition at line 21 of file KoShapeMeshGradientHandles.cpp.

{
    QVector<Handle> result;
 
    const SvgMeshGradient *g = gradient();
    if (!g) return result;
 
    SvgMeshArray const *mesharray = g->getMeshArray().data();
 
    for (int irow = 0; irow < mesharray->numRows(); ++irow) {
        for (int icol = 0; icol < mesharray->numColumns(); ++icol) {
            // add corners as well
            result << getHandles(mesharray, SvgMeshPatch::Top, irow, icol);
 
            result << getBezierHandles(mesharray, SvgMeshPatch::Left, irow, icol);
 
            if (irow == mesharray->numRows() - 1) {
                result << getHandles(mesharray, SvgMeshPatch::Left, irow, icol);
 
                if (icol == mesharray->numColumns() - 1) {
                    result << getHandles(mesharray, SvgMeshPatch::Bottom, irow, icol);
                } else {
                    result << getBezierHandles(mesharray, SvgMeshPatch::Bottom, irow, icol);
                }
            }
 
            if (icol == mesharray->numColumns() - 1) {
                result << getHandles(mesharray, SvgMeshPatch::Right, irow, icol);
            }
        }
    }
 
    // we get pointer events in points (pts, not logical), so we transform these now
    // and then invert them while drawing handles (see SelectionDecorator).
    QTransform t = absoluteTransformation(g->gradientUnits());
    for (auto &handle: result) {
        handle.pos = t.map(handle.pos);
    }
 
    return result;
}

References absoluteTransformation(), SvgMeshPatch::Bottom, getBezierHandles(), getHandles(), SvgMeshGradient::getMeshArray(), gradient(), SvgMeshGradient::gradientUnits(), SvgMeshPatch::Left, SvgMeshArray::numColumns(), SvgMeshArray::numRows(), SvgMeshPatch::Right, and SvgMeshPatch::Top.

moveGradientHandle()

KUndo2Command * KoShapeMeshGradientHandles::moveGradientHandle	(	const Handle &	handle,
		const QPointF &	newPos )

Definition at line 76 of file KoShapeMeshGradientHandles.cpp.

{
    KoShapeFillWrapper wrapper(m_shape, m_fillVariant);
    QScopedPointer<SvgMeshGradient> newGradient(new SvgMeshGradient(*wrapper.meshgradient()));
    SvgMeshArray *mesharray = newGradient->getMeshArray().data();
    SvgMeshPatch *patch = newGradient->getMeshArray()->getPatch(handle.row, handle.col);
    std::array<QPointF, 4> path = patch->getSegment(handle.segmentType);
 
    QTransform t = absoluteTransformation(newGradient->gradientUnits()).inverted();
 
    if (handle.type == Handle::BezierHandle) {
        path[handle.index] = t.map(newPos);
        mesharray->modifyHandle(SvgMeshPosition {handle.row, handle.col, handle.segmentType}, path);
 
    } else if (handle.type == Handle::Corner) {
        mesharray->modifyCorner(SvgMeshPosition {handle.row, handle.col, handle.segmentType}, t.map(newPos));
    }
 
    return wrapper.setMeshGradient(newGradient.data(), QTransform());
}

References absoluteTransformation(), KoShapeMeshGradientHandles::Handle::BezierHandle, KoShapeMeshGradientHandles::Handle::col, KoShapeMeshGradientHandles::Handle::Corner, SvgMeshPatch::getSegment(), KoShapeMeshGradientHandles::Handle::index, m_fillVariant, m_shape, KoShapeFillWrapper::meshgradient(), SvgMeshArray::modifyCorner(), SvgMeshArray::modifyHandle(), path(), KoShapeMeshGradientHandles::Handle::row, KoShapeMeshGradientHandles::Handle::segmentType, KoShapeFillWrapper::setMeshGradient(), and KoShapeMeshGradientHandles::Handle::type.

path()

QPainterPath KoShapeMeshGradientHandles::path

(

)

const

Definition at line 98 of file KoShapeMeshGradientHandles.cpp.

{
    QPainterPath painterPath;
 
    if (!gradient())
        return painterPath;
 
    QScopedPointer<SvgMeshGradient> g(new SvgMeshGradient(*gradient()));
    if (g->gradientUnits() == KoFlake::ObjectBoundingBox) {
        const QTransform gradientToUser = KisAlgebra2D::mapToRect(m_shape->outlineRect());
        g->setTransform(gradientToUser);
    }
 
    SvgMeshArray *mesharray = g->getMeshArray().data();
 
    for (int i = 0; i < mesharray->numRows(); ++i) {
        for (int j = 0; j < mesharray->numColumns(); ++j) {
            painterPath.addPath(mesharray->getPatch(i, j)->getPath());
        }
    }
 
    return painterPath;
}

References SvgMeshArray::getPatch(), SvgMeshPatch::getPath(), gradient(), m_shape, KisAlgebra2D::mapToRect(), SvgMeshArray::numColumns(), SvgMeshArray::numRows(), KoFlake::ObjectBoundingBox, and KoShape::outlineRect().

Member Data Documentation

m_fillVariant

KoFlake::FillVariant KoShapeMeshGradientHandles::m_fillVariant {KoFlake::Fill}

private

Definition at line 88 of file KoShapeMeshGradientHandles.h.

{KoFlake::Fill};

m_shape

KoShape* KoShapeMeshGradientHandles::m_shape {0}

private

Definition at line 89 of file KoShapeMeshGradientHandles.h.

{0};

---

The documentation for this class was generated from the following files:

• plugins/tools/defaulttool/defaulttool/KoShapeMeshGradientHandles.h
• plugins/tools/defaulttool/defaulttool/KoShapeMeshGradientHandles.cpp