ActionHelper Namespace Reference

Functions
KisImageSP	makeImage (KisViewManager *view, KisNodeList nodes)
void	trimDevice (KisViewManager *view, KisPaintDeviceSP device, bool makeSharpClip=false, const KisTimeSpan &range=KisTimeSpan())

Function Documentation

makeImage()

KisImageSP ActionHelper::makeImage	(	KisViewManager *	view,
		KisNodeList	nodes )

Definition at line 130 of file kis_selection_action_factories.cpp.

    {
        KisImageWSP image = view->image();
 
        KisImageSP clipImage = new KisImage(0, image->width(), image->height(), image->colorSpace(), "ClipImage");
        clipImage->setResolution(image->xRes(), image->yRes());
        Q_FOREACH (KisNodeSP node, nodes) {
            clipImage->addNode(node, clipImage->root());
        }
 
        clipImage->refreshGraphAsync();
        clipImage->waitForDone();
 
        return clipImage;
    }

References KisNodeFacade::addNode(), KisImage::colorSpace(), KisImage::height(), KisViewManager::image(), KisImage::refreshGraphAsync(), KisNodeFacade::root, KisImage::setResolution(), KisImage::waitForDone(), KisImage::width(), KisImage::xRes(), and KisImage::yRes().

trimDevice()

void ActionHelper::trimDevice	(	KisViewManager *	view,
		KisPaintDeviceSP	device,
		bool	makeSharpClip = false,
		const KisTimeSpan &	range = KisTimeSpan() )

Sharp method is an exact reverse of COMPOSITE_OVER so if you cover the cut/copied piece over its source you get an exactly the same image without any seams

Definition at line 70 of file kis_selection_action_factories.cpp.

    {
        Q_UNUSED(range); // TODO: Allow multiple frame operation across a timespan.
 
        KisImageWSP image = view->image();
        if (!image) return;
 
        KisSelectionSP selection = view->selection();
 
        QRect rc = (selection) ? selection->selectedExactRect() : image->bounds();
 
        const KoColorSpace *cs = device->colorSpace();
 
        // We need to allow for trimming from non-transparent defaultPixel layers.
        // Default color should be phased out of use when the area in question is not aligned with image bounds.
        // Otherwise, we can maintain default pixel.
        const bool hasNonTransparentDefaultPixel = device->defaultPixel() != KoColor::createTransparent(device->colorSpace());
        const bool needsTransparentPixel = selection && rc != image->bounds() && hasNonTransparentDefaultPixel;
 
        if (selection) {
            // Apply selection mask.
            KisPaintDeviceSP selectionProjection = selection->projection();
            const KoColorSpace *selCs = selection->projection()->colorSpace();
 
            KisSequentialIterator layerIt(device, rc);
            KisSequentialConstIterator selectionIt(selectionProjection, rc);
 
            while (layerIt.nextPixel() && selectionIt.nextPixel()) {
 
                if (makeSharpClip) {
                    qreal dstAlpha = cs->opacityF(layerIt.rawData());
                    qreal sel = selCs->opacityF(selectionIt.oldRawData());
                    qreal newAlpha = sel * dstAlpha / (1.0 - dstAlpha + sel * dstAlpha);
                    float mask = newAlpha / dstAlpha;
 
                    cs->applyAlphaNormedFloatMask(layerIt.rawData(), &mask, 1);
                } else {
                    cs->applyAlphaU8Mask(layerIt.rawData(), selectionIt.oldRawData(), 1);
                }
            }
        }
 
 
 
        if ( needsTransparentPixel ) {
            device->setDefaultPixel(KoColor::createTransparent(device->colorSpace()));
            device->purgeDefaultPixels();
        }
 
        device->crop(rc);
    }

References KoColorSpace::applyAlphaNormedFloatMask(), KoColorSpace::applyAlphaU8Mask(), KisImage::bounds(), KisPaintDevice::colorSpace(), KoColor::createTransparent(), KisPaintDevice::crop(), KisPaintDevice::defaultPixel(), KisViewManager::image(), KisSequentialIteratorBase< IteratorPolicy, SourcePolicy, ProgressPolicy >::nextPixel(), KisSequentialIteratorBase< IteratorPolicy, SourcePolicy, ProgressPolicy >::oldRawData(), KoColorSpace::opacityF(), KisSelection::projection(), KisPaintDevice::purgeDefaultPixels(), KisSequentialIteratorBase< IteratorPolicy, SourcePolicy, ProgressPolicy >::rawData(), KisSelection::selectedExactRect(), KisViewManager::selection(), and KisPaintDevice::setDefaultPixel().