dmPMGetName(3dm)

NAME
     dmPMGetName, dmPMGetLocalName, dmPMGetPrefix, dmPMGetPathname,
     dmPMGetType - retrieve the name, prefix, pathname or type of a plugin


SYNOPSIS
     #include <dmedia/fx_plugin_mgr.h>

     const char* dmPMGetName
           ( DMplugin* plugin )

     const char* dmPMGetLocalName
           ( DMplugin* plugin )

     const char* dmPMGetPrefix
           ( DMplugin* plugin )

     const char* dmPMGetPathname
           ( DMplugin* plugin )

     PMtype* dmPMGetType
           ( DMplugin* plugin )


PARAMETERS
     plugin   A pointer to a DMplugin, which was created with dmPMInitPlugin
              or dmPMInitDirectory.


DESCRIPTION
     dmPMGetName returns the name of the plugin.  This does not change with
     locale.  It may be combined with the plugin prefix and type to create a
     unique descriptor for each plugin.

     dmPMGetLocalName returns the localized name of the plugin. This string is
     obtained from the plugin's X resource file and is intended for labels in
     menus and other user interface components.

     dmPMGetPrefix returns the prefix of the plugin.

     dmPMGetPathname returns the pathname of the plugin.

     dmPMGetType returns the type of the plugin.


RETURN VALUES
     dmPMGetName will return the name of the plugin if successful, or will
     return NULL if it fails.  dmPMGetLocalName will return a localized plugin
     name.  If a plugin does not define a localized name then it will return
     the same result as dmPMGetName.  dmPMGetPrefix will return the prefix of
     the plugin if successful, or will return NULL if it fails.
     dmPMGetPathname will return the pathname of the plugin if successful, or
     will return NULL if it fails.  dmPMGetType will return the type of the
     plugin if successful, or will return 0 if it fails.


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