KisToolSelectContiguous Class Reference

#include <kis_tool_select_contiguous.h>

Inheritance diagram for KisToolSelectContiguous:

Public Types
enum	ContiguousSelectionMode { FloodFill , BoundaryFill }
Public Types inherited from KisToolSelectBase< BaseClass >
enum	SampleLayersMode { SampleAllLayers , SampleCurrentLayer , SampleColorLabeledLayers }

Public Slots
void	activate (const QSet< KoShape * > &shapes) override
void	deactivate () override
void	slotSetCloseGap (int)
void	slotSetContiguousSelectionBoundaryColor (const KoColor &)
void	slotSetContiguousSelectionMode (ContiguousSelectionMode)
void	slotSetOpacitySpread (int)
void	slotSetThreshold (int)
void	slotSetUseSelectionAsBoundary (bool)

Public Member Functions
void	beginPrimaryAction (KoPointerEvent *event) override
QWidget *	createOptionWidget () override
void	endPrimaryAction (KoPointerEvent *event) override
	KisToolSelectContiguous (KoCanvasBase *canvas)
void	paint (QPainter &painter, const KoViewConverter &converter) override
void	resetCursorStyle () override
	~KisToolSelectContiguous () override
Public Member Functions inherited from KisToolSelectBase< BaseClass >
void	activate (const QSet< KoShape * > &shapes) override
void	activateAlternateAction (KisTool::AlternateAction action) override
SelectionAction	alternateSelectionAction () const
bool	antiAliasSelection () const
void	beginAlternateAction (KoPointerEvent *event, KisTool::AlternateAction action) override
bool	beginMoveSelectionInteraction ()
void	beginPrimaryAction (KoPointerEvent *event) override
bool	beginSelectInteraction ()
QList< int >	colorLabelsSelected () const
void	continueAlternateAction (KoPointerEvent *event, KisTool::AlternateAction action) override
void	continuePrimaryAction (KoPointerEvent *event) override
QWidget *	createOptionWidget () override
void	deactivate () override
void	deactivateAlternateAction (KisTool::AlternateAction action) override
void	endAlternateAction (KoPointerEvent *event, KisTool::AlternateAction action) override
bool	endMoveSelectionInteraction ()
void	endPrimaryAction (KoPointerEvent *event) override
bool	endSelectInteraction ()
int	featherSelection () const
int	growSelection () const
bool	isMovingSelection () const
bool	isSelecting () const
void	keyPressEvent (QKeyEvent *event) override
void	keyReleaseEvent (QKeyEvent *event) override
	KisToolSelectBase (KoCanvasBase *canvas, const QCursor cursor, const QString toolName)
	KisToolSelectBase (KoCanvasBase *canvas, const QString toolName)
	KisToolSelectBase (KoCanvasBase *canvas, QCursor cursor, QString toolName, KoToolBase *delegateTool)
KisNodeSP	locateSelectionMaskUnderCursor (const QPointF &pos, Qt::KeyboardModifiers modifiers)
void	mouseMoveEvent (KoPointerEvent *event) override
QMenu *	popupActionsMenu () override
KisPopupWidgetInterface *	popupWidget () override
SampleLayersMode	sampleLayersMode () const
SelectionAction	selectionAction () const
bool	selectionDidMove () const
SelectionMode	selectionMode () const
KisSelectionOptions *	selectionOptionWidget ()
virtual void	setAlternateSelectionAction (SelectionAction action)
bool	stopGrowingAtDarkestPixel () const
void	updateActionShortcutToolTips ()
void	updateCursorDelayed ()

Protected Member Functions
bool	isPixelOnly () const override
bool	usesColorLabels () const override
bool	wantsAutoScroll () const override

Protected Attributes
KisSelectionToolConfigWidgetHelper	m_widgetHelper
Protected Attributes inherited from KisToolSelectBase< BaseClass >
SelectionAction	m_selectionActionAlternate
KisSelectionToolConfigWidgetHelper	m_widgetHelper

Private Slots
void	slot_optionButtonStripContiguousSelectionMode_buttonToggled (KoGroupButton *, bool)

Private Member Functions
KoColor	loadContiguousSelectionBoundaryColorFromConfig ()

