Skip to main content :: ::

KOffice API Docs

:: Skip to Link Menu
/ KOffice / API Docs / libs / flake

libs/flake KoSnapGuide.cpp Go to the documentation of this file. /* This file is part of the KDE project * Copyright (C) 2008-2009 Jan Hambrecht <jaham@gmx.net> * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public License * along with this library; see the file COPYING.LIB. If not, write to * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301, USA. */ #include "KoSnapGuide.h" #include "KoSnapStrategy.h" #include <KoPathShape.h> #include <KoPathPoint.h> #include <KoViewConverter.h> #include <KoCanvasBase.h> #include <KoShapeManager.h> #include <QtGui/QPainter> #include <math.h> class KoSnapGuide::Private { public: Private(KoCanvasBase *parentCanvas) : canvas(parentCanvas), editedShape(0), currentStrategy(0) , usedStrategies(0), active(true), snapDistance(10) { } ~Private() { qDeleteAll( strategies ); strategies.clear(); } KoCanvasBase * canvas; KoShape * editedShape; QList<KoSnapStrategy*> strategies; KoSnapStrategy * currentStrategy; int usedStrategies; bool active; int snapDistance; QList<KoPathPoint*> ignoredPoints; QList<KoShape*> ignoredShapes; }; KoSnapGuide::KoSnapGuide(KoCanvasBase * canvas) : d(new Private(canvas)) { d->strategies.append(new GridSnapStrategy()); d->strategies.append(new NodeSnapStrategy()); d->strategies.append(new OrthogonalSnapStrategy()); d->strategies.append(new ExtensionSnapStrategy()); d->strategies.append(new IntersectionSnapStrategy()); d->strategies.append(new BoundingBoxSnapStrategy()); d->strategies.append(new LineGuideSnapStrategy()); } KoSnapGuide::~KoSnapGuide() { delete d; } void KoSnapGuide::setEditedShape(KoShape * shape) { d->editedShape = shape; } KoShape * KoSnapGuide::editedShape() const { return d->editedShape; } void KoSnapGuide::enableSnapStrategies(int strategies) { d->usedStrategies = strategies; } int KoSnapGuide::enabledSnapStrategies() const { return d->usedStrategies; } bool KoSnapGuide::addCustomSnapStrategy(KoSnapStrategy * customStrategy) { if (!customStrategy || customStrategy->type() != KoSnapStrategy::Custom) return false; d->strategies.append(customStrategy); return true; } void KoSnapGuide::enableSnapping(bool on) { d->active = on; } bool KoSnapGuide::isSnapping() const { return d->active; } void KoSnapGuide::setSnapDistance(int distance) { d->snapDistance = qAbs(distance); } int KoSnapGuide::snapDistance() const { return d->snapDistance; } QPointF KoSnapGuide::snap(const QPointF &mousePosition, Qt::KeyboardModifiers modifiers) { d->currentStrategy = 0; if (! d->active || (modifiers & Qt::ShiftModifier)) return mousePosition; KoSnapProxy proxy(this); qreal minDistance = HUGE_VAL; qreal maxSnapDistance = d->canvas->viewConverter()->viewToDocument(QSizeF(d->snapDistance, d->snapDistance)).width(); foreach(KoSnapStrategy * strategy, d->strategies) { if (d->usedStrategies & strategy->type() || strategy->type() == KoSnapStrategy::Grid || strategy->type() == KoSnapStrategy::Custom) { if (! strategy->snap(mousePosition, &proxy, maxSnapDistance)) continue; QPointF snapCandidate = strategy->snappedPosition(); qreal distance = KoSnapStrategy::squareDistance(snapCandidate, mousePosition); if (distance < minDistance) { d->currentStrategy = strategy; minDistance = distance; } } } if (! d->currentStrategy) return mousePosition; return d->currentStrategy->snappedPosition(); } QRectF KoSnapGuide::boundingRect() { QRectF rect; if (d->currentStrategy) { rect = d->currentStrategy->decoration(*d->canvas->viewConverter()).boundingRect(); return rect.adjusted(-2, -2, 2, 2); } else { return rect; }; } void KoSnapGuide::paint(QPainter &painter, const KoViewConverter &converter) { if (! d->currentStrategy || ! d->active) return; QPainterPath decoration = d->currentStrategy->decoration(converter); painter.setBrush(Qt::NoBrush); QPen whitePen(Qt::white); whitePen.setStyle(Qt::SolidLine); painter.setPen(whitePen); painter.drawPath(decoration); QPen redPen(Qt::red); redPen.setStyle(Qt::DotLine); painter.setPen(redPen); painter.drawPath(decoration); } KoCanvasBase * KoSnapGuide::canvas() const { return d->canvas; } void KoSnapGuide::setIgnoredPathPoints(const QList<KoPathPoint*> &ignoredPoints) { d->ignoredPoints = ignoredPoints; } QList<KoPathPoint*> KoSnapGuide::ignoredPathPoints() const { return d->ignoredPoints; } void KoSnapGuide::setIgnoredShapes(const QList<KoShape*> &ignoredShapes) { d->ignoredShapes = ignoredShapes; } QList<KoShape*> KoSnapGuide::ignoredShapes() const { return d->ignoredShapes; } void KoSnapGuide::reset() { d->currentStrategy = 0; d->editedShape = 0; d->ignoredPoints.clear(); d->ignoredShapes.clear(); // remove all custom strategies int strategyCount = d->strategies.count(); for(int i = strategyCount-1; i >= 0; --i) { if (d->strategies[i]->type() == KoSnapStrategy::Custom) { delete d->strategies[i]; d->strategies.removeAt(i); } } } // snap proxy KoSnapProxy::KoSnapProxy(KoSnapGuide * snapGuide) : m_snapGuide(snapGuide) { } QList<QPointF> KoSnapProxy::pointsInRect(const QRectF &rect) { QList<QPointF> points; QList<KoShape*> shapes = shapesInRect(rect); foreach(KoShape * shape, shapes) { foreach(const QPointF & point, pointsFromShape(shape)) { if (rect.contains(point)) points.append(point); } } return points; } QList<KoShape*> KoSnapProxy::shapesInRect(const QRectF &rect, bool omitEditedShape) { QList<KoShape*> shapes = m_snapGuide->canvas()->shapeManager()->shapesAt(rect); foreach(KoShape * shape, m_snapGuide->ignoredShapes()) { int index = shapes.indexOf(shape); if (index >= 0) shapes.removeAt(index); } if (! omitEditedShape && m_snapGuide->editedShape()) { QRectF bound = m_snapGuide->editedShape()->boundingRect(); if (rect.intersects(bound) || rect.contains(bound)) shapes.append(m_snapGuide->editedShape()); } return shapes; } QList<QPointF> KoSnapProxy::pointsFromShape(KoShape * shape) { QList<QPointF> snapPoints; // no snapping to hidden shapes if (! shape->isVisible(true)) return snapPoints; // return the special snap points of the shape snapPoints += shape->snapData().snapPoints(); KoPathShape * path = dynamic_cast<KoPathShape*>(shape); if (path) { QMatrix m = path->absoluteTransformation(0); QList<KoPathPoint*> ignoredPoints = m_snapGuide->ignoredPathPoints(); int subpathCount = path->subpathCount(); for (int subpathIndex = 0; subpathIndex < subpathCount; ++subpathIndex) { int pointCount = path->pointCountSubpath(subpathIndex); for (int pointIndex = 0; pointIndex < pointCount; ++pointIndex) { KoPathPoint * p = path->pointByIndex(KoPathPointIndex(subpathIndex, pointIndex)); if (! p || ignoredPoints.contains(p)) continue; snapPoints.append(m.map(p->point())); } } } else { // add the bounding box corners as default snap points QRectF bbox = shape->boundingRect(); snapPoints.append(bbox.topLeft()); snapPoints.append(bbox.topRight()); snapPoints.append(bbox.bottomRight()); snapPoints.append(bbox.bottomLeft()); } return snapPoints; } QList<KoPathSegment> KoSnapProxy::segmentsInRect(const QRectF &rect) { QList<KoShape*> shapes = shapesInRect(rect, true); QList<KoPathPoint*> ignoredPoints = m_snapGuide->ignoredPathPoints(); QList<KoPathSegment> segments; foreach(KoShape * shape, shapes) { QList<KoPathSegment> shapeSegments; QRectF rectOnShape = shape->documentToShape(rect); KoPathShape * path = dynamic_cast<KoPathShape*>(shape); if (path) { shapeSegments = path->segmentsAt(rectOnShape); } else { foreach(const KoPathSegment & s, shape->snapData().snapSegments()) { QRectF controlRect = s.controlPointRect(); if (! rect.intersects(controlRect) && ! controlRect.contains(rect)) continue; QRectF bound = s.boundingRect(); if (! rect.intersects(bound) && ! bound.contains(rect)) continue; shapeSegments.append(s); } } QMatrix m = shape->absoluteTransformation(0); // transform segments to document coordinates foreach(const KoPathSegment & s, shapeSegments) { if (ignoredPoints.contains(s.first()) || ignoredPoints.contains(s.second())) continue; segments.append(s.mapped(m)); } } return segments; } QList<KoShape*> KoSnapProxy::shapes(bool omitEditedShape) { QList<KoShape*> allShapes = m_snapGuide->canvas()->shapeManager()->shapes(); QList<KoShape*> filteredShapes; QList<KoShape*> ignoredShapes = m_snapGuide->ignoredShapes(); // filter all hidden and ignored shapes foreach(KoShape * shape, allShapes) { if (! shape->isVisible(true)) continue; if (ignoredShapes.contains(shape)) continue; filteredShapes.append(shape); } if (! omitEditedShape && m_snapGuide->editedShape()) filteredShapes.append(m_snapGuide->editedShape()); return filteredShapes; } KoCanvasBase * KoSnapProxy::canvas() { return m_snapGuide->canvas(); } libs/flake Skip menu "libs/flake" Main Page Namespace List Class Hierarchy Alphabetical List Class List File List Namespace Members Class Members API Reference Skip menu "API Reference" kdgantt Kexi   KoProperty   flake kplato krita   image   plugins       libbrush       libpaintop   ui kspread   part     scripting libs   flake   kotext   main   pigment   store   musicshape Generated for API Reference by doxygen 1.5.9-20090814 This website is maintained by Adriaan de Groot and Allen Winter. KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal