MCPcopy Create free account
hub / github.com/4lex4/scantailor-advanced

github.com/4lex4/scantailor-advanced @2019.8.16_EA

Chat with this repo
repository ↗ · DeepWiki ↗ · release 2019.8.16_EA ↗ · + Follow
5,521 symbols 14,087 edges 759 files 246 documented · 4% updated 2y ago2019.8.16_EA · 2019-08-16★ 1,50396 open issues

Browse by type

Functions 3,907 Types & classes 1,614
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

ScanTailor Advanced

The ScanTailor version that merges the features of the ScanTailor Featured and ScanTailor Enhanced versions, brings new ones and fixes.

Contents:

Description

ScanTailor is an interactive post-processing tool for scanned pages. It performs operations such as: - page splitting, - deskewing, - adding/removing borders, - selecting content - ... and others.

You give it raw scans, and you get pages ready to be printed or assembled into a PDF or DjVu file. Scanning, optical character recognition, and assembling multi-page documents are out of scope of this project.

Features

ScanTailor Enhanced

  • Auto margins [improved]
    Auto margins feature allows keep page content on original place. In the Margins step you can choose from Auto, Manual (default) and Original mode. The manual mode is the original one. Auto mode try to decide if it is better to align page top, bottom or center. Original mode keeps page on their vertical original position.

This feature has been improved. See page area feature description. Also see ScanTailor Advanced fixes & improvements

  • Page detect [reworked]
    Page detect feature allows detect page in black margins or switch off page content detection and keep original page layout.

This feature has been reworked. See ScanTailor Advanced fixes & improvements for more information.

  • Deviation [reworked]
    Deviation feature enables highlighting of different pages. Highlighted in red are pages from Deskew filter with too high skew, from Select Content filter pages with different size of content and in Margins filter are highlighted pages which does not match others.

This feature has been reworked. See ScanTailor Advanced fixes & improvements for more information.

  • Picture shape [reworked]
    Picture shape feature adds option for mixed pages to choose from free shape and rectangular shape images. This patch does not improve the original algoritm but creates from the detected "blobs" rectangular shapes and the rectangles that intersects joins to one.

This feature has been reworked. See rectangular picture shape feature description.

  • Multi column thumbnails view [reworked]
    This allows to expand and un-dock thumbnails view to see more thumbnails at a time.

This feature had performance and drawing issues and has been reworked.

ScanTailor Featured

  • ScanTailor Featured fixes & improvements
  • Deleted 3 Red Points.
    The 3 central red points on the topmost (bottom-most) horizontal blue line of the dewarping mesh are now eliminated.
  • Manual dewarping mode auto switch.
    The dewarping mode is now set to MANUAL (from OFF) after the user has moved the dewarping mesh.
  • Auto dewarping vertical half correction.
    This patch corrects the original auto-dewarping in half the cases when it fails. If the vertical content boundary angle (calculated by auto-dewarping) exceeds an empirical value (2.75 degrees from vertical), the patch adds a new point to the distortion model (with the coordinates equal to the neighboring points) to make this boundary vertical. The patch works ONLY for the linear end of the top (bottom) horizontal line of the blue mesh (and not for the opposite curved end).

  • Line vertical dragging on dewarp

    You can move the topmost (bottom-most) horizontal blue line of the dewarping mesh up and down as a whole - if you grab it at the most left (right) red point - holding down the CTRL key.

  • Square picture zones [reworked]

    You can create the rectangular picture zones - holding down the CTRL key. You can move the (rectangular) picture zones corners in an orthogonal manner - holding down the CTRL key.

This feature has been reworked and is now a part of new zone interaction modes feature.

  • Auto save project [optimized]
    Set the "auto-save project" checked in the Settings menu and you will get your project auto-saved provided you have originally saved your new project. Works at the batch processing too.

This feature had performance issues and has been optimized.

  • Quadro Zoner [reworked]
    Another rectangular picture zone shape. This option is based on Picture shape, Square picture zones. It squeezes every Picture shape zone down to the real rectangular picture outline and then replaces it (the resulting raster zone) by a vector rectangular zone, so that a user could easily adjust it afterwards (by moving its corners in an orthogonal manner).

This feature has been reworked. See rectangular picture shape feature description.

  • Marginal dewarping
    An automatic dewarping mode. Works ONLY with such raw scans that have the top and bottom curved page borders (on the black background). It automatically sets the red points of the blue mesh along these borders (to create a distortion model) and then dewarps the scan according to them. Works best on the low-curved scans.

Note: Other features of this version, such as Export, Dont_Equalize_Illumination_Pic_Zones, Original_Foreground_Mixed has't been moved due to dirty realization. Their functionality is fully covered by full control over settings on output and splitting output features.

ScanTailor Universal

  • ScanTailor Universal fixes & improvements
  • Improvements for the thumbnail view.

    1. More accurate multi-column list handling.
    2. Scaling thumbnails via Alt+Wheel.
  • Fixed some bugs of official and Enhanced version.

