NAME

XmuLocatePixmapFile — create a pixmap from a file in a standard location. 

SYNOPSIS

#include <X11/Xmu/Drawing.h>

Pixmap XmuLocatePixmapFile (screen, name, fore, back, depth, srcname,
 srcnamelen, widthp, heightp, xhotp, yhotp)
    Screen ∗screen;
    char ∗name;
    unsigned long fore, back;
    unsigned int depth;
    char ∗srcname;
    int srcnamelen;
    int ∗widthp, ∗heightp, ∗xhotp, ∗yhotp;

ARGUMENTS

screenSpecifies the screen. 

nameSpecifies the pixmap filename. 

fore, backSpecify the foreground and background colors of the pixmap. 

depthSpecifies the depth of the pixmap. 

srcnameReturns the absolute filename of the pixmap. 

srcnamelenSpecifies the length of the srcname buffer. 

widthp, heightp
Return the width and height of the pixmap.

xhotp, yhotpReturn the x and y coordinates of the pixmap hotspot. 

AVAILABILITY

Release 5 and later. 

DESCRIPTION

This function reads a file in standard bitmap file format, using XmuReadBitmapDataFromFile and creates a pixmap with the specified foreground and background colors and specified depth using XCreatePixmapFromBitmapData().  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 /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. 

SEE ALSO

XmuLocateBitmapFile, XmuCreatePixmapFromBitmap, XmuReadBitmapData, XmuReadBitmapDataFromFile, XCreatePixmapFromBitmapData().