dmPMCreateEffect(3dm)					 dmPMCreateEffect(3dm)

NAME    [Toc]    [Back]

     dmPMCreateEffect, dmPMCreateEffectByName, dmPMDestroyEffect - create and
     destroy special effects

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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 ALSO    [Toc]    [Back]

     dmPMCreateManager(3dm), dmPMInitPlugin(3dm), dmGetError(3dm).


									PPPPaaaaggggeeee 2222