dmPMInitDirectory(3dm)

NAME
     dmPMInitDirectory, dmPMInitDirectoryWithProgress - initializes a
     directory of plugins


SYNOPSIS
     #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
     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
     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.
     Passing in NULL causes the plugin-manager to initialize the default
     plugin directory.


RETURN VALUES
     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
     /usr/lib/dmedia/plugins/premiere     default plugin directory
     $HOME/.fxplugmgr.cache               plugin-manager cache file

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