1 files changed, 66 insertions, 0 deletions
diff --git a/doc/gamma4scanimage.man b/doc/gamma4scanimage.man
new file mode 100644
index 0000000..fe81b15
--- /dev/null
+++ b/doc/gamma4scanimage.man
@@ -0,0 +1,66 @@
+.TH gamma4scanimage 1 "10 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
+.IX gamma4scanimage
+.SH NAME
+gamma4scanimage \- create a gamma table for scanimage
+.SH SYNOPSIS
+.B gamma4scanimage 
+.I gamma
+.RI [ shadow 
+.RI [ highlight
+.RI [ maxin
+.RI [ maxout ]]]]
+
+.SH DESCRIPTION
+The tool
+.B gamma4scanimage
+creates a gamma table in the format expected by scanimage. You can define a
+.BR gamma,
+a
+.BR shadow
+and a
+.BR highlight
+value. You also can specify the size
+.RB ( maxin )
+and maximum output value
+.RB ( maxout )
+of the gamma table.
+.PP
+.BR gamma
+is a floating point value, neutral value is 1.0, if the value is larger than
+1.0 then the image gets brighter.
+.PP
+.BR shadow
+defines the minimum input value that is necessary to create an output value
+larger than zero.  shadow has to be in the range [0..maxin]. Its default value
+is 0.
+.PP
+.BR highlight
+defines the maximum input value that produces an output value smaller than
+maxout.  highlight has to be in the range [0..maxin], highlight has to be
+larger than shadow. Its default value is the same as maxin (16383 if not set).
+.PP
+.BR maxin
+defines the size of the gamma table. The size depends on the scanner/backend.
+If the scanner uses 8 bits gamma input then maxin has to be set to 255, for 10
+bits 1023, for 12 bits 4095, for 14 bits 16383. The default is 16383.  To find
+out what value maxin has to be call scanimage with a very large gamma table
+[0]0-[99999]255 then scanimage prints an error message with the needed size of
+the gamma table.
+.PP
+.BR maxout
+defines the maximum output value. Take a look at the output of scanimage \-h to
+find out what maxout has to be. The default value is 255.
+.PP
+.SH EXAMPLE
+.B scanimage \-\-custom\-gamma=yes \-\-gamma\-table 
+.I `gamma4scanimage 1.8 0 11500 16383 255`
+>image.pnm
+
+.SH SEE ALSO
+.BR scanimage (1)
+
+.SH AUTHOR
+Oliver Rauch
+
+.SH EMAIL-CONTACT
+Oliver.Rauch@Rauch-Domain.DE