KisVisualColorSelectorShape Class Reference

The KisVisualColorSelectorShape class A 2d widget can represent at maximum 2 coordinates. So first decide how many coordinates you need. (onedimensional, or twodimensional) Then, select the channels you wish to be affected. This uses the model, so for cmyk the channel is c=0, m=1, y=2, k=3, but for hsv, hue=0, sat=1, and val=2 Then finally, connect the displayrenderer, you can also do this with 'setdisplayrenderer'. More...

#include <KisVisualColorSelectorShape.h>

Inheritance diagram for KisVisualColorSelectorShape:

Classes
struct	Private

Public Types
enum	Dimensions { onedimensional , twodimensional }
	The Dimensions enum Whether or not the shape is single or two dimensional. More...

Signals
void	sigCursorMoved (QPointF pos)

Public Member Functions
int	channel (int dimension) const
	channel Get the channel index associated with a selector shape dimension
quint32	channelMask () const
void	forceImageUpdate ()
	forceImageUpdate force the image to recache.
QColor	getColorFromConverter (KoColor c)
	getColorFromConverter
KoColor	getCurrentColor ()
	getCurrentColor
QPointF	getCursorPosition () const
	getCursorPosition
Dimensions	getDimensions () const
	getDimensions
const QImage &	getImageMap ()
	getImageMap returns the updated base image
virtual QRect	getSpaceForCircle (QRect geom)=0
virtual QRect	getSpaceForSquare (QRect geom)=0
	getSpaceForSquare
virtual QRect	getSpaceForTriangle (QRect geom)=0
bool	isHueControl () const
	KisVisualColorSelectorShape (KisVisualColorSelector *parent, KisVisualColorSelectorShape::Dimensions dimension, int channel1, int channel2)
void	setAcceptTabletEvents (bool on)
virtual void	setBorderWidth (int width)=0
	setBorderWidth set the border of the single dimensional selector.
void	setChannelValues (QVector4D channelValues, quint32 channelFlags)
	setChannelValues Set the current channel values; Note that channel values controlled by the shape itself have no effect unless setCursor is true. This will trigger a full widget repaint.
void	setCursorPosition (QPointF position, bool signal=false)
	setCursorPosition Set the cursor to normalized shape coordinates. This will only repaint the cursor.
virtual bool	supportsGamutMask () const
virtual void	updateGamutMask ()
	Notify shape that the gamut mask changed.
	~KisVisualColorSelectorShape () override

Protected Member Functions
KisVisualColorSelector *	colorSelector () const
virtual QImage	compositeBackground () const
QImage	convertImageMap (const quint8 *rawColor, quint32 bufferSize, QSize imgSize) const
	convertImageMap convert image data containing raw KoColor data into a QImage
void	mouseMoveEvent (QMouseEvent *e) override
virtual QPointF	mousePositionToShapeCoordinate (const QPointF &pos, const QPointF &dragStart) const
	default implementation just calls convertWidgetCoordinateToShapeCoordinate(pos)
void	mousePressEvent (QMouseEvent *e) override
void	mouseReleaseEvent (QMouseEvent *e) override
void	paintEvent (QPaintEvent *) override
virtual QImage	renderAlphaMask () const
	render the alpha mask for the widget background the returned image is expected to be QImage::Format_Alpha8
virtual QImage	renderBackground (const QVector4D &channelValues, const QImage &alpha) const
	renderBackground Render the widget background visible inside the widget's mask in current color space Rendering shall be done with the conversion functions of KisVisualColorSelector
virtual QImage	renderStaticAlphaMask () const
void	resizeEvent (QResizeEvent *) override
KisVisualColorModel *	selectorModel () const
void	tabletEvent (QTabletEvent *event) override

Private Member Functions
virtual QPointF	convertShapeCoordinateToWidgetCoordinate (QPointF) const =0
	convertShapeCoordinateToWidgetCoordinate
virtual QPointF	convertWidgetCoordinateToShapeCoordinate (QPointF coordinate) const =0
	convertWidgetCoordinateToShapeCoordinate Convert a coordinate in the widget's height/width to a shape coordinate.
virtual void	drawCursor (QPainter &painter)=0
virtual void	drawGamutMask (QPainter &painter)
virtual QRegion	getMaskMap ()=0
	getPixmap

Private Attributes
const QScopedPointer< Private >	m_d

Detailed Description

