X Version 11 (Release 6.1)

XmuLocateBitmapFile(X3xmu)

XmuLocateBitmapFile -- locate and return bitmap

Synopsis

cc . . . -lXmu

#include <X11/Xmu/Drawing.h>

Pixmap XmuLocateBitmapFile(screen, name, srcname, srcnamelen, widthp,
                           heightp, xhotp, yhotp)
    Screen *screen;
    char *name;
    char *srcname;
    int srcnamelen;
    int *widthp, *heightp, *xhotp, *yhotp;

Arguments

screen: Specifies the screen the pixmap is created on.
name: Specifies the file to read from.
srcname: Returns the full filename of the bitmap.
srcnamelen: Specifies the length of the srcname buffer.
width: Returns the width of the bitmap.
height: Returns the height of the bitmap.
xhotp: Returns the x coordinate of the hotspot.
yhotp: Returns the y coordinate of the hotspot.

Description

The XmuLocateBitmapFile function reads a file in standard bitmap file format, using XReadBitmapFile, and returns the created bitmap.

The filename may be absolute, or relative to the global resource named bitmapFilePath with class BitmapFilePath. If the resource is not defined, the default value is the build symbol BITMAPDIR, which is typically /usr/include/X11/bitmaps. If srcnamelen is greater than zero and srcname is not NULL, the null-terminated filename will be copied into srcname. The size and hotspot of the bitmap are also returned.

References

XmuDrawRoundedRectangle(X3xmu), XmuDrawLogo(X3xmu), XmuCreateStippledPixmap(X3xmu), XmuReadBitmapData(X3xmu), XmuLocateBitmapFile(X3xmu), XmuCreatePixmapFromBitmap(X3xmu), XReadBitmapFile(X3xlib)
Xlib - C Language X Interface