KisAnimationImporter Class Reference

#include <kis_animation_importer.h>

Inheritance diagram for KisAnimationImporter:

Classes
struct	Private

Public Member Functions
KisImportExportErrorCode	import (QStringList files, int firstFrame, int step, bool autoAddHoldframes=false, bool startfrom0=false, int isAscending=0, bool assignDocumentProfile=false, QList< int > optionalKeyframeTimeList={})
	KisAnimationImporter (KisDocument *document)
	KisAnimationImporter (KisImageSP image, KoUpdaterPtr updater=0)
	~KisAnimationImporter () override

Private Slots
void	cancel ()

Private Member Functions
QPair< KisPaintLayerSP, class KisRasterKeyframeChannel * >	initializePaintLayer (QScopedPointer< KisDocument > &doc, class KisUndoAdapter *undoAdapter)

Private Attributes
QScopedPointer< Private >	m_d

Detailed Description

Definition at line 19 of file kis_animation_importer.h.

Constructor & Destructor Documentation

KisAnimationImporter() [1/2]

KisAnimationImporter::KisAnimationImporter	(	KisImageSP	image,
		KoUpdaterPtr	updater = 0 )

Definition at line 34 of file kis_animation_importer.cpp.

    : m_d(new Private())
{
    m_d->document = 0;
    m_d->image = image;
    m_d->stop = false;
    m_d->updater = updater;
}

References m_d.

KisAnimationImporter() [2/2]

KisAnimationImporter::KisAnimationImporter

(

KisDocument *

document

)

Definition at line 43 of file kis_animation_importer.cpp.

    : m_d(new Private())
{
    m_d->document= document;
    m_d->image = document->image();
    m_d->stop = false;
}

References m_d.

~KisAnimationImporter()

KisAnimationImporter::~KisAnimationImporter ( )

override

Definition at line 51 of file kis_animation_importer.cpp.

{}

Member Function Documentation

cancel

void KisAnimationImporter::cancel ( )

privateslot

Definition at line 214 of file kis_animation_importer.cpp.

{
    m_d->stop = true;
}

References m_d.

import()

KisImportExportErrorCode KisAnimationImporter::import	(	QStringList	files,
		int	firstFrame,
		int	step,
		bool	autoAddHoldframes = false,
		bool	startfrom0 = false,
		int	isAscending = 0,
		bool	assignDocumentProfile = false,
		QList< int >	optionalKeyframeTimeList = {} )

Definition at line 54 of file kis_animation_importer.cpp.