Private Attributes
int	m_closeGap {0}
KConfigGroup	m_configGroup
KoColor	m_contiguousSelectionBoundaryColor
ContiguousSelectionMode	m_contiguousSelectionMode {FloodFill}
int	m_opacitySpread {100}
int	m_previousTime
KisMergeLabeledLayersCommand::ReferenceNodeInfoListSP	m_referenceNodeList
KisPaintDeviceSP	m_referencePaintDevice
int	m_threshold {8}
bool	m_useSelectionAsBoundary {false}

Detailed Description

The 'magic wand' selection tool – in fact just a floodfill that only creates a selection.

Definition at line 27 of file kis_tool_select_contiguous.h.

Member Enumeration Documentation

ContiguousSelectionMode

enum KisToolSelectContiguous::ContiguousSelectionMode

Enumerator
FloodFill
BoundaryFill

Definition at line 33 of file kis_tool_select_contiguous.h.

    {
        FloodFill,
        BoundaryFill
    };

Constructor & Destructor Documentation

KisToolSelectContiguous()

KisToolSelectContiguous::KisToolSelectContiguous

(

KoCanvasBase *

canvas

)

Definition at line 55 of file kis_tool_select_contiguous.cc.

    : KisToolSelect(
        canvas,
        KisCursor::load("tool_contiguous_selection_cursor.png", 6, 6),
        i18n("Contiguous Area Selection"))
    , m_threshold(8)
    , m_opacitySpread(100)
    , m_useSelectionAsBoundary(false)
    , m_previousTime(0)
{
    setObjectName("tool_select_contiguous");
}

~KisToolSelectContiguous()

KisToolSelectContiguous::~KisToolSelectContiguous ( )

override

Definition at line 68 of file kis_tool_select_contiguous.cc.

{
}

Member Function Documentation

activate

void KisToolSelectContiguous::activate ( const QSet< KoShape * > & shapes )

overrideslot

Definition at line 72 of file kis_tool_select_contiguous.cc.

{
    KisToolSelect::activate(shapes);
    m_configGroup =  KSharedConfig::openConfig()->group(toolId());
}

References KisToolSelectBase< BaseClass >::activate(), and m_configGroup.

beginPrimaryAction()

void KisToolSelectContiguous::beginPrimaryAction ( KoPointerEvent * event )

override

Definition at line 85 of file kis_tool_select_contiguous.cc.

