128 lines
4.3 KiB
Plaintext
128 lines
4.3 KiB
Plaintext
|
|
||
|
|
README.MSW hedu@cul-ipn.uni-kiel.de 5/94
|
||
|
|
|
||
|
|
The XPM library for MS-Windows
|
||
|
|
|
||
|
|
Motivated by the wxWindows library, which is a (freely available) toolkit
|
||
|
|
for developing multi-platform, graphical applications from the same body
|
||
|
|
of C++ code, I wanted to have XPM pixmaps for MS-windows. Instead of rewriting
|
||
|
|
a XPM-parser I managed to port the XPM-library-code to MS-windows.
|
||
|
|
Thanks to Anaud Le Hors this became a part of the official XPM-library.
|
||
|
|
|
||
|
|
Until now it's only used together with wxWindows. And even there it's more
|
||
|
|
a kind of beta. But it should be possible to run it as a simple libxpm.a
|
||
|
|
without wxWindows.
|
||
|
|
|
||
|
|
The key is a transformation of some X types plus some basic X functions.
|
||
|
|
There is not yet a special MSW-API, so you should know the X types used.
|
||
|
|
|
||
|
|
The following is done in simx.h:
|
||
|
|
|
||
|
|
typedef HDC Display;
|
||
|
|
typedef COLORREF Pixel;
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
Pixel pixel;
|
||
|
|
BYTE red, green, blue;
|
||
|
|
} XColor;
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
HBITMAP bitmap;
|
||
|
|
unsigned int width;
|
||
|
|
unsigned int height;
|
||
|
|
unsigned int depth;
|
||
|
|
} XImage;
|
||
|
|
|
||
|
|
With these defines and the according functions from simx.c you can call
|
||
|
|
XPM-functions the way it's done under X windows. It can look like this:
|
||
|
|
|
||
|
|
ErrorStatus=XpmCreateImageFromData(&dc, data,
|
||
|
|
&ximage,(XImage **)NULL, &xpmAttr);
|
||
|
|
ms_bitmap = ximage->bitmap;
|
||
|
|
// releases the malloc,but do not destroy the bitmap
|
||
|
|
XImageFree(ximage);
|
||
|
|
|
||
|
|
Supported functions are the Xpm*Image* but not the Xpm*Pixmap*.
|
||
|
|
|
||
|
|
DRAWBACKS:
|
||
|
|
The main drawback is the missing support for Colormaps! There was nothing for
|
||
|
|
it in wxWindows, so I did not know how to deal with Colormaps.
|
||
|
|
|
||
|
|
The size of the pixmaps is bounded by malloc() (width*height*2 < 64K).
|
||
|
|
|
||
|
|
Close colors do not look that close. But that seems to be the window system.
|
||
|
|
|
||
|
|
Neither a special API for MSW nor a special MSW documentation other than this.
|
||
|
|
(I can only point you to wxxpm as an example , see below.)
|
||
|
|
|
||
|
|
INSTALLATION:
|
||
|
|
There is not yet a makefile with it. Simply take all the *.c files
|
||
|
|
into your project except the files related to Pixmap operations: *P*.c.
|
||
|
|
!!!You MUST set FOR_MSW on the preprocessor options!!!
|
||
|
|
(You might uncomment NEED_STRCASECMP in xpm.h if it's in your lib)
|
||
|
|
This should compile into libxpm.a. Good luck...
|
||
|
|
|
||
|
|
FTP:
|
||
|
|
wxWindows is currently available from the Artificial Intelligence
|
||
|
|
Applications Institute (University of Edinburgh) by anonymous FTP.
|
||
|
|
skye.aiai.ed.ac.uk pub/wxwin/
|
||
|
|
or read http://burray.aiai.ed.ac.uk/aiai/aiai.html
|
||
|
|
|
||
|
|
wxxpm, XPM support for wxWindows, the latest version is available at
|
||
|
|
yoda.cul-ipn.uni-kiel.de pub/wxxpm/
|
||
|
|
and maybe in the contrib or tools of wxWindows
|
||
|
|
|
||
|
|
Please contact me if you have suggestions, comments or problems!
|
||
|
|
|
||
|
|
================================================================
|
||
|
|
Some fixes and comments by Jan Wielemaker (jan@swi.psy.uva.nl),
|
||
|
|
Oct 24, 1996:
|
||
|
|
|
||
|
|
* Please try not to disturb me on this, XPM is not my
|
||
|
|
piece of cake.
|
||
|
|
|
||
|
|
* Hermann Dunkel has appearently moved in virtual space.
|
||
|
|
|
||
|
|
Changes:
|
||
|
|
|
||
|
|
* I've used the xpm package under NT 4.0 and MSVC++ 4.2.
|
||
|
|
|
||
|
|
* I've made a big performance improvement in
|
||
|
|
ParseAndPutPixels(), fixed creation of the mask in
|
||
|
|
SetColor() in create.c. I looked into XCreateImage()
|
||
|
|
in simx.c, but commented out my improvement for reasons
|
||
|
|
you'll find there. If you know what is going on, statement
|
||
|
|
(1) does not apply to you.
|
||
|
|
|
||
|
|
Comments on installation:
|
||
|
|
|
||
|
|
* Donot include the to/from pixmap files into the project.
|
||
|
|
These are the ones containing a capital P somewhere in their
|
||
|
|
name. You can also first include all, and then remove all
|
||
|
|
the files you get errors on :-)
|
||
|
|
|
||
|
|
* The DC that is requested should be a valid memory DC, thus
|
||
|
|
CreateCompatibleDC(NULL) provides a good generic one, but
|
||
|
|
GetDC(NULL) doesn't! This costed me some time.
|
||
|
|
|
||
|
|
* The real difficulty is using the mask, mostly due to the
|
||
|
|
bad documentation. If 95 or NT is your target, use:
|
||
|
|
|
||
|
|
MaskBlt(context.hdc, // Destination DC
|
||
|
|
x, y, w, h, // Destination area
|
||
|
|
mhdc, // Memory DC with the image selected
|
||
|
|
sx, sy, // Source X,Y
|
||
|
|
msk, // HBITMAP of the mask
|
||
|
|
sx, sy, // Mask X,Y
|
||
|
|
MAKEROP4(SRCPAINT, SRCCOPY)); // The magic op code.
|
||
|
|
================================================================
|
||
|
|
|
||
|
|
|
||
|
|
--
|
||
|
|
////|\\\\ \\\\\\ Hermann Dunkel
|
||
|
|
O O ////// IPN Uni Kiel, Germany
|
||
|
|
| \\\\\\ Tel: +49 431 / 880 3144
|
||
|
|
\___/ ////// E-mail: hedu@cul-ipn.uni-kiel.de
|
||
|
|
\_/ \\\\\\ X.400 : c=de;a=d400;p=uni-kiel;ou=nw-didaktik;s=dunkel
|
||
|
|
|