The KisVisualColorSelectorShape class A 2d widget can represent at maximum 2 coordinates. So first decide how many coordinates you need. (onedimensional, or twodimensional) Then, select the channels you wish to be affected. This uses the model, so for cmyk the channel is c=0, m=1, y=2, k=3, but for hsv, hue=0, sat=1, and val=2 Then finally, connect the displayrenderer, you can also do this with 'setdisplayrenderer'.

Either way, this class is made to be subclassed, with a few virtuals so that the geometry can be calculated properly.

Definition at line 33 of file KisVisualColorSelectorShape.h.

Member Enumeration Documentation

Dimensions

enum KisVisualColorSelectorShape::Dimensions

The Dimensions enum Whether or not the shape is single or two dimensional.

Enumerator
onedimensional
twodimensional

Definition at line 41 of file KisVisualColorSelectorShape.h.

{onedimensional, twodimensional};

Constructor & Destructor Documentation

KisVisualColorSelectorShape()

KisVisualColorSelectorShape::KisVisualColorSelectorShape ( KisVisualColorSelector * parent, KisVisualColorSelectorShape::Dimensions dimension, int channel1, int channel2 )

explicit

Definition at line 40 of file KisVisualColorSelectorShape.cpp.

                                                                      : QWidget(parent), m_d(new Private)
{
    m_d->dimension = dimension;
    int maxchannel = parent->selectorModel()->colorSpace()->colorChannelCount()-1;
    m_d->channel1 = qBound(0, channel1, maxchannel);
    m_d->channel2 = qBound(0, channel2, maxchannel);
    m_d->channelMask = 1 << channel1;
    if (dimension == Dimensions::twodimensional) {
        m_d->channelMask |= 1 << channel2;
    }
    this->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
}

References m_d, and twodimensional.

~KisVisualColorSelectorShape()

KisVisualColorSelectorShape::~KisVisualColorSelectorShape ( )

override

Definition at line 56 of file KisVisualColorSelectorShape.cpp.

{
}

Member Function Documentation

channel()

int KisVisualColorSelectorShape::channel

(

int

dimension

)

const

channel Get the channel index associated with a selector shape dimension

Parameters

dimension

A shape dimension that can be controlled by the cursor

Returns

Definition at line 405 of file KisVisualColorSelectorShape.cpp.

{
    if (dimension == 0) {
        return m_d->channel1;
    }
    if (dimension == 1 && getDimensions() == twodimensional) {
        return m_d->channel2;
    }
    return -1;
}

References getDimensions(), m_d, and twodimensional.

channelMask()

quint32 KisVisualColorSelectorShape::channelMask

(

)

const

Definition at line 416 of file KisVisualColorSelectorShape.cpp.

{
    return m_d->channelMask;
}

References m_d.

colorSelector()

KisVisualColorSelector * KisVisualColorSelectorShape::colorSelector ( ) const

protected

Definition at line 137 of file KisVisualColorSelectorShape.cpp.

{
    KisVisualColorSelector* selectorWidget = qobject_cast<KisVisualColorSelector*>(parent());
    KIS_ASSERT(selectorWidget);
    return selectorWidget;
}

References KIS_ASSERT.

compositeBackground()

QImage KisVisualColorSelectorShape::compositeBackground ( ) const

protectedvirtual

Definition at line 239 of file KisVisualColorSelectorShape.cpp.

{
    // Shapes are expect to return a valid alpha mask or a valid
    // static alpha mask. If they provide both, the rendered backgrounds
    // get composited.
    if (m_d->alphaNeedsUpdate) {
        QImage staticAlpha = renderStaticAlphaMask();
        if (!staticAlpha.isNull()) {
            QVector4D neutralValues(1, 1, 1, 1);
            switch (selectorModel()->colorModel()) {
            case KisVisualColorModel::HSL:
            case KisVisualColorModel::HSI:
            case KisVisualColorModel::HSY:
                neutralValues.setZ(0.5f);
            default:
                break;
            }
 
            m_d->staticBackground = renderBackground(neutralValues, staticAlpha);
        }
        m_d->alphaMask = renderAlphaMask();
        m_d->alphaNeedsUpdate = false;
    }
    if (m_d->alphaMask.isNull()) {
        return m_d->staticBackground;
    }
 
    QImage bgImage = renderBackground(m_d->currentChannelValues, m_d->alphaMask);
    if (!m_d->staticBackground.isNull()) {
        QPainter painter(&bgImage);
        // composite static and dynamic background parts
        painter.setCompositionMode(QPainter::CompositionMode_DestinationOver);
        painter.drawImage(0, 0, m_d->staticBackground);
    }
    return bgImage;
}