{
    KisToolSelectBase::beginPrimaryAction(event);
    if (isMovingSelection()) {
        return;
    }
 
    KisPaintDeviceSP dev;
 
    if (!currentNode() ||
        !(dev = currentNode()->projection()) ||
        !selectionEditable()) {
        event->ignore();
        return;
    }
 
    beginSelectInteraction();
 
    KisCursorOverrideLock cursorLock(KisCursor::waitCursor());
 
    // -------------------------------
 
    KisProcessingApplicator applicator(currentImage(), currentNode(),
                                       KisProcessingApplicator::NONE,
                                       KisImageSignalVector(),
                                       kundo2_i18n("Select Contiguous Area"));
 
    QPoint pos = convertToImagePixelCoordFloored(event);
    QRect rc = currentImage()->bounds();
 
    KisPaintDeviceSP sourceDevice;
 
    if (sampleLayersMode() == SampleCurrentLayer) {
        sourceDevice = m_referencePaintDevice = dev;
    } else if (sampleLayersMode() == SampleAllLayers) {
        sourceDevice = m_referencePaintDevice = currentImage()->projection();
    } else if (sampleLayersMode() == SampleColorLabeledLayers) {
        if (!m_referenceNodeList) {
            m_referencePaintDevice = KisMergeLabeledLayersCommand::createRefPaintDevice(image(), "Contiguous Selection Tool Reference Result Paint Device");
            m_referenceNodeList.reset(new KisMergeLabeledLayersCommand::ReferenceNodeInfoList);
        }
        KisPaintDeviceSP newReferencePaintDevice = KisMergeLabeledLayersCommand::createRefPaintDevice(image(), "Contiguous Selection Tool Reference Result Paint Device");
        KisMergeLabeledLayersCommand::ReferenceNodeInfoListSP newReferenceNodeList(new KisMergeLabeledLayersCommand::ReferenceNodeInfoList);
        const int currentTime = image()->animationInterface()->currentTime();
        applicator.applyCommand(
            new KisMergeLabeledLayersCommand(
                image(),
                m_referenceNodeList,
                newReferenceNodeList,
                m_referencePaintDevice,
                newReferencePaintDevice,
                colorLabelsSelected(),
                KisMergeLabeledLayersCommand::GroupSelectionPolicy_SelectIfColorLabeled,
                m_previousTime != currentTime
            ),
            KisStrokeJobData::SEQUENTIAL,
            KisStrokeJobData::EXCLUSIVE
        );
        sourceDevice = m_referencePaintDevice = newReferencePaintDevice;
        m_referenceNodeList = newReferenceNodeList;
        m_previousTime = currentTime;
    }
 
    if (sampleLayersMode() != SampleColorLabeledLayers) {
        // Reset this so that the device from color labeled layers gets
        // regenerated when that mode is selected again
        m_referenceNodeList.reset();
    }
 
    KisPixelSelectionSP selection =
        new KisPixelSelection(new KisSelectionDefaultBounds(dev));
 
    ContiguousSelectionMode contiguousSelectionMode = m_contiguousSelectionMode;
    KoColor contiguousSelectionBoundaryColor = m_contiguousSelectionBoundaryColor;
    int threshold = m_threshold;
    int opacitySpread = m_opacitySpread;
    int closeGap = m_closeGap;
    bool useSelectionAsBoundary = m_useSelectionAsBoundary;
    bool antiAlias = antiAliasSelection();
    int grow = growSelection();
    bool stopGrowingAtDarkestPixel = this->stopGrowingAtDarkestPixel();
    int feather = featherSelection();
 
    KisCanvas2 * kisCanvas = dynamic_cast<KisCanvas2*>(canvas());
    KIS_SAFE_ASSERT_RECOVER(kisCanvas) {
        applicator.cancel();
        return;
    };
 
    KisPixelSelectionSP existingSelection;
    if (kisCanvas->imageView() && kisCanvas->imageView()->selection())
    {
        existingSelection = kisCanvas->imageView()->selection()->pixelSelection();
    }
 
    KUndo2Command
        *cmd =
            new KisCommandUtils::LambdaCommand(
                [dev,
                 rc,
                 contiguousSelectionMode,
                 contiguousSelectionBoundaryColor,
                 threshold,
                 opacitySpread,
                 closeGap,
                 antiAlias,
                 feather,
                 grow,
                 stopGrowingAtDarkestPixel,
                 useSelectionAsBoundary,
                 selection,
                 pos,
                 sourceDevice,
                 existingSelection]() mutable -> KUndo2Command * {
                    KisFillPainter fillpainter(dev);
                    fillpainter.setHeight(rc.height());
                    fillpainter.setWidth(rc.width());
                    fillpainter.setRegionFillingMode(
                        contiguousSelectionMode == FloodFill
                        ? KisFillPainter::RegionFillingMode_FloodFill
                        : KisFillPainter::RegionFillingMode_BoundaryFill
                    );
                    if (contiguousSelectionMode == BoundaryFill) {
                        fillpainter.setRegionFillingBoundaryColor(contiguousSelectionBoundaryColor);
                    }
                    fillpainter.setFillThreshold(threshold);
                    fillpainter.setOpacitySpread(opacitySpread);
                    fillpainter.setAntiAlias(antiAlias);
                    fillpainter.setFeather(feather);
                    fillpainter.setCloseGap(closeGap);
                    fillpainter.setSizemod(grow);
                    fillpainter.setStopGrowingAtDarkestPixel(stopGrowingAtDarkestPixel);
                    fillpainter.setUseCompositing(true);
 
                    useSelectionAsBoundary &=
                        existingSelection &&
                        !existingSelection->isEmpty() &&
                        existingSelection->pixel(pos).opacityU8() != OPACITY_TRANSPARENT_U8;
 
                    fillpainter.setUseSelectionAsBoundary(useSelectionAsBoundary);
                    fillpainter.createFloodSelection(selection, pos.x(), pos.y(), sourceDevice, existingSelection);
 
                    selection->invalidateOutlineCache();
 
                    return 0;
                });
    applicator.applyCommand(cmd, KisStrokeJobData::BARRIER);
 
 
 
    KisSelectionToolHelper helper(kisCanvas, kundo2_i18n("Select Contiguous Area"));
 
    helper.selectPixelSelection(applicator, selection, selectionAction());
 
    applicator.end();
 
}

