dmPMGetPlugin(3dm)

NAME
     dmPMGetPlugin, dmPMGetPluginByName, dmPMGetPluginByPathname,
     dmPMGetPluginFromEffect - retrieve a pointer to a special effects plugin


SYNOPSIS
     #include <dmedia/fx_plugin_mgr.h>

     DMplugin* dmPMGetPlugin
           ( DMplugmgr* manager,
             int n )

     DMplugin* dmPMGetPluginByName
           ( DMplugmgr* manager,
             const char* name,
             const char* prefix )

     DMplugin* dmPMGetPluginByPathname
           ( DMplugmgr* manager,
             const char* pathname )

     DMplugin* dmPMGetPluginFromEffect
           ( DMeffect* effect )


PARAMETERS
     manager    A pointer to a DMplugmgr, which was returned from
                dmPMCreateManager.

     n          The index into the plugin list in the plugin-manager.

     name       The name of a plugin to retrieve.

     prefix     The prefix of a plugin to retrieve; can be NULL.

     pathname   The pathname of a plugin to retrieve.

     effect     A pointer to a DMeffect, which was returned from
                dmPMCreateEffect.


DESCRIPTION
     dmPMGetPlugin returns a pointer to the nth DMplugin.

     dmPMGetPluginByName returns a pointer to the DMplugin specified by the
     name and prefix. Passing in NULL as the prefix will return a pointer to
     the first DMplugin with the specified name.

     dmPMGetPluginByPathname returns a pointer to the DMplugin specified by
     the pathname.
     dmPMGetPluginFromEffect returns a pointer to the DMplugin used by the
     given special effect.


RETURN VALUES
     dmPMGetPlugin will return a pointer to a DMplugin if successful, or will
     return NULL if it fails.  dmPMGetPluginByName will return a pointer to a
     DMplugin if successful, or will return NULL if it fails.
     dmPMGetPluginByPathname will return a pointer to a DMplugin if
     successful, or will return NULL if it fails.  dmPMGetPluginFromEffect
     will return a pointer to a DMplugin if successful, or will return NULL if
     it fails.


SEE ALSO
     dmPMCreateManager(3dm), dmPMInitPlugin(3dm), dmPMInitDirectory(3dm),
     dmGetError(3dm).