KisQPainterCanvas Class Reference

#include <kis_qpainter_canvas.h>

Inheritance diagram for KisQPainterCanvas:

Classes
class	Private

Public Member Functions
void	channelSelectionChanged (const QBitArray &channelFlags) override
void	finishResizingImage (qint32 w, qint32 h) override
void	focusInEvent (QFocusEvent *event) override
void	focusOutEvent (QFocusEvent *event) override
void	hideEvent (QHideEvent *event) override
void	inputMethodEvent (QInputMethodEvent *event) override
QVariant	inputMethodQuery (Qt::InputMethodQuery query) const override
bool	isBusy () const override
	KisQPainterCanvas (KisCanvas2 *canvas, KisCoordinatesConverter *coordinatesConverter, QWidget *parent)
void	notifyImageColorSpaceChanged (const KoColorSpace *cs) override
	set/update the color space of the attached image
void	paintEvent (QPaintEvent *ev) override
void	resizeEvent (QResizeEvent *e) override
void	setDisplayConfig (const KisDisplayConfig &config) override
void	setDisplayFilter (QSharedPointer< KisDisplayFilter > displayFilter) override
	set the specified display filter on the canvas
void	setLodResetInProgress (bool value) override
void	setPrescaledProjection (KisPrescaledProjectionSP prescaledProjection)
void	setWrapAroundViewingMode (bool value) override
void	setWrapAroundViewingModeAxis (WrapAroundAxis value) override
void	showEvent (QShowEvent *event) override
KisUpdateInfoSP	startUpdateCanvasProjection (const QRect &rc) override
void	updateCanvasDecorations (const QRect &decoUpdateRect) override
void	updateCanvasImage (const QRect &imageUpdateRect) override
QVector< QRect >	updateCanvasProjection (const QVector< KisUpdateInfoSP > &infoObjects) override
virtual QVector< QRect >	updateCanvasProjection (const QVector< KisUpdateInfoSP > &infoObjects)=0
QRect	updateCanvasProjection (KisUpdateInfoSP info) override
virtual QRect	updateCanvasProjection (KisUpdateInfoSP info)=0
QWidget *	widget () override
bool	wrapAroundViewingMode () const override
WrapAroundAxis	wrapAroundViewingModeAxis () const override
	~KisQPainterCanvas () override
Public Member Functions inherited from KisCanvasWidgetBase
void	addDecoration (KisCanvasDecorationSP deco) override
QColor	borderColor () const
KisCoordinatesConverter *	coordinatesConverter () const
BitDepthMode	currentBitDepthMode () const override
QString	currentBitDepthUserReport () const override
KisCanvasDecorationSP	decoration (const QString &id) const override
QList< KisCanvasDecorationSP >	decorations () const override
void	drawDecorations (QPainter &gc, const QRect &updateWidgetRect) const override
	KisCanvasWidgetBase (KisCanvas2 *canvas, KisCoordinatesConverter *coordinatesConverter)
void	notifyDecorationsWindowMinimized (bool minimized)
void	removeDecoration (const QString &id) override
void	setDecorations (const QList< KisCanvasDecorationSP > &) override
KoToolProxy *	toolProxy () const override
	~KisCanvasWidgetBase () override
Public Member Functions inherited from KisAbstractCanvasWidget
	KisAbstractCanvasWidget ()
virtual	~KisAbstractCanvasWidget ()

Protected Member Functions
bool	callFocusNextPrevChild (bool next) override
	To be implemented by the derived canvas.
virtual void	drawImage (QPainter &gc, const QRect &updateWidgetRect) const
Protected Member Functions inherited from KisCanvasWidgetBase
KisCanvas2 *	canvas () const
void	notifyConfigChanged ()
void	processFocusInEvent (QFocusEvent *event)
void	processFocusOutEvent (QFocusEvent *event)
void	processInputMethodEvent (QInputMethodEvent *event)
QVariant	processInputMethodQuery (Qt::InputMethodQuery query) const

Private Slots
void	slotConfigChanged ()

Private Attributes
Private *const	m_d

