libxpm-3.4k: description + notes

XPM (X PixMap) is a format for storing/retrieving X pixmaps to/from files.

Here is provided a library containing a set of four functions, similar to the X bitmap functions as defined in the Xlib: XpmCreatePixmapFromData,XpmCreateDataFromPixmap, XpmReadFileToPixmap and XpmCreateImageFromData, XpmCreateDataFromImage,XpmWriteFileFromImage for working with images instead of pixmaps.

This new version provides a C includable format, defaults for different types of display: monochrome/color/grayscale, hotspot coordinates and symbol names for colors for overriding default colors when creating the pixmap. It provides a mechanism for storing information while reading a file which is re-used while writing. This way comments, default colors and symbol names aren't lost. It also handles "transparent pixels" by returning a shape mask in addition to the created pixmap.

See the XPM Manual for details.

NOTE: Developers intending to use this distribution of libxpm for application development should be sure to read the information below. Users installing libxpm for the runtime environment only need not read any further.

Developers intending to use this library for development of other freeware packages or their own software applications will need to be familiar with a few peculiarities due to the way that this library is packaged and installed. The reasons for this installation strategy are described further in the fw_common product release notes.

The header files and libraries in this package are installed into /usr/freeware. This means that when building software using this distribution of libxpm you should be sure to do the following:

Following these guidelines will allow your application to safely and easily use the software in this package.
To auto-install this package, go back and click on the respective install icon.