References KisToolSelectBase< BaseClass >::antiAliasSelection(), KisProcessingApplicator::applyCommand(), KisStrokeJobData::BARRIER, KisToolSelectBase< BaseClass >::beginPrimaryAction(), KisToolSelectBase< BaseClass >::beginSelectInteraction(), BoundaryFill, KisProcessingApplicator::cancel(), KisToolSelectBase< BaseClass >::colorLabelsSelected(), KisFillPainter::createFloodSelection(), KisMergeLabeledLayersCommand::createRefPaintDevice(), KisProcessingApplicator::end(), KisStrokeJobData::EXCLUSIVE, KisToolSelectBase< BaseClass >::featherSelection(), FloodFill, KisMergeLabeledLayersCommand::GroupSelectionPolicy_SelectIfColorLabeled, KisToolSelectBase< BaseClass >::growSelection(), KisCanvas2::imageView(), KisPixelSelection::invalidateOutlineCache(), KisPixelSelection::isEmpty(), KisToolSelectBase< BaseClass >::isMovingSelection(), KIS_SAFE_ASSERT_RECOVER, kundo2_i18n(), m_closeGap, m_contiguousSelectionBoundaryColor, m_contiguousSelectionMode, m_opacitySpread, m_previousTime, m_referenceNodeList, m_referencePaintDevice, m_threshold, m_useSelectionAsBoundary, KisProcessingApplicator::NONE, OPACITY_TRANSPARENT_U8, KisPaintDevice::pixel(), KisFillPainter::RegionFillingMode_BoundaryFill, KisFillPainter::RegionFillingMode_FloodFill, KisToolSelectBase< BaseClass >::SampleAllLayers, KisToolSelectBase< BaseClass >::SampleColorLabeledLayers, KisToolSelectBase< BaseClass >::SampleCurrentLayer, KisToolSelectBase< BaseClass >::sampleLayersMode(), KisToolSelectBase< BaseClass >::selectionAction(), KisSelectionToolHelper::selectPixelSelection(), KisStrokeJobData::SEQUENTIAL, KisFillPainter::setAntiAlias(), KisFillPainter::setCloseGap(), KisFillPainter::setFeather(), KisFillPainter::setFillThreshold(), KisFillPainter::setHeight(), KisFillPainter::setOpacitySpread(), KisFillPainter::setRegionFillingBoundaryColor(), KisFillPainter::setRegionFillingMode(), KisFillPainter::setSizemod(), KisFillPainter::setStopGrowingAtDarkestPixel(), KisFillPainter::setUseCompositing(), KisFillPainter::setUseSelectionAsBoundary(), KisFillPainter::setWidth(), KisToolSelectBase< BaseClass >::stopGrowingAtDarkestPixel(), and KisCursor::waitCursor().

createOptionWidget()

QWidget * KisToolSelectContiguous::createOptionWidget ( )

override

Definition at line 355 of file kis_tool_select_contiguous.cc.

