---
name: "MrmFetchColorLiteral"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/MrmFetchColorLiteral"
---

# MrmFetchColorLiteral(3)

Fetches a named color literal from a UID file

## 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 specified 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* argument specifies the connection to the X server. For more information 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)](/MrmFetchBitmapLiteral/3.md), [**MrmOpenHierarchyPerDisplay**(3)](/MrmOpenHierarchyPerDisplay/3.md), [**MrmFetchIconLiteral**(3)](/MrmFetchIconLiteral/3.md), [**MrmFetchLiteral**(3)](/MrmFetchLiteral/3.md), and [**XOpenDisplay**(3)](/XOpenDisplay/3.md).