References KisVisualColorModel::HSI, KisVisualColorModel::HSL, KisVisualColorModel::HSY, m_d, renderAlphaMask(), renderBackground(), renderStaticAlphaMask(), and selectorModel().

convertImageMap()

QImage KisVisualColorSelectorShape::convertImageMap ( const quint8 * rawColor, quint32 bufferSize, QSize imgSize ) const

protected

convertImageMap convert image data containing raw KoColor data into a QImage

Parameters

data	must point to memory of size width()*height()*pixelSize
size	the number of bytes to read from data, must match aforementioned criteria

Returns

the converted QImage guaranteed to match the widget size (black content on failure)

Definition at line 165 of file KisVisualColorSelectorShape.cpp.

{
    const KoColorSpace *colorSpace = selectorModel()->colorSpace();
    Q_ASSERT(bufferSize == imgSize.width() * imgSize.height() * colorSpace->pixelSize());
    const KoColorDisplayRendererInterface *renderer = colorSelector()->displayRenderer();
 
    // Convert the buffer to a qimage
    QImage image = renderer->toQImage(colorSpace, rawColor, imgSize, colorSelector()->proofColors());
 
    // safeguard:
    if (image.isNull())
    {
        image = QImage(width(), height(), QImage::Format_ARGB32);
        image.fill(Qt::black);
    }
 
    return image;
}

References colorSelector(), KisVisualColorModel::colorSpace(), KisVisualColorSelector::displayRenderer(), KoColorSpace::pixelSize(), selectorModel(), and KoColorDisplayRendererInterface::toQImage().

convertShapeCoordinateToWidgetCoordinate()

virtual QPointF KisVisualColorSelectorShape::convertShapeCoordinateToWidgetCoordinate ( QPointF ) const

privatepure virtual

convertShapeCoordinateToWidgetCoordinate

Returns

take the position in the shape and convert it to screen coordinates.

Implemented in KisVisualDiamondSelectorShape, KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, and KisVisualTriangleSelectorShape.

convertWidgetCoordinateToShapeCoordinate()

virtual QPointF KisVisualColorSelectorShape::convertWidgetCoordinateToShapeCoordinate ( QPointF coordinate ) const

privatepure virtual

convertWidgetCoordinateToShapeCoordinate Convert a coordinate in the widget's height/width to a shape coordinate.

Parameters

coordinate

the position your wish to have the shape coordinates of.

Implemented in KisVisualDiamondSelectorShape, KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, and KisVisualTriangleSelectorShape.

drawCursor()

virtual void KisVisualColorSelectorShape::drawCursor ( QPainter & painter )

privatepure virtual

Implemented in KisVisualDiamondSelectorShape, KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, and KisVisualTriangleSelectorShape.

drawGamutMask()

void KisVisualColorSelectorShape::drawGamutMask ( QPainter & painter )

privatevirtual

Reimplemented in KisVisualEllipticalSelectorShape.

Definition at line 384 of file KisVisualColorSelectorShape.cpp.

{
    // Nothing to do if gamut masks not supported
    Q_UNUSED(painter);
}

forceImageUpdate()

void KisVisualColorSelectorShape::forceImageUpdate

(

)

forceImageUpdate force the image to recache.

Definition at line 119 of file KisVisualColorSelectorShape.cpp.

{
    //qDebug() << this  << "forceImageUpdate";
    m_d->alphaNeedsUpdate = true;
    m_d->imagesNeedUpdate = true;
}

References m_d.

getColorFromConverter()

QColor KisVisualColorSelectorShape::getColorFromConverter

(

KoColor

c

)

getColorFromConverter

Parameters

c	a koColor.

Returns

get the qcolor from the given kocolorusing this widget's display renderer.

Definition at line 131 of file KisVisualColorSelectorShape.cpp.

{
    const KoColorDisplayRendererInterface *renderer = colorSelector()->displayRenderer();
    return renderer->toQColor(c, colorSelector()->proofColors());
}

References colorSelector(), KisVisualColorSelector::displayRenderer(), and KoColorDisplayRendererInterface::toQColor().

getCurrentColor()

KoColor KisVisualColorSelectorShape::getCurrentColor

