Penguin
Recent Changes
Annotated edit history of wrjpgcom(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 WRJPGCOM
2 !!!WRJPGCOM
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 EXAMPLES
8 SEE ALSO
9 AUTHOR
10 ----
11 !!NAME
12
13
14 wrjpgcom - insert text comments into a JPEG file
15 !!SYNOPSIS
16
17
18 __wrjpgcom__ [[ __-replace__ ] [[ __-comment__
19 ''text'' ] [[ __-cfile__ ''name'' ] [[
20 ''filename'' ]
21 !!DESCRIPTION
22
23
24 __wrjpgcom__ reads the named JPEG/JFIF file, or the
25 standard input if no file is named, and generates a new
26 JPEG/JFIF file on standard output. A comment block is added
27 to the file.
28
29
30 The JPEG standard allows
31
32
33 __wrjpgcom__ adds a COM block, containing text you
34 provide, to a JPEG file. Ordinarily, the COM block is added
35 after any existing COM blocks; but you can delete the old
36 COM blocks if you wish.
37 !!OPTIONS
38
39
40 Switch names may be abbreviated, and are not case
41 sensitive.
42
43
44 __-replace__
45
46
47 Delete any existing COM blocks from the file.
48
49
50 __-comment__ ''text''
51
52
53 Supply text for new COM block on command line.
54
55
56 __-cfile__ ''name''
57
58
59 Read text for new COM block from named file.
60
61
62 If you have only one line of comment text to add, you can
63 provide it on the command line with __-comment__. The
64 comment text must be surrounded with quotes so that it is
65 treated as a single argument. Longer comments can be read
66 from a text file.
67
68
69 If you give neither __-comment__ nor __-cfile__, then
70 __wrjpgcom__ will read the comment text from standard
71 input. (In this case an input image file name MUST be
72 supplied, so that the source JPEG file comes from somewhere
73 else.) You can enter multiple lines, up to 64KB worth. Type
74 an end-of-file indicator (usually control-D) to terminate
75 the comment text entry.
76
77
78 __wrjpgcom__ will not add a COM block if the provided
79 comment string is empty. Therefore __-replace -comment
80 __ can be used to delete all COM blocks from a
81 file.
82 !!EXAMPLES
83
84
85 Add a short comment to in.jpg, producing
86 out.jpg:
87
88
89 __wrjpgcom -c__ ''
90 '' ____ ''out.jpg''
91
92
93 Attach a long comment previously stored in
94 comment.txt:
95
96
97 __wrjpgcom__ ''in.jpg'' ____ ''comment.txt''
98 ____ ''out.jpg''
99
100
101 or equivalently
102
103
104 __wrjpgcom -cfile__ ''comment.txt'' ____
105 ''in.jpg'' ____ ''out.jpg''
106 !!SEE ALSO
107
108
109 cjpeg(1), djpeg(1), jpegtran(1),
110 rdjpgcom(1)
111 !!AUTHOR
112
113
114 Independent JPEG Group
115 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.