home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume34 / hpcdtoppm / part01 / README < prev    next >
Text File  |  1992-12-19  |  2KB  |  59 lines
  1. This is Version 0.3 of hpcdtoppm, Hadmut's pcd to ppm converter.
  2. It has this name to be distinguishable in case someone
  3. else is producing a program also called pcdtoppm.
  4.  
  5. Read the README.TOO !
  6.  
  7. This program converts Photo-CD-Images to the ppm-Format of
  8. pbmplus. You can compile the program in two ways:
  9.  
  10. 1. Use its own ppm-writing-routines. In this case
  11.    you don't need ppm-includes or libraries. You
  12.    have to define macro 'OWN_WRITE' in the source or
  13.    by compiler-option. I am not sure, whether the
  14.    format of the ppm-header is the same on non-unix
  15.    machines. If you get problems with line-endings
  16.    (things like CR, LF, CR/LF), modify the macro
  17.    PPM_Header.
  18.  
  19. 2. You can use the trusted pbmplus-routines. In this case
  20.    you need some files from the pbmplus package to compile:
  21.  
  22.    ppm.h pgm.h pbm.h pbmplus.h libppm.a libpgm.a libpbm.a
  23.  
  24.  
  25. IMPORTANT: Some older versions of the gcc have problems with
  26. optimization. They produce buggy code. This code will not
  27. die with 'segmentation fault' or something like that, it 
  28. just produces damaged images. 
  29.  
  30. I did not have detailed information of the file-format and
  31. i could test it only with a single Photo-CD with 24 Images.
  32. Most of my information i got by starring 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.  
  52. If you compile the program on a machine other than
  53. SPARC please send me a short email which machine
  54. you are using, whether you had problems or which
  55. changes you have made.
  56.  
  57. Hadmut  (danisch@ira.uka.de)
  58.  
  59.