svcore
1.9
|
#include <ModelTransformerFactory.h>
Classes | |
class | AdditionalModelHandler |
class | UserConfigurator |
Public Member Functions | |
virtual | ~ModelTransformerFactory () |
ModelTransformer::Input | getConfigurationForTransform (Transform &transform, const std::vector< Model * > &candidateInputModels, Model *defaultInputModel, AudioPlaySource *source=0, int startFrame=0, int duration=0, UserConfigurator *configurator=0) |
Fill out the configuration for the given transform (may include asking the user by calling back on the UserConfigurator). | |
Model * | transform (const Transform &transform, const ModelTransformer::Input &input, QString &message, AdditionalModelHandler *handler=0) |
Return the output model resulting from applying the named transform to the given input model. | |
std::vector< Model * > | transformMultiple (const Transforms &transform, const ModelTransformer::Input &input, QString &message, AdditionalModelHandler *handler=0) |
Return the multiple output models resulting from applying the named transforms to the given input model. | |
Static Public Member Functions | |
static ModelTransformerFactory * | getInstance () |
Protected Types | |
typedef std::map< TransformId, QString > | TransformerConfigurationMap |
typedef std::set < ModelTransformer * > | TransformerSet |
typedef std::map < ModelTransformer *, AdditionalModelHandler * > | HandlerMap |
Protected Slots | |
void | transformerFinished () |
void | modelAboutToBeDeleted (Model *) |
Protected Member Functions | |
ModelTransformer * | createTransformer (const Transforms &transforms, const ModelTransformer::Input &input) |
Protected Attributes | |
TransformerConfigurationMap | m_lastConfigurations |
TransformerSet | m_runningTransformers |
HandlerMap | m_handlers |
Static Protected Attributes | |
static ModelTransformerFactory * | m_instance = new ModelTransformerFactory |
Definition at line 34 of file ModelTransformerFactory.h.
typedef std::map<TransformId, QString> ModelTransformerFactory::TransformerConfigurationMap [protected] |
Definition at line 157 of file ModelTransformerFactory.h.
typedef std::set<ModelTransformer *> ModelTransformerFactory::TransformerSet [protected] |
Definition at line 160 of file ModelTransformerFactory.h.
typedef std::map<ModelTransformer *, AdditionalModelHandler *> ModelTransformerFactory::HandlerMap [protected] |
Definition at line 163 of file ModelTransformerFactory.h.
ModelTransformerFactory::~ModelTransformerFactory | ( | ) | [virtual] |
Definition at line 49 of file ModelTransformerFactory.cpp.
ModelTransformerFactory * ModelTransformerFactory::getInstance | ( | ) | [static] |
Definition at line 44 of file ModelTransformerFactory.cpp.
References m_instance.
Referenced by getConfigurationForTransform(), and transformMultiple().
ModelTransformer::Input ModelTransformerFactory::getConfigurationForTransform | ( | Transform & | transform, |
const std::vector< Model * > & | candidateInputModels, | ||
Model * | defaultInputModel, | ||
AudioPlaySource * | source = 0 , |
||
int | startFrame = 0 , |
||
int | duration = 0 , |
||
UserConfigurator * | configurator = 0 |
||
) |
Fill out the configuration for the given transform (may include asking the user by calling back on the UserConfigurator).
Returns the selected input model and channel if the transform is acceptable, or an input with a null model if the operation should be cancelled. Audio play source may be used to audition effects plugins, if provided.
!! This will need revision -- we'll have to have a callback
Definition at line 54 of file ModelTransformerFactory.cpp.
References ModelTransformerFactory::UserConfigurator::configure(), Transform::getIdentifier(), getInstance(), Transform::getPluginIdentifier(), Model::getSampleRate(), AudioPlaySource::getTargetBlockSize(), AudioPlaySource::getTargetChannelCount(), AudioPlaySource::getTargetSampleRate(), FeatureExtractionPluginFactory::instanceFor(), RealTimePluginFactory::instanceFor(), FeatureExtractionPluginFactory::instantiatePlugin(), RealTimePluginFactory::instantiatePlugin(), m_lastConfigurations, ModelTransformer::Input::setModel(), PluginXml::setParametersFromXml(), and XmlExportable::toXmlString().
Model * ModelTransformerFactory::transform | ( | const Transform & | transform, |
const ModelTransformer::Input & | input, | ||
QString & | message, | ||
AdditionalModelHandler * | handler = 0 |
||
) |
Return the output model resulting from applying the named transform to the given input model.
The transform may still be working in the background when the model is returned; check the output model's isReady completion status for more details. To cancel a background transform, call abandon() on its model.
If the transform is unknown or the input model is not an appropriate type for the given transform, or if some other problem occurs, return 0. Set message if there is any error or warning to report.
Some transforms may return additional models at the end of processing. (For example, a transform that splits an output into multiple one-per-bin models.) If an additionalModelHandler is provided here, its moreModelsAvailable method will be called when those models become available, and ownership of those models will be transferred to the handler. Otherwise (if the handler is null) any such models will be discarded.
The returned model is owned by the caller and must be deleted when no longer needed.
Definition at line 195 of file ModelTransformerFactory.cpp.
References ModelTransformer::Input::getModel(), SVDEBUG, and transformMultiple().
vector< Model * > ModelTransformerFactory::transformMultiple | ( | const Transforms & | transform, |
const ModelTransformer::Input & | input, | ||
QString & | message, | ||
AdditionalModelHandler * | handler = 0 |
||
) |
Return the multiple output models resulting from applying the named transforms to the given input model.
The transforms may differ only in output identifier for the plugin: they must all use the same plugin, parameters, and programs. The plugin will be run once only, but more than one output will be harvested (as appropriate). Models will be returned in the same order as the transforms were given. The plugin may still be working in the background when the model is returned; check the output models' isReady completion statuses for more details. To cancel a background transform, call abandon() on its model.
If a transform is unknown or the transforms are insufficiently closely related or the input model is not an appropriate type for the given transform, or if some other problem occurs, return 0. Set message if there is any error or warning to report.
Some transforms may return additional models at the end of processing. (For example, a transform that splits an output into multiple one-per-bin models.) If an additionalModelHandler is provided here, its moreModelsAvailable method will be called when those models become available, and ownership of those models will be transferred to the handler. Otherwise (if the handler is null) any such models will be discarded. Note that calling abandon() on any one of the models returned by transformMultiple is sufficient to cancel all background transform activity associated with these output models.
The returned models are owned by the caller and must be deleted when no longer needed.
Definition at line 210 of file ModelTransformerFactory.cpp.
References createTransformer(), ModelTransformer::detachOutputModels(), getInstance(), ModelTransformer::getMessage(), ModelTransformer::Input::getModel(), m_handlers, m_runningTransformers, Thread::start(), SVDEBUG, and transformerFinished().
Referenced by transform().
void ModelTransformerFactory::transformerFinished | ( | ) | [protected, slot] |
Definition at line 257 of file ModelTransformerFactory.cpp.
References ModelTransformer::detachAdditionalOutputModels(), m_handlers, m_runningTransformers, and ModelTransformer::willHaveAdditionalOutputModels().
Referenced by transformMultiple().
void ModelTransformerFactory::modelAboutToBeDeleted | ( | Model * | m | ) | [protected, slot] |
Definition at line 293 of file ModelTransformerFactory.cpp.
References ModelTransformer::abandon(), ModelTransformer::getInputModel(), ModelTransformer::getOutputModels(), and m_runningTransformers.
ModelTransformer * ModelTransformerFactory::createTransformer | ( | const Transforms & | transforms, |
const ModelTransformer::Input & | input | ||
) | [protected] |
Definition at line 167 of file ModelTransformerFactory.cpp.
References FeatureExtractionPluginFactory::instanceFor(), RealTimePluginFactory::instanceFor(), and SVDEBUG.
Referenced by transformMultiple().
Definition at line 158 of file ModelTransformerFactory.h.
Referenced by getConfigurationForTransform().
Definition at line 161 of file ModelTransformerFactory.h.
Referenced by modelAboutToBeDeleted(), transformerFinished(), and transformMultiple().
HandlerMap ModelTransformerFactory::m_handlers [protected] |
Definition at line 164 of file ModelTransformerFactory.h.
Referenced by transformerFinished(), and transformMultiple().
ModelTransformerFactory * ModelTransformerFactory::m_instance = new ModelTransformerFactory [static, protected] |
Definition at line 166 of file ModelTransformerFactory.h.
Referenced by getInstance().