home *** CD-ROM | disk | FTP | other *** search
/ AMIGA PD 1 / AMIGA-PD-1.iso / Programme_zum_Heft / Anwendungen / Kurztests / PBM / HPCDTOPPM_0_6.LHA / hpcdtoppm.0.6 / doc / README < prev    next >
Text File  |  1994-10-04  |  4KB  |  122 lines
  1.  
  2. This is Version 0.6 of hpcdtoppm, Hadmut's pcd to ppm converter.
  3. It has this name to be distinguishable in case someone
  4. else is producing a program also called pcdtoppm.
  5.  
  6. Read the README.TOO and edit the config.h and the Makefile !
  7.  
  8. This program converts Photo-CD-Images to the ppm-Format of
  9. pbmplus. You can compile the program in two ways:
  10.  
  11. 1. Use its own ppm-writing-routines. In this case
  12.    you don't need ppm-includes or libraries. You
  13.    have to define macro 'OWN_WRITE' in the source or
  14.    by compiler-option. I am not sure, whether the
  15.    format of the ppm-header is the same on non-unix
  16.    machines. If you get problems with line-endings
  17.    (things like CR, LF, CR/LF), modify the macro
  18.    PPM_Header.
  19.  
  20. 2. You can use the pbmplus-routines. In this case
  21.    you need some files from the pbmplus package to compile:
  22.  
  23.    ppm.h pgm.h pbm.h pbmplus.h libppm.a libpgm.a libpbm.a
  24.  
  25.  
  26. IMPORTANT: Some older versions of the gcc have problems with
  27. optimization. They produce buggy code. This code will not
  28. die with 'segmentation fault' or something like that, it 
  29. just produces damaged images. 
  30.  
  31. I did not have detailed information of the file-format and
  32. most of my information I got by staring at the hex-dumps
  33. of an image file. So I am not absolutly sure, whether it
  34. works on all Photo-CDs, because there are some bytes in
  35. the header which I don't understand. But it works on
  36. my Photo-CD.
  37.  
  38. Note that you will get a 24 bit image. You can view these
  39. files with xv, but if you have an 8-bit-screen you will
  40. sometimes have some color-defects (if you have an 1-bit-screen
  41. you will often have a lot of color-defects :-). 
  42. It will also take some time to show with xv.
  43.  
  44. You can produce nice overview prints if you get the icontact
  45. program of Mark B. Hanson and put something like
  46.  
  47. decode    pcd    hpcdtoppm -1 -a
  48.  
  49. in your ~/.icrc 
  50.  
  51. or by use of the pcdindex script of Pieter S. van der
  52. Meulen in this distribution.
  53.  
  54.  
  55. If you compile the program on a machine other than
  56. SPARC please send me a short email which machine
  57. you are using, whether you had problems or which
  58. changes you have made.
  59.  
  60. If you port the program to any machine, please tell me,
  61. what you did and where to get the program. Within the
  62. last weeks I got a lot of mail asking for the special
  63. Amiga/NeXT/SGI/... version. Read the Special.* files.
  64.  
  65.  
  66.  
  67. Thanks to
  68.  
  69. - James Pearson (jcpearso@ps.ucl.ac.uk) for giving debugging hints for 
  70.   the 64Base code, for sending a 64Base image and the code to find the
  71.   64Base files from the image file path.
  72.  
  73. - R. P. Channing ["Rick"] Rodgers (rodgers@nlm.nih.gov) for improving the
  74.   man page.
  75.  
  76.  
  77. - Some people sending code for TIFF and GIF writing code. Sorry, I didn't
  78.   have the time to implant the code yet. I don't know whether many people want
  79.   to have such extensions, please send mail if so.
  80.  
  81. - Adolf Mathias (mathias@ira.uka.de) for writing some of the
  82.   postscript drivers.
  83.  
  84. - Pieter S. van der Meulen for the contact sheet script.
  85.  
  86. - Jeff for finding out how to detect the orientation of the 
  87.   Overview thumbnails [ Hi Jeff, how are you? :-) ]
  88.  
  89. - A lot of people for sending mail about
  90.   compilation on MS-DOS and OS/2 and many other machines.
  91.  
  92. - lots and lots of people for sending me their improvements of the code.
  93.   Sorry, but I can not read and analyze them all. I do not have so
  94.   much time for the decoder, its my hobby, not my job. Often I get
  95.   mail with a complete source and "Hi Hadmut, I have improved your
  96.   code. It is now faster/smaller/better/something_else." But I don't
  97.   know, *what* is changed. A simple diff doesn't work, they all were
  98.   reformatting my source completely and I do not have the time to
  99.   read all sources to find the real changes. There are a lot
  100.   of real good ideas, but *please* tell me, where is the beef.
  101.  
  102. - lots of people sending me just a formatted version of my code.
  103.   Thanks to them all, and yes, I have indent(1). I prefer
  104.   this way of formatting C-source.
  105.  
  106.  
  107.  
  108.  
  109. Hadmut Danisch  (danisch@ira.uka.de , will change in future)
  110. E.I.S.S.  (European Institute for System Security)
  111. Universitaet Karlsruhe
  112. Am Fasanengarten 5
  113.  
  114. D-76128 Karlsruhe  
  115.  
  116. Germany
  117.  
  118. FAX: +49 721 696893
  119. Tel./FAX privat: +49 721 607306  (will change in future)
  120.  
  121.  
  122.