GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTPARSEXPMDATA (3)

NAME

XmtParseXpmData(), XmtParseXpmFile(), XmtFreeXmtImage() - parse an XPM pixmap into the intermediate XmtImage format.

CONTENTS

SYNOPSIS

   #include <Xmt/Xpm.h>

   XmtImage *XmtParseXpmData(String *data)

   XmtImage *XmtParseXpmFile(String filename)

   void XmtFreeXmtImage(XmtImage *image)

ARGUMENTS

INPUTS
data An array of strings defined by an XPM file that has been included into an application.
filename The name of a file containing pixmap data in XPM format.
image An XmtImage to be freed.
RETURNS

XmtParseXpmData() and XmtParseXpmFile() return an XmtImage, or NULL, if the XPM data was invalid or the file could not be found. The returned XmtImage should be freed when no longer need with XmtFreeXmtImage().

DESCRIPTION

XmtParseXpmData() parses the specified array of strings (declared by an #included XPM file) into an XmtImage structure. On success, it returns a pointer to the allocated XmtImage. If the data was invalid, it returns NULL.

XmtParseXpmFile() reads the contents of the specified file, and parses it into an XmtImage structure. It returns a pointer to an allocated XmtImage structure on success, or NULL if the file could not be read, or if the file contained invalid data.

When the XmtImage returned by either of these functions is no longer needed, they may be freed by calling XmtFreeXmtImage().

An XmtImage structure is a parsed representation of an XPM pixmap file. The symbolic color names it contains have not yet been looked up, nor have any pixel values been allocated for a specific display and colormap. An XmtImage may be converted to a Pixmap in an additional step, by calling XmtCreatePixmapFromXmtImage(), or it may be cached for later lookup and conversion in the Xmt image cache by calling XmtRegisterImage().

SEE ALSO

Chapter 5, Using Icons,
XmtCreatePixmapFromXmtImage(), XmtCreateXImageFromXmtImage(), XmtGetPixmap(), XmtLookupPixmap(), XmtRegisterImage().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTPARSEXPMDATA (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.