ScanTailor Advanced

  • ScanTailor Advanced fixes & improvements
  • Portability.
    The settings and program files are stored in the folder with the application.
    Note: If installed into a system directory, where config and data files can't be written into the folder with the application executable, ScanTailor Advanced works as a standalone app and stores its settings and application data in the appropriate system specific paths.

  • Page splitting settings now influence on the output by filling offcut. Fill offcut option has been added.

  • Page layout and all the other views now consider splitting settings. Corresponding improvements are done for thumbnails.

  • Changed ScanTailor behavior on page split stage.

    1. Reworked apply cut feature. Now on applying cut to the pages with different dimensions than the page the cut applied to, ScanTailor tries to adapt cutters instead of fully rejecting the cut setting and switching to auto mode for those pages as it was before. The later was annoying as pages could be similar and had the difference in a few pixels.
    2. Added check to reject invalid cut settings in manual mode.
    3. UI: Added cutters interaction between each other. They can't more intersect each other, which created a wrong page layout configuration before.
  • Optimized memory usage on the output stage.

  • Reworking on multi column thumbnails view feature from ver. Enhanced. Now thumbnails are shown evenly.

  • Added option to control highlighting the thumbnails of pages with high deviation with red asterisks. The option refreshes the thumbnails instantly.

  • Deviation feature reworked.

    1. A deviation provider implemented.
      It supports caching and recalculates the values on demand. There isn't more any necessity to store deviation in page parameters and so in the project file, that approach caused some problems as the deviation is not actually a page parameter and depends on all the pages in the project.
    2. Added sorting by decreasing deviation.
  • Page/content boxes and auto margins features fixes & improvements.

    1. Added a feature of dragging both content and page areas by using Shift+LMB combination.
    2. A page box implementation reworked. Now it's interactive and can be adjusted by the same way as a content box is done.
    3. The page rectangle does not require refreshing page and won't be reset on the content area changes.
    4. Implemented applying the page/content boxes to the other pages automatically correcting the position of the boxes.
    5. Added width and height parameters to regulate the page box size in manual mode.
    6. Auto margins option has been moved out of the alignment settings and does no more force to use only the original layout.
    7. Auto margins feature now considers page box changes made at the selection content stage.
    8. Other bug fixes and improvements.
  • Auto and original alignment modes reworked:

    1. The original and auto alignment modes didn't work correctly due to the error in code.
    2. Both the modes didn't work rightly after select content stage or reopening the project file, always requiring secondary batch processing of every page at margins stage to work correctly.
    3. Reworked calculation method for the original alignment. Now it is more precise.
    4. Original alignment mode now considers the page box from 4th stage.
    5. Fixed behaviour of horizontal alignment, when the original mode enabled, and auto margins has been enabled/disabled. Also on applying auto-margins / original alignment to the set of pages, that is now set correctly for each page.
    6. Added ability to separately control vertical and horizontal automatic alignment when auto or original alignment mode enabled.
  • Changed the way of the adjustment of the despeckle strength.
    Now that's set via the slider. It allows to adjust the despeckle strength more smoothly and exactly. Value 1.0 matches the old cautious mode, 2.0 - normal and 3.0 - aggressive.

  • Improvements on the thumbnails view:

    • Saving selection of pages on filter switch.
    • Separate highlighting for selection leader in thumbnails.
    • Navigating between selected pages. Use Shift+PgUp/Q and Shift+PgDown/W to navigate between selected pages.
    • Added buttons to navigate between pages.
  • Added options in the settings to manage the quality and size of thumbnails.
    It's possible to switch thumbnail quality while working on a project with the changes applied immediately. For every quality chosen a cache is created.
    Usage example: you could use this feature for the preview purpose, which is faster than simple navigating between pages. Undock the thumbnails panel, set the quality, for ex., to 700, and size to 1000. You can mark problem pages with Ctrl+Click on a thumbnail and navigate between these selected pages after finishing to fix them. To finish the preview change the quality and size values back and dock the panel.

  • Fixed other bugs of official, Enhanced and Featured ve

Core symbols most depended-on inside this repo

Shape

Method 3,565
Class 1,546
Function 342
Enum 68

Languages

C++100%

Modules by API surface

src/app/MainWindow.cpp109 symbols
src/app/ThumbnailSequence.cpp76 symbols
src/core/ImageViewBase.cpp63 symbols
src/core/filters/output/OptionsWidget.cpp62 symbols
src/app/DefaultParamsDialog.cpp61 symbols
src/core/filters/output/OutputGenerator.cpp59 symbols
src/app/ProjectFilesDialog.cpp49 symbols
src/core/filters/page_layout/ImageView.cpp48 symbols
src/app/FixDpiDialog.cpp47 symbols
src/imageproc/Morphology.cpp43 symbols
src/dewarping/TopBottomEdgeTracer.cpp43 symbols
src/imageproc/BinaryImage.cpp42 symbols

For agents

$ claude mcp add scantailor-advanced \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page