Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MrmFetchColorLiteral(3)	   Library Functions Manual    MrmFetchColorLiteral(3)

NAME
       MrmFetchColorLiteral -- Fetches a named color literal from a UID	file

SYNOPSIS
       #include	<Mrm/MrmPublic.h>
       Cardinal	MrmFetchColorLiteral(
       MrmHierarchy hierarchy_id,
       String index,
       Display *display,
       Colormap	colormap_id,
       Pixel *pixel);

DESCRIPTION
       The  MrmFetchColorLiteral function fetches a named color	literal	from a
       UID file, and converts the color	literal	to a pixel color value.

       hierarchy_id
		 Specifies the ID of the UID hierarchy that contains the spec-
		 ified literal.	 The value of hierarchy_id was returned	 in  a
		 previous call to MrmOpenHierarchyPerDisplay.

       index	 Specifies  the	 UIL  name of the color	literal	to fetch.  You
		 must define this name in UIL as an exported value.

       display	 Specifies the display used for	the pixmap.  The display argu-
		 ment specifies	the connection to the X	server.	 For more  in-
		 formation  on	the  Display  structure, see the Xlib function
		 XOpenDisplay.

       colormap_id
		 Specifies the ID of the color map.  If	colormap_id  is	 NULL,
		 the default color map is used.

       pixel	 Returns the ID	of the color literal.

RETURN
       This function returns one of the	following status return	constants:

       MrmSUCCESS
		 The function executed successfully.

       MrmBAD_HIERARCHY
		 The hierarchy ID was invalid.

       MrmNOT_FOUND
		 The color literal was not found in the	UIL file.

       MrmWRONG_TYPE
		 The  caller  tried to fetch a literal of a type not supported
		 by this function.

       MrmFAILURE
		 The function failed.

RELATED
       MrmFetchBitmapLiteral(3), MrmOpenHierarchyPerDisplay(3),	 MrmFetchIcon-
       Literal(3), MrmFetchLiteral(3), and XOpenDisplay(3).

						       MrmFetchColorLiteral(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=MrmFetchColorLiteral&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help