Additional Inherited Members
Public Types inherited from KisAbstractCanvasWidget
enum class	BitDepthMode { Depth8Bit = 0 , Depth10Bit }
Static Public Member Functions inherited from KisCanvasWidgetBase
static QImage	createCheckersImage (qint32 checkSize=-1)

Detailed Description

KisQPainterCanvas is the widget that shows the actual image using arthur.

NOTE: if you change something in the event handling here, also change it in the opengl canvas.

Author

Boudewijn Rempt boud@.nosp@m.vald.nosp@m.yas.o.nosp@m.rg

Definition at line 27 of file kis_qpainter_canvas.h.

Constructor & Destructor Documentation

KisQPainterCanvas()

KisQPainterCanvas::KisQPainterCanvas	(	KisCanvas2 *	canvas,
		KisCoordinatesConverter *	coordinatesConverter,
		QWidget *	parent )

Definition at line 57 of file kis_qpainter_canvas.cpp.

        : QWidget(parent)
        , KisCanvasWidgetBase(canvas, coordinatesConverter)
        , m_d(new Private())
{
    setAutoFillBackground(true);
    setAcceptDrops(true);
    setFocusPolicy(Qt::StrongFocus);
    setAttribute(Qt::WA_InputMethodEnabled, true);
    setAttribute(Qt::WA_StaticContents);
    setAttribute(Qt::WA_OpaquePaintEvent);
#ifdef Q_OS_MACOS
    setAttribute(Qt::WA_AcceptTouchEvents, false);
#else
    setAttribute(Qt::WA_AcceptTouchEvents, true);
#endif
    connect(KisConfigNotifier::instance(), SIGNAL(configChanged()), SLOT(slotConfigChanged()));
    slotConfigChanged();
}

References connect(), KisConfigNotifier::instance(), and slotConfigChanged().

~KisQPainterCanvas()

KisQPainterCanvas::~KisQPainterCanvas ( )

override

Definition at line 77 of file kis_qpainter_canvas.cpp.

{
    delete m_d;
}

References m_d.

Member Function Documentation

callFocusNextPrevChild()

bool KisQPainterCanvas::callFocusNextPrevChild ( bool next )

overrideprotectedvirtual

To be implemented by the derived canvas.

Implements KisCanvasWidgetBase.

Definition at line 274 of file kis_qpainter_canvas.cpp.

{
    return focusNextPrevChild(next);
}

channelSelectionChanged()

void KisQPainterCanvas::channelSelectionChanged ( const QBitArray & channelFlags )

overridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 172 of file kis_qpainter_canvas.cpp.

{
    Q_ASSERT(m_d->prescaledProjection);
    m_d->prescaledProjection->setChannelFlags(channelFlags);
}

References m_d, KisQPainterCanvas::Private::prescaledProjection, and KisPrescaledProjection::setChannelFlags().

drawImage()

void KisQPainterCanvas::drawImage ( QPainter & gc, const QRect & updateWidgetRect ) const

protectedvirtual

Definition at line 125 of file kis_qpainter_canvas.cpp.

{
    KisCoordinatesConverter *converter = coordinatesConverter();
 
    QTransform imageTransform = converter->viewportToWidgetTransform();
    gc.setTransform(imageTransform);
    gc.setRenderHint(QPainter::SmoothPixmapTransform, true);
 
    QRectF viewportRect = converter->widgetToViewport(updateWidgetRect);
 
    gc.setCompositionMode(QPainter::CompositionMode_SourceOver);
    gc.drawImage(viewportRect, m_d->prescaledProjection->prescaledQImage(),
                 viewportRect);
}

References KisCanvasWidgetBase::coordinatesConverter(), m_d, KisQPainterCanvas::Private::prescaledProjection, KisPrescaledProjection::prescaledQImage(), KisCoordinatesConverter::viewportToWidgetTransform(), and KisCoordinatesConverter::widgetToViewport().

finishResizingImage()

void KisQPainterCanvas::finishResizingImage ( qint32 w, qint32 h )

overridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 224 of file kis_qpainter_canvas.cpp.

{
    m_d->prescaledProjection->slotImageSizeChanged(w, h);
}

References m_d, KisQPainterCanvas::Private::prescaledProjection, and KisPrescaledProjection::slotImageSizeChanged().

