*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> fx/dmFXMergeResources (3d)              


dmFXMergeResources(3dm)				       dmFXMergeResources(3dm)

NAME    [Toc]    [Back]

     dmFXMergeResources	- load and merge plugin	resources with those of	the
     parent application

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/fx_utils.h>

     DMstatus dmFXMergeResources    [Toc]    [Back]
	   ( const char* rf )

PARAMETERS    [Toc]    [Back]

     rf	  The name of the X resource file.

DESCRIPTION    [Toc]    [Back]

     To	support	internationalization it	is desirable for all user interface
     strings to	be defined in locale-specific X	resource files.
     dmFXMergeResources	is a utility function which plugins may	use to merge
     their own X resource files	with those of the current application.
     Plugins may use the merged	resources to define a locale-specific name
     and, if desired, locale-specific labels for their own user	interface
     components.  Even if you only ever	intend to support English it may still
     be	desirable to use a resource file since it allows simple	changes	to the
     user interface without any	need to	recompile.

     Internationalized applications (such as Moviemaker) will search the
     merged resource database for a unique plugin identifier and use the value
     of	that resource to replace PK_Name in user-interface components.

     The unique	plugin identifier is constructed from the plugin prefix, name
     and type as follows (with any non alpanumeric characters replaced by

	  PK_UniquePrefix ``_''	PK_Name	``_Video_Filter''

	  PK_UniquePrefix ``_''	PK_Name	``_Video_Transition''

	  PK_UniquePrefix ``_''	PK_Name	``_Audio_Filter''

	  PK_UniquePrefix ``_''	PK_Name	``_Other''

     For example, if a video filter has	a prefix of ``SGI'' and	a name of
     ``Brightness & Contrast'' then the	parent application will	expect a
     resource line of the form:

     *SGI_Brightness___Contrast_Video_Filter: Brightness and Contrast

     If	your plugin has	a user interface you may also specifiy localized
     string labels for buttons and dialogs in rf - just	be careful to
     sufficiently qualify the resource names so	you don't interfere with any

									Page 1

dmFXMergeResources(3dm)				       dmFXMergeResources(3dm)

     resources which other plugins may specify.	 We recommended	you use
     PK_UniquePrefix as	part of	the label for your dialog and specify that
     with every	resource.

     dmFXMergeResources	should be called in your PRX_PluginProperties
     function.	This guarantees	that resources will have been merged before
     the parent	application searches the resource database for your localized
     plugin name.

     Plugin resource files should be located in:


     with optional locale-specific versions in:


     dmFXMergeResources	searches for your resource file	using the same rules
     as	XtResolvePathname with a file type of ``appdefaults/dmedia/plugins/premiere''.

     For assistance in debugging set the plugin	property PK_Debugging to True
     and observe messages printed to stderr.

RETURN VALUES    [Toc]    [Back]

     Returns DM_SUCCESS	on success and DM_FAILURE otherwise.

SEE ALSO    [Toc]    [Back]

     dmPMGetLocalName(3dm), XtResolvePathname(Xt).

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
dlaeda IRIX compute the Z vector corresponding to the merge step in the CURLVLth step of the merge process with TLVLS step
slaeda IRIX compute the Z vector corresponding to the merge step in the CURLVLth step of the merge process with TLVLS step
dmPMGetProperty IRIX retrieves a property of the specified plugin
dmPMHasDialog IRIX determine whether or not a plugin has a setup dialog
dmPMGetSourceAUsage IRIX retrieves the usage bitmask of the plugin
dmPMGetPlugin IRIX retrieve a pointer to a special effects plugin
cosmoplayer IRIX Netscape Plugin to view VRML files
dmPMGetName IRIX retrieve the name, prefix, pathname or type of a plugin
pxfgetppid IRIX Gets the parent process ID
device_get_parent FreeBSD return the device's parent
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service