switched to new XPM code in wxMSW

[wxWidgets.git] / src / xpm / readme.msw

diff --git a/src/xpm/readme.msw b/src/xpm/readme.msw
index 6e97bb598918347dd4e4925d23b7661620ff89b5..f6315256e9e4da9b9425133be278b81f822ed6a1 100644 (file)
--- a/src/xpm/readme.msw
+++ b/src/xpm/readme.msw
@@ -5,9 +5,9 @@ README.MSW      hedu@cul-ipn.uni-kiel.de        5/94
                
 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 
+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.
+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 
@@ -57,7 +57,7 @@ Neither a special API for MSW nor a special MSW documentation other than this.
 
 INSTALLATION:
 There is not yet a makefile with it. Simply take all the *.c files
-into your project. 
+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...
@@ -74,6 +74,50 @@ wxxpm, XPM support for wxWindows, the latest version is available at
        
 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