home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #18 / NN_1992_18.iso / spool / comp / windows / x / 15310 < prev    next >
Encoding:
Internet Message Format  |  1992-08-17  |  6.9 KB
  1. Path: sparky!uunet!mcsun!corton!sophia!koala.inria.fr!lehors
  2. From: lehors@koala.inria.fr (Arnaud Le Hors)
  3. Newsgroups: comp.windows.x
  4. Subject: ** XPM3.2a is available **
  5. Message-ID: <27140@sophia.inria.fr>
  6. Date: 17 Aug 92 16:04:00 GMT
  7. Sender: news@sophia.inria.fr
  8. Organization: Koala Project, Bull Research France
  9. Lines: 202
  10.  
  11.  
  12. (For those who don't know what XPM is yet, I've appended to this message the
  13. xpm README file.)
  14.  
  15. Nothing really important just some fixes.
  16.  
  17. It is on export.lcs.mit.edu in contrib dir and on avahi.inria.fr in pub/xpm
  18. dir.
  19. Here is the changes :
  20.  
  21.  
  22. 3.2a        (92/08/17)
  23.  
  24.     ENHANCEMENTS:
  25.         - use the mock lisp hashing function instead of the gnu emacs one,
  26.     it is faster in some cases and never slower (I've not found any case).
  27.  
  28.     BUGS CORRECTED:
  29.     - function prototypes for ansi compilers.
  30.     - some memory initialization bugs (purify is just great for this).
  31.     - empty strings in extensions are now correctly handled.
  32.  
  33. -- 
  34.  Arnaud LE HORS - lehors@sophia.inria.fr - BULL Research France, Koala Project
  35.  
  36. -------------------------------- XPM README -----------------------------------
  37. ** Copyright 1990-92 GROUPE BULL -- See license conditions in file COPYRIGHT **
  38.  
  39.                 XPM Version 3
  40.  
  41. WHAT IS XPM?
  42. ============
  43.  
  44. XPM (X PixMap) is a format for storing/retrieving X pixmaps to/from files.
  45.  
  46. Here is provided a library containing a set of four functions, similar to the
  47. X bitmap functions as defined in the Xlib: XpmCreatePixmapFromData,
  48. XpmCreateDataFromPixmap, XpmReadFileToPixmap and XpmWriteFileFromPixmap for
  49. respectively including, storing, reading and writing this format, plus four
  50. other: XpmCreateImageFromData, XpmCreateDataFromImage, XpmReadFileToImage and
  51. XpmWriteFileFromImage for working with images instead of pixmaps.
  52.  
  53. This new version provides a C includable format, defaults for different types
  54. of display: monochrome/color/grayscale, hotspot coordinates and symbol names
  55. for colors for overriding default colors when creating the pixmap. It provides
  56. a mechanism for storing information while reading a file which is re-used
  57. while writing. This way comments, default colors and symbol names aren't lost.
  58. It also handles "transparent pixels" by returning a shape mask in addition to
  59. the created pixmap.
  60.  
  61. See the XPM Manual for more details.
  62.  
  63. HOW TO GET XPM?
  64. ===============
  65.  
  66. New xpm updates are announced on the comp.windows.x newsgroup, and on the
  67. "xpm-talk" list. All new "official" xpm releases can be found by ftp on:
  68.  
  69.     export.lcs.mit.edu (18.30.0.238) contrib     (Boston, USA)
  70.     avahi.inria.fr     (192.5.60.47) pub     (Sophia Antipolis, France)
  71.  
  72.  
  73. DOCUMENTATION:
  74. =============
  75.  
  76. Old users might read the CHANGES file for a history of changes interesting
  77. the user.
  78.  
  79. Read the docs (xpm.tex is the manual in LaTeX form). The documentation is in
  80. LaTeX format (IMPORTANT: see the Makefile to know how to print it. The LaTeX
  81. source should work with most dvi2ps or dvips programs. I use myself Tomas
  82. Rokicki's dvips v5.0 that you can get by anonymous ftp on
  83. labrea.stanford.edu).  We can mail you a PostScript version of the
  84. documentation if you are not able to print it, or you can grab one on the ftp
  85. servers.
  86.  
  87. INSTALLATION:
  88. ============
  89.  
  90. To obtain the XPM library, first uncompress and untar the compressed tar file
  91. in an approriate directory.
  92.  
  93. Then you can either compile xpm via "imake" or in a stand-alone way.
  94.  
  95. WITH IMAKE:
  96.  
  97.     The Imakefile is provided. You should know how to use imake to build 
  98.     the XPM Makefile, by executing "xmkmf" then do:
  99.  
  100.         make depend
  101.         make
  102.  
  103.     which will build the XPM library and sxpm application. 
  104.     Then do:
  105.  
  106.              make install
  107.         make install.man
  108.  
  109.     which will install the library and the sxpm man page.
  110.  
  111.     If it fails, you may edit the Imakefile to add compilation flags to
  112.     suit your machine.
  113.  
  114. WITHOUT IMAKE:
  115.  
  116.     To compile xpm, in the xpm directory you just created, do:
  117.  
  118.             make -f Makefile.noXtree
  119.  
  120.     Then to install it, do:
  121.  
  122.         make -f Makefile.noXtree install
  123.  
  124. NOTE:   if you compile  with gcc, use "gcc -traditional", otherwise you will
  125.         have compilation warnings (but the code will work Ok)
  126.  
  127. SXPM:
  128. ====
  129.  
  130. In addition to the library the sxpm tool is provided to show XPM file and
  131. convert them from XPM2 to XPM version 3. If you have previously done 'make' or
  132. 'make all' you should have it yet, otherwise just do:
  133.  
  134.               make sxpm
  135.  
  136. This application shows you most of the features of XPM and its source can be
  137. used to quickly see how to use the provided functions
  138.  
  139. By executing 'sxpm' without any option you will get the usage.
  140.  
  141. Executing 'sxpm -plaid' will show a demo of the XpmCreatePixmapFromData
  142. function. The pixmap is created from the static variable plaid defined in the
  143. sxpm.c file. Sxpm will end when you press the key Q in the created window.
  144.  
  145. Executing 'sxpm -plaid -s lines_in_mix blue' will show the feature of
  146. overriding color symbols giving a colorname, and executing 'sxpm -p
  147. lines_in_mix 1' will show overriding giving pixel value.
  148.  
  149. Then you should try 'sxpm -plaid -o output' to get an output file using the
  150. XpmWriteFileFromPixmap function.
  151.  
  152. You can now try 'sxpm -plaid -o - -nod -rgb /usr/lib/X11/rgb.txt' to directly
  153. get the pixmap printed out on the standard output with colornames instead of
  154. rgb values.
  155.  
  156. Then you should try 'sxpm plaid.xpm' to use the XpmReadFileToPixmap function,
  157. and 'cat plaid_mask.xpm|sxpm' to see how "transparent pixels" are handled.
  158.  
  159. The XpmCreatePixmapFromData function is on purpose called without any Xpminfo 
  160. pointer to show the utility of this one. Indeed, compare the color section of
  161. the two files foo and bar obtained from 'sxpm -nod -plaid -o foo' and 
  162. 'sxpm -nod plaid.xpm -o bar'.
  163.  
  164. To end look at plaid_ext.xpm and try "sxpm -nod plaid_ext.xpm -v" to see how
  165. extensions are handled.
  166.  
  167. Of course, other combinations are allowed and should be tried. Thus, 'sxpm
  168. plaid.xpm -o output -nod' will show you how to convert a file from XPM2 to a
  169. XPM version 3 using sxpm.
  170.  
  171. See the manual page for more detail.
  172.  
  173. CONVERTERS:
  174. ==========
  175.  
  176. In the converters directory you can find different converters about XPM.
  177. There is a perl script xpm1to3.pl to convert XPM1 format file to XPM version
  178. 3. And there are files to build the converters ppmtoxpm and xpmtoppm; to get
  179. instructions about how to build them you should read the corresponding
  180. ppm.README file.
  181.  
  182. KNOWN BUG:
  183. =========
  184.  
  185. If two symbols get the same color pixel when reading a pixmap, one will be
  186. lost when writting it out.
  187.  
  188. DISCUSSION:
  189. ==========
  190.  
  191. There is a mailing list to discuss about XPM which is xpm-talk@sophia.inria.fr.
  192. Any request to subscribe should be sent to xpm-talk-request@sophia.inria.fr.
  193.  
  194. COPYRIGHT:
  195. ==========
  196.  
  197.   Copyright 1990,91 GROUPE BULL --
  198.   See license conditions in the COPYRIGHT file of the XPM distribution
  199.  
  200. Please mail any bug reports or modifications done, comments, suggestions,
  201. requests for updates or patches to port on another machine to:
  202.  
  203. lehors@sophia.inria.fr        (INTERNET)
  204.  
  205. 33 (FRANCE) 93.65.77.71        (VOICE PHONE)
  206.  
  207. Arnaud Le Hors            (SURFACE MAIL)
  208. Bull c/o Inria BP. 109
  209. 2004, Route des lucioles
  210. Sophia Antipolis
  211. 06561 Valbonne Cedex
  212. FRANCE
  213.