|
NAMEXmtLookupPixmap(), XmtLookupSimplePixmap(), XmtLookupWidgetPixmap(), XmtLookupBitmap(), XmtLookupBitmask() - get a named pixmap or bitmap from the Xmt image cache.SYNOPSIS#include <Xmt/Pixmap.h>
Pixmap XmtLookupPixmap(Widget w, Visual *visual, Colormap colormap, unsigned int depth, XmtColorTable colortable, String name) Pixmap XmtLookupSimplePixmap(Widget w, XmtColorTable colortable, String name) Pixmap XmtLookupWidgetPixmap(Widget w, String name) Pixmap XmtLookupBitmap(Widget w, String name) Pixmap XmtLookupBitmask(Widget w, String name) ARGUMENTSINPUTS
RETURNS A multi-plane pixmap or single-plane bitmap created as described below, or None if the named data could not be found or converted. When no longer needed, the returned Pixmap should be freed with XmtReleasePixmap(). DESCRIPTIONXmtLookupPixmap() looks up XBM or XmtImage data registered in the image cache with the name name. If no data is found, it returns None. Otherwise, it looks up and returns a cached Pixmap containing that data for the screen of w and for the specified depth, visual, colormap and color table. If no such pixmap is found, it creates one and adds it to the cache.XmtLookupSimplePixmap() is a simplified version of XmtLookupPixmap(). It uses the visual, colormap and depth of the specified widget w. XmtLookupWidgetPixmap() is a further simplified version of XmtLookupPixmap(). Besides passing the visual, colormap, and depth of w, it also passes the default color table of the application, specified by the Xmt colorTable application resource. XmtLookupBitmap() looks up the XBM data registered in the image cache with the name name. If no data is found, it returns None. Otherwise, it looks up and returns a single plane Pixmap for the screen of w that contains the data. If no such pixmap already exists, it creates one and adds it to the cache. XmtLookupBitmask() looks up the named image in the Xmt image cache. If that image is XBM data that was registered with a mask, or if it is an XmtImage with ``transparent'' pixels, then this function looks up and returns or creates, caches and returns a single-plane Pixmap for the screen of w that contains the mask data for the named image. When the pixmaps returned by these functions will no longer be needed, they can be released from the cache by calling XmtReleasePixmap(). This will decrement their reference count and remove them from the cache if that reference count reaches zero. SEE ALSOChapter 5, Using Icons,XmtGetBitmap(), XmtGetPixmap(), XmtRegisterImage(), XmtRegisterXbmData(), XmtReleasePixmap().
Visit the GSP FreeBSD Man Page Interface. |