KisSelectionActionsPanel Class Reference

#include <kis_selection_actions_panel.h>

Inheritance diagram for KisSelectionActionsPanel:

Classes
struct	Private

Public Member Functions
void	draw (QPainter &painter)
bool	eventFilter (QObject *obj, QEvent *event) override
	KisSelectionActionsPanel ()=delete
	KisSelectionActionsPanel (KisViewManager *viewManager, QWidget *parent)
void	setEnabled (bool enabled)
void	setVisible (bool visible)
	~KisSelectionActionsPanel ()

Private Member Functions
QPushButton *	createButton (const QString &iconName, const QString &tooltip)
void	drawActionBarBackground (QPainter &gc) const
QPoint	initialDragHandlePosition () const
void	setupButtons ()
QPoint	updateCanvasBoundaries (QPoint position, QWidget *canvasWidget) const

Private Attributes
QScopedPointer< Private >	d

Detailed Description

Definition at line 30 of file kis_selection_actions_panel.h.

Constructor & Destructor Documentation

KisSelectionActionsPanel() [1/2]

KisSelectionActionsPanel::KisSelectionActionsPanel ( )

delete

KisSelectionActionsPanel() [2/2]

KisSelectionActionsPanel::KisSelectionActionsPanel	(	KisViewManager *	viewManager,
		QWidget *	parent )

Definition at line 81 of file kis_selection_actions_panel.cpp.

    : QWidget(parent)
    , d(new Private)
{
    d->m_viewManager = viewManager;
    d->m_selectionManager = viewManager->selectionManager();
 
    // Setup buttons...
    for (const ActionButtonData &buttonData : Private::buttonData()) {
        QPushButton *button = createButton(buttonData.iconName, buttonData.tooltip);
        connect(button, &QPushButton::clicked, d->m_selectionManager, buttonData.slot);
        d->m_buttons.append(button);
    }
}

References button(), KisSelectionActionsPanel::Private::buttonData(), connect(), createButton(), d, and KisViewManager::selectionManager().

~KisSelectionActionsPanel()

KisSelectionActionsPanel::~KisSelectionActionsPanel

(

)

Definition at line 96 of file kis_selection_actions_panel.cpp.

{
    // buttons are children of the canvas, but we should still delete
    // them to make sure they are not accessed after the decoration dies
    qDeleteAll(d->m_buttons);
    d->m_buttons.clear();
}

References d.

Member Function Documentation

createButton()

QPushButton * KisSelectionActionsPanel::createButton ( const QString & iconName, const QString & tooltip )

private

Definition at line 258 of file kis_selection_actions_panel.cpp.

{
    QPushButton *button = new QPushButton();
    button->setIcon(KisIconUtils::loadIcon(iconName));
    button->setFixedSize(BUTTON_SIZE, BUTTON_SIZE);
    button->setToolTip(tooltip);
    return button;
}

References button(), BUTTON_SIZE, and KisIconUtils::loadIcon().

draw()

void KisSelectionActionsPanel::draw

(

QPainter &

painter

)

Definition at line 104 of file kis_selection_actions_panel.cpp.

{
    KisSelectionSP selection = d->m_viewManager->selection();
 
    if (!selection || !d->m_enabled || !d->m_visible) {
        return;
    }
 
    drawActionBarBackground(painter);
 
    for (int i = 0; i < d->m_buttons.size(); i++) {
        QPushButton *button = d->m_buttons[i];
        int buttonPosition = i * BUTTON_SIZE;
        button->move(d->m_dragHandle->position.x() + buttonPosition, d->m_dragHandle->position.y());
        button->show();
    }
}

References button(), BUTTON_SIZE, d, and drawActionBarBackground().

drawActionBarBackground()

void KisSelectionActionsPanel::drawActionBarBackground ( QPainter & gc ) const

private

Definition at line 267 of file kis_selection_actions_panel.cpp.

