XmuLocateBitmapFile(Xmu) X Version 11 (Release 5)   XmuLocateBitmapFile(Xmu)
                                6 January 1993


 Name

    XmuLocateBitmapFile - locate and return bitmap

 Syntax


    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 typi-
    cally /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

    XmuDrawRoundedRectangle(Xmu), XmuDrawLogo(Xmu), XmuCre-
    ateStippledPixmap(Xmu), XmuReadBitmapData(Xmu), XmuLocateBitmapFile(Xmu),
    XmuCreatePixmapFromBitmap(Xmu), XReadBitmapFile(XS)
    Xlib - C Language X Interface