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 / hpcdtoppm.man < prev    next >
Text File  |  1994-10-14  |  14KB  |  397 lines
  1.  
  2.  
  3.  
  4. hpcdtoppm(1L)                                       hpcdtoppm(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        hpcdtoppm - convert a Photo-CD file into a portable bitmap
  9.        file
  10.  
  11. SSYYNNOOPPSSIISS
  12.        hhppccddttooppppmm _i_n_f_i_l_e  [--aa]  [{--CC|--00|--OOvveerrvviieeww|--OO}]  _f_i_l_e  _o_p_t]
  13.        [--cc00]  [--cc--]  [--cc++]  [--ccrroopp]  [--dd] [--ddppii _f] [--eeppss] [--eeppssdd]
  14.        [--eeppssgg] [--ffaakk _s_c_a_l_e] [--hhoorrii] [--ii] [--qquuaalliittyy N]]  [--ll]  [--mm]
  15.        [--mmaaxxmmeemmoorryy  N]]  [--nn]  [--ooppttiimmiizzee]]  [--ppbb  _p_o_s] [--ppggmm] [--pphh
  16.        _h_e_i_g_h_t] [--ppll _p_o_s] [--ppooss] [--ppppmm] [--ppss] [--ppssdd]  [--ppssgg]  [--ppww
  17.        _w_i_d_t_h]  [--qquuaalliittyyN]  [--rr]  [--rreepp]  [--SS  _l_o_n_g  _s_h_o_r_t]  [--ss]
  18.        [--vveerrtt] [--xx] [--yycccc]  [--11|--BBaassee//1166  |_-_1_2_8_x_1_9_2]  [--22|--BBaassee//44
  19.        |_-_2_5_6_x_3_8_4]  [--33|--BBaassee  |_-_5_1_2_x_7_6_8]  [--44|--44BBaassee |_-_1_0_2_4_x_1_5_3_6]
  20.        [--55|--1166BBaassee |_-_2_0_4_8_x_3_0_7_2]  [--66|--6644BBaassee  |_-_4_0_9_6_x_6_1_4_4]  [_o_u_t_­
  21.        _f_i_l_e]
  22.  
  23. DDEESSCCRRIIPPTTIIOONN
  24.        This  program accepts Photo-CD image or overview file data
  25.        from the specified input file, _i_n_f_i_l_e (or, if the  resolu­
  26.        tion  is lower than 64Base and the file argument is speci­
  27.        fied  as  --,  from  standard  input),  and  writes  either
  28.        Portable Bitmap Format or POSTSCRIPT to the specified out­
  29.        put file (or to standard output if no file is  specified).
  30.  
  31.        On   a   standard   Photo-CD,   image   files   appear  in
  32.        _p_h_o_t_o___c_d_/_i_m_a_g_e_s, where they appear in files with names  of
  33.        the form img_n_n_n_n_._p_c_d, where _n_n_n_n is a 4-digit-number.  The
  34.        overview file appears in _p_h_o_t_o___c_d_/_o_v_e_r_v_i_e_w_._p_c_d.
  35.  
  36.        Photo-CD images are stored using as many  as  6  different
  37.        resolutions:
  38.                  Format              Resolution
  39.                  ------              ----------
  40.                  64Base              4096x6144 (ProPhotoCD only)
  41.                  16Base              2048x3072
  42.                  4Base               1024x1536
  43.                  Base                512x768
  44.                  Base/4              256x384
  45.                  Base/16             128x192
  46.  
  47.        The overview file employs Base/16 format.
  48.  
  49. OOPPTTIIOONNSS
  50.        Invoking  _h_p_c_d_t_o_p_p_m  without  arguments produces a list of
  51.        default values.  Note that you can supply  only  one  size
  52.        option.
  53.  
  54.        --aa     Automatically  determine  image  orientation  (this
  55.               option is  experimental,  and  does  not  work  for
  56.               overview files).
  57.  
  58.        {--CC | --00 | --OOvveerrvviieeww | --OO } _f_i_l_e _o_p_t
  59.               Extract  all  images  from  an  overview file.  The
  60.               mandatory _f_i_l_e argument is the name of a _p_p_m  file;
  61.  
  62.  
  63.  
  64.                            3 March 1994                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. hpcdtoppm(1L)                                       hpcdtoppm(1L)
  71.  
  72.  
  73.               output  files  are  named _f_i_l_e_n_n_n_n, where _n_n_n_n is a
  74.               4-digit number.  Overview images are  extracted  in
  75.               their  original  Base/16  format.  The value of _o_p_t
  76.               determines the orientation  of  the  contact  sheet
  77.               image; recognized values are:
  78.  
  79.               nn      Do not rotate the image.
  80.  
  81.               ll      Rotate  the  picture counter-clockwise (por­
  82.                      trait mode).
  83.  
  84.               rr      Rotate  the  picture   clockwise   (portrait
  85.                      mode).
  86.  
  87.        --cc00    Do not correct (brighten or darken) the image.
  88.  
  89.        --cc--    Darken the image.
  90.  
  91.        --cc++    Brighten the image.
  92.  
  93.        --ccrroopp  Cut  off the black frame which sometimes appears at
  94.               the image borders.
  95.  
  96.        --dd     Show only the decompressed difference  rather  than
  97.               the  complete  image  (applicable only to 4Base and
  98.               16Base images).
  99.  
  100.        --ddppii rreess
  101.               Set the printer  resolution  to  _r_e_s  for  dithered
  102.               POSTSCRIPT images.
  103.  
  104.        --eeppss   Write a RGB Encapsulated POSTSCRIPT color image.
  105.  
  106.        --eeppssdd  Write  a Floyd-Steinberg dithered image in Encapsu­
  107.               lated POSTSCRIPT.
  108.  
  109.        --jjppeegg  Write image in JPEG format.
  110.  
  111.        --qquuaalliittyy  NN
  112.               Scale quantization tables to adjust image  quality.
  113.               (JPEG  output  only)  Quality  is  0 (worst) to 100
  114.               (best); default is 75.
  115.  
  116.        --eeppssgg  Write a grayscale image in Encapsulated POSTSCRIPT.
  117.  
  118.        --ffaakk ssccaallee
  119.               Set  the  scaling  factor  for  dithered POSTSCRIPT
  120.               images to _s_c_a_l_e.
  121.  
  122.        --hhoorrii  Flip the image horizontally.
  123.  
  124.        --ii     Send information from an image file header to stan­
  125.               dard error.
  126.  
  127.  
  128.  
  129.  
  130.                            3 March 1994                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. hpcdtoppm(1L)                                       hpcdtoppm(1L)
  137.  
  138.  
  139.        --ll     Rotate   the  picture  counter-clockwise  (portrait
  140.               mode).
  141.  
  142.        --mm     Write messages about  the  phases  of  decoding  to
  143.               standard error.
  144.  
  145.        --mmaaxxmmeemmoorryy  NN
  146.               Set  limit  for  amount  of memory used by the JPEG
  147.               encoder. Value is in thousands of bytes.   If  more
  148.               space  is  needed,  temporary  files  will be used.
  149.               Default is 50000 bytes.
  150.  
  151.        --nn     Do not rotate the image.
  152.  
  153.        --ooppttiimmiizzee
  154.               Perform optimization of  entropy  encoding  parame­
  155.               ters.   (JPEG  output  only)  Without this, default
  156.               encoding parameters are  used.   --ooppttiimmiizzee  usually
  157.               makes  the JPEG file a little smaller, but encoding
  158.               is somewhat slower  and  needs  much  more  memory.
  159.               Image  quality and speed of decompression are unaf­
  160.               fected by --ooppttiimmiizzee.
  161.  
  162.        --ppbb ppooss
  163.               Set the bottom position of the POSTSCRIPT image  to
  164.               _p_o_s.
  165.  
  166.        --ppggmm   Write a _p_g_m (grayscale) image.
  167.  
  168.        --pphh hheeiigghhtt
  169.               Set the height of the POSTSCRIPT image to _h_e_i_g_h_t.
  170.  
  171.        --ppll ppooss
  172.               Set  the  leftmost position of the POSTSCRIPT image
  173.               to _p_o_s.
  174.  
  175.        --ppooss   Print the relative starting position  of  the  data
  176.               for the current resolution.
  177.  
  178.        --ppppmm   Write a _p_p_m RGB (color) image.
  179.  
  180.        --ppss    Write a RGB POSTSCRIPT color image.
  181.  
  182.        --ppssdd   Write   a   Floyd-Steinberg   dithered   image   in
  183.               POSTSCRIPT.
  184.  
  185.        --ppssgg   Write a POSTSCRIPT grayscale image.
  186.  
  187.        --ppww wwiiddtthh
  188.               Set the width of the POSTSCRIPT image to _w_i_d_t_h.
  189.  
  190.        --rr     Rotate the picture clockwise (portrait mode).
  191.  
  192.        --rreepp   Try to jump over  reading  errors  in  the  Huffman
  193.  
  194.  
  195.  
  196.                            3 March 1994                         3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. hpcdtoppm(1L)                                       hpcdtoppm(1L)
  203.  
  204.  
  205.               code.
  206.  
  207.        --SS lloonngg sshhoorrtt
  208.               Cut  out  a subrectangle with boundaries defined by
  209.               the values:
  210.  
  211.               _l_o_n_g   For the longer side of the image.
  212.  
  213.               _s_h_o_r_t  For the shorter side of the image.
  214.  
  215.               where _l_o_n_g and _s_h_o_r_t take one of two forms:
  216.  
  217.               aa--bb    Cut from position _a to position _b.
  218.  
  219.               aa++bb    Starting at offset _a, cut a length of _b.
  220.  
  221.               and where _a and _b are either integers  representing
  222.               pixel  locations, or floating point values over the
  223.               range [0.0 ... 1.0], representing the  fraction  of
  224.               the length of a side.
  225.  
  226.        --ss     Apply a simple sharpness operator to the luminosity
  227.               channel.
  228.  
  229.        --vveerrtt  Flip the image vertically.
  230.  
  231.        --xx     Overskip Mode (applicable to Base/16, Base/4,  Base
  232.               and  4Base).   In  Photo-CD  images  the luminosity
  233.               channel is stored in full resolution, the two chro­
  234.               maticity  channels  are  stored  in half resolution
  235.               only and have  to  be  interpolated.   In  Overskip
  236.               Mode,  the chromaticity channels of the next higher
  237.               resolution are taken instead of interpolating.   To
  238.               see  the  difference, generate one _p_p_m with and one
  239.               _p_p_m without this flag.  Use _p_n_m_a_r_i_t_h(1L) to  gener­
  240.               ate the difference image of these two images.  Call
  241.               _p_p_m_h_i_s_t(1L) for this difference  or  show  it  with
  242.               _x_v(1L)  (push  the  HHiissttEEqq button in the color edi­
  243.               tor).
  244.  
  245.        --yycccc   Write the image in _p_p_m YCC format.
  246.  
  247.        --11|--BBaassee//1166|--112288xx119922
  248.               Extract the Base/16 image.
  249.  
  250.        --22 || --BBaassee//44 || --225566xx338844
  251.               Extract the Base/4 image.
  252.  
  253.        --33 || --BBaassee || --551122xx776688
  254.               Extract the Base image.
  255.  
  256.        --44 || --44BBaassee || --11002244xx11553366
  257.               Extract the 4Base image.
  258.  
  259.  
  260.  
  261.  
  262.                            3 March 1994                         4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. hpcdtoppm(1L)                                       hpcdtoppm(1L)
  269.  
  270.  
  271.        --55 || --1166BBaassee || --22004488xx33007722
  272.               Extract the 16Base image.
  273.  
  274.        --66 || --6644BBaassee || --44009966xx66114444
  275.               Extract the 64Base image. This  resolution  can  be
  276.               extracted  from ProPhotoCD images only. The path of
  277.               the 64Base extension files is derived from the path
  278.               to  the image file. This means that it doesn't work
  279.               on stdin an the directory  structure  must  be  the
  280.               very same as on the ProPhotoCD.
  281.  
  282. PPOOSSTTSSCCRRIIPPTT OOUUTTPPUUTT
  283.        For  POSTSCRIPT  output  (options  --ppss, --eeppss, --ppssgg, --eeppssgg,
  284.        --ppssdd, --eeppssgg) you can define both the resolution and place­
  285.        ment  of  the image.  Both size and position are specified
  286.        in points (1/72 inch).
  287.  
  288.        The position of the image (where the origin is assumed  to
  289.        be  at the lower left corner of the page) is controlled by
  290.        the --ppll and --ppbb options (applicable at all resolutions).
  291.  
  292.        The size of color and grayscale images is changed with the
  293.        --ppww and --pphh options.  Every image pixel is mapped onto one
  294.        POSTSCRIPT pixel.
  295.  
  296.        There are three modes of control for dithered POSTSCRIPT:
  297.  
  298.        Image size
  299.               (--ppww and --pphh)
  300.  
  301.        Printer resolution
  302.               (--ddppii)
  303.  
  304.        Scaling factor
  305.               (--ffaakk)
  306.  
  307.        These three factors are interdependent, hence no more then
  308.        two  can  be specified simultaneously.  Using --ddppii and the
  309.        --ppww/--pphh options together often  yields  pleasing  results.
  310.        Even  using the default values for these options will pro­
  311.        duce results differing from those obtained without use  of
  312.        the options.
  313.  
  314. BBUUGGSS
  315.        The program ignores read protection.
  316.  
  317.        The --ii option is not working correctly.
  318.  
  319.        Available  information obout the Photo-CD format is vague;
  320.        this program was developed by trial-and-error after  star­
  321.        ing at hex-dumps.  Please send bugs reports and patches to
  322.        the author.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                            3 March 1994                         5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. hpcdtoppm(1L)                                       hpcdtoppm(1L)
  335.  
  336.  
  337. SSEEEE AALLSSOO
  338.        pnmarith(1L),  ppm(5L),  ppmhist(1L),  ppmquant(1L),  ppm­
  339.        topgm(1L), ppmtorgb3(1L), cjpeg(1L), xv(1L)
  340.  
  341. VVEERRSSIIOONN
  342.        The name _h_p_c_d_t_o_p_p_m stands for "Hadmut's pcdtoppm," to make
  343.        it distinguishable in  the  event  that  someone  else  is
  344.        building  a  similar  application  and naming it _p_c_d_t_o_p_p_m.
  345.        This is version 0.6.
  346.  
  347. AAUUTTHHOORR
  348.        Copyright  (c)  1992,  1993,  1994   by   Hadmut   Danisch
  349.        (danisch@ira.uka.de).  This software is not public domain.
  350.        Permission to use and distribute  this  software  and  its
  351.        documentation  for  noncommercial  use  and without fee is
  352.        hereby granted, provided that the above  copyright  notice
  353.        appear  in  all copies and that both that copyright notice
  354.        and this permission notice appear in supporting documenta­
  355.        tion.   This  software may not be sold or used for profit-
  356.        making activities.
  357.  
  358.        Manual page extensively  modified  by  R.  P.  C.  Rodgers
  359.        (rodgers@nlm.nih.gov).
  360.  
  361.        Amiga  port  and  JPEG  support  added  by Günther Röhrich
  362.        (Guenther@studbox.uni-stuttgart.de)
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                            3 March 1994                         6
  395.  
  396.  
  397.