wrjpgcom(1) User Commands wrjpgcom(1)NAMEwrjpgcom - insert text comments into a JPEG file
SYNOPSISwrjpgcom [-replace] [-comment text] [-cfile name] [filename]
DESCRIPTIONwrjpgcom reads the named JPEG or JFIF file, or the standard input if no
file is named, and generates a new JPEG or JFIF file on the standard
output. A comment block is added to the file.
The JPEG standard allows "comment" (COM) blocks to occur within a JPEG
file. Although the standard does not actually define the intended func‐
tion of COM blocks, they are widely used to hold user-supplied text
strings. This enables you to add annotations, titles, index terms, and
so on to your JPEG files, and later retrieve the COM blocks as text.
COM blocks do not interfere with the image stored in the JPEG file. The
maximum size of a COM block is 64K, but you can have many COM blocks in
one JPEG file.
wrjpgcom adds a COM block, containing text that you provide, to a JPEG
file. Ordinarily, the COM block is added after any existing COM blocks,
but you can delete the old COM blocks if you wish.
OPTIONS
The following options are supported:
-cfile name Read the text for a new COM block from the named file.
-comment text Supply the text for a new COM block on the command
line.
-replace Delete any existing COM blocks from the file.
OPERANDS
The following operands are supported:
filename The name of the JPEG file to which you want to add text
comments.
EXTENDED DESCRIPTION
To add only one line of comment text, use the -comment option to pro‐
vide the text on the command line. Specify the comment text within
quotes, so that the text is treated as a single argument. Longer com‐
ments can be read from a text file.
If you specify neither the -comment nor the -cfile option, wrjpgcom
reads the comment text from standard input. In such cases, you must
supply an input image filename. You can enter multiple lines, up to
64KB. Type an end-of-file indicator, usually Ctrl-D, to terminate the
comment text entry.
wrjpgcom does not add a COM block if the provided comment string is
empty. Therefore, you can use -replace -comment "" to delete all COM
blocks from a file.
EXAMPLES
Example 1: Adding a Short Comment to in.jpg to Produce out.jpg
example% wrjpgcom-c "View of my back yard" in.jpg > out.jpg
Example 2: Attaching a Long Comment Previously Stored in comment.txt
example% wrjpgcom in.jpg < comment.txt > out.jpg
or
example% wrjpgcom-cfile comment.txt < in.jpg > out.jpg
In this example, 1000 is a number that is larger than the number of
rows in the source file.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │image/library/libjpeg │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOcjpeg(1), djpeg(1), jpegtran(1), rdjpgcom(1)NOTES
This man page was originally written by the Independent JPEG Group.
Updated by Breda McColgan, Sun Microsystems Inc., 2004.
SunOS 5.11 26 Mar 2004 wrjpgcom(1)