{
    const int CORNER_RADIUS = 4;
    const int PEN_WIDTH = 5;
    const QColor BACKGROUND_COLOR = Qt::darkGray;
    const QColor OUTLINE_COLOR(60, 60, 60, 80);
    const QColor DOT_COLOR = Qt::lightGray;
    const int DOT_SIZE = 4;
    const int DOT_SPACING = 5;
    const QPoint DRAG_HANDLE_RECT_DOTS_OFFSET(10, 10);
 
    QRectF actionBarRect(d->m_dragHandle->position, QSize(d->m_actionBarWidth, BUTTON_SIZE));
    QPainterPath bgPath;
    bgPath.addRoundedRect(actionBarRect, CORNER_RADIUS, CORNER_RADIUS);
    painter.fillPath(bgPath, BACKGROUND_COLOR);
 
    QPen pen(OUTLINE_COLOR);
    pen.setWidth(PEN_WIDTH);
    painter.setPen(pen);
    painter.drawPath(bgPath);
 
    QRectF dragHandleRect(
        QPoint(d->m_dragHandle->position.x() + d->m_actionBarWidth - BUTTON_SIZE, d->m_dragHandle->position.y()),
        QSize(BUTTON_SIZE, BUTTON_SIZE));
    QPainterPath dragHandlePath;
    dragHandlePath.addRect(dragHandleRect);
    painter.fillPath(dragHandlePath, BACKGROUND_COLOR);
 
    const std::list<std::pair<int, int>> DOT_OFFSETS = {{0, 0},
                                                        {DOT_SPACING, 0},
                                                        {-DOT_SPACING, 0},
                                                        {0, DOT_SPACING},
                                                        {0, -DOT_SPACING},
                                                        {DOT_SPACING, DOT_SPACING},
                                                        {DOT_SPACING, -DOT_SPACING},
                                                        {-DOT_SPACING, DOT_SPACING},
                                                        {-DOT_SPACING, -DOT_SPACING}};
 
    QPainterPath dragHandleRectDots;
    for (const std::pair<int, int> &offset : DOT_OFFSETS) {
        dragHandleRectDots.addEllipse(offset.first, offset.second, DOT_SIZE, DOT_SIZE);
    };
 
    dragHandleRectDots.translate(dragHandleRect.topLeft() + DRAG_HANDLE_RECT_DOTS_OFFSET);
    painter.fillPath(dragHandleRectDots, DOT_COLOR);
}

References BUTTON_SIZE, and d.

eventFilter()

bool KisSelectionActionsPanel::eventFilter ( QObject * obj, QEvent * event )

override

Definition at line 170 of file kis_selection_actions_panel.cpp.

{
    bool eventHandled = false;
 
    bool focusInEvent = event->type() == QEvent::FocusIn;
    if (focusInEvent && !eventHandled) {
        eventHandled = true;
    }
 
    // Clicks...
    bool clickEvent = event->type() == QEvent::MouseButtonPress || event->type() == QEvent::TabletPress || event->type() == QEvent::TouchBegin;
    if (clickEvent && !eventHandled ) {
        QMouseEvent *mouseEvent = static_cast<QMouseEvent *>(event);
        QRect dragHandleRect(d->m_dragHandle->position, QSize(25 * (d->m_buttonCount), 25));
        if (dragHandleRect.contains(mouseEvent->pos())) {
            d->m_dragging = true;
            d->m_dragHandle->dragOrigin = mouseEvent->pos() - d->m_dragHandle->position;
 
            eventHandled = true;
        }
    }
 
    // Drags...
    bool dragEvent = d->m_dragging && (event->type() == QEvent::MouseMove || event->type() == QEvent::TouchUpdate);
 
    if (dragEvent && !eventHandled) {
        QMouseEvent *mouseEvent = static_cast<QMouseEvent *>(event);
        QPoint newPos = mouseEvent->pos() - d->m_dragHandle->dragOrigin;
 
        // bound actionBar to stay within canvas space
        QWidget *canvasWidget = dynamic_cast<QWidget *>(d->m_viewManager->canvas());
 
        if (obj == canvasWidget) {
            d->m_dragHandle->position = updateCanvasBoundaries(newPos, canvasWidget);
            canvasWidget->update();
            eventHandled = true;
        }
    }
 
    // Releases...
    bool releaseEvent = d->m_dragging && (event->type() == QEvent::MouseButtonRelease || event->type() == QEvent::TabletRelease || event->type() == QEvent::TouchEnd);
 
    if (releaseEvent && d->m_dragging) {
        d->m_dragging = false;
        eventHandled = true;
    }
 
    return eventHandled;
}

References d, and updateCanvasBoundaries().

initialDragHandlePosition()

QPoint KisSelectionActionsPanel::initialDragHandlePosition ( ) const

private