{
    KisToolSelectBase::createOptionWidget();
    KisSelectionOptions *selectionWidget = selectionOptionWidget();
 
    selectionWidget->setStopGrowingAtDarkestPixelButtonVisible(true);
 
    // Create widgets
    KisOptionButtonStrip *optionButtonStripContiguousSelectionMode =
        new KisOptionButtonStrip;
    KoGroupButton *buttonContiguousSelectionModeFloodFill =
        optionButtonStripContiguousSelectionMode->addButton(
            KisIconUtils::loadIcon("region-filling-flood-fill")
        );
    KoGroupButton *buttonContiguousSelectionModeBoundaryFill =
        optionButtonStripContiguousSelectionMode->addButton(
            KisIconUtils::loadIcon("region-filling-boundary-fill")
        );
    buttonContiguousSelectionModeFloodFill->setChecked(true);
    KisColorButton *buttonContiguousSelectionBoundaryColor = new KisColorButton;
    KisSliderSpinBox *sliderThreshold = new KisSliderSpinBox;
    sliderThreshold->setPrefix(i18nc(
        "The 'threshold' spinbox prefix in contiguous selection tool options",
        "Threshold: "));
    sliderThreshold->setRange(1, 100);
    KisSliderSpinBox *sliderSpread = new KisSliderSpinBox;
    sliderSpread->setRange(0, 100);
    KisSpinBoxI18nHelper::setText(
        sliderSpread,
        i18nc(
            "The 'spread' spinbox in contiguous selection tool options; {n} is the number value, % is the percent sign",
            "Spread: {n}%"));
    QCheckBox *checkBoxSelectionAsBoundary = new QCheckBox(i18nc(
        "The 'use selection as boundary' checkbox in contiguous selection tool "
        "to use selection borders as boundary when filling",
        "Use selection as boundary"));
    checkBoxSelectionAsBoundary->setSizePolicy(QSizePolicy::Ignored,
                                               QSizePolicy::Preferred);
 
    // Set the tooltips
    buttonContiguousSelectionModeFloodFill->setToolTip(
        i18n("Select regions similar in color to the clicked region"));
    buttonContiguousSelectionModeBoundaryFill->setToolTip(
        i18n("Select all regions until a specific boundary color"));
    buttonContiguousSelectionBoundaryColor->setToolTip(i18n("Boundary color"));
    sliderThreshold->setToolTip(
        i18n("Set the color similarity tolerance of the selection. "
             "Increasing threshold increases the range of similar colors to be selected."));
    sliderSpread->setToolTip(i18n(
        "Set the extent of the opaque portion of the selection. "
        "Decreasing spread decreases opacity of selection areas depending on color similarity."));
    checkBoxSelectionAsBoundary->setToolTip(
        i18n("Set if the contour of the active selection should be treated as "
             "a boundary when making a new selection"));
 
 
    KisSliderSpinBox *sliderCloseGap = new KisSliderSpinBox;
    sliderCloseGap->setPrefix(i18nc("The 'close gap' spinbox prefix in contiguous selection tool options", "Close Gap: "));
    sliderCloseGap->setRange(0, 32);
    sliderCloseGap->setSuffix(i18n(" px"));
 
    // Construct the option widget
    KisOptionCollectionWidgetWithHeader *sectionSelectionExtent =
        new KisOptionCollectionWidgetWithHeader(
            i18nc("The 'selection extent' section label in contiguous "
                  "selection tool options",
                  "Selection extent"));
    sectionSelectionExtent->setPrimaryWidget(
        optionButtonStripContiguousSelectionMode
    );
    sectionSelectionExtent->appendWidget(
        "buttonContiguousSelectionBoundaryColor",
        buttonContiguousSelectionBoundaryColor
    );
    sectionSelectionExtent->setWidgetVisible(
        "buttonContiguousSelectionBoundaryColor",
        false
    );
    sectionSelectionExtent->appendWidget("sliderThreshold", sliderThreshold);
    sectionSelectionExtent->appendWidget("sliderSpread", sliderSpread);
    sectionSelectionExtent->appendWidget("sliderCloseGap", sliderCloseGap);
    sectionSelectionExtent->appendWidget("checkBoxSelectionAsBoundary",
                                         checkBoxSelectionAsBoundary);
 
    selectionWidget->insertWidget(3,
                                  "sectionSelectionExtent",
                                  sectionSelectionExtent);
 
    // Load configuration settings into tool options
    const QString contiguousSelectionModeStr =
        m_configGroup.readEntry<QString>("contiguousSelectionMode", "");
    m_contiguousSelectionMode =
        contiguousSelectionModeStr == "boundaryFill"
        ? BoundaryFill
        : FloodFill;
    m_contiguousSelectionBoundaryColor =
        loadContiguousSelectionBoundaryColorFromConfig();
    if (m_configGroup.hasKey("threshold")) {
        m_threshold = m_configGroup.readEntry("threshold", 8);
    } else {
        m_threshold = m_configGroup.readEntry("fuzziness", 8);
    }
    m_opacitySpread = m_configGroup.readEntry("opacitySpread", 100);
    m_closeGap = m_configGroup.readEntry("closeGapAmount", 0);
    m_useSelectionAsBoundary =
        m_configGroup.readEntry("useSelectionAsBoundary", false);
 
    if (m_contiguousSelectionMode == BoundaryFill) {
        buttonContiguousSelectionModeBoundaryFill->setChecked(true);
        sectionSelectionExtent->setWidgetVisible(
            "buttonContiguousSelectionBoundaryColor",
            true
        );
    }
    buttonContiguousSelectionBoundaryColor->setColor(
        m_contiguousSelectionBoundaryColor
    );
    sliderThreshold->setValue(m_threshold);
    sliderSpread->setValue(m_opacitySpread);
    sliderCloseGap->setValue(m_closeGap);
    checkBoxSelectionAsBoundary->setChecked(m_useSelectionAsBoundary);
 
    // Make connections
    connect(optionButtonStripContiguousSelectionMode,
            SIGNAL(buttonToggled(KoGroupButton*, bool)),
            SLOT(slot_optionButtonStripContiguousSelectionMode_buttonToggled(
                    KoGroupButton*, bool)));
    connect(buttonContiguousSelectionBoundaryColor,
            SIGNAL(changed(const KoColor&)),
            SLOT(slotSetContiguousSelectionBoundaryColor(const KoColor&)));
    connect(sliderThreshold,
            SIGNAL(valueChanged(int)),
            this,
            SLOT(slotSetThreshold(int)));
    connect(sliderSpread,
            SIGNAL(valueChanged(int)),
            this,
            SLOT(slotSetOpacitySpread(int)));
    connect(sliderCloseGap,
            SIGNAL(valueChanged(int)),
            this,
            SLOT(slotSetCloseGap(int)));
    connect(checkBoxSelectionAsBoundary,
            SIGNAL(toggled(bool)),
            this,
            SLOT(slotSetUseSelectionAsBoundary(bool)));
 
    return selectionWidget;
}

