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

# MrmFetchBitmapLiteral(3)

Fetches a bitmap literal from a hierarchy

## NAME

**MrmFetchBitmapLiteral** — Fetches a bitmap literal from a hierarchy

## SYNOPSIS

```
#include <Mrm/MrmPublic.h>
Cardinal MrmFetchBitmapLiteral(
MrmHierarchy hierarchy_id,
String index,
Screen *screen,
Display *display,
Pixmap *pixmap_return,
Dimension *width,
Dimension *height);
```

## DESCRIPTION

The **MrmFetchBitmapLiteral** function fetches a bitmap literal from an MRM hierarchy, and converts the bitmap literal to an X pixmap of depth 1. The function returns this pixmap and its width and height.

- *hierarchy\_id*

  Specifies the ID of the UID hierarchy that contains the specified icon literal. The value of *hierarchy\_id* was returned in a previous call to **MrmOpenHierarchyPerDisplay**.

- *index*

  Specifies the UIL name of the bitmap literal to fetch.

- *screen*

  Specifies the screen used for the pixmap. The *screen* argument specifies a pointer to the Xlib structure **Screen** which contains the information about that screen and is linked to the **Display** structure. For more information on the **Display** and **Screen** structures, see the Xlib function **XOpenDisplay** and the associated screen information macros.

- *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**.

- *pixmap\_return*

  Returns the resulting X pixmap value. The function allocates space for this pixmap. The application is responsible for managing the allocated space. The application can recover the allocated space by calling **XmDestroyPixmap**.

- *width*

  Specifies a pointer to the width of the pixmap.

- *height*

  Specifies a pointer to the height of the pixmap.

## 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 bitmap literal was not found in the hierarchy.

- **MrmWRONG\_TYPE**

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

- **MrmFAILURE**

  The function failed.

## RELATED

[**MrmFetchIconLiteral**(3)](/MrmFetchIconLiteral/3.md), [**MrmFetchLiteral**(3)](/MrmFetchLiteral/3.md), and [**XOpenDisplay**(3)](/XOpenDisplay/3.md).