(

)

getCurrentColor

Returns

the current kocolor

Definition at line 395 of file KisVisualColorSelectorShape.cpp.

{
    const KisVisualColorModel *selector = selectorModel();
    if (selector)
    {
        return selector->convertChannelValuesToKoColor(m_d->currentChannelValues);
    }
    return KoColor();
}

References KisVisualColorModel::convertChannelValuesToKoColor(), m_d, and selectorModel().

getCursorPosition()

QPointF KisVisualColorSelectorShape::getCursorPosition

(

)

const

getCursorPosition

Returns

current cursor position in shape-coordinates.

Definition at line 60 of file KisVisualColorSelectorShape.cpp.

                                                             {
    return m_d->currentCoordinates;
}

References m_d.

getDimensions()

KisVisualColorSelectorShape::Dimensions KisVisualColorSelectorShape::getDimensions

(

)

const

getDimensions

Returns

whether this is a single or twodimensional widget.

Definition at line 390 of file KisVisualColorSelectorShape.cpp.

{
    return m_d->dimension;
}

References m_d.

getImageMap()

const QImage & KisVisualColorSelectorShape::getImageMap

(

)

getImageMap returns the updated base image

Returns

the final image of the shape content, before the handle gets drawn. the pixmap will not change until a redraw is required, which depends on whether the shape is static or changes depending on other color channels.

Definition at line 151 of file KisVisualColorSelectorShape.cpp.

{
    //qDebug() << this  << ">>>>>>>>> getImageMap()" << m_d->imagesNeedUpdate;
 
    if (m_d->imagesNeedUpdate) {
        // NOTE: pure static backgrounds are currently somewhat implicitly handled,
        // it would be nicer to avoid re-checking and overwriting m_d->gradient.
        // But QImage's implicit data sharing allows all this mindless by-value stuff...
        m_d->gradient = compositeBackground();
        m_d->imagesNeedUpdate = false;
    }
    return m_d->gradient;
}

References compositeBackground(), and m_d.

getMaskMap()

virtual QRegion KisVisualColorSelectorShape::getMaskMap ( )

privatepure virtual

getPixmap

Returns

the pixmap of this shape.

Implemented in KisVisualDiamondSelectorShape, KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, and KisVisualTriangleSelectorShape.

getSpaceForCircle()

virtual QRect KisVisualColorSelectorShape::getSpaceForCircle ( QRect geom )

pure virtual

Implemented in KisVisualDiamondSelectorShape, KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, and KisVisualTriangleSelectorShape.

getSpaceForSquare()

virtual QRect KisVisualColorSelectorShape::getSpaceForSquare ( QRect geom )

pure virtual

getSpaceForSquare

Parameters

geom	the full widget rectangle

Returns

rectangle with enough space for second widget

Implemented in KisVisualDiamondSelectorShape, KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, and KisVisualTriangleSelectorShape.

getSpaceForTriangle()

virtual QRect KisVisualColorSelectorShape::getSpaceForTriangle ( QRect geom )

pure virtual

Implemented in KisVisualDiamondSelectorShape, KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, and KisVisualTriangleSelectorShape.

isHueControl()

bool KisVisualColorSelectorShape::isHueControl

(

)

const

Definition at line 107 of file KisVisualColorSelectorShape.cpp.

{
    return selectorModel()->isHSXModel()
            && getDimensions() == KisVisualColorSelectorShape::onedimensional
            && m_d->channel1 == 0;
}

References getDimensions(), KisVisualColorModel::isHSXModel(), m_d, onedimensional, and selectorModel().

mouseMoveEvent()

void KisVisualColorSelectorShape::mouseMoveEvent ( QMouseEvent * e )

overrideprotected

Definition at line 305 of file KisVisualColorSelectorShape.cpp.

{
    if (e->buttons() & Qt::LeftButton) {
        QPointF coordinates = mousePositionToShapeCoordinate(e->localPos(), m_d->dragStart);
        setCursorPosition(coordinates, true);
    } else {
        e->ignore();
    }
}

References m_d, mousePositionToShapeCoordinate(), and setCursorPosition().

mousePositionToShapeCoordinate()

QPointF KisVisualColorSelectorShape::mousePositionToShapeCoordinate ( const QPointF & pos, const QPointF & dragStart ) const

protectedvirtual

default implementation just calls convertWidgetCoordinateToShapeCoordinate(pos)