References KisOptionButtonStrip::addButton(), KisOptionCollectionWidgetWithHeader::appendWidget(), BoundaryFill, connect(), KisToolSelectBase< BaseClass >::createOptionWidget(), FloodFill, KisOptionCollectionWidget::insertWidget(), loadContiguousSelectionBoundaryColorFromConfig(), KisIconUtils::loadIcon(), m_closeGap, m_configGroup, m_contiguousSelectionBoundaryColor, m_contiguousSelectionMode, m_opacitySpread, m_threshold, m_useSelectionAsBoundary, KisToolSelectBase< BaseClass >::selectionOptionWidget(), KisColorButton::setColor(), KisOptionCollectionWidgetWithHeader::setPrimaryWidget(), KisSliderSpinBox::setRange(), KisSelectionOptions::setStopGrowingAtDarkestPixelButtonVisible(), KisSpinBoxI18nHelper::setText(), KisSliderSpinBox::setValue(), KisOptionCollectionWidgetWithHeader::setWidgetVisible(), slot_optionButtonStripContiguousSelectionMode_buttonToggled(), slotSetCloseGap(), slotSetContiguousSelectionBoundaryColor(), slotSetOpacitySpread(), slotSetThreshold(), and slotSetUseSelectionAsBoundary().

deactivate

void KisToolSelectContiguous::deactivate ( )

overrideslot

Definition at line 78 of file kis_tool_select_contiguous.cc.

{
    m_referencePaintDevice = nullptr;
    m_referenceNodeList = nullptr;
    KisToolSelect::deactivate();
}

References KisToolSelectBase< BaseClass >::deactivate(), m_referenceNodeList, and m_referencePaintDevice.

endPrimaryAction()

void KisToolSelectContiguous::endPrimaryAction ( KoPointerEvent * event )

override

Definition at line 243 of file kis_tool_select_contiguous.cc.

{
    if (isMovingSelection()) {
        KisToolSelectBase::endPrimaryAction(event);
        return;
    }
 
    endSelectInteraction();
}

References KisToolSelectBase< BaseClass >::endPrimaryAction(), KisToolSelectBase< BaseClass >::endSelectInteraction(), and KisToolSelectBase< BaseClass >::isMovingSelection().

isPixelOnly()

bool KisToolSelectContiguous::isPixelOnly ( ) const

inlineoverrideprotectedvirtual

Reimplemented from KisToolSelectBase< BaseClass >.

Definition at line 54 of file kis_tool_select_contiguous.h.

{ return true; }

loadContiguousSelectionBoundaryColorFromConfig()

KoColor KisToolSelectContiguous::loadContiguousSelectionBoundaryColorFromConfig ( )

private

Definition at line 334 of file kis_tool_select_contiguous.cc.

{
    const QString xmlColor =
        m_configGroup.readEntry("contiguousSelectionBoundaryColor", QString());
    QDomDocument doc;
    if (doc.setContent(xmlColor)) {
        QDomElement e = doc.documentElement().firstChild().toElement();
        QString channelDepthID =
            doc.documentElement().attribute("channeldepth",
                                            Integer16BitsColorDepthID.id());
        bool ok;
        if (e.hasAttribute("space") || e.tagName().toLower() == "srgb") {
            return KoColor::fromXML(e, channelDepthID, &ok);
        } else if (doc.documentElement().hasAttribute("space") ||
                   doc.documentElement().tagName().toLower() == "srgb") {
            return KoColor::fromXML(doc.documentElement(), channelDepthID, &ok);
        }
    }
    return KoColor();
}

