#include <kis_painting_information_builder.h>

Inheritance diagram for KisPaintingInformationBuilder:

Public Member Functions
KisPaintInformation	continueStroke (KoPointerEvent *event, int timeElapsed)

KisPaintInformation	hover (const QPointF &imagePoint, const KoPointerEvent *event, bool isStrokeStarted)

	KisPaintingInformationBuilder ()

qreal	pressureToCurve (qreal pressure)

void	reset ()

KisPaintInformation	startStroke (KoPointerEvent event, int timeElapsed, const KoCanvasResourceProvider manager)

	~KisPaintingInformationBuilder () override

Protected Slots
void	updateSettings ()

Protected Member Functions
virtual QPointF	adjustDocumentPoint (const QPointF &point, const QPointF &startPoint)

virtual qreal	calculatePerspective (const QPointF &documentPoint)

virtual bool	canvasMirroredX () const

virtual bool	canvasMirroredY () const

virtual qreal	canvasRotation () const

virtual QPointF	documentToImage (const QPointF &point)

virtual QPointF	imageToDocument (const QPointF &point)

virtual QPointF	imageToView (const QPointF &point)

Private Member Functions
KisPaintInformation	createPaintingInformation (KoPointerEvent *event, int timeElapsed)

Private Attributes
int	m_maxAllowedSpeedValue = 30

bool	m_pressureDisabled

QVector< qreal >	m_pressureSamples

QScopedPointer< KisSpeedSmoother >	m_speedSmoother

QPointF	m_startPoint

qreal	m_tiltDirectionOffset = 0

Static Private Attributes
static const int	LEVEL_OF_PRESSURE_RESOLUTION = 1024

Detailed Description

Definition at line 23 of file kis_painting_information_builder.h.

Constructor & Destructor Documentation

◆ KisPaintingInformationBuilder()

KisPaintingInformationBuilder::KisPaintingInformationBuilder ( )

Definition at line 29 of file kis_painting_information_builder.cpp.

    : m_speedSmoother(new KisSpeedSmoother()),
      m_pressureDisabled(false)
{
    connect(KisConfigNotifier::instance(), SIGNAL(configChanged()),
            SLOT(updateSettings()));
 
    updateSettings();
}

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

◆ ~KisPaintingInformationBuilder()

KisPaintingInformationBuilder::~KisPaintingInformationBuilder ( )

override

Definition at line 39 of file kis_painting_information_builder.cpp.

{
 
}

Member Function Documentation

◆ adjustDocumentPoint()

QPointF KisPaintingInformationBuilder::adjustDocumentPoint	(	const QPointF &	point,
		const QPointF &	startPoint )

protectedvirtual

Reimplemented in KisToolFreehandPaintingInformationBuilder.

Definition at line 80 of file kis_painting_information_builder.cpp.

{
    return point;
}

◆ calculatePerspective()

qreal KisPaintingInformationBuilder::calculatePerspective ( const QPointF & documentPoint )

protectedvirtual

Reimplemented in KisToolFreehandPaintingInformationBuilder.

Definition at line 100 of file kis_painting_information_builder.cpp.

{
    Q_UNUSED(documentPoint);
    return 1.0;
}

◆ canvasMirroredX()

bool KisPaintingInformationBuilder::canvasMirroredX ( ) const

protectedvirtual

Reimplemented in KisConverterPaintingInformationBuilder, and KisToolFreehandPaintingInformationBuilder.

Definition at line 111 of file kis_painting_information_builder.cpp.

{
    return false;
}

◆ canvasMirroredY()

bool KisPaintingInformationBuilder::canvasMirroredY ( ) const

protectedvirtual

Reimplemented in KisConverterPaintingInformationBuilder, and KisToolFreehandPaintingInformationBuilder.

Definition at line 116 of file kis_painting_information_builder.cpp.

{
    return false;
}

◆ canvasRotation()

qreal KisPaintingInformationBuilder::canvasRotation ( ) const

protectedvirtual

Reimplemented in KisConverterPaintingInformationBuilder, and KisToolFreehandPaintingInformationBuilder.

Definition at line 106 of file kis_painting_information_builder.cpp.

{
    return 0;
}

◆ continueStroke()

KisPaintInformation KisPaintingInformationBuilder::continueStroke	(	KoPointerEvent *	event,
		int	timeElapsed )

Definition at line 74 of file kis_painting_information_builder.cpp.

{
    return createPaintingInformation(event, timeElapsed);
}

References createPaintingInformation().

◆ createPaintingInformation()

KisPaintInformation KisPaintingInformationBuilder::createPaintingInformation	(	KoPointerEvent *	event,
		int	timeElapsed )

private

Definition at line 121 of file kis_painting_information_builder.cpp.

