Click above to get retro games delivered to your door ever month!

ShowXPM

Display a X Windows Pixmap/Desqview/X XPM image


Syntax

SHOWXPM <cFILENAME.XPM> [<nScreenWidth>] [<nScreenHeight>]


Arguments

<cFILENAME.XPM>
The XPM image to display, with drive and path if necessary.

<nScreenWidth>
Optional screen width, otherwise will display in first available video mode 
that the image fits in.

<nScreenHeight>
Optional screen height, otherwise will display in first available video mode 
that the image fits in.


DOS Error Messages

Can not open <cFILENAME.XPM>
<cFILENAME.XPM> is not a X Windows .XPM file
This is not a Type I, II, or II XPM file
Unable to find a graphic mode for this image
Can not allocate memory for line buffers
This XPM file type is not supported


Remarks

The XPM (X PixMap) is an ASCII-based image format for storing/retrieving X 
Windows "pixmaps" or icons. It is a quite unusual, e-mailable, ASCII, 
portable format, compared to conventional PC image formats which are 
normally binary, and represents another tool in the image developers toolkit.

Since there are type I, II, III, there may be some incompatibilities between 
MS-DOS and Unix derived XPM images. Quarterdeck Systems, Inc. DESQview/X 
only supports type I with certain palette limitations. Sunshow's display 
modules provide complete support for types I, II & III and 24-bit support, 
RGB palette and working with bilevel (XBM), color, and grayscale. 

Unless the <nScreenWidth> and <nScreenHeight> parameters are used, ShowXPM 
does not force a video mode. It simply finds the first available video mode 
that the image coordinates will fit into. Therefore, most small XPM icons 
will default to 320x200x256, Video Mode 19. While probably not the intended 
mode of use, it is still useful for viewing your icons. They display as 
usually intended or more correctly at 640x480 SVGA or higher at a 1:1 pixel 
aspect ratio.


Example

Display module forces display of 129x92 pixel CORRIDOR.XPM to 640x480 video 
mode.

SHOWXPM CORRIDOR.XPM 640 480