Definition at line 238 of file kis_selection_actions_panel.cpp.

{
    KisSelectionSP selection = d->m_viewManager->selection();
    KisCanvasWidgetBase *canvas = dynamic_cast<KisCanvasWidgetBase*>(d->m_viewManager->canvas());
    KIS_ASSERT(selection);
    KIS_ASSERT(canvas);
 
    QRectF selectionBounds = selection->selectedRect();
    int selectionBottom = selectionBounds.bottom();
    QPointF selectionCenter = selectionBounds.center();
    QPointF bottomCenter(selectionCenter.x(), selectionBottom);
 
    QPointF widgetBottomCenter = canvas->coordinatesConverter()->imageToWidget(bottomCenter); // converts current selection's QPointF into canvasWidget's QPointF space
 
    widgetBottomCenter.setX(widgetBottomCenter.x() - (d->m_actionBarWidth / 2)); // centers toolbar midpoint with the selection center
    widgetBottomCenter.setY(widgetBottomCenter.y() + BUFFER_SPACE);
 
    return updateCanvasBoundaries(widgetBottomCenter.toPoint(), d->m_viewManager->canvas());
}

References BUFFER_SPACE, KisCanvasWidgetBase::coordinatesConverter(), d, KisCoordinatesConverter::imageToWidget(), KIS_ASSERT, KisSelection::selectedRect(), and updateCanvasBoundaries().

setEnabled()

void KisSelectionActionsPanel::setEnabled

(

bool

enabled

)

Definition at line 160 of file kis_selection_actions_panel.cpp.

{
    bool configurationChanged = enabled != d->m_enabled;
    d->m_enabled = enabled;
    if (configurationChanged) {
        // Reset visibility when configuration changes
        setVisible(d->m_visible);
    }
}

References d, and setVisible().

setupButtons()

void KisSelectionActionsPanel::setupButtons ( )

private

setVisible()

void KisSelectionActionsPanel::setVisible

(

bool

visible

)

Definition at line 122 of file kis_selection_actions_panel.cpp.

{
    QWidget *canvasWidget = dynamic_cast<QWidget *>(d->m_viewManager->canvas());
    if (!canvasWidget) {
        return;
    }
 
    p_visible &= d->m_enabled;
 
    const bool VISIBILITY_CHANGED = d->m_visible != p_visible;
    if (!VISIBILITY_CHANGED) {
        return;
    }
 
    if (d->m_viewManager->selection() && p_visible) { // Now visible!
        canvasWidget->installEventFilter(this);
 
        if (!d->m_dragHandle) {
            d->m_dragHandle.reset(new Private::DragHandle());
            d->m_dragHandle->position = initialDragHandlePosition();
        }
 
        for (QPushButton *button : d->m_buttons) {
            button->setParent(canvasWidget);
        }
    } else { // Now hidden!
        canvasWidget->removeEventFilter(this);
 
        for (QPushButton *button : d->m_buttons) {
            button->hide();
        }
 
        d->m_dragHandle.reset();
    }
 
    d->m_visible = p_visible;
}

References button(), d, and initialDragHandlePosition().

updateCanvasBoundaries()

QPoint KisSelectionActionsPanel::updateCanvasBoundaries ( QPoint position, QWidget * canvasWidget ) const

private

Definition at line 220 of file kis_selection_actions_panel.cpp.

{
    QRect canvasBounds = canvasWidget->rect();
 
    const int ACTION_BAR_WIDTH = d->m_actionBarWidth;
    const int ACTION_BAR_HEIGHT = BUTTON_SIZE;
 
    position.setX(qBound(canvasBounds.left() + BUFFER_SPACE,
                         position.x(),
                         canvasBounds.right() - ACTION_BAR_WIDTH - BUFFER_SPACE));
 
    position.setY(qBound(canvasBounds.top() + BUFFER_SPACE,
                         position.y(),
                         canvasBounds.bottom() - ACTION_BAR_HEIGHT - BUFFER_SPACE));
 
    return position;
}

References BUFFER_SPACE, BUTTON_SIZE, and d.

Member Data Documentation

d

QScopedPointer<Private> KisSelectionActionsPanel::d

private

Definition at line 51 of file kis_selection_actions_panel.h.

---

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

• libs/ui/kis_selection_actions_panel.h
• libs/ui/kis_selection_actions_panel.cpp