home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_docs.lzh / NETPBM / DOCS / hpcdtoppm.1 < prev    next >
Text File  |  1996-11-18  |  4KB  |  98 lines
  1. .TH hpcdtoppm 1 " 28 November 1992"
  2. .IX hpcdtoppm
  3. .SH NAME
  4. hpcdtoppm v0.3 - convert a Photo-CD file into a portable pixmap
  5. .SH SYNOPSIS
  6. .B hpcdtoppm
  7. [options] pcd-file [ppm-file]
  8. .SH DESCRIPTION
  9. Reads a Photo-CD Image file or Overview file, and outputs portable pixmap.
  10. Image files you can find on the Photo-CD in photo_cd/images, they are named
  11. as "imgnnnn.pcd", where nnnn is a 4-digit-number. The Overview file is at
  12. photo_cd/overview.pcd . If there is no ppm-file-name given, output will be
  13. printed to stdout. hpcdtoppm stands for "Hadmut's pcdtoppm" to make it
  14. distinguishable in case someone else is building the same thing and
  15. calling it pcdtoppm.
  16. .IX GIF
  17. .SH OPTIONS
  18. .TP
  19. .B -i
  20. Give some information from the fileheader to stderr. It works only for 
  21. Image files. (It is not working correctly, just printing some strings.)
  22. .TP
  23. .B -s
  24. Apply simple sharpness-operator on the Luma-channel.
  25. .TP
  26. .B -d
  27. Do not show the complete image, but only the decompressed difference.
  28. It works only on the 4Base and the 16Base resolution. It does not
  29. have any deeper sense, but it was simple to implement and it shows what
  30. causes different sizes of image files.
  31. .TP
  32. .B -r
  33. Rotate the picture clockwise for portraits.
  34. .TP
  35. .B -l
  36. Rotate the picture counter-clockwise for portraits.
  37. .TP
  38. .B -a
  39. Try to find out the image orientation byself. This doesn't work
  40. for overview files yet. It is very experimental and depends on
  41. one byte. Please tell me if it doesn't work.
  42. .TP
  43. .B -x
  44. Overskip Mode. Works on Base/16, Base/4, Base and 4Base. In Photo-CD
  45. images the luma channel is stored in full resolution, the two chroma
  46. channels are stored in half resolution only and have to be interpolated.
  47. In the Overskip Mode the chroma channels of the next higher resolution are
  48. taken instead of interpolating. To see the difference, generate one ppm with
  49. and one ppm without this flag. Use pnmarith to generate the difference image
  50. of these two images. Call ppmhist for this difference or show it with xv
  51. (push the HistEq button in the color editor).
  52. .TP
  53. .B -1 | -Base/16 | -128x192
  54. Extract the Base/16 size picture (size 128x192 pixels). Note that you
  55. can only give one size option.
  56. .TP
  57. .B -2 | -Base/4 | -256x384
  58. Extract the Base/4 size picture.
  59. .TP
  60. .B -3 | -Base | -512x768
  61. Extract the Base size picture.
  62. .TP
  63. .B -4 | -4Base | -1024x1536
  64. Extract the 4Base size picture.
  65. .TP
  66. .B -5 | -16Base | -2048x3072
  67. Extract the 16Base size picture.
  68. .TP
  69. .B -0 | -Overview | -O
  70. Extract all pictures from an Overview file. A ppmfilename must be given. If the
  71. given name is "foo", the files are named "foonnnn", where nnnn is a 4-digit number.
  72. Since they are stored in Base/16 format, they are extracted in this format.
  73. .TP
  74. .B -ycc
  75. Suppress the ycc to rgb conversion. This is experimental only.
  76. You can use this and apply ppmtorgb3 on the file. Then you will
  77. get three pgm-files, one Luma and two Chroma files. 
  78.  
  79. .PP
  80.  
  81. .SH BUGS
  82. I still don't have enough information about the Photo-CD to
  83. take care of all data structures. The informations i have are
  84. quite vague and this program was developed by starring at the
  85. hex-dumps and the famous trial-and-error-method. :-) If anything
  86. doesn't work, please send me a report and perhaps you could try to
  87. find out, why it doesn't work.
  88. .SH "SEE ALSO"
  89. ppm(5), ppmquant(1), ppmtopgm(1), ppmhist(1), pnmarith(1), ppmtorgb3(1), xv(1)
  90. .SH AUTHOR
  91. Copyright (c) 1992 by Hadmut Danisch (danisch@ira.uka.de).
  92. Permission to use and distribute this software and its
  93. documentation for noncommercial use and without fee is hereby granted,
  94. provided that the above copyright notice appear in all copies and that
  95. both that copyright notice and this permission notice appear in
  96. supporting documentation. It is not allowed to sell this software in 
  97. any way. This software is not public domain.
  98.