home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / hpcd051b / hpcdtopp.1 next >
Text File  |  1993-12-14  |  8KB  |  213 lines
  1. hpcdtoppm(1)             USER COMMANDS               hpcdtoppm(1)
  2.  
  3. NAME
  4.      hpcdtoppm v0.5 pl1 - convert a Photo-CD file into a portable
  5.      pixmap
  6.  
  7. SYNOPSIS
  8.      hpcdtoppm [options] pcd-file [ppm-file]
  9.  
  10. DESCRIPTION
  11.      Decodes a Photo-CD Image file or Overview file.  Image files
  12.      you  can  find  on the Photo-CD in photo_cd/images, they are
  13.      named as "imgnnnn.pcd", where nnnn is a 4-digit-number.  The
  14.      Overview  file  is at photo_cd/overview.pcd . If there is no
  15.      output filename given, output will  be  printed  to  stdout.
  16.      hpcdtoppm  stands for "Hadmut's pcdtoppm" to make it distin-
  17.      guishable in case someone else is building  the  same  thing
  18.      and calling it pcdtoppm. Call hpcdtoppm without arguments to
  19.      see the defaults values. If pcd-file is  "-",  the  Photo-CD
  20.      file is read from stdin.
  21.  
  22. OPTIONS
  23.      -x   Overskip Mode.  Works  on  Base/16,  Base/4,  Base  and
  24.           4Base. In Photo-CD images the luma channel is stored in
  25.           full resolution, the two chroma channels are stored  in
  26.           half  resolution  only and have to be interpolated.  In
  27.           the Overskip Mode  the  chroma  channels  of  the  next
  28.           higher  resolution  are taken instead of interpolating.
  29.           To see the difference, generate one ppm  with  and  one
  30.           ppm  without  this  flag.  Use pnmarith to generate the
  31.           difference image of these two images. Call ppmhist  for
  32.           this  difference  or  show  it with xv (push the HistEq
  33.           button in the color editor).
  34.  
  35.      -s   Apply simple sharpness-operator on the Luma-channel.
  36.  
  37.      -d   Do  not  show  the  complete  image,   but   only   the
  38.           decompressed  difference.   It  works only on the 4Base
  39.           and the 16Base resolution. It does not have any  deeper
  40.           sense, but it was simple to implement and it shows what
  41.           causes different sizes of image files.
  42.  
  43.      -i   Give some information from the fileheader to stderr. It
  44.           works   only  for  Image  files.  (It  is  not  working
  45.           correctly, just printing some strings.)
  46.  
  47.      -m   Show the phases of decoding to stderr.
  48.  
  49.      -crop
  50.           Try to cut off  the  black  frame  which  is  sometimes
  51.           scanned at the image borders. The image size shrinks.
  52.  
  53.      -pos Print the file relative start position of the data  for
  54.           the current resolution.
  55.  
  56.      -rep Try to jump over reading errors in Huffman code.
  57.  
  58.      -n   Don't rotate the image.
  59.  
  60.      -r   Rotate the picture clockwise for portraits.
  61.  
  62.      -l   Rotate the picture counter-clockwise for portraits.
  63.  
  64.      -a   Try to find out  the  image  orientation  byself.  This
  65.           doesn't work for overview files yet. It is very experi-
  66.           mental and depends on one byte. Please tell  me  if  it
  67.           doesn't work.
  68.  
  69.      -vert
  70.           Vertical flip.
  71.  
  72.      -hori
  73.           Horizontal flip.
  74.  
  75.      -S h v
  76.           Cut out subrectangle with boundaries h (longer side  of
  77.           the  image)  and  v  (shorter side). h and v are of the
  78.           form a-b ( cut from a to b ) or a+b ( offset a,  length
  79.           b). a and b are integer (pixels) or float [0.0 ... 1.0]
  80.           relative to the length of the side.
  81.  
  82.      -ppm Write rgb image in ppm-format.
  83.  
  84.      -pgm Write grayscale image in pgm-format.
  85.  
  86.      -ycc Write ycc image in ppm-format.
  87.  
  88.      -ps  Write rgb image in postscript.
  89.  
  90.      -eps Write rgb image in encapsulated postscript.
  91.  
  92.      -psg Write grayscale image in postscript.
  93.  
  94.      -epsg
  95.           Write grayscale image in encapsulated postscript.
  96.  
  97.      -psd Write a Floyd-Steinberg dithered image  in  postscript.
  98.           See the Postscript section below.
  99.  
  100.      -epsd
  101.           Write a Floyd-Steinberg dithered image in  encapsulated
  102.           postscript.  See the Postscript section below.
  103.  
  104.      -pl f
  105.           Set left position of Postscript image to f.
  106.  
  107.      -pb f
  108.           Set bottom position of Postscript image to f.
  109.  
  110.      -pw f
  111.           Set width of Postscript image to f.
  112.  
  113.      -ph f
  114.           Set height of Postscript image to f.
  115.  
  116.      -dpi f
  117.           Set printer resolution for dithered postscript  images.
  118.           See the Postscript section below.
  119.  
  120.      -fak f
  121.           Sets a scaling factor for dithered  postscript  images.
  122.           See the Postscript section below.
  123.  
  124.      -c0  Don't correct the image.
  125.  
  126.      -c-  Do a correction (darker). Hardware and taste dependend.
  127.  
  128.      -c+  Do a correction (brighter). Hardware and  taste  depen-
  129.           dend.
  130.  
  131.      -1 | -Base/16 | -128x192
  132.           Extract the Base/16 size picture (size 128x192 pixels).
  133.           Note that you can only give one size option.
  134.  
  135.      -2 | -Base/4 | -256x384
  136.           Extract the Base/4 size picture.
  137.  
  138.      -3 | -Base | -512x768
  139.           Extract the Base size picture.
  140.  
  141.      -4 | -4Base | -1024x1536
  142.           Extract the 4Base size picture.
  143.  
  144.      -5 | -16Base | -2048x3072
  145.           Extract the 16Base size picture.
  146.  
  147.      -0 | -Overview | -O
  148.           Extract  all  pictures  from  an   Overview   file.   A
  149.           ppmfilename  must be given. If the given name is "foo",
  150.           the files are named "foonnnn", where nnnn is a  4-digit
  151.           number.   Since they are stored in Base/16 format, they
  152.           are extracted in this format.
  153.  
  154.      -C d s
  155.           Extract  all  pictures  from  an   Overview   file.   A
  156.           ppmfilename  must be given. If the given name is "foo",
  157.           the files are named "foonnnn", where nnnn is a  4-digit
  158.           number.   Since they are stored in Base/16 format, they
  159.           are extracted in this format. s is one of "n", "l"  and
  160.           "r" and determines the orientation of the contact sheet
  161.           image.
  162.  
  163.  
  164.  
  165. POSTSCRIPT OUTPUT
  166.      For postscript output ( ps, eps, psg, epsg, psd, epsg )  you
  167.      can  choose  parameters  for the resolution and placement on
  168.      the paper.  The default values are used if none of the  fol-
  169.      lowing options is given.
  170.  
  171.      The position of  the  image  within  the  paper  (down  left
  172.      corner) is changed with the -pl and -pb option for all reso-
  173.      lutions. The unit is 1/72 inch.
  174.  
  175.      For color and grayscale postscript you can change the  image
  176.      size  with  the  -pw and -ph option (1/72 inch). Every image
  177.      pixel is mapped onto one postscript pixel.
  178.  
  179.      For dithered postscript (-psd and  -epsd)  there  are  three
  180.      options,  the  image size (-pw and -ph), the printer resolu-
  181.      tion (-dpi) and a scaling factor (-fak). Since these  values
  182.      depend  from  each  other, you can not give more than two of
  183.      these options. You should play with these options to get the
  184.      results  you like. You will get pretty images if you use the
  185.      -dpi and the -pw/-ph options together. Even if you  use  the
  186.      default  values,  the result will not be the same as without
  187.      options.
  188.  
  189.  
  190.  
  191. BUGS
  192.      hpcdtoppm seems to  ignore  the  read  protection.  :-)  The
  193.      informations  i  have  are  quite vague and this program was
  194.      developed by staring at the hex-dumps and the famous  trial-
  195.      and-error-method. If anything doesn't work, please send me a
  196.      report and perhaps you could try to find out, why it doesn't
  197.      work.
  198.  
  199. SEE ALSO
  200.      ppm(5), ppmquant(1), ppmtopgm(1),  ppmhist(1),  pnmarith(1),
  201.      ppmtorgb3(1), xv(1)
  202.  
  203. AUTHOR
  204.      Copyright    (c)    1992,    1993    by    Hadmut    Danisch
  205.      (danisch@ira.uka.de).  Permission to use and distribute this
  206.      software and its documentation  for  noncommercial  use  and
  207.      without fee is hereby granted, provided that the above copy-
  208.      right notice appear in all copies and that both  that  copy-
  209.      right notice and this permission notice appear in supporting
  210.      documentation. It is not allowed to sell  this  software  in
  211.      any way. This software is not public domain.
  212.  
  213.