dmPMGetName(3dm)					      dmPMGetName(3dm)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

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

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

DESCRIPTION    [Toc]    [Back]

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

     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



									Page 1






dmPMGetName(3dm)					      dmPMGetName(3dm)



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

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


									PPPPaaaaggggeeee 2222