annotate Meerwald-dir/wm_cox_d.1 @ 25:5a57a145bccb default tip

Added tag v0.7 for changeset 9f20bce6184e
author Peter Meerwald-Stadler <pmeerw@pmeerw.net>
date Fri, 20 Dec 2024 13:32:15 +0100
parents 9f20bce6184e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
1 .\"
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
2 .\" wm_cox_d.1 - the *roff document processor man page source
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
3 .\"
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
4 .TH wm_cox_d 1 "98/07/05" "Watermarking, Version 1.0"
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
5 .SH NAME
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
6 .B wm_cox_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
7 \- a program to extract a signature from the DCT coefficients of a watermarked image
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
8 .SH SYNOPSIS
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
9 .B wm_cox_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
10 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
11 .BI \-a \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
12 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
13 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
14 .B \-h
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
15 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
16 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
17 .BI \-i \ ifile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
18 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
19 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
20 .BI \-n \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
21 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
22 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
23 .BI \-o \ ofile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
24 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
25 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
26 .BI \-q \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
27 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
28 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
29 .BI \-v \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
30 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
31 .br
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
32 .BI \-s \ sfile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
33 .I file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
34 .SH DESCRIPTION
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
35 .B wm_cox_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
36 is a program to extract a signature from the DCT coefficients of the watermarked image
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
37 .I file.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
38 The
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
39 .B cmp_cox_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
40 program is used to test the extracted signature against the original signature.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
41 The input image is in PGM (portable graymap) format.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
42 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
43 If
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
44 .I file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
45 or
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
46 .I ofile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
47 is not specified, then standard input or standard output is
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
48 used.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
49 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
50 .B gen_cox_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
51 is used to generate a signature file,
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
52 .B wm_cox_e
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
53 embeds the signature into an image.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
54 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
55 Please refer to Ingemar J. Cox's paper "Secure Spread Spectrum
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
56 Watermarking for Multimedia", 1995, to get an idea about the algorithm.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
57 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
58 .SH OPTIONS
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
59 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
60 .BI \-a \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
61 Alpha factor that determines embedding strength of the signature.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
62 Allows to override the setting in the signature file.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
63 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
64 .B \-h
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
65 Print a help message.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
66 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
67 .BI \-i \ ifile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
68 The original image.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
69 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
70 .BI \-o \ ofile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
71 Output watermarked image to the specified
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
72 .I file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
73 instead of standard output.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
74 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
75 .BI \-q \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
76 Set quantization/quality factor. Overrides the setting in the signature
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
77 file.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
78 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
79 .BI \-v \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
80 Verbosity level. Default value: 0.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
81 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
82 .BI \-s \ sfile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
83 The signature file to embed into the input image. See
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
84 .B gen_cox_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
85 (1) for a description of the file format. Mandatory parameter.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
86 .IR file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
87 Input image in PGM format to sign (watermark). Default: standard input.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
88 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
89 .I
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
90 The watermarked image file in PGM format.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
91 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
92 .SH OUTPUT
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
93 The signed (watermarked) image in PGM format is written to standard output
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
94 or ,optionally, to
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
95 .I ofile.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
96 The embedding process may take some time on large images since the DCT
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
97 is performed on the whole image in one step (not block-wise).
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
98 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
99 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
100 The output file has the following format:
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
101 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
102 .B CXSG
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
103 Magic to identify file type.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
104 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
105 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
106 The length of the signature in bits.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
107 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
108 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
109 The alpha factor (embedding strength).
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
110 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
111 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
112 The quantization/quality factor.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
113 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
114 .I numbers
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
115 The actual normal distributed signature values, one per line.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
116 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
117 .SH AUTHOR
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
118 Peter Meerwald.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
119 Email bug reports to pmeerw@cosy.sbg.ac.at.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
120 .SH AVAILABILITY
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
121 The most recent released version of
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
122 .B wm_cox_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
123 is always available
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
124 at http://www.cosy.sbg.ac.at/~pmeerw/Watermarking or via anonymous ftp from ftp.cosy.sbg.ac.at in the
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
125 directory /pub/people/pmeerw/Watermarking.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
126 .SH "SEE ALSO"
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
127 .BR gen_cox_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
128 (1),
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
129 .BR wm_cox_e
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
130 (1),
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
131 .BR cmp_cox_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
132 (1)

Repositories maintained by Peter Meerwald, pmeerw@pmeerw.net.