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


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004