Reimplemented in KisVisualEllipticalSelectorShape.

Definition at line 286 of file KisVisualColorSelectorShape.cpp.

{
    Q_UNUSED(dragStart);
    return convertWidgetCoordinateToShapeCoordinate(pos);
}

References convertWidgetCoordinateToShapeCoordinate().

mousePressEvent()

void KisVisualColorSelectorShape::mousePressEvent ( QMouseEvent * e )

overrideprotected

Definition at line 292 of file KisVisualColorSelectorShape.cpp.

{
    if (e->button() == Qt::LeftButton) {
        m_d->dragStart = e->localPos();
        Q_EMIT colorSelector()->sigInteraction(true);
        QPointF coordinates = mousePositionToShapeCoordinate(e->localPos(), m_d->dragStart);
        setCursorPosition(coordinates, true);
    }
    else {
        e->ignore();
    }
}

References colorSelector(), m_d, mousePositionToShapeCoordinate(), setCursorPosition(), and KisVisualColorSelector::sigInteraction().

mouseReleaseEvent()

void KisVisualColorSelectorShape::mouseReleaseEvent ( QMouseEvent * e )

overrideprotected

Definition at line 315 of file KisVisualColorSelectorShape.cpp.

{
    if (e->button() == Qt::LeftButton) {
        Q_EMIT colorSelector()->sigInteraction(false);
    } else {
        e->ignore();
    }
}

References colorSelector(), and KisVisualColorSelector::sigInteraction().

paintEvent()

void KisVisualColorSelectorShape::paintEvent ( QPaintEvent * )

overrideprotected

Definition at line 360 of file KisVisualColorSelectorShape.cpp.

{
    QPainter painter(this);
 
    const QImage &fullSelector = getImageMap();
    if (!fullSelector.isNull()) {
        painter.drawImage(0, 0, fullSelector);
    }
 
    drawGamutMask(painter);
 
    if (isEnabled()) {
        painter.setRenderHint(QPainter::Antialiasing);
        drawCursor(painter);
    }
}

References drawCursor(), drawGamutMask(), and getImageMap().

renderAlphaMask()

QImage KisVisualColorSelectorShape::renderAlphaMask ( ) const

protectedvirtual

render the alpha mask for the widget background the returned image is expected to be QImage::Format_Alpha8

Reimplemented in KisVisualDiamondSelectorShape, KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, and KisVisualTriangleSelectorShape.

Definition at line 276 of file KisVisualColorSelectorShape.cpp.

{
    return QImage();
}

renderBackground()

QImage KisVisualColorSelectorShape::renderBackground ( const QVector4D & channelValues, const QImage & alpha ) const

protectedvirtual

renderBackground Render the widget background visible inside the widget's mask in current color space Rendering shall be done with the conversion functions of KisVisualColorSelector

Parameters

data	points to zero-initialized memory of size width()*height()*pixelSize
pixelSize	the data size to transfer from KoColor::data() to data per pixel in the current color space
channelValues	the normalized channel values of the currently selected color

Definition at line 184 of file KisVisualColorSelectorShape.cpp.