{
 
    QPointF adjusted = adjustDocumentPoint(event->point, m_startPoint);
    QPointF imagePoint = documentToImage(adjusted);
    qreal perspective = calculatePerspective(adjusted);
    const qreal speed = m_speedSmoother->getNextSpeed(imageToView(imagePoint), event->time());
 
    KisPaintInformation pi(imagePoint,
                           !m_pressureDisabled ? 1.0 : pressureToCurve(event->pressure()),
                           event->xTilt(), event->yTilt(),
                           event->rotation(),
                           event->tangentialPressure(),
                           perspective,
                           timeElapsed,
                           qMin(1.0, speed / qreal(m_maxAllowedSpeedValue)));
 
    pi.setCanvasRotation(canvasRotation());
    pi.setCanvasMirroredH(canvasMirroredX());
    pi.setCanvasMirroredV(canvasMirroredY());
    pi.setTiltDirectionOffset(m_tiltDirectionOffset);
 
    return pi;
}

References adjustDocumentPoint(), calculatePerspective(), canvasMirroredX(), canvasMirroredY(), canvasRotation(), documentToImage(), imageToView(), m_maxAllowedSpeedValue, m_pressureDisabled, m_speedSmoother, m_startPoint, m_tiltDirectionOffset, KoPointerEvent::point, KoPointerEvent::pressure(), pressureToCurve(), KisPaintInformation::setCanvasMirroredH(), KisPaintInformation::setCanvasMirroredV(), KisPaintInformation::setCanvasRotation(), KisPaintInformation::setTiltDirectionOffset(), and KoPointerEvent::time().

◆ documentToImage()

QPointF KisPaintingInformationBuilder::documentToImage ( const QPointF & point )

protectedvirtual

Reimplemented in KisConverterPaintingInformationBuilder, and KisToolFreehandPaintingInformationBuilder.

Definition at line 85 of file kis_painting_information_builder.cpp.

{
    return point;
}

◆ hover()

KisPaintInformation KisPaintingInformationBuilder::hover	(	const QPointF &	imagePoint,
		const KoPointerEvent *	event,
		bool	isStrokeStarted )

Definition at line 147 of file kis_painting_information_builder.cpp.

{
    const qreal perspective = calculatePerspective(imageToDocument(imagePoint));
 
    const qreal speed = !isStrokeStarted && event ?
        m_speedSmoother->getNextSpeed(imageToView(imagePoint), event->time()) :
        m_speedSmoother->lastSpeed();
 
    if (event) {
        return KisPaintInformation::createHoveringModeInfo(imagePoint,
                                                           PRESSURE_DEFAULT,
                                                           event->xTilt(), event->yTilt(),
                                                           event->rotation(),
                                                           event->tangentialPressure(),
                                                           perspective,
                                                           qMin(1.0, speed / qreal(m_maxAllowedSpeedValue)),
                                                           canvasRotation(),
                                                           canvasMirroredX(),
                                                           canvasMirroredY(),
                                                           m_tiltDirectionOffset);
    } else {
        KisPaintInformation pi = KisPaintInformation::createHoveringModeInfo(imagePoint);
        pi.setCanvasRotation(canvasRotation());
        pi.setCanvasMirroredH(canvasMirroredX());
        pi.setCanvasMirroredV(canvasMirroredY());
        pi.setTiltDirectionOffset(m_tiltDirectionOffset);
        return pi;
    }
}

References calculatePerspective(), canvasMirroredX(), canvasMirroredY(), canvasRotation(), KisPaintInformation::createHoveringModeInfo(), imageToDocument(), imageToView(), m_maxAllowedSpeedValue, m_speedSmoother, m_tiltDirectionOffset, PRESSURE_DEFAULT, KoPointerEvent::rotation(), KisPaintInformation::setCanvasMirroredH(), KisPaintInformation::setCanvasMirroredV(), KisPaintInformation::setCanvasRotation(), KisPaintInformation::setTiltDirectionOffset(), KoPointerEvent::tangentialPressure(), KoPointerEvent::time(), KoPointerEvent::xTilt(), and KoPointerEvent::yTilt().

◆ imageToDocument()

QPointF KisPaintingInformationBuilder::imageToDocument ( const QPointF & point )

protectedvirtual

Reimplemented in KisConverterPaintingInformationBuilder, and KisToolFreehandPaintingInformationBuilder.

Definition at line 90 of file kis_painting_information_builder.cpp.

{
    return point;
}

◆ imageToView()

QPointF KisPaintingInformationBuilder::imageToView ( const QPointF & point )

protectedvirtual

Reimplemented in KisConverterPaintingInformationBuilder, KisToolFreehandPaintingInformationBuilder, and KisScratchPadPaintingInformationBuilder.

Definition at line 95 of file kis_painting_information_builder.cpp.

{
    return point;
}

