dmPMInitDirectory(3dm)					dmPMInitDirectory(3dm)

NAME    [Toc]    [Back]

     dmPMInitDirectory,	dmPMInitDirectoryWithProgress -	initializes a
     directory of plugins

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/fx_plugin_mgr.h>

     DMplugin**	dmPMInitDirectory
	   ( DMplugmgr*	manager,
	     const char* pathname,
	     unsigned int typemask )

     DMplugin**	dmPMInitDirectoryWithProgress
	   ( DMplugmgr*	manager,
	     const char* pathname,
	     unsigned int typemask,
	     DMprogresscallback	*progressCallback,
	     void *progressClientData )

PARAMETERS    [Toc]    [Back]

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

     pathname		  The pathname of the directory	from which to
			  initialize the plugins; can be NULL.

     typemask		  The typemask of the plugin type which	is a bitwise
			  combination of one or	more of: DM_VIDEO_FILTER,
			  DM_VIDEO_TRANSITION, DM_AUDIO_FILTER,	or
			  DM_ALL_PLUGIN_TYPES.

     progressCallback	  The progressCallback is a pointer to a
			  DMprogresscallback callback.	This callback gets
			  triggered periodically during	the loading of plugins
			  if and only if, the plugin-manager cache file	needs
			  to be	updated.  Define your callback like:

			  DMboolean myProgressCallback(
			      float fractionComplete, /* 0.0 - 1.0 */
			      void* clientData);


     progressClientData	  The progressClientData gets passed into the
			  progressCallback; can	be NULL.

DESCRIPTION    [Toc]    [Back]

     dmPMInitDirectory and dmPMInitDirectoryWithProgress initialize a
     directory of plugins. The plugin-manager manages a	list of	plugins	and a
     cached file that allows applications to use special effects plugins.



									Page 1






dmPMInitDirectory(3dm)					dmPMInitDirectory(3dm)



     Passing in	NULL causes the	plugin-manager to initialize the default
     plugin directory.

RETURN VALUES    [Toc]    [Back]

     dmPMInitDirectory and dmPMInitDirectoryWithProgress will return a pointer
     to	an array of DMplugin's if successful, or will return NULL if it	fails.
     The plug-in manager owns this array, therefore your application must not
     free it.  You can access the plugins like:


	  DMplugin **plugins = dmPMInitDirectory(mgr, NULL, DM_VIDEO_FILTER);

	  if (plugins)
	  {
	      int i;

	      for (i = 0; i < dmPMGetPluginCount(mgr); i++)
		   name	= dmPMGetName(plugins[i]);
	  }

FILES    [Toc]    [Back]

     /usr/lib/dmedia/plugins/premiere	  default plugin directory
     $HOME/.fxplugmgr.cache		  plugin-manager cache file

SEE ALSO    [Toc]    [Back]

     dmPMCreateManager(3dm), dmPMGetPluginCount(3dm), dmPMInitPlugin(3dm),
     dmPMFreePlugin(3dm), dmPMFreeAllPlugins(3dm), dmGetError(3dm).


									PPPPaaaaggggeeee 2222