home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / graphics / jpeg5 / bin / wrjpgcom.man < prev    next >
Text File  |  1994-08-08  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. WRJPGCOM(1)              USER COMMANDS                WRJPGCOM(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      wrjpgcom - insert text comments into a JPEG file
  10.  
  11. SYNOPSIS
  12.      wrjpgcom [ -replace ] [ -comment _✓t_✓e_✓x_✓t ] [ _✓f_✓i_✓l_✓e_✓n_✓a_✓m_✓e ]
  13.  
  14. DESCRIPTION
  15.      wrjpgcom reads the named JPEG/JFIF  file,  or  the  standard
  16.      input  if  no  file  is named, and generates a new JPEG/JFIF
  17.      file on standard output.  A comment block is  added  to  the
  18.      file.
  19.  
  20.      The JPEG standard allows "comment"  (COM)  blocks  to  occur
  21.      within  a JPEG file.  Although the standard doesn't actually
  22.      define what COM blocks are for, they are widely used to hold
  23.      user-supplied  text strings.  This lets you add annotations,
  24.      titles, index terms, etc  to  your  JPEG  files,  and  later
  25.      retrieve them as text.  COM blocks do not interfere with the
  26.      image stored in the JPEG file.  The maximum size  of  a  COM
  27.      block  is  64K, but you can have as many of them as you like
  28.      in one JPEG file.
  29.  
  30.      wrjpgcom adds a COM block, containing text you provide, to a
  31.      JPEG  file.   Ordinarily,  the  COM block is added after any
  32.      existing COM blocks; but you can delete the old  COM  blocks
  33.      if you wish.
  34.  
  35. OPTIONS
  36.      Switch names may be abbreviated, and are not case sensitive.
  37.  
  38.      -replace
  39.           Delete any existing COM blocks from the file.
  40.  
  41.      -comment _✓t_✓e_✓x_✓t
  42.           Supply text for new COM block on command line.
  43.  
  44.      If you have only one line of comment text to  add,  you  can
  45.      provide  it  on the command line with -comment.  The comment
  46.      text must be surrounded with quotes so that it is treated as
  47.      a single argument.
  48.  
  49.      If your comment text is longer than one line, omit the -com-
  50.      ment  switch  from  the command line.  In this case wrjpgcom
  51.      will read the comment text from  standard  input  (an  input
  52.      file  name  MUST  be  supplied  so that the source JPEG file
  53.      comes from somewhere else).  You can enter  multiple  lines,
  54.      up  to  64KB  worth.  Type an end-of-file indicator (usually
  55.      control-D) to terminate the comment text entry.
  56.  
  57.      wrjpgcom will not add a COM block if  the  provided  comment
  58.      string is empty.  Therefore -replace -comment "" can be used
  59.      to delete all COM blocks from a file.
  60.  
  61.  
  62.  
  63. Sun Release 4.1     Last change: 17 July 1994                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. WRJPGCOM(1)              USER COMMANDS                WRJPGCOM(1)
  71.  
  72.  
  73.  
  74. EXAMPLES
  75.      Add a short comment to in.jpg, producing out.jpg:
  76.  
  77.           wrjpgcom -c "_✓V_✓i_✓e_✓w _✓o_✓f _✓m_✓y _✓b_✓a_✓c_✓k _✓y_✓a_✓r_✓d" _✓i_✓n._✓j_✓p_✓g > _✓o_✓u_✓t._✓j_✓p_✓g
  78.  
  79.      Attach a long comment previously stored in comment.txt:
  80.  
  81.           wrjpgcom _✓i_✓n._✓j_✓p_✓g < _✓c_✓o_✓m_✓m_✓e_✓n_✓t._✓t_✓x_✓t > _✓o_✓u_✓t._✓j_✓p_✓g
  82.  
  83. SEE ALSO
  84.      cjpeg(1), djpeg(1), rdjpgcom(1)
  85.  
  86. AUTHOR
  87.      Independent JPEG Group
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1     Last change: 17 July 1994                   2
  130.  
  131.  
  132.  
  133.