{
    //TODO: We should clean up this code --
    // There are a lot of actions here that we should break into individual methods
    // so that we can better control code flow, and I'd prefer to use multiple import
    // calls to better handle all of these different options!
    // Additionally, we might prefer to use flags for multiple booleans to improve
    // legibility of calls.
    Q_ASSERT(step > 0);
 
    KisUndoAdapter *undo = m_d->image->undoAdapter();
    undo->beginMacro(kundo2_i18n("Import animation"));
 
    QScopedPointer<KisDocument> importDoc(KisPart::instance()->createDocument());
    importDoc->setFileBatchMode(true);
 
    const bool usingPredefinedTimes = !optionalKeyframeTimeList.isEmpty() && !autoAddHoldframes;
    QQueue<int> predefinedFrameQueue;
    predefinedFrameQueue.append(optionalKeyframeTimeList);
 
    KisImportExportErrorCode status = ImportExportCodes::OK;
    int frame = usingPredefinedTimes ? predefinedFrameQueue.dequeue() : firstFrame;
    int filesProcessed = 0;
 
    if (usingPredefinedTimes) {
        KIS_ASSERT(files.count() == optionalKeyframeTimeList.count());
    }
 
    if (m_d->updater) {
        m_d->updater->setRange(0, files.size());
    }
 
    QPair<KisPaintLayerSP, KisRasterKeyframeChannel*> layerRasterChannelPair;
 
    const QRegularExpression rx(QLatin1String("(\\d+)"));    //regex for extracting numbers
    QStringList fileNumberRxList;
    
    QRegularExpressionMatchIterator i = rx.globalMatch(files.at(0));
    while (i.hasNext()) {
        QRegularExpressionMatch match = i.next();
        fileNumberRxList << match.captured(1);
    }
 
    int firstFrameNumber = 0;
    bool ok;
 
    if (!fileNumberRxList.isEmpty()) {
        fileNumberRxList.last().toInt(&ok);    // selects the last number of file name of the first frame (useful for descending order)
        // Note to self -- ^^ uh.... This isn't doing anything?? Shouldn't this assign `firstFrameNumber`?
    }
 
    if (firstFrameNumber == 0){
        startfrom0 = false;     // if enabled, the zeroth frame will be places in -1 slot, leading to an error
    }
 
    fileNumberRxList.clear();
    const int offset = (startfrom0 ? 1 : 0);    //offset added to consider file numbering starts from 1 instead of 0
    int autoframe = 0;
 
    KisConfig cfg(true);
 
    Q_FOREACH(QString file, files) {
        bool successfullyLoaded = importDoc->openPath(file, KisDocument::DontAddToRecent);
        KIS_SAFE_ASSERT_RECOVER_RETURN_VALUE(successfullyLoaded, ImportExportCodes::InternalError);
 
        if ( (!usingPredefinedTimes && frame == firstFrame)
          || (usingPredefinedTimes && frame == optionalKeyframeTimeList.first()) ) {
             layerRasterChannelPair = initializePaintLayer(importDoc, undo);
        }
 
        if (m_d->updater) {
            if (m_d->updater->interrupted()) {
                m_d->stop = true;
            } else {
                m_d->updater->setValue(filesProcessed + 1);
 
                // the updater doesn't call that automatically,
                // it is "threaded" by default
                qApp->processEvents();
            }
        }
 
        if (m_d->stop) {
            status = ImportExportCodes::Cancelled;
            break;
        }
 
        if (cfg.trimFramesImport()) {
            importDoc->image()->projection()->crop(m_d->image->bounds());
        }
        importDoc->image()->projection()->purgeDefaultPixels();
 
        KIS_SAFE_ASSERT_RECOVER_RETURN_VALUE(layerRasterChannelPair.second, ImportExportCodes::InternalError);
 
        if (!autoAddHoldframes) {
            layerRasterChannelPair.second->importFrame(frame, importDoc->image()->projection(), NULL);    // as first frame added will go to second slot i.e #1 instead of #0
        } else {
            QRegularExpressionMatchIterator i = rx.globalMatch(file);
            while (i.hasNext()) {
                QRegularExpressionMatch match = i.next();
                fileNumberRxList << match.captured(1);
            }
 
            int filenum = fileNumberRxList.last().toInt(&ok);
 
            if (isAscending == 0) {
                autoframe = firstFrame + filenum - offset;
            } else {
                autoframe = firstFrame + (firstFrameNumber - filenum); //places the first frame #0 (or #1) slot, and later frames are added as per the difference
            }
 
            if (ok) {
                layerRasterChannelPair.second->importFrame(autoframe , importDoc->image()->projection(), NULL);
            } else {
                // if it fails to extract a number, the next frame will simply be added to next slot
                layerRasterChannelPair.second->importFrame(autoframe + 1, importDoc->image()->projection(), NULL);
            }
            fileNumberRxList.clear();
        }
 
        if (usingPredefinedTimes && predefinedFrameQueue.count()) {
            frame = predefinedFrameQueue.dequeue();
        } else {
            frame += step;
        }
 
        filesProcessed++;
    }
 
    if (layerRasterChannelPair.first && assignDocumentProfile) {
 
        if (layerRasterChannelPair.first->colorSpace()->colorModelId() == m_d->image->colorSpace()->colorModelId()) {
 
            const KoColorSpace *srcColorSpace = layerRasterChannelPair.first->colorSpace();
            const KoColorSpace *dstColorSpace = KoColorSpaceRegistry::instance()->colorSpace(
                        srcColorSpace->colorModelId().id()
                        , srcColorSpace->colorDepthId().id()
                        , m_d->image->colorSpace()->profile());
 
            KisAssignProfileProcessingVisitor *visitor = new KisAssignProfileProcessingVisitor(srcColorSpace, dstColorSpace);
            visitor->visit(layerRasterChannelPair.first.data(), undo);
        }
    }
 
    undo->endMacro();
 
    return status;
}

References ImportExportCodes::Cancelled, KoColorSpace::colorDepthId(), KoColorSpace::colorModelId(), KoColorSpaceRegistry::colorSpace(), createDocument(), KisDocument::DontAddToRecent, KoID::id(), initializePaintLayer(), KoColorSpaceRegistry::instance(), KisPart::instance(), ImportExportCodes::InternalError, KIS_ASSERT, KIS_SAFE_ASSERT_RECOVER_RETURN_VALUE, kundo2_i18n(), m_d, ImportExportCodes::OK, KisConfig::trimFramesImport(), and KisAssignProfileProcessingVisitor::visit().

initializePaintLayer()

QPair< KisPaintLayerSP, KisRasterKeyframeChannel * > KisAnimationImporter::initializePaintLayer ( QScopedPointer< KisDocument > & doc, class KisUndoAdapter * undoAdapter )

private

Definition at line 203 of file kis_animation_importer.cpp.

{
    const KoColorSpace *cs = doc->image()->colorSpace();
    KisPaintLayerSP paintLayer = new KisPaintLayer(m_d->image, m_d->image->nextLayerName(), OPACITY_OPAQUE_U8, cs);
    undoAdapter->addCommand(new KisImageLayerAddCommand(m_d->image, paintLayer, m_d->image->rootLayer(), m_d->image->rootLayer()->childCount()));
 
    paintLayer->enableAnimation();
    KisRasterKeyframeChannel* contentChannel = qobject_cast<KisRasterKeyframeChannel*>(paintLayer->getKeyframeChannel(KisKeyframeChannel::Raster.id(), true));
    return QPair<KisPaintLayerSP, KisRasterKeyframeChannel*>(paintLayer, contentChannel);
}

References KisUndoAdapter::addCommand(), KisNode::childCount(), KisBaseNode::enableAnimation(), KisBaseNode::getKeyframeChannel(), KoID::id(), KisBaseNode::image, m_d, OPACITY_OPAQUE_U8, KisKeyframeChannel::Raster, and KisImage::rootLayer().

Member Data Documentation

m_d

QScopedPointer<Private> KisAnimationImporter::m_d

private

Definition at line 45 of file kis_animation_importer.h.

---

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

• libs/ui/kis_animation_importer.h
• libs/ui/kis_animation_importer.cpp