◆ pressureToCurve()

qreal KisPaintingInformationBuilder::pressureToCurve ( qreal pressure )

Definition at line 179 of file kis_painting_information_builder.cpp.

{
    return KisCubicCurve::interpolateLinear(pressure, m_pressureSamples);
}

References KisCubicCurve::interpolateLinear(), and m_pressureSamples.

◆ reset()

void KisPaintingInformationBuilder::reset ( )

Definition at line 184 of file kis_painting_information_builder.cpp.

{
    m_speedSmoother->clear();
}

References m_speedSmoother.

◆ startStroke()

KisPaintInformation KisPaintingInformationBuilder::startStroke	(	KoPointerEvent *	event,
		int	timeElapsed,
		const KoCanvasResourceProvider *	manager )

Definition at line 61 of file kis_painting_information_builder.cpp.

{
    if (manager) {
        m_pressureDisabled = manager->resource(KoCanvasResource::DisablePressure).toBool();
    }
 
    m_startPoint = event->point;
    return createPaintingInformation(event, timeElapsed);
 
}

References createPaintingInformation(), KoCanvasResource::DisablePressure, m_pressureDisabled, m_startPoint, and KoCanvasResourceProvider::resource().

◆ updateSettings

void KisPaintingInformationBuilder::updateSettings ( )

protectedslot

Definition at line 44 of file kis_painting_information_builder.cpp.

{
    KisConfig cfg(true);
    const KisCubicCurve curve(cfg.pressureTabletCurve());
    m_pressureSamples = curve.floatTransfer(LEVEL_OF_PRESSURE_RESOLUTION + 1);
    m_maxAllowedSpeedValue = cfg.readEntry("maxAllowedSpeedValue", 30);
 
    // The setting is stored in [-180, 180] degrees range to match the UI.
    // We now need to convert it to [0, 360) range.
    m_tiltDirectionOffset = cfg.readEntry("tiltDirectionOffset", 0);
    if (m_tiltDirectionOffset < 0.0) {
        m_tiltDirectionOffset += 360.0;
    }
 
    m_speedSmoother->updateSettings();
}

References KisCubicCurve::floatTransfer(), LEVEL_OF_PRESSURE_RESOLUTION, m_maxAllowedSpeedValue, m_pressureSamples, m_speedSmoother, m_tiltDirectionOffset, KisConfig::pressureTabletCurve(), and KisConfig::readEntry().

Member Data Documentation

◆ LEVEL_OF_PRESSURE_RESOLUTION

const int KisPaintingInformationBuilder::LEVEL_OF_PRESSURE_RESOLUTION = 1024

staticprivate

Defines how many discrete samples are stored in a precomputed array of different pressures.

Definition at line 67 of file kis_painting_information_builder.h.

◆ m_maxAllowedSpeedValue

int KisPaintingInformationBuilder::m_maxAllowedSpeedValue = 30

private

Definition at line 74 of file kis_painting_information_builder.h.

◆ m_pressureDisabled

bool KisPaintingInformationBuilder::m_pressureDisabled

private

Definition at line 73 of file kis_painting_information_builder.h.

◆ m_pressureSamples

QVector<qreal> KisPaintingInformationBuilder::m_pressureSamples

private

Definition at line 70 of file kis_painting_information_builder.h.

◆ m_speedSmoother

QScopedPointer<KisSpeedSmoother> KisPaintingInformationBuilder::m_speedSmoother

private

Definition at line 72 of file kis_painting_information_builder.h.

◆ m_startPoint

QPointF KisPaintingInformationBuilder::m_startPoint

private

Definition at line 71 of file kis_painting_information_builder.h.

◆ m_tiltDirectionOffset

qreal KisPaintingInformationBuilder::m_tiltDirectionOffset = 0

private

Definition at line 75 of file kis_painting_information_builder.h.

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

libs/ui/tool/kis_painting_information_builder.h
libs/ui/tool/kis_painting_information_builder.cpp

Public Member Functions

Protected Slots

Protected Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ KisPaintingInformationBuilder()

◆ ~KisPaintingInformationBuilder()

Member Function Documentation

◆ adjustDocumentPoint()

◆ calculatePerspective()

◆ canvasMirroredX()

◆ canvasMirroredY()

◆ canvasRotation()

◆ continueStroke()

◆ createPaintingInformation()

◆ documentToImage()

◆ hover()

◆ imageToDocument()

◆ imageToView()

◆ pressureToCurve()

◆ reset()

◆ startStroke()

◆ updateSettings

Member Data Documentation

◆ LEVEL_OF_PRESSURE_RESOLUTION

◆ m_maxAllowedSpeedValue

◆ m_pressureDisabled

◆ m_pressureSamples

◆ m_speedSmoother

◆ m_startPoint

◆ m_tiltDirectionOffset