focusInEvent()

void KisQPainterCanvas::focusInEvent ( QFocusEvent * event )

override

Definition at line 150 of file kis_qpainter_canvas.cpp.

{
    processFocusInEvent(event);
}

References KisCanvasWidgetBase::processFocusInEvent().

focusOutEvent()

void KisQPainterCanvas::focusOutEvent ( QFocusEvent * event )

override

Definition at line 155 of file kis_qpainter_canvas.cpp.

{
    processFocusOutEvent(event);
}

References KisCanvasWidgetBase::processFocusOutEvent().

hideEvent()

void KisQPainterCanvas::hideEvent ( QHideEvent * event )

override

Definition at line 160 of file kis_qpainter_canvas.cpp.

{
    QWidget::hideEvent(e);
    notifyDecorationsWindowMinimized(true);
}

References KisCanvasWidgetBase::notifyDecorationsWindowMinimized().

inputMethodEvent()

void KisQPainterCanvas::inputMethodEvent ( QInputMethodEvent * event )

override

Definition at line 145 of file kis_qpainter_canvas.cpp.

{
    processInputMethodEvent(event);
}

References KisCanvasWidgetBase::processInputMethodEvent().

inputMethodQuery()

QVariant KisQPainterCanvas::inputMethodQuery ( Qt::InputMethodQuery query ) const

override

Definition at line 140 of file kis_qpainter_canvas.cpp.

{
    return processInputMethodQuery(query);
}

References KisCanvasWidgetBase::processInputMethodQuery().

isBusy()

bool KisQPainterCanvas::isBusy ( ) const

inlineoverridevirtual

Returns true if the asynchronous engine of the canvas (e.g. openGL pipeline) is busy with processing of the previous update events. This will make KisCanvas2 to postpone and compress update events.

Implements KisAbstractCanvasWidget.

Definition at line 73 of file kis_qpainter_canvas.h.

                                 {
        return false;
    }

notifyImageColorSpaceChanged()

void KisQPainterCanvas::notifyImageColorSpaceChanged ( const KoColorSpace * cs )

overridevirtual

set/update the color space of the attached image

Implements KisAbstractCanvasWidget.

Definition at line 192 of file kis_qpainter_canvas.cpp.

{
    Q_UNUSED(cs);
    // FIXME: on color space change the data is refetched multiple
    //        times by different actors!
    canvas()->startUpdateInPatches(canvas()->image()->bounds());
}

References bounds, KisCanvasWidgetBase::canvas(), and KisCanvas2::startUpdateInPatches().

paintEvent()

void KisQPainterCanvas::paintEvent ( QPaintEvent * ev )

override

Definition at line 87 of file kis_qpainter_canvas.cpp.

{
    KisImageWSP image = canvas()->image();
    if (image == 0) return;
 
    setAutoFillBackground(false);
 
    QPainter gc(this);
    gc.setClipRegion(ev->region());
 
    KisCoordinatesConverter *converter = coordinatesConverter();
 
    gc.save();
 
    gc.setCompositionMode(QPainter::CompositionMode_Source);
    gc.fillRect(QRect(QPoint(0, 0), size()), borderColor());
 
    QTransform checkersTransform;
    QPointF brushOrigin;
    QPolygonF polygon;
 
    converter->getQPainterCheckersInfo(&checkersTransform, &brushOrigin, &polygon, m_d->scrollCheckers);
    gc.setPen(Qt::NoPen);
    gc.setBrush(m_d->checkBrush);
    gc.setBrushOrigin(brushOrigin);
    gc.setTransform(checkersTransform);
    gc.drawPolygon(polygon);
 
    drawImage(gc, ev->rect());
 
    gc.restore();
 
    drawDecorations(gc, ev->rect());
 
    gc.end();
    m_d->repaintDbg.paint(this, ev);
}

References KisCanvasWidgetBase::borderColor(), KisCanvasWidgetBase::canvas(), KisQPainterCanvas::Private::checkBrush, KisCanvasWidgetBase::coordinatesConverter(), KisCanvasWidgetBase::drawDecorations(), drawImage(), KisCoordinatesConverter::getQPainterCheckersInfo(), KisCanvas2::image(), m_d, KisRepaintDebugger::paint(), KisQPainterCanvas::Private::repaintDbg, and KisQPainterCanvas::Private::scrollCheckers.

