hpcdtoppm(1)                                         hpcdtoppm(1)

NAME
       hpcdtoppm  v0.3  - convert a Photo-CD file into a portable
       pixmap

SYNOPSIS
       hpcdtoppm [options] pcd-file [ppm-file]

DESCRIPTION
       Reads a Photo-CD Image file or Overview file, and  outputs
       portable pixmap.  Image files you can find on the Photo-CD
       in photo_cd/images, they are named as "imgnnnn.pcd", where
       nnnn   is  a  4-digit-number.  The  Overview  file  is  at
       photo_cd/overview.pcd  .  If  there  is  no  ppm-file-name
       given,  output will be printed to stdout. hpcdtoppm stands
       for "Hadmut's pcdtoppm" to make it distinguishable in case
       someone  else  is  building  the same thing and calling it
       pcdtoppm.

OPTIONS
       -i     Give  some  information  from  the  fileheader   to
              stderr.  It  works only for Image files. (It is not
              working correctly, just printing some strings.)

       -s     Apply simple sharpness-operator on  the  Luma-chan-
              nel.

       -d     Do not show the complete image, but only the decom-
              pressed difference.  It works only on the 4Base and
              the  16Base resolution. It does not have any deeper
              sense, but it was simple to implement and it  shows
              what causes different sizes of image files.

       -r     Rotate the picture clockwise for portraits.

       -l     Rotate the picture counter-clockwise for portraits.

       -a     Try to find out the image orientation byself.  This
              doesn't  work  for  overview  files yet. It is very
              experimental and depends on one byte.  Please  tell
              me if it doesn't work.

       -x     Overskip  Mode.  Works on Base/16, Base/4, Base and
              4Base. In  Photo-CD  images  the  luma  channel  is
              stored  in full resolution, the two chroma channels
              are stored in half resolution only and have  to  be
              interpolated.   In  the  Overskip  Mode  the chroma
              channels of the next higher  resolution  are  taken
              instead  of  interpolating.  To see the difference,
              generate one ppm with  and  one  ppm  without  this
              flag. Use pnmarith to generate the difference image
              of these two images. Call ppmhist for this  differ-
              ence  or show it with xv (push the HistEq button in
              the color editor).

       -1 | -Base/16 | -128x192
              Extract the Base/16 size picture (size 128x192 pix-
              els).  Note that you can only give one size option.

       -2 | -Base/4 | -256x384
              Extract the Base/4 size picture.

       -3 | -Base | -512x768
              Extract the Base size picture.

       -4 | -4Base | -1024x1536
              Extract the 4Base size picture.

       -5 | -16Base | -2048x3072
              Extract the 16Base size picture.

       -0 | -Overview | -O
              Extract all pictures from an Overview file. A  ppm-
              filename must be given. If the given name is "foo",
              the files are named  "foonnnn",  where  nnnn  is  a
              4-digit  number.   Since they are stored in Base/16
              format, they are extracted in this format.

       -ycc   Suppress the ycc to rgb conversion. This is experi-
              mental  only.  You can use this and apply ppmtorgb3
              on the file. Then you will get three pgm-files, one
              Luma and two Chroma files.

BUGS
       I  still  don't have enough information about the Photo-CD
       to take care of all data structures.  The  informations  i
       have  are  quite  vague  and this program was developed by
       starring at the hex-dumps and the famous  trial-and-error-
       method.  :-)  If  anything  doesn't work, please send me a
       report and perhaps you could  try  to  find  out,  why  it
       doesn't work.

SEE ALSO
       ppm(5), ppmquant(1), ppmtopgm(1), ppmhist(1), pnmarith(1),
       ppmtorgb3(1), xv(1)

AUTHOR
       Copyright (c) 1992 by Hadmut Danisch (danisch@ira.uka.de).
       Permission  to  use  and  distribute this software and its
       documentation for noncommercial use  and  without  fee  is
       hereby  granted,  provided that the above copyright notice
       appear in all copies and that both that  copyright  notice
       and this permission notice appear in supporting documenta-
       tion. It is not allowed to sell this software in any  way.
       This software is not public domain.

                         28 November 1992                       1