References KoColor::fromXML(), KoID::id(), Integer16BitsColorDepthID, and m_configGroup.

paint()

void KisToolSelectContiguous::paint ( QPainter & painter, const KoViewConverter & converter )

override

Definition at line 253 of file kis_tool_select_contiguous.cc.

{
    Q_UNUSED(painter);
    Q_UNUSED(converter);
}

resetCursorStyle()

void KisToolSelectContiguous::resetCursorStyle ( )

override

Definition at line 505 of file kis_tool_select_contiguous.cc.

{
    if (selectionAction() == SELECTION_ADD) {
        useCursor(KisCursor::load("tool_contiguous_selection_cursor_add.png", 6, 6));
    } else if (selectionAction() == SELECTION_SUBTRACT) {
        useCursor(KisCursor::load("tool_contiguous_selection_cursor_sub.png", 6, 6));
    } else if (selectionAction() == SELECTION_INTERSECT) {
        useCursor(KisCursor::load("tool_contiguous_selection_cursor_inter.png", 6, 6));
    } else if (selectionAction() == SELECTION_SYMMETRICDIFFERENCE) {
        useCursor(KisCursor::load("tool_contiguous_selection_cursor_symdiff.png", 6, 6));
    } else {
        KisToolSelect::resetCursorStyle();
    }
}

References KisCursor::load(), SELECTION_ADD, SELECTION_INTERSECT, SELECTION_SUBTRACT, SELECTION_SYMMETRICDIFFERENCE, and KisToolSelectBase< BaseClass >::selectionAction().

slot_optionButtonStripContiguousSelectionMode_buttonToggled

void KisToolSelectContiguous::slot_optionButtonStripContiguousSelectionMode_buttonToggled ( KoGroupButton * button, bool checked )

privateslot

Definition at line 308 of file kis_tool_select_contiguous.cc.

{
    if (!checked) {
        return;
    }
 
    KisOptionCollectionWidgetWithHeader *sectionSelectionExtent =
        selectionOptionWidget()->widgetAs<KisOptionCollectionWidgetWithHeader*>(
            "sectionSelectionExtent"
        );
    const KoGroupButton *buttonContiguousSelectionModeBoundaryFill =
        sectionSelectionExtent->primaryWidgetAs<KisOptionButtonStrip*>()->button(1);
    const bool visible = button == buttonContiguousSelectionModeBoundaryFill;
    sectionSelectionExtent->setWidgetVisible(
        "buttonContiguousSelectionBoundaryColor", visible
    );
 
    slotSetContiguousSelectionMode(
        button == buttonContiguousSelectionModeBoundaryFill
        ? BoundaryFill
        : FloodFill
    );
}

References BoundaryFill, button(), FloodFill, KisOptionCollectionWidgetWithHeader::primaryWidgetAs(), KisToolSelectBase< BaseClass >::selectionOptionWidget(), KisOptionCollectionWidgetWithHeader::setWidgetVisible(), slotSetContiguousSelectionMode(), and KisOptionCollectionWidget::widgetAs().

slotSetCloseGap

void KisToolSelectContiguous::slotSetCloseGap ( int closeGap )

slot

Definition at line 296 of file kis_tool_select_contiguous.cc.

{
    m_closeGap = closeGap;
    m_configGroup.writeEntry("closeGapAmount", closeGap);
}

References m_closeGap, and m_configGroup.

slotSetContiguousSelectionBoundaryColor

void KisToolSelectContiguous::slotSetContiguousSelectionBoundaryColor ( const KoColor & color )

slot

Definition at line 274 of file kis_tool_select_contiguous.cc.

{
    if (color == m_contiguousSelectionBoundaryColor) {
        return;
    }
    m_contiguousSelectionBoundaryColor = color;
    m_configGroup.writeEntry("contiguousSelectionBoundaryColor", color.toXML());
}

References m_configGroup, m_contiguousSelectionBoundaryColor, and KoColor::toXML().

slotSetContiguousSelectionMode

void KisToolSelectContiguous::slotSetContiguousSelectionMode ( ContiguousSelectionMode contiguousSelectionMode )