resizeEvent()

void KisQPainterCanvas::resizeEvent ( QResizeEvent * e )

override

Definition at line 252 of file kis_qpainter_canvas.cpp.

{
    QSize size(e->size());
    if (size.width() <= 0) {
        size.setWidth(1);
    }
    if (size.height() <= 0) {
        size.setHeight(1);
    }
 
    m_d->prescaledProjection->notifyCanvasSizeChanged(size);
}

References m_d, KisPrescaledProjection::notifyCanvasSizeChanged(), and KisQPainterCanvas::Private::prescaledProjection.

setDisplayConfig()

void KisQPainterCanvas::setDisplayConfig ( const KisDisplayConfig & config )

overridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 178 of file kis_qpainter_canvas.cpp.

{
    Q_ASSERT(m_d->prescaledProjection);
    m_d->prescaledProjection->setDisplayConfig(config);
}

References m_d, KisQPainterCanvas::Private::prescaledProjection, and KisPrescaledProjection::setDisplayConfig().

setDisplayFilter()

void KisQPainterCanvas::setDisplayFilter ( QSharedPointer< KisDisplayFilter > displayFilter )

overridevirtual

set the specified display filter on the canvas

Implements KisAbstractCanvasWidget.

Definition at line 184 of file kis_qpainter_canvas.cpp.

{
        Q_ASSERT(m_d->prescaledProjection);
        m_d->prescaledProjection->setDisplayFilter(displayFilter);
 
        canvas()->startUpdateInPatches(canvas()->image()->bounds());
}

References bounds, KisCanvasWidgetBase::canvas(), m_d, KisQPainterCanvas::Private::prescaledProjection, KisPrescaledProjection::setDisplayFilter(), and KisCanvas2::startUpdateInPatches().

setLodResetInProgress()

void KisQPainterCanvas::setLodResetInProgress ( bool value )

inlineoverridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 77 of file kis_qpainter_canvas.h.

                                                    {
        Q_UNUSED(value);
    }

References value().

setPrescaledProjection()

void KisQPainterCanvas::setPrescaledProjection

(

KisPrescaledProjectionSP

prescaledProjection

)

Definition at line 82 of file kis_qpainter_canvas.cpp.

{
    m_d->prescaledProjection = prescaledProjection;
}

References m_d, and KisQPainterCanvas::Private::prescaledProjection.

setWrapAroundViewingMode()

void KisQPainterCanvas::setWrapAroundViewingMode ( bool value )

overridevirtual

Reimplemented from KisCanvasWidgetBase.

Definition at line 200 of file kis_qpainter_canvas.cpp.

{
    Q_UNUSED(value);
    dbgKrita << "Wrap around viewing mode not implemented in QPainter Canvas.";
    return;
}

References dbgKrita, and value().

setWrapAroundViewingModeAxis()

void KisQPainterCanvas::setWrapAroundViewingModeAxis ( WrapAroundAxis value )

overridevirtual

Reimplemented from KisCanvasWidgetBase.

Definition at line 212 of file kis_qpainter_canvas.cpp.

{
    Q_UNUSED(value);
    dbgKrita << "Wrap around viewing mode not implemented in QPainter Canvas.";
    return;
}

References dbgKrita, and value().

showEvent()

void KisQPainterCanvas::showEvent ( QShowEvent * event )

override

Definition at line 166 of file kis_qpainter_canvas.cpp.

{
    QWidget::showEvent(e);
    notifyDecorationsWindowMinimized(false);
}

References KisCanvasWidgetBase::notifyDecorationsWindowMinimized().

slotConfigChanged

void KisQPainterCanvas::slotConfigChanged ( )

privateslot

Definition at line 265 of file kis_qpainter_canvas.cpp.

{
    KisConfig cfg(true);
 
    m_d->checkBrush = QBrush(createCheckersImage());
    m_d->scrollCheckers = cfg.scrollCheckers();
    notifyConfigChanged();
}

