aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/wrjpgcom.1
diff options
context:
space:
mode:
authorDavid Walter Seikel2013-01-13 18:54:10 +1000
committerDavid Walter Seikel2013-01-13 18:54:10 +1000
commit959831f4ef5a3e797f576c3de08cd65032c997ad (patch)
treee7351908be5995f0b325b2ebeaa02d5a34b82583 /libraries/irrlicht-1.8/source/Irrlicht/jpeglib/wrjpgcom.1
parentAdd info about changes to Irrlicht. (diff)
downloadSledjHamr-959831f4ef5a3e797f576c3de08cd65032c997ad.zip
SledjHamr-959831f4ef5a3e797f576c3de08cd65032c997ad.tar.gz
SledjHamr-959831f4ef5a3e797f576c3de08cd65032c997ad.tar.bz2
SledjHamr-959831f4ef5a3e797f576c3de08cd65032c997ad.tar.xz
Remove damned ancient DOS line endings from Irrlicht. Hopefully I did not go overboard.
Diffstat (limited to 'libraries/irrlicht-1.8/source/Irrlicht/jpeglib/wrjpgcom.1')
-rw-r--r--libraries/irrlicht-1.8/source/Irrlicht/jpeglib/wrjpgcom.1206
1 files changed, 103 insertions, 103 deletions
diff --git a/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/wrjpgcom.1 b/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/wrjpgcom.1
index 44dad35..d419a99 100644
--- a/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/wrjpgcom.1
+++ b/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/wrjpgcom.1
@@ -1,103 +1,103 @@
1.TH WRJPGCOM 1 "15 June 1995" 1.TH WRJPGCOM 1 "15 June 1995"
2.SH NAME 2.SH NAME
3wrjpgcom \- insert text comments into a JPEG file 3wrjpgcom \- insert text comments into a JPEG file
4.SH SYNOPSIS 4.SH SYNOPSIS
5.B wrjpgcom 5.B wrjpgcom
6[ 6[
7.B \-replace 7.B \-replace
8] 8]
9[ 9[
10.BI \-comment " text" 10.BI \-comment " text"
11] 11]
12[ 12[
13.BI \-cfile " name" 13.BI \-cfile " name"
14] 14]
15[ 15[
16.I filename 16.I filename
17] 17]
18.LP 18.LP
19.SH DESCRIPTION 19.SH DESCRIPTION
20.LP 20.LP
21.B wrjpgcom 21.B wrjpgcom
22reads the named JPEG/JFIF file, or the standard input if no file is named, 22reads the named JPEG/JFIF file, or the standard input if no file is named,
23and generates a new JPEG/JFIF file on standard output. A comment block is 23and generates a new JPEG/JFIF file on standard output. A comment block is
24added to the file. 24added to the file.
25.PP 25.PP
26The JPEG standard allows "comment" (COM) blocks to occur within a JPEG file. 26The JPEG standard allows "comment" (COM) blocks to occur within a JPEG file.
27Although the standard doesn't actually define what COM blocks are for, they 27Although the standard doesn't actually define what COM blocks are for, they
28are widely used to hold user-supplied text strings. This lets you add 28are widely used to hold user-supplied text strings. This lets you add
29annotations, titles, index terms, etc to your JPEG files, and later retrieve 29annotations, titles, index terms, etc to your JPEG files, and later retrieve
30them as text. COM blocks do not interfere with the image stored in the JPEG 30them as text. COM blocks do not interfere with the image stored in the JPEG
31file. The maximum size of a COM block is 64K, but you can have as many of 31file. The maximum size of a COM block is 64K, but you can have as many of
32them as you like in one JPEG file. 32them as you like in one JPEG file.
33.PP 33.PP
34.B wrjpgcom 34.B wrjpgcom
35adds a COM block, containing text you provide, to a JPEG file. 35adds a COM block, containing text you provide, to a JPEG file.
36Ordinarily, the COM block is added after any existing COM blocks; but you 36Ordinarily, the COM block is added after any existing COM blocks; but you
37can delete the old COM blocks if you wish. 37can delete the old COM blocks if you wish.
38.SH OPTIONS 38.SH OPTIONS
39Switch names may be abbreviated, and are not case sensitive. 39Switch names may be abbreviated, and are not case sensitive.
40.TP 40.TP
41.B \-replace 41.B \-replace
42Delete any existing COM blocks from the file. 42Delete any existing COM blocks from the file.
43.TP 43.TP
44.BI \-comment " text" 44.BI \-comment " text"
45Supply text for new COM block on command line. 45Supply text for new COM block on command line.
46.TP 46.TP
47.BI \-cfile " name" 47.BI \-cfile " name"
48Read text for new COM block from named file. 48Read text for new COM block from named file.
49.PP 49.PP
50If you have only one line of comment text to add, you can provide it on the 50If you have only one line of comment text to add, you can provide it on the
51command line with 51command line with
52.BR \-comment . 52.BR \-comment .
53The comment text must be surrounded with quotes so that it is treated as a 53The comment text must be surrounded with quotes so that it is treated as a
54single argument. Longer comments can be read from a text file. 54single argument. Longer comments can be read from a text file.
55.PP 55.PP
56If you give neither 56If you give neither
57.B \-comment 57.B \-comment
58nor 58nor
59.BR \-cfile , 59.BR \-cfile ,
60then 60then
61.B wrjpgcom 61.B wrjpgcom
62will read the comment text from standard input. (In this case an input image 62will read the comment text from standard input. (In this case an input image
63file name MUST be supplied, so that the source JPEG file comes from somewhere 63file name MUST be supplied, so that the source JPEG file comes from somewhere
64else.) You can enter multiple lines, up to 64KB worth. Type an end-of-file 64else.) You can enter multiple lines, up to 64KB worth. Type an end-of-file
65indicator (usually control-D) to terminate the comment text entry. 65indicator (usually control-D) to terminate the comment text entry.
66.PP 66.PP
67.B wrjpgcom 67.B wrjpgcom
68will not add a COM block if the provided comment string is empty. Therefore 68will not add a COM block if the provided comment string is empty. Therefore
69\fB\-replace \-comment ""\fR can be used to delete all COM blocks from a file. 69\fB\-replace \-comment ""\fR can be used to delete all COM blocks from a file.
70.SH EXAMPLES 70.SH EXAMPLES
71.LP 71.LP
72Add a short comment to in.jpg, producing out.jpg: 72Add a short comment to in.jpg, producing out.jpg:
73.IP 73.IP
74.B wrjpgcom \-c 74.B wrjpgcom \-c
75\fI"View of my back yard" in.jpg 75\fI"View of my back yard" in.jpg
76.B > 76.B >
77.I out.jpg 77.I out.jpg
78.PP 78.PP
79Attach a long comment previously stored in comment.txt: 79Attach a long comment previously stored in comment.txt:
80.IP 80.IP
81.B wrjpgcom 81.B wrjpgcom
82.I in.jpg 82.I in.jpg
83.B < 83.B <
84.I comment.txt 84.I comment.txt
85.B > 85.B >
86.I out.jpg 86.I out.jpg
87.PP 87.PP
88or equivalently 88or equivalently
89.IP 89.IP
90.B wrjpgcom 90.B wrjpgcom
91.B -cfile 91.B -cfile
92.I comment.txt 92.I comment.txt
93.B < 93.B <
94.I in.jpg 94.I in.jpg
95.B > 95.B >
96.I out.jpg 96.I out.jpg
97.SH SEE ALSO 97.SH SEE ALSO
98.BR cjpeg (1), 98.BR cjpeg (1),
99.BR djpeg (1), 99.BR djpeg (1),
100.BR jpegtran (1), 100.BR jpegtran (1),
101.BR rdjpgcom (1) 101.BR rdjpgcom (1)
102.SH AUTHOR 102.SH AUTHOR
103Independent JPEG Group 103Independent JPEG Group