{
    const KisVisualColorModel *selector = selectorModel();
    Q_ASSERT(selector);
 
    // Hi-DPI aware rendering requires that we determine the device pixel dimension;
    // actual widget size in device pixels is not accessible unfortunately, it might be 1px smaller...
    const qreal deviceDivider = 1.0 / devicePixelRatioF();
    const int deviceWidth = qCeil(width() * devicePixelRatioF());
    const int deviceHeight = qCeil(height() * devicePixelRatioF());
    quint32 imageSize = deviceWidth * deviceHeight * selector->colorSpace()->pixelSize();
    QScopedArrayPointer<quint8> raw(new quint8[imageSize] {});
    quint8 *dataPtr = raw.data();
    QVector4D coordinates = channelValues;
    const qsizetype pixelSize = selector->colorSpace()->pixelSize();
 
    bool checkAlpha = !alpha.isNull() && alpha.valid(deviceWidth - 1, deviceHeight - 1);
    KIS_SAFE_ASSERT_RECOVER(!checkAlpha || alpha.format() == QImage::Format_Alpha8) {
        checkAlpha = false;
    }
 
    KoColor filler(Qt::white, selector->colorSpace());
    for (int y = 0; y < deviceHeight; y++) {
        const uchar *alphaLine = checkAlpha ? alpha.scanLine(y) : 0;
        for (int x=0; x < deviceWidth; x++) {
            if (!checkAlpha || alphaLine[x]) {
                QPointF newcoordinate = convertWidgetCoordinateToShapeCoordinate(QPointF(x, y) * deviceDivider);
                coordinates[m_d->channel1] = newcoordinate.x();
                if (m_d->dimension == Dimensions::twodimensional) {
                    coordinates[m_d->channel2] = newcoordinate.y();
                }
                KoColor c = selector->convertChannelValuesToKoColor(coordinates);
                memcpy(dataPtr, c.data(), pixelSize);
            }
            else {
                // need to write a color with non-zero alpha, otherwise the display converter
                // will for some arcane reason crop the final QImage and screw rendering
                memcpy(dataPtr, filler.data(), pixelSize);
            }
            dataPtr += pixelSize;
        }
    }
    QImage image = convertImageMap(raw.data(), imageSize, QSize(deviceWidth, deviceHeight));
    image.setDevicePixelRatio(devicePixelRatioF());
 
    if (!alpha.isNull()) {
        QPainter painter(&image);
        // transfer alphaMask to Alpha channel
        painter.setCompositionMode(QPainter::CompositionMode_DestinationIn);
        painter.drawImage(0, 0, alpha);
    }
 
    return image;
}

References KisVisualColorModel::colorSpace(), KisVisualColorModel::convertChannelValuesToKoColor(), convertImageMap(), convertWidgetCoordinateToShapeCoordinate(), KoColor::data(), KIS_SAFE_ASSERT_RECOVER, m_d, KoColorSpace::pixelSize(), selectorModel(), and twodimensional.

renderStaticAlphaMask()

QImage KisVisualColorSelectorShape::renderStaticAlphaMask ( ) const

protectedvirtual

Reimplemented in KisVisualEllipticalSelectorShape.

Definition at line 281 of file KisVisualColorSelectorShape.cpp.

{
    return QImage();
}

resizeEvent()

void KisVisualColorSelectorShape::resizeEvent ( QResizeEvent * )

overrideprotected

Definition at line 377 of file KisVisualColorSelectorShape.cpp.

{
    forceImageUpdate();
    updateGamutMask();
    setMask(getMaskMap());
}

References forceImageUpdate(), getMaskMap(), and updateGamutMask().

selectorModel()

KisVisualColorModel * KisVisualColorSelectorShape::selectorModel ( ) const

protected

Definition at line 144 of file KisVisualColorSelectorShape.cpp.

{
    KisVisualColorSelector* selectorWidget = qobject_cast<KisVisualColorSelector*>(parent());
    KIS_ASSERT(selectorWidget);
    return selectorWidget->selectorModel().data();
}

References KIS_ASSERT, and KisVisualColorSelector::selectorModel().

setAcceptTabletEvents()

void KisVisualColorSelectorShape::setAcceptTabletEvents

(

bool

on

)

Definition at line 102 of file KisVisualColorSelectorShape.cpp.

{
    m_d->acceptTabletEvents = on;
}

References m_d.

setBorderWidth()

virtual void KisVisualColorSelectorShape::setBorderWidth ( int width )

pure virtual

setBorderWidth set the border of the single dimensional selector.

Parameters

width

Implemented in KisVisualEllipticalSelectorShape, KisVisualRectangleSelectorShape, KisVisualDiamondSelectorShape, and KisVisualTriangleSelectorShape.

setChannelValues()

void KisVisualColorSelectorShape::setChannelValues	(	QVector4D	channelValues,
		quint32	channelFlags )

setChannelValues Set the current channel values; Note that channel values controlled by the shape itself have no effect unless setCursor is true. This will trigger a full widget repaint.

Parameters

position	normalized shape coordinates ([0,1] range) these are not yet transformed to color space specific ranges!
setCursor	if true, sets the cursor too, otherwise the shape-controlled channels are not set

Definition at line 82 of file KisVisualColorSelectorShape.cpp.

