-
-
Notifications
You must be signed in to change notification settings - Fork 0
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
unapper #1
Comments
Basic ConceptsThe terminology to describe Sheets and PagesThe very basic object To do something useful with a sheet, you will at least want to place Input and Output Image Files
By default, If two image-files are specified as input, they will successively be In the same way, if two image-files are specified as output, the The default value both for File FormatsThe image-file formats accepted by The output format is restricted to the PNM family of formats, and Layouts and TemplatesBuilt-In Layout-TemplatesLayouts are the linking concept between physical sheets and
A layout template is chosen by using the option
Choosing a template with the The default template is Note: A layout is completely independent from the number of Complex LayoutsBesides the built-in fixed templates, any kind of complex layout Processing Multiple FilesIn many cases, especially when post-processing scanned books, there
This will successively read images from files Using a wildcard of the form Wildcards in filenames are also useful when combining a sequence of The following example will combine single-page image-files onto a
This joins the input images Using multiple input image-files by setting
Similarly, it is also possible to split up a sheet into several
By default, processing of multiple sheets starts with sheet number Adjusting IndicesIn order to start with a different sheet index, the Using
This would generate the output-files To prevent some sheets from being processed (i.e., remove them from The input and output index numbers to start with can be adjusted using unpaper --input-pages 2 (...options...) --start-input 7 input%03d.pgm output%03d.pgm These settings would cause the input-files File-Sequence PatternsMore sophisticated file-sequence patterns can be specified using Note that it would also be possible to use file-sequence patterns of Specifying a filename as the very last argument on the command-line is Inserting Blank ContentInput file-sequences may be forced to use completely blank images at The MasksMasks are rectangular areas on a sheet that are affected by Automatic Mask-DetectionMasks can be set directly by specifying pixel coordinates using the Automatic mask-detection uses a starting point somewhere on the Several parameters control the process of mask-detection. At first, Mask-detection is performed by the use of a 'virtual bar' which While moving the 'virtual bar' the number of dark pixels below it is The width of the 'virtual bar' can be configured using the Mask-detection can be disabled using the Mask-CenteringMasks that have been automatically detected or manually set will be This allows Mask-centering can be suppressed using BordersUnlike masks, borders are detected by starting at the outer Border-AligningBorders serve two different purposes: First, the area outside the Second, a detected border can optionally be aligned towards one edge This way, it can be assured that e.g. all pages of a scanned book Note that border-aligning is not performed by default, it needs to Use Size ValuesWhenever an option expects a size value, there are three possible
Using one of the last two ways, length measurements get internally Note that using the |
Image Processing FeaturesBlackfilterSometimes it is desirable to automatically remove large black areas Be careful with pictures in scanned documents, especially with The blackfilter can be disabled by the option NoisefilterThe noisefilter removes small clusters of pixels ("noise") from Disable with BlurfilterThe blurfilter removes "lonely" clusters of pixels, i.e. clusters The size of the neighborhood to be searched and the amount of other Disable with GrayfilterThe grayfilter removes areas which are gray-only, that means it Be careful with the grayfilter when processing color scans, because Disable with Deskewing (Auto-Straightening)The deskewing performed by The algorithm that detects the angle of skew works better the more Some parameters control the the size of the 'virtual line' and its At each of these rotation steps, the following is done: The rotated The relative amount of dark pixels to accumulate before shifting the Sometimes, trying out different deskew-scan-depth values, either lower The above described the detection process starting at one single edge If the standard-deviation among the detected angles exceeds the value Deskewing can be disabled with Processing OrderProcessing of the filters and auto-corrections is performed in a fixed
Disabling Processing StepsEach processing step can be disabled individually by a corresponding
This will disable the blackfilter on the sheets 3, 15, 21, 22, 23, |
No description provided.
The text was updated successfully, but these errors were encountered: