dmPMCreateEffect(3dm)dmPMCreateEffect(3dm)NAME
dmPMCreateEffect, dmPMCreateEffectByName, dmPMDestroyEffect - create and
destroy special effects
SYNOPSIS
#include <dmedia/fx_plugin_mgr.h>
DMplugin* dmPMCreateEffect
( DMplugmgr* manager,
DMplugin* plugin )
DMplugin* dmPMCreateEffectByName
( DMplugmgr* manager,
const char* name,
const char* prefix )
void dmPMDestroyEffect
( DMeffect* effect )
PARAMETERS
manager A pointer to a DMplugmgr, which was returned from
dmPMCreateManager.
plugin A pointer to a DMplugin, which was returned from
dmPMInitPlugin.
name The name of a plugin from which to create the DMeffect.
prefix The prefix of a plugin from which to create the DMeffect; can
be NULL.
effect A pointer to a DMeffect, which was returned from
dmPMCreateEffect or dmPMCreateEffectByName.
DESCRIPTION
dmPMCreateEffect creates an effect derived from the specified plugin.
dmPMCreateEffectByName creates an effect derived from the plugin
specified by name and prefix. Passing in NULL as the prefix will create
an effect from the first plugin with the specified name.
dmPMDestroyEffect destroys and frees the effect.
RETURN VALUES
dmPMCreateEffect will return a pointer to a DMeffect if successful, or
will return NULL if it fails. dmPMCreateEffectByName will return a
pointer to a DMeffect if successful, or will return NULL if it fails.
Page 1
dmPMCreateEffect(3dm)dmPMCreateEffect(3dm)SEE ALSOdmPMCreateManager(3dm), dmPMInitPlugin(3dm), dmGetError(3dm).
Page 2