annotate Meerwald/gen_kutter_sig.1 @ 23:71dd4b96221b

fix some compiler warning
author Peter Meerwald-Stadler <pmeerw@pmeerw.net>
date Fri, 20 Dec 2024 12:53:41 +0100
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 .\" gen_kutter_sig.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 gen_kutter_sig 1 "98/06/30" "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 gen_kutter_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
7 \- a program to generate a signature for
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
8 the
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
9 .B wm_kutter_e
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
10 watermarking program
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
11 .SH SYNOPSIS
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
12 .B gen_kutter_sig
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 \-n \ number
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 \-o \ file
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 \-p \ number
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 \-r \ 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 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
33 .BI \-s \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
34 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
35 [
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
36 .I file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
37 ]
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
38 .SH DESCRIPTION
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
39 .B gen_kutter_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
40 is a program to generate a signature to be
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
41 embedded with the
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
42 .B wm_kutter_e
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
43 watermarking program and extracted with the
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
44 .B wm_kutter_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
45 program. The
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
46 .B cmp_kutter_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
47 program is used to compare and test an
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
48 extracted signature with the original signature.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
49 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
50 Please refer to M. Kutter's paper "Digital Signature of Color Images
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
51 using Amplitude Modulation", 1997, to get an idea about the algorithm.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
52 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
53 .SH OPTIONS
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
54 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
55 .B \-h
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
56 Print a help message.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
57 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
58 .BI \-n \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
59 Limit the signature length to
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
60 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
61 bits (0 <
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
62 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
63 <= 1024) unless reading from standard input. When reading from
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
64 standard input, the signature is terminated by the first
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
65 carriage return character.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
66 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
67 .BI \-o \ file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
68 Output signature to the specified
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
69 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
70 .BI \-p \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
71 Density parameter in the range 0.0 <
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
72 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
73 <= 1.0. Default value 0.01.
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 Signature strength. Default value 0.1.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
77 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
78 .BI \-r \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
79 Signature bit repetition factor. Specifies how often a single
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
80 signature bit is embedded. Default value 8.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
81 .I file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
82 instead of standard output.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
83 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
84 .BI \-s \ number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
85 Specify a seed value to initialize the pseudo-random number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
86 generator; if not specified, time and pid (process id) are used
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
87 to initialize the pseudo-random number generator.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
88 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
89 .I file
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
90 Input file to read raw signature data from. Default: standard
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
91 input.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
92 .PP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
93 .SH OUTPUT
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
94 The output file has the following format:
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
95 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
96 .B KTSG
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
97 Magic to identify file type.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
98 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
99 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
100 The length of the signature in bits.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
101 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
102 .I number
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
103 The density parameter.
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 signature strength.
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 bit repetition parameter.
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 seed value for the pseudo-random number generator.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
113 .TP
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
114 .I string
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
115 The actual signature bytes.
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. Email bug reports to pmeerw@cosy.sbg.ac.at.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
119 .SH AVAILABILITY
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
120 The most recent released version of
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
121 .B gen_kutter_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
122 is always available
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
123 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
124 directory /pub/people/pmeerw/Watermarking.
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
125 .SH "SEE ALSO"
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
126 .BR wm_kutter_e
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
127 (1),
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
128 .BR wm_kutter_d
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
129 (1),
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
130 .BR cmp_kutter_sig
Peter Meerwald <pmeerw@cosy.sbg.ac.at>
parents:
diff changeset
131 (1)

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