home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1996 May / PCOnline_05_1996.bin / linux / source / x / x11r6-ch / xpm-3.4 / xpm-3 / xpm-3.4c / README.MSW < prev   
Text File  |  1994-06-06  |  3KB  |  84 lines
  1.  
  2. README.MSW    hedu@cul-ipn.uni-kiel.de    5/94
  3.  
  4.         The XPM library for MS-Windows
  5.         
  6. Motivated by the wxWindows library, which is a (freely available) toolkit
  7. for developing multi-platform, graphical applications from the same body 
  8. of C++ code,I wanted to have XPM pixmaps for MS-windows. Instead of rewriting 
  9. a XPM-parser I managed to port the XPM-library-code to MS-windows.
  10. Thanks to Anaud Le Hors  this became a part of the official XPM-library.
  11.  
  12. Until now it's only used together with wxWindows. And even there it's more 
  13. a kind of beta. But it should be possible to run it as a simple libxpm.a 
  14. without wxWindows.
  15.  
  16. The key is a transformation of some X types plus some basic X functions.
  17. There is not yet a special MSW-API, so you should know the X types used.
  18.  
  19. The following is done in simx.h:
  20.  
  21. typedef HDC Display;
  22. typedef COLORREF Pixel;
  23.  
  24. typedef struct {
  25.     Pixel pixel;
  26.     BYTE red, green, blue;
  27. }      XColor;
  28.  
  29. typedef struct {
  30.     HBITMAP bitmap;
  31.     unsigned int width;
  32.     unsigned int height;
  33.     unsigned int depth;
  34. }      XImage;
  35.  
  36. With these defines and the according functions from simx.c you can call
  37. XPM-functions the way it's done under X windows. It can look like this:
  38.  
  39.     ErrorStatus=XpmCreateImageFromData(&dc, data, 
  40.                 &ximage,(XImage **)NULL, &xpmAttr);
  41.     ms_bitmap = ximage->bitmap;
  42.     // releases the malloc,but do not destroy the bitmap
  43.     XImageFree(ximage);
  44.     
  45. Supported functions are the Xpm*Image* but not the Xpm*Pixmap*.
  46.  
  47. DRAWBACKS:
  48. The main drawback is the missing support for Colormaps! There was nothing for
  49. it in wxWindows, so I did not know how to deal with Colormaps.
  50.  
  51. The size of the pixmaps is bounded by malloc() (width*height*2 < 64K).
  52.  
  53. Close colors do not look that close. But that seems to be the window system.
  54.  
  55. Neither a special API for MSW nor a special MSW documentation other than this.
  56. (I can only point you to wxxpm as an example , see below.)
  57.  
  58. INSTALLATION:
  59. There is not yet a makefile with it. Simply take all the *.c files
  60. into your project. 
  61. !!!You MUST set FOR_MSW on the preprocessor options!!!
  62. (You might uncomment NEED_STRCASECMP in xpm.h if it's in your lib)
  63. This should compile into libxpm.a. Good luck...
  64.  
  65. FTP:  
  66. wxWindows is currently available from the Artificial Intelligence
  67. Applications Institute (University of Edinburgh) by anonymous FTP.
  68.     skye.aiai.ed.ac.uk  pub/wxwin/
  69. or read http://burray.aiai.ed.ac.uk/aiai/aiai.html
  70.  
  71. wxxpm, XPM support for wxWindows, the latest version is available at
  72.     yoda.cul-ipn.uni-kiel.de pub/wxxpm/
  73.     and maybe in the contrib or tools of wxWindows
  74.     
  75. Please contact me if you have suggestions, comments or problems!
  76.  
  77. --
  78.    ////|\\\\   \\\\\\  Hermann Dunkel
  79.      O   O     //////  IPN Uni Kiel, Germany
  80.        |       \\\\\\  Tel: +49 431 / 880 3144
  81.      \___/     //////  E-mail: hedu@cul-ipn.uni-kiel.de
  82.       \_/      \\\\\\  X.400 : c=de;a=d400;p=uni-kiel;ou=nw-didaktik;s=dunkel
  83.  
  84.