GitXplorerGitXplorer
h

skanfixer

public
1 stars
0 forks
3 issues

Commits

List of commits on branch master.
Verified
2f95f92dc2931ed888fdb65526964f4cbc11b2ee

Merge pull request #1 from hemidactylus/dependabot/pip/pillow-8.1.1

hhemidactylus committed 4 years ago
Verified
7d937d21300e6da72eefa826d681ef8c301ebfbe

Bump pillow from 7.0.0 to 8.1.1

ddependabot[bot] committed 4 years ago
Unverified
2bfcd90388a5bc58ea7a38fc46e1f876077d398f

python3

hhemidactylus committed 5 years ago
Unverified
cb101e50a144bfd1c074560805e55839409eeb57

Minor changes in params

hhemidactylus committed 7 years ago
Unverified
90a827e3e0f960c9cee9d2311b3a0c5b4997f7a5

Updated the pillow version to fix some zip-missing errors

hhemidactylus committed 7 years ago
Unverified
00b619f3291e2bdf2b94dd6613682716b736bb61

More small stuff in readme and so on

hhemidactylus committed 8 years ago

README

The README file for this repository.

skanfixer

A program to quickly sort multi-photo scanned images.

Define clip rectangles, with their rotation and label, hit Save and move on to the next picture. Quick and easy.

Overview

Flow

You have a directory with some images, each coming for instance from scanning a pageful of photos or something and containing several subjects. If you want to save each subject as a separate image, and do it quickly, then skanfixer is the right tool.

skanfixer lets you browse all pictures in a given folder, define a number of clip-rectangles in each picture, optionally assign a rotation angle and a label to them, and save the contents of each rectangle as a separate image into a target directory.

Starting in version 1.0, the loaded image is analysed and a set of clip rectangles is suggested. This procedure, based on erosion/dilation techniques, can be turned off and configured in the settings.

Installation and requirements

To install: clone this repo, make sure you have Python3 and install the packages in the requirements.txt

Usage

There are a source directory and a target directory: each can be chosen from the button bar. To move through the source images use the arrows; for each image you define one or more clip-rectangles and hit Save to have them exported as stand-alone images in the target directory.

The output filenames features a numeric prefix (whose offset can be configured) and a rectangle label, if one was specified. The prefix keeps increasing throughout the whole source-dir.

Defining clip-rectangles

Every time you move away from a given source-image, all defined rectangles are lost; so, once all rectangles are set up, hit Save before advancing to the next picture.

A first click on the picture creates a new rectangle's corner; a second click places the opposite corner. Rectangles are deleted with a right-click and resized by clicking on their eight size-handles.

The bottom side of the enclosed clip is marked by a thinner internal line: press 'R' when a rectangle is highlighted to change its orientation (which affects the final saved clip-picture).

A rectangle can have a defining, not necessarily unique, label: to set it, press 'L' when the rectangle is highlighted, type the label and press 'Enter' to confirm.

Labeling

The zoom view

You can turn on and off, at any time, a zoom view, centred on the current mouse position, to perform pixel-sharp positioning. Press 'Z' to toggle it, or 'Esc' to clear it. The zoom view acts as a portion of the main picture view in (almost) all respects, so for instance you can move a rectangle's corner through the zoom view, in and out of it, open the zoom window while moving it, etc.

Zoom

Known bugs

None at the moment; please let me know if you find any.

To do

See TODO file in this repository.