{
    //qDebug() << this  << "setChannelValues";
    m_d->currentChannelValues = channelValues;
    bool setCursor = channelFlags & m_d->channelMask;
    if (setCursor) {
        m_d->currentCoordinates = QPointF(qBound(0.f, channelValues[m_d->channel1], 1.f),
                                          qBound(0.f, channelValues[m_d->channel2], 1.f));
    }
    else {
        // for internal consistency, because we have a bit of redundancy here
        m_d->currentChannelValues[m_d->channel1] = m_d->currentCoordinates.x();
        if (m_d->dimension == Dimensions::twodimensional){
            m_d->currentChannelValues[m_d->channel2] = m_d->currentCoordinates.y();
        }
    }
    m_d->imagesNeedUpdate = m_d->imagesNeedUpdate || channelFlags & ~m_d->channelMask;
    update();
}

References m_d, and twodimensional.

setCursorPosition()

void KisVisualColorSelectorShape::setCursorPosition	(	QPointF	position,
		bool	signal = false )

setCursorPosition Set the cursor to normalized shape coordinates. This will only repaint the cursor.

Parameters

position	normalized shape coordinates ([0,1] range, not yet transformed to actual channel values!)
signal	if true, Q_EMIT a sigCursorMoved signal

Definition at line 64 of file KisVisualColorSelectorShape.cpp.

{
    QPointF newPos(qBound(0.0, position.x(), 1.0), qBound(0.0, position.y(), 1.0));
    if (newPos != m_d->currentCoordinates)
    {
        m_d->currentCoordinates = newPos;
        // for internal consistency, because we have a bit of redundancy here
        m_d->currentChannelValues[m_d->channel1] = newPos.x();
        if (m_d->dimension == Dimensions::twodimensional){
            m_d->currentChannelValues[m_d->channel2] = newPos.y();
        }
        update();
        if (signal){
            Q_EMIT sigCursorMoved(newPos);
        }
    }
}

References m_d, sigCursorMoved(), and twodimensional.

sigCursorMoved

void KisVisualColorSelectorShape::sigCursorMoved ( QPointF pos )

signal

supportsGamutMask()

bool KisVisualColorSelectorShape::supportsGamutMask ( ) const

virtual

Reimplemented in KisVisualEllipticalSelectorShape.

Definition at line 114 of file KisVisualColorSelectorShape.cpp.

{
    return false;
}

tabletEvent()

void KisVisualColorSelectorShape::tabletEvent ( QTabletEvent * event )

overrideprotected

Definition at line 324 of file KisVisualColorSelectorShape.cpp.

{
    // only accept tablet events that are associated to "left" button
    // NOTE: QTabletEvent does not have a windowPos() equivalent, but we don't need it
    if (m_d->acceptTabletEvents &&
        (event->button() == Qt::LeftButton || (event->buttons() & Qt::LeftButton)))
    {
        event->accept();
        switch (event->type()) {
        case  QEvent::TabletPress: {
            QMouseEvent mouseEvent(QEvent::MouseButtonPress, event->posF(), event->posF(),
                                   event->globalPosF(), event->button(), event->buttons(),
                                   event->modifiers(), Qt::MouseEventSynthesizedByApplication);
            mousePressEvent(&mouseEvent);
            break;
        }
        case QEvent::TabletMove: {
            QMouseEvent mouseEvent(QEvent::MouseMove, event->posF(), event->posF(),
                                   event->globalPosF(), event->button(), event->buttons(),
                                   event->modifiers(), Qt::MouseEventSynthesizedByApplication);
            mouseMoveEvent(&mouseEvent);
            break;
        }
        case QEvent::TabletRelease: {
            QMouseEvent mouseEvent(QEvent::MouseButtonRelease, event->posF(), event->posF(),
                                   event->globalPosF(), event->button(), event->buttons(),
                                   event->modifiers(), Qt::MouseEventSynthesizedByApplication);
            mouseReleaseEvent(&mouseEvent);
            break;
        }
        default:
            event->ignore();
        }
    }
}

References m_d, mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

updateGamutMask()

void KisVisualColorSelectorShape::updateGamutMask ( )

virtual

Notify shape that the gamut mask changed.

The gamut mask shall be updated and the widget repainted if necessary. This includes removal of gamut masks

Reimplemented in KisVisualEllipticalSelectorShape.

Definition at line 126 of file KisVisualColorSelectorShape.cpp.

{
    // Nothing to do if gamut masks not supported
}

Member Data Documentation

m_d

const QScopedPointer<Private> KisVisualColorSelectorShape::m_d

private

Definition at line 185 of file KisVisualColorSelectorShape.h.

---

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

• libs/widgets/KisVisualColorSelectorShape.h
• libs/widgets/KisVisualColorSelectorShape.cpp