slot

Definition at line 259 of file kis_tool_select_contiguous.cc.

{
    if (contiguousSelectionMode == m_contiguousSelectionMode) {
        return;
    }
    m_contiguousSelectionMode = contiguousSelectionMode;
    m_configGroup.writeEntry(
        "contiguousSelectionMode",
        contiguousSelectionMode == FloodFill
        ? "floodFill"
        : "boundaryFill"
    );
}

References FloodFill, m_configGroup, and m_contiguousSelectionMode.

slotSetOpacitySpread

void KisToolSelectContiguous::slotSetOpacitySpread ( int opacitySpread )

slot

Definition at line 290 of file kis_tool_select_contiguous.cc.

{
    m_opacitySpread = opacitySpread;
    m_configGroup.writeEntry("opacitySpread", opacitySpread);
}

References m_configGroup, and m_opacitySpread.

slotSetThreshold

void KisToolSelectContiguous::slotSetThreshold ( int threshold )

slot

Definition at line 284 of file kis_tool_select_contiguous.cc.

{
    m_threshold = threshold;
    m_configGroup.writeEntry("threshold", threshold);
}

References m_configGroup, and m_threshold.

slotSetUseSelectionAsBoundary

void KisToolSelectContiguous::slotSetUseSelectionAsBoundary ( bool useSelectionAsBoundary )

slot

Definition at line 302 of file kis_tool_select_contiguous.cc.

{
    m_useSelectionAsBoundary = useSelectionAsBoundary;
    m_configGroup.writeEntry("useSelectionAsBoundary", useSelectionAsBoundary);
}

References m_configGroup, and m_useSelectionAsBoundary.

usesColorLabels()

bool KisToolSelectContiguous::usesColorLabels ( ) const

inlineoverrideprotectedvirtual

Reimplemented from KisToolSelectBase< BaseClass >.

Definition at line 55 of file kis_tool_select_contiguous.h.

{ return true; }

wantsAutoScroll()

bool KisToolSelectContiguous::wantsAutoScroll ( ) const

inlineoverrideprotected

Definition at line 52 of file kis_tool_select_contiguous.h.

{ return false; }

Member Data Documentation

m_closeGap

int KisToolSelectContiguous::m_closeGap {0}

private

Definition at line 76 of file kis_tool_select_contiguous.h.

{0};

m_configGroup

KConfigGroup KisToolSelectContiguous::m_configGroup

private

Definition at line 78 of file kis_tool_select_contiguous.h.

m_contiguousSelectionBoundaryColor

KoColor KisToolSelectContiguous::m_contiguousSelectionBoundaryColor

private

Definition at line 73 of file kis_tool_select_contiguous.h.

m_contiguousSelectionMode

ContiguousSelectionMode KisToolSelectContiguous::m_contiguousSelectionMode {FloodFill}

private

Definition at line 72 of file kis_tool_select_contiguous.h.

{FloodFill};

m_opacitySpread

int KisToolSelectContiguous::m_opacitySpread {100}

private

Definition at line 75 of file kis_tool_select_contiguous.h.

{100};

m_previousTime

int KisToolSelectContiguous::m_previousTime

private

Definition at line 81 of file kis_tool_select_contiguous.h.

m_referenceNodeList

KisMergeLabeledLayersCommand::ReferenceNodeInfoListSP KisToolSelectContiguous::m_referenceNodeList

private

Definition at line 80 of file kis_tool_select_contiguous.h.

m_referencePaintDevice

KisPaintDeviceSP KisToolSelectContiguous::m_referencePaintDevice

private

Definition at line 79 of file kis_tool_select_contiguous.h.

m_threshold

int KisToolSelectContiguous::m_threshold {8}

private

Definition at line 74 of file kis_tool_select_contiguous.h.

{8};

m_useSelectionAsBoundary

bool KisToolSelectContiguous::m_useSelectionAsBoundary {false}

private

Definition at line 77 of file kis_tool_select_contiguous.h.

{false};

m_widgetHelper

KisSelectionToolConfigWidgetHelper KisToolSelectBase< BaseClass >::m_widgetHelper

protected

Definition at line 535 of file kis_tool_select_base.h.

---

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

• plugins/tools/selectiontools/kis_tool_select_contiguous.h
• plugins/tools/selectiontools/kis_tool_select_contiguous.cc