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.
SEE ALSO
     dmPMCreateManager(3dm), dmPMInitPlugin(3dm), dmGetError(3dm).