'\" t
.\"     Title: optimize2bw
.\"    Author: Jakub Wilk <jwilk@debian.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 04/11/2010
.\"    Manual: ExactImage Manual
.\"    Source: optimize2bw
.\"  Language: English
.\"
.TH "OPTIMIZE2BW" "1" "04/11/2010" "optimize2bw" "ExactImage Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
optimize2bw \- automatic thresholder of the ExactImage toolkit
.SH "SYNOPSIS"
.HP \w'\fBoptimize2bw\fR\ 'u
\fBoptimize2bw\fR [\fIoption\fR...] {\fB\-i\fR\ |\ \fB\-\-input\fR}\ \fIinput\-file\fR  {\fB\-o\fR\ |\ \fB\-\-output\fR}\ \fIoutput\-file\fR 
.HP \w'\fBoptimize2bw\fR\ 'u
\fBoptimize2bw\fR \fB\-\-help\fR
.SH "DESCRIPTION"
.PP
ExactImage is a fast C++ image processing library\&. Unlike many other library frameworks it allows operation in several color spaces and bit depths natively, resulting in low memory and computational requirements\&.
.PP
\fBoptimize2bw\fR
reads image files and performs automatic thresholding and optional scaling on the data\&. It is useful for long term archiving of documents that have to be stored in sub\-byte black and white data to reduce storage requirements\&.
.SH "OPTIONS"
.PP
\fB\-i \fR\fB\fIfile\fR\fR, \fB\-\-input \fR\fB\fIfile\fR\fR
.RS 4
Read image from the specified file\&.
.RE
.PP
\fB\-o \fR\fB\fIfile\fR\fR, \fB\-\-output \fR\fB\fIfile\fR\fR
.RS 4
Save output image to the specified file\&.
.RE
.PP
\fB\-n\fR, \fB\-\-denoise\fR
.RS 4
Remove (\(lqdenoise\(rq) single bit pixel noise\&.
.RE
.PP
\fB\-d \fR\fB\fIn\fR\fR, \fB\-\-dpi \fR\fB\fIn\fR\fR
.RS 4
Scale the image to the specified resolution\&.
.RE
.PP
\fB\-h \fR\fB\fIn\fR\fR, \fB\-\-high \fR\fB\fIn\fR\fR
.RS 4
Set high normalization value\&.
.RE
.PP
\fB\-l \fR\fB\fIn\fR\fR, \fB\-\-low \fR\fB\fIn\fR\fR
.RS 4
Set low normalization value\&.
.RE
.PP
\fB\-r \fR\fB\fIn\fR\fR, \fB\-\-radius \fR\fB\fIn\fR\fR
.RS 4
Set \(lqunsharp mask\(rq radius\&. The default is 0\&.
.RE
.PP
\fB\-s \fR\fB\fIn\fR\fR, \fB\-\-scale \fR\fB\fIn\fR\fR
.RS 4
Set output scale factor\&. The default is 1\&.0\&.
.RE
.PP
\fB\-sd \fR\fB\fIx\fR\fR, \fB\-\-standard\-deviation \fR\fB\fIx\fR\fR
.RS 4
Set standard deviation for Gaussian distribution\&. The default is 0\&.0\&.
.RE
.PP
\fB\-t \fR\fB\fIn\fR\fR, \fB\-\-threshold \fR\fB\fIn\fR\fR
.RS 4
Set threshold value\&. The default is 0\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Display help text and exit\&.
.RE
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
$ optimize2bw \-i logo\&.jpg \-o logo\&.tif
Scale: 0
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
\fBexactimage\fR(7)
.SH "AUTHORS"
.PP
\fBJakub Wilk\fR <\&jwilk@debian\&.org\&>
.RS 4
Wrote this manual page for the Debian system\&.
.RE
.PP
\fB\m[blue]\fB\%https://exactcode.com/opensource/exactimage/\fR\m[]\fR
.RS 4
This manual page incorporates texts found on the ExactImage homepage\&.
.RE
.SH "COPYRIGHT"
.br
.PP
This manual page was written for the Debian system (and may be used by others)\&.
.PP
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in
/usr/share/common\-licenses/GPL\-2\&.
.sp