References KisQPainterCanvas::Private::checkBrush, KisCanvasWidgetBase::createCheckersImage(), m_d, KisCanvasWidgetBase::notifyConfigChanged(), KisQPainterCanvas::Private::scrollCheckers, and KisConfig::scrollCheckers().

startUpdateCanvasProjection()

KisUpdateInfoSP KisQPainterCanvas::startUpdateCanvasProjection ( const QRect & rc )

overridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 229 of file kis_qpainter_canvas.cpp.

{
    return m_d->prescaledProjection->updateCache(rc);
}

References m_d, KisQPainterCanvas::Private::prescaledProjection, and KisPrescaledProjection::updateCache().

updateCanvasDecorations()

void KisQPainterCanvas::updateCanvasDecorations ( const QRect & decoUpdateRect )

inlineoverridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 85 of file kis_qpainter_canvas.h.

                                                                       {
        update(decoUpdateRect);
    }

updateCanvasImage()

void KisQPainterCanvas::updateCanvasImage ( const QRect & imageUpdateRect )

inlineoverridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 81 of file kis_qpainter_canvas.h.

                                                                  {
        update(imageUpdateRect);
    }

updateCanvasProjection() [1/4]

QVector< QRect > KisCanvasWidgetBase::updateCanvasProjection ( const QVector< KisUpdateInfoSP > & infoObjects )

overridevirtual

Reimplemented from KisCanvasWidgetBase.

Definition at line 69 of file kis_canvas_widget_base.cpp.

{
    QVector<QRect> dirtyViewRects;
 
    Q_FOREACH (KisUpdateInfoSP info, infoObjects) {
        dirtyViewRects << this->updateCanvasProjection(info);
    }
 
    return dirtyViewRects;
}

updateCanvasProjection() [2/4]

virtual QVector< QRect > KisAbstractCanvasWidget::updateCanvasProjection ( const QVector< KisUpdateInfoSP > & infoObjects )

virtual

Reimplemented from KisCanvasWidgetBase.

updateCanvasProjection() [3/4]

QRect KisQPainterCanvas::updateCanvasProjection ( KisUpdateInfoSP info )

overridevirtual

It might happen that the canvas type is switched while the update info is being stuck in the Qt's signals queue. Than a wrong type of the info may come. So just check it here.

Reimplemented from KisCanvasWidgetBase.

Definition at line 235 of file kis_qpainter_canvas.cpp.

{
    bool isPPUpdateInfo = dynamic_cast<KisPPUpdateInfo*>(info.data());
    if (isPPUpdateInfo) {
        m_d->prescaledProjection->recalculateCache(info);
        return info->dirtyViewportRect();
    } else {
        return QRect();
    }
}

References KisSharedPtr< T >::data(), m_d, KisQPainterCanvas::Private::prescaledProjection, and KisPrescaledProjection::recalculateCache().

updateCanvasProjection() [4/4]

virtual QRect KisAbstractCanvasWidget::updateCanvasProjection ( KisUpdateInfoSP info )

virtual

Reimplemented from KisCanvasWidgetBase.

widget()

QWidget * KisQPainterCanvas::widget ( )

inlineoverridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 69 of file kis_qpainter_canvas.h.

                                {
        return this;
    }

wrapAroundViewingMode()

bool KisQPainterCanvas::wrapAroundViewingMode ( ) const

overridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 207 of file kis_qpainter_canvas.cpp.

{
    return false;
}

wrapAroundViewingModeAxis()

WrapAroundAxis KisQPainterCanvas::wrapAroundViewingModeAxis ( ) const

overridevirtual

Implements KisAbstractCanvasWidget.

Definition at line 219 of file kis_qpainter_canvas.cpp.

{
    return WRAPAROUND_BOTH;
}

References WRAPAROUND_BOTH.

Member Data Documentation

m_d

Private* const KisQPainterCanvas::m_d

private

Definition at line 101 of file kis_qpainter_canvas.h.

---

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

• libs/ui/canvas/kis_qpainter_canvas.h
• libs/ui/canvas/kis_qpainter_canvas.cpp