annotate Meerwald/wm_koch_d.1 @ 15:ad1d224896c5

fix scanf() warning
author Peter Meerwald <pmeerw@cosy.sbg.ac.at>
date Mon, 30 Jun 2008 20:59:01 +0200
parents be303a3f5ea8
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_koch_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_koch_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_koch_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
7 \- a program to extract signature bits that have been embedded into
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
8 the DCT coefficients of an image
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
9 .SH SYNOPSIS
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
10 .B wm_koch_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
11 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
12 .B \-h
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
13 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
14 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
15 .BI \-o \ ofile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
16 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
17 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
18 .BI \-q \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
19 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
20 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
21 .BI \-v \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
22 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
23 .BI \-s \ sfile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
24 .IR file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
25 .SH DESCRIPTION
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
26 .B wm_koch_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
27 is a program to extract signature bits from the 8x8 DCT coefficients of
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
28 an image, embedded with the
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
29 .B wm_koch_e
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
30 watermarking program.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
31 .B cmp_koch_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
32 program compares and tests the extracted signature against the original signature.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
33 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
34 The input image is in PGM (portable graymap) format.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
35 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
36 If
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
37 .I file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
38 or
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
39 .I ofile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
40 is not specified, then standard input or standard output is
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
41 used. The signature
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
42 .I sfile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
43 is a mandatory parameter however.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
44 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
45 Please refer to E. Koch's paper "Towards Robust and Hidden
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
46 Image Copyright", 1995, to get an idea about the algorithm.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
47 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
48 .SH OPTIONS
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
49 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
50 .B \-h
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
51 Print a help message.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
52 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
53 .BI \-o \ ofile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
54 Output the extracted signature to
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
55 .I ofile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
56 instead of standard output.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
57 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
58 .BI \-q \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
59 Quality/robustness factor used to extract the signature.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
60 Overrides setting from signature file.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
61 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
62 .BI \-s \ sfile
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
63 The original signature file. See
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
64 .B gen_koch_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
65 (1) for a description of the file format. Mandatory parameter.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
66 .BI \-v \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
67 Verbosity level. 0 for quiet operation, higher numbers for more
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
68 output. Default value: 0.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
69 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
70 .IR file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
71 Signed (watermarked) input image in PGM format. Default: standard input.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
72 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
73 .SH OUTPUT
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
74 The extracted signature is written to standard output
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
75 or, optionally, to
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
76 .I ofile.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
77 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
78 The extraction algorithm examines the relationship between two random
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
79 coefficients of randomly selected 8x8 DCT blocks to reconstruct the
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
80 signature bits.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
81 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
82 The output file has the following format:
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
83 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
84 .B KCSG
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
85 Magic to identify file type.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
86 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
87 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
88 The length of the signature in bits.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
89 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
90 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
91 The quality/robustness factor.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
92 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
93 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
94 The seed value for the pseudo-random number generator.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
95 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
96 .I string
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
97 The actual signature bytes.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
98 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
99 .SH AUTHOR
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
100 Peter Meerwald.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
101 Email bug reports to pmeerw@cosy.sbg.ac.at.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
102 .SH AVAILABILITY
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
103 The most recent released version of
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
104 .B wm_koch_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
105 is always available
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
106 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
107 directory /pub/people/pmeerw/Watermarking.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
108 .SH "SEE ALSO"
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
109 .BR gen_koch_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
110 (1),
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
111 .BR wm_koch_e
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
112 (1),
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
113 .BR cmp_koch_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
114 (1)

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