Kristian/scanned-image-extractor
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

initial commit

Browse Source
This commit is contained in:
Kristian Krsnik
2024-01-30 00:24:37 +01:00
commit 7c12323acc
94 changed files with 17952 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/images/SIE.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 13 KiB

BIN
doc/images/multiplace.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 722 KiB

BIN
doc/images/note.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.5 KiB

BIN
doc/images/overview.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 499 KiB

BIN
doc/images/scannerpos.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 494 KiB

333
doc/scannerExtract.css Normal file
View File

@ -0,0 +1,333 @@
/*
* Copyright (c) 2001, 2003, 2010 The FreeBSD Documentation Project
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
* $FreeBSD: doc/share/misc/docbook.css,v 1.21 2012/01/25 22:16:36 wblock Exp $
*/
BODY ADDRESS {
line-height: 1.3;
margin: .6em 0;
}
BODY BLOCKQUOTE {
margin-top: .75em;
line-height: 1.3;
margin-bottom: .75em;
}
HTML BODY {
margin: 1em 8% 1em 10%;
line-height: 1.2;
}
/* .LEGALNOTICE { */
/* font-size: small; */
/* font-variant: small-caps; */
/* } */
/* legal notice box */
div.legalnotice
{
/* list of fonts provides fallbacks if a font is not present */
font-family: Verdana, Arial, Helvetica, Sans-Serif;
/* font size, relative to body font size */
font-size: 85%;
/* color: black */
color: #000;
/* background color: gray */
background-color: #ddd;
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 5px 45px 5px 45px;
/* padding ("inner margin") settings are top - right - bottom - left */
/* (think clockwise) */
padding: 0px 5px 0px 5px;
/* solid black border, 1px wide */
border: 1px solid #000;
}
BODY DIV {
margin: 0;
}
DL {
margin: .8em 0;
line-height: 1.2;
}
DIV.CALLOUTLIST DT {
float: left;
width: 1em;
}
DIV.CALLOUTLIST DD {
clear: right;
margin-bottom: 1ex;
}
BODY FORM {
margin: .6em 0;
}
H1, H2, H3, H4, H5, H6,
DIV.EXAMPLE P B,
.QUESTION,
DIV.TABLE P B,
DIV.PROCEDURE P B {
color: #000066;
}
BODY H1, BODY H2, BODY H3, BODY H4, BODY H5, BODY H6 {
line-height: 1.3;
margin-left: 0;
}
BODY H1, BODY H2 {
margin: .8em 0 0 -4%;
}
BODY H3, BODY H4 {
margin: .8em 0 0 -3%;
}
BODY H5 {
margin: .8em 0 0 -2%;
}
BODY H6 {
margin: .8em 0 0 -1%;
}
BODY HR {
margin: .6em;
border-width: 0 0 1px 0;
border-style: solid;
border-color: #cecece;
}
BODY IMG.NAVHEADER {
margin: 0 0 0 -4%;
}
OL {
margin: 0 0 0 5%;
line-height: 1.2;
}
BODY PRE {
margin: .75em 0;
line-height: 1.0;
font-family: monospace;
}
BODY TD, BODY TH {
line-height: 1.2;
}
UL, BODY DIR, BODY MENU {
margin: 0 0 0 5%;
line-height: 1.2;
}
HTML {
margin: 0;
padding: 0;
}
BODY P B.APPLICATION {
color: #000000;
}
P {
text-align: justify;
}
.FILENAME {
color: #007a00;
}
SVNREF {
color: #007a00;
}
.GUIMENU, .GUIMENUITEM, .GUISUBMENU,
.GUILABEL, .INTERFACE,
.SHORTCUT, .SHORTCUT .KEYCAP {
font-weight: bold;
}
.GUIBUTTON {
background-color: #CFCFCF;
padding: 2px;
}
.ACCEL {
background-color: #F0F0F0;
text-decoration: underline;
}
.SCREEN {
padding: 1ex;
}
.PROGRAMLISTING {
padding: 1ex;
background-color: #eee;
border: 1px solid #ccc;
line-height: 1.1;
}
@media screen { /* hide from IE3 */
a[href]:hover { background: #ffa }
}
.INFORMALTABLE, .TABLE TH {
padding-left: 02.em;
text-align: left;
}
BLOCKQUOTE, .EXAMPLE, .PROGRAMLISTING {
-moz-border-radius: 6px;
-webkit-border-radius: 6px;
-khtml-border-radius: 6px;
border-radius: 6px;
}
BLOCKQUOTE {
padding: 0 2ex;
}
BLOCKQUOTE.NOTE {
color: #222;
background: #eee;
border: 1px solid #ccc;
width: 85%;
}
BLOCKQUOTE.TIP {
color: #004F00;
background: #d8ecd6;
border: 1px solid green;
width: 85%;
}
BLOCKQUOTE.IMPORTANT {
font-style:italic;
border: 1px solid #a00;
border-left: 12px solid #c00;
}
BLOCKQUOTE.WARNING {
color: #9F1313;
background: #f8e8e8;
border: 1px solid #e59595;
width: 85%;
}
BLOCKQUOTE.CAUTION {
color: #3E3535;
background: #FFC;
border: 1px solid #e59595;
width: 85%;
}
.EXAMPLE {
background: #fefde6;
border: 1px solid #f1bb16;
margin: 1em 0;
padding: 0.2em 2em;
width: 90%;
}
.INFORMALTABLE TABLE.CALSTABLE TR TD {
padding-left: 1em;
padding-right: 1em;
}
.figure
{
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 0 75px 0 75px;
/* no padding ("inner border") */
padding-top: 15px;
padding-bottom: 15px;
color: black;
/* center text */
text-align: center;
/* background color: gray */
background-color: #bbb;
/* solid black border, 1px wide */
/* border: 1px solid #000; */
border: 0
}
/* admonitions */
.warning, .caution, .tip, .note, .important {
border: 1px dashed grey;
padding: .5em;
margin-top: 1em;
}
.note{
background-color: #ddffff;
background: #deffce url("images/note.png") no-repeat left center;
}
.note h3, .warning h3, .caution h3, .tip h3, .important h3 {
margin: 0 0 0 2.5em;
}
.note p, .warning p, .caution p, .tip p, .important p {
margin-left: 3em;
}
/* FIXME: background colours are cheezy :S ... */
/* see language specific css for content: */
.warning {
background-color: red;
}
.caution {
background-color: yellow;
}
.tip {
background-color: #aaaddd;
}
.important {
background-color: plum;
}

219
doc/scannerExtract_help_de.html Normal file
View File

@ -0,0 +1,219 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Scanned Image Extractor</title><link rel="stylesheet" type="text/css" href="scannerExtract.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /></head><body><p xmlns=""><a href="../">Back to main page</a>,
<a href="scannerExtract_help_en.html" style="margin-left:25px;">English Version</a></p><div class="article"><div class="titlepage"><div><div><h2 class="title"><a id="idp50610432"></a>Scanned Image Extractor</h2></div><div><p class="copyright">Copyright © 2015 Dominik Rueß</p></div><div><div class="legalnotice"><a id="idp50611984"></a><p class="legalnotice-title"><strong>Rechtshinweise</strong></p><p xml:lang="de" lang="de">
</p><p>
Dieser Artikel ist Bestandteil von <span class="emphasis"><em>Scanned Image Extractor</em></span>.
<span class="emphasis"><em>Scanned Image Extractor</em></span> ist freie Software.
Sie können es unter den Bedingungen der GNU General Public
License, wie von der Free Software Foundation veröffentlicht,
weitergeben und/oder modifizieren, entweder gemäß Version
3 der Lizenz oder (nach Ihrer Option) jeder späteren Version.
</p><p xml:lang="de" lang="de">
</p><p>
Die Veröffentlichung dieses Programms erfolgt in der Hoffnung,
daß es Ihnen von Nutzen sein wird,
aber OHNE IRGENDEINE GARANTIE, sogar ohne die implizite Garantie
der MARKTREIFE oder der VERWENDBARKEIT FÜR EINEN BESTIMMTEN
ZWECK.
Details finden Sie in der GNU General Public License.
</p><p xml:lang="de" lang="de">
</p><p>
In <a class="xref" href="#gplde" title="6. GNU General Public License">Abschnitt 6, „GNU General Public License“</a> ist ein Verweis auf die Lizenz zu finden,
oder alternativ direkt unter
<a class="ulink" href="http://www.gnu.org/licenses/" target="_top">http://www.gnu.org/licenses/</a>
</p><p xml:lang="de" lang="de">
</p></div></div></div><hr /></div><div class="toc"><p><strong>Inhaltsverzeichnis</strong></p><dl class="toc"><dt><span class="sect1"><a href="#preface">1. Vorwort 1: Open Source und unterstützte Platformen</a></span></dt><dt><span class="sect1"><a href="#backup">2. Vorwort 2: Sichern Sie Ihre Daten</a></span></dt><dt><span class="sect1"><a href="#idp48855296">3. Was ist <span class="emphasis"><em>Scanned Image Extractor</em></span> ?</a></span></dt><dd><dl><dt><span class="sect2"><a href="#features">3.1. Liste der Möglichkeiten mit <span class="emphasis"><em>Scanned Image Extractor</em></span></a></span></dt><dt><span class="sect2"><a href="#download">3.2. <span class="emphasis"><em>Scanned Image Extractor</em></span> herunterladen</a></span></dt><dt><span class="sect2"><a href="#reports">3.3. Wo können Sprachschwächen, Programmfehler
und Anforderungswünsche verfasst werden ?</a></span></dt><dt><span class="sect2"><a href="#errors">3.4. Was tun, wenn meine Scannerbilder nicht gut erkannt werden?</a></span></dt></dl></dd><dt><span class="sect1"><a href="#usecases">4. Benutzung:</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp53572416">4.1. Installation von <span class="emphasis"><em>Scanned Imaged Extractor</em></span></a></span></dt><dd><dl><dt><span class="sect3"><a href="#idp53575504">4.1.1. Microsoft Windows</a></span></dt><dt><span class="sect3"><a href="#idp53577280">4.1.2. GNU Linux</a></span></dt><dt><span class="sect3"><a href="#idp53584064">4.1.3. Von den Quellen bauen</a></span></dt></dl></dd><dt><span class="sect2"><a href="#idp53588592">4.2. Übersicht des gesamten Album-Scannes</a></span></dt><dt><span class="sect2"><a href="#howto">4.3. Wie Sie <span class="emphasis"><em>Scanned Image Extractor</em></span> benutzen</a></span></dt><dt><span class="sect2"><a href="#tips">4.4. Tipps und Tricks für <span class="emphasis"><em>Scanned Image Extractor</em></span></a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp53641376">5. Weitere Hilfe</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp53642256">5.1. Hilfe für bestimmte Bedienelemente</a></span></dt><dt><span class="sect2"><a href="#donate">5.2. Spenden an den Autor</a></span></dt></dl></dd><dt><span class="sect1"><a href="#gplde">6. GNU General Public License</a></span></dt></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="preface"></a>1. Vorwort 1: Open Source und unterstützte Platformen</h2></div></div></div><p xml:lang="de" lang="de">
Diese Software App is <span class="emphasis"><em>Open Source</em></span>.
Das heißt, dass ich nicht extrem viel Zeit und Geld in das Testen und Erwerben von verschiedenen Systemen bzw. Platformen investieren kann.
Der Vorteil von Open Source liegt in Freiheit und Offenheit (im Gegensatz zu Kommerzieller Software, Freeware oder Shareware).
Manchmal ist Open Source aber nicht ganz kostenlos - der Benutzer hat Kosten in dem Sinne, dass er dem Entwickler Feedback oder Fehlermeldungen zurück gibt.
</p><p xml:lang="de" lang="de">
Ich habe diese Software für verschiedene Platformen herausgegeben (z.B. Windows, Ubuntu, Fedora).
Ich kann das aber nur für Systeme tun, die ich selbst besitze.
Wenn eine Platform nicht unterstützt ist, senden Sie mir doch einen Vorschlag.
Ich würde auch liebend gerne die Software für <span class="emphasis"><em>Mac OS X</em></span> herausgeben.
Leider besitze ich keinen Mac.
Wenn Sie hieran interessiert sind, denken Sie über eine Spende nach (<a class="xref" href="#donate" title="5.2. Spenden an den Autor">Abschnitt 5.2, „Spenden an den Autor“</a>),
dann kann ich hoffentlich bald einen Mac erwerben und die Software dafür anpassen und vor allem dauerhaft supporten.
</p></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="backup"></a>2. Vorwort 2: Sichern Sie Ihre Daten</h2></div></div></div><p xml:lang="de" lang="de">
Erstellen Sie immer Sicherungen von Ihren Dateien, auch
wenn Sie Scanned Image Extractor benutzen !!!
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Anmerkung</h3><p xml:lang="de" lang="de">
Das reine Scannen von Alben oder Bildern ist sehr zeitaufwändig. Behalten Sie daher am besten eine Kopie der Original-Scannerdaten an einem anderen Ort auf.
</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp48855296"></a>3. Was ist <span class="emphasis"><em>Scanned Image Extractor</em></span> ?</h2></div></div></div><p xml:lang="de" lang="de">
</p><div><img src="images/SIE.png" /></div><p xml:lang="de" lang="de">
<span class="emphasis"><em>Scanned Image Extractor</em></span> is ein Werkzeug um schnell und effizient rechteckige Fotografien aus Albums- oder (mehreren) Fotografie-Scans zu extrahieren. Das Programm is halb-automatisch und versucht Fotografien zu erkennen. Sie können diese Vorschläge akzeptieren, modifizieren, löschen oder ggf. selbst hinzufügen.
</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="features"></a>3.1. Liste der Möglichkeiten mit <span class="emphasis"><em>Scanned Image Extractor</em></span></h3></div></div></div><p xml:lang="de" lang="de">
<span class="emphasis"><em>Scanned Image Extractor</em></span> bietet eine interessante Liste von Eigenschaften
und Fähigkeiten.
Um ein paar dieser Möglichkeiten beschrieben zu sehen,
gehen Sie zu <a class="xref" href="#usecases" title="4. Benutzung:">Abschnitt 4, „Benutzung:“</a>.
Mit <span class="emphasis"><em>Scanned Image Extractor</em></span> können Sie:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
effizient eine oder mehrere Fotografien aus Scannerbildern extrahieren.
</p></li><li class="listitem"><p>
mit 16 Bit Eingangs- und Ausgangsbildern arbeiten (nützlich, falls Sie danach z.B. noch mit Gimp 2.9+ oder Lightroom arbeiten)
</p></li><li class="listitem"><p>
automatische Fotografieerkennungen vorgeschlagen bekomen. Falls diese falsch sind, können Sie diese manuell korrigieren, löschen oder neu erstellen.
</p></li><li class="listitem"><p>
Das Seitenverhältnis der extrahierten Fotografien kontrollieren.
</p></li><li class="listitem"><p>
Tastenkürzel für einen noch effizienteren Arbeitsablauf benutzen.
</p></li></ul></div><p xml:lang="de" lang="de">
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="download"></a>3.2. <span class="emphasis"><em>Scanned Image Extractor</em></span> herunterladen</h3></div></div></div><p xml:lang="de" lang="de">
Gehen Sie zu sourceforge und laden sie die Dateien dort herunter:
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/" target="_top">sourceforge.net/p/scannedimageextractor/</a> -&gt;
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/files/" target="_top">Files</a>. Wählen Sie die aktuelle
Version und die passende Datei für Ihr Betriebssystem aus (vor allem für 32/64 Bit Windows).
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reports"></a>3.3. Wo können Sprachschwächen, Programmfehler
und Anforderungswünsche verfasst werden ?</h3></div></div></div><p xml:lang="de" lang="de">
Gehen Sie zu sourceforge und verfassen Sie Ihren Beitrag dort.
Am besten auf Englisch, dann können Ihnen auch andere Benutzer helfen.
Es geht aber auch auf Deutsch:
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/" target="_top">sourceforge.net/p/scannedimageextractor/</a> -&gt;
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/tickets" target="_top">Tickets</a>
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="errors"></a>3.4. Was tun, wenn meine Scannerbilder nicht gut erkannt werden?</h3></div></div></div><p xml:lang="de" lang="de">
Jedes Fotoalbum sieht anders aus.
Wenn Sie ein Album haben, von dessen Scans die Fotografien nur schlecht erkannt werden, senden Sie mir ein paar Beispiele (volle Auflösung) an <span class="emphasis"><em>scannerextract at dominik-ruess.de</em></span>.
Für eine gute, automatische Erkennung sollten Sie aber immer die Hinweise in <a class="xref" href="#howto" title="4.3. Wie Sie Scanned Image Extractor benutzen">Abschnitt 4.3, „Wie Sie <span class="emphasis"><em>Scanned Image Extractor</em></span> benutzen“</a> und <a class="xref" href="#tips" title="4.4. Tipps und Tricks für Scanned Image Extractor">Abschnitt 4.4, „Tipps und Tricks für <span class="emphasis"><em>Scanned Image Extractor</em></span>“</a> beachten.
</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="usecases"></a>4. Benutzung:</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp53572416"></a>4.1. Installation von <span class="emphasis"><em>Scanned Imaged Extractor</em></span></h3></div></div></div><p xml:lang="de" lang="de">
Laden Sie die neueste Datei für Ihr Betriebssystem von <a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/files/" target="_top">Scanned Image Extractor Files</a> herunter.
Wenn Sie ein 64bit Betriebssystem benutzen (sehr wahrscheinlich heutzutage), dann empfehle ich die 64bit Version von <span class="emphasis"><em>Scanned Imaged Extractor</em></span>.
</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp53575504"></a>4.1.1. Microsoft Windows</h4></div></div></div><p xml:lang="de" lang="de">
Die Installationsdatei (endet auf win32.exe oder win64.exe) ist selbsteklärend. Laden Sie sie herunter und führen Sie sie aus.
Getestet mit Windows 7 (64bit).
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp53577280"></a>4.1.2. GNU Linux</h4></div></div></div><p xml:lang="de" lang="de">
Für Debian-ähnliche Systeme (mit Ubuntu getestet) laden Sie die passende .DEB-Datei herunter.
Installieren Sie die Voraussetzungen:
<code class="code">
sudo apt-get install libqt5core5a libqt5network5
libqt5gui5 libqt5svg5 libqt5widgets5 liblbfgs0
libopencv-core2.4 libopencv-highgui2.4
libopencv-imgproc2.4
</code>.
Installieren Sie nun <span class="emphasis"><em>Scanned Imaged Extractor</em></span> mit
<code class="code">sudo dpkg -i scannerExtract-x.y.z.deb</code>.
Das Programm kann mit <code class="code">scannedImagedExtractor</code> gestartet werden.
</p><p xml:lang="de" lang="de">
Für RPM-basierte Systeme (mit Fedora getestet) installieren Sie die Vorraussetzungen:
<code class="code">sudo dnf install opencv-core qt5-qtsvg
qt5-qtbase liblbfgs
opencv</code>.
Installieren Sie nun <span class="emphasis"><em>Scanned Imaged Extractor</em></span> mittels
<code class="code">rpm --install -p scannerExtract-x.y.z.rpm </code>
Das Programm kann mit <code class="code">scannedImagedExtractor</code> gestartet werden.
</p><p xml:lang="de" lang="de">
Getestet mit Ubuntu 14.04, 15.04 und Fedora 22-3 (alle jeweils mit 32 und 64bit).
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp53584064"></a>4.1.3. Von den Quellen bauen</h4></div></div></div><p xml:lang="de" lang="de">
Sie benötigen cmake und die Module OpenCV (Version 2.4 or 3), liblbfgs und Qt5.
Wenn Sie Version 2 von OpenCV benutzen, dann müssen Sie "-DOPENCV2=1" zur CMAKE-Kommandezeile hinzufügen.
Wenn Sie zum Beispiel unter Ubuntu bauen wollen, dann so:
<code class="code"> sudo apt-get install liblbfgs-dev libopencv-dev libqt5svg5-dev
qttools5-dev-tools qttools5-dev qtbase5-dev cmake </code>.
Nun <span class="emphasis"><em>Scanned Image Extractor</em></span> bauen:
<code class="code"><div class="literallayout"><p><br />
                mkdir build<br />
                cd build<br />
                cmake path/to/scannerExtract-X.Y.Z/scannerExtract/ -DCMAKE_BUILD_TYPE=release -DOPENCV2=1<br />
                make<br />
                (make install)</p></div>
</code>
</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp53588592"></a>4.2. Übersicht des gesamten Album-Scannes</h3></div></div></div><p xml:lang="de" lang="de">
Dieser Abschnitt illustriert die Benutzung von
<span class="emphasis"><em>Scanned Image Extractor</em></span>
als kurze Übersicht:
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
Scannen Sie die Alben mit einer Auflösung von mindestens 300dpi (gerade für ältere Fotografien sollten 600dpi ausreichen).
Als Dokumenttyp wählen Sie Fotografie/Bilder.
Der Schritt alle Alben zu scannen wird am längsten dauern.
Um diesen Teil effizienter zu gestalten, beachten Sie bitte die folgenden Hinweise.
Weitere Hinweise gibt es in <a class="xref" href="#tips" title="4.4. Tipps und Tricks für Scanned Image Extractor">Abschnitt 4.4, „Tipps und Tricks für <span class="emphasis"><em>Scanned Image Extractor</em></span>“</a>.
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Anmerkung</h3><p>
Benutzen Sie nicht das Vorschau-System Ihres Scanners. Das benötigt extrem viel Zeit. Scannen Sie einfach den größtmöglichen Bereich.
</p></div><p>
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Anmerkung</h3><p>
Testen Sie den Prozess bevor Sie alle Alben scannen. D.h. probieren Sie alle hier aufgeführten Schritte für ein paar Albenseiten aus, bevor Sie alles einscannen.
</p></div><p>
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Anmerkung</h3><p>
Falls Ihre Fotografien qualitativ noch hochwertig sind und sie die Daten in einem 16-Bit Porgramm weiterverarbeiten möchten (Gimp 2.9+, Lightroom, ...), dann stellen Sie in Ihrer Scanner-Software 16Bit Farbtiefe ein.
</p></div><p>
</p></li><li class="listitem"><p>
Nach dem alles eingescannt wurde, benutzen Sie <span class="emphasis"><em>Scanned Image Extractor</em></span> um die Fotografien zu extrahieren (sehen Sie auch unter <a class="xref" href="#howto" title="4.3. Wie Sie Scanned Image Extractor benutzen">Abschnitt 4.3, „Wie Sie <span class="emphasis"><em>Scanned Image Extractor</em></span> benutzen“</a>).
</p></li><li class="listitem"><p>
Organisieren Sie Ihre Fotografien auf Dateeibene.
D.h. erstellen Sie Verzeichnisse, bennen Sie Ihre Dateien passend um, usw.
Auch hilft es, mögliche schriftliche Kommentare, in den Alben neben den Bildern, in den Dateinamen einzutragen.
Ein Programm wie mein freies <a class="ulink" href="http://dominik-ruess.de/pivot/" target="_top">pivot - photo, image and video organization tool</a> kann Ihnen dabei behilflich sein.
</p></li><li class="listitem"><p>
Organisieren Sie Ihre Fotografien auf der (Meta-)Datenebene. Verstichworten Sie Ihre Dateien, manipulieren Sie die Farben, usw.
Hier können Sie auf freie Programme wie
<a class="ulink" href="https://www.digikam.org/" target="_top">digiKam</a> oder kommerzielle Programme wie Lightroom zurückgreifen.
</p></li></ol></div><p xml:lang="de" lang="de">
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="howto"></a>4.3. Wie Sie <span class="emphasis"><em>Scanned Image Extractor</em></span> benutzen</h3></div></div></div><p xml:lang="de" lang="de">
Die Benutzeroberfläche von <span class="emphasis"><em>Scanned Image Extractor</em></span> ist nicht sehr kompliziert.
Sie besteht aus drei Hauptbereichen.
Einer davon stellt das Scan-Bild und die möglichen Fotografien dar (1),
ein weiterer Bereich stellt die Vorschau dar (2)
und zuletzt gibt es ein Bereich für schnelle Einstellungen (3), davon am wichtigsten das Seitenverhältnis (4) und die Ausrichtung (5).
Sehen Sie das beispielhaft auch in <a class="xref" href="#fig_overview" title="Abbildung 1. Scanned Image Extractor Screenshot">Abbildung 1, „<span class="emphasis"><em>Scanned Image Extractor</em></span> Screenshot“</a>.
</p><div class="figure"><a id="fig_overview"></a><p class="title"><strong>Abbildung 1. <span class="emphasis"><em>Scanned Image Extractor</em></span> Screenshot</strong></p><div class="figure-contents"><div class="mediaobject" align="center"><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="640"><tr><td align="center" valign="center"><img src="images/overview.png" align="middle" width="640" alt="Scanned Image Extractor Screenshot" /></td></tr></table></div></div></div><br class="figure-break" /><p xml:lang="de" lang="de">
Starten Sie damit, ein Bild zu laden (Datei-Menü).
Wenn Sie alle Bilder bearbeiten wollen, wählen Sie am besten das Erste Bild.
Nach einer kurzen Berechnung sehen Sie die Vorschläge der Fotografie-Detektion - in blauen, überlargerten Rechtecken.
Diese Rechtecke werden bei der Speicherung aus den Scandaten extrahiert und in das Zielverzeichnis gespeichert (siehe auch "einstellungen" im Menü).
Sobald Sie mit dem aktuellen Bild fertig sind, klicken Sie zum nächsten Bild.
Die Ausgangsbilder des vorherigen Bildes werden automatisch gespeichert - Sie müssen also nicht jedesmal auf "Speichern" klicken.
</p><p xml:lang="de" lang="de">
Drücken Sie die Tasten 1-9 und 0 um ein bestimmtes Seitenverhältnis zu erzwingen.
</p><p xml:lang="de" lang="de">
Drücken Sie die Tasten "a", "s", "d" oder "f" um schnell die Ausrichtung des akt. Ausgangsbildes zu ändern.
</p><p xml:lang="de" lang="de">
Wenn die aktuellen Detektionen falsch sind, können Sie sie manipulieren, löschen oder manuell hinzufügen
Wenn Sie bei einem ausgewählten Rechteck die Ecken oder Kanten ziehen, wird dieses entsprechend vergrößert.
Halten Sie die STRG-Taste dabei gedrückt, findet das Ganze symmetrisch statt.
Halten Sie die Umschalt-Taste gedrückt bevor Sie auf eine Ecke klicken - dann können Sie das Rechteck drehen.
Um ein neues Rechteck hinzuzufügen, wählen Sie alle Rechtecke ab (irgendwo ins Leere klicken) und klicken Sie auf eine Ecke der gewünschten Fotografie.
Danach halten Sie die Maus gedrückt und ziehen Sie den roten Balken entlang zu einer zweiten Ecke (über die Lange Seite ist es genauer).
Lassen Sie los, nun können Sie das neue Rechteck in der Größe verändern.
Nach einem letzten Klick ist das neue Rechteck fertig und Sie haben ein Kopierziel hinzugefügt.
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="tips"></a>4.4. Tipps und Tricks für <span class="emphasis"><em>Scanned Image Extractor</em></span></h3></div></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Anmerkung</h3><p xml:lang="de" lang="de">
Die meisten Alben haben ein Format, dass nicht komplett auf einen Scanner passt.
Scannen Sie eine Albenseite in zwei Schritten:
Richten Sie die obere linke Ecke an Ihrem Scanner aus und drehen Sie danach die Seite um die untere-rechte (dann neue obere linke) Ecke nochmals an Ihrem Scanner auszurichten und ebenfalls zu scannen.
In den meisten Fällen sichert diese Methode, dass Ihre Fotografien in mindestens einem der beiden Scans enthalten sind.
Sie können die Klappe auch auflassen, das spart Zeit.
</p><div class="figure"><a id="fig_page_Format"></a><p class="title"><strong>Abbildung 2. <span class="emphasis"><em>Scanned Image Extractor</em></span> Platzierung von Alben</strong></p><div class="figure-contents"><div class="mediaobject" align="center"><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="640"><tr><td align="center" valign="center"><img src="images/scannerpos.png" align="middle" width="640" alt="Scanned Image Extractor Platzierung von Alben" /></td></tr></table></div></div></div><br class="figure-break" /></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Anmerkung</h3><p xml:lang="de" lang="de">
ICH ÜBERNEHME KEINERLEI HAFTUNG FÜR BESCHÄDIGUNGEN IHRES SCANNERS.
Wenden Sie folgenden Hinweis also nur auf eigene Verantwortung an:
Wenn Sie mit Ihrer Hand auf den Albenrücken drücken, werden die Bilder etwas besser angepresst und sind weniger gewölbt.
(see also <a class="xref" href="#fig_page_Format" title="Abbildung 2. Scanned Image Extractor Platzierung von Alben">Abbildung 2, „<span class="emphasis"><em>Scanned Image Extractor</em></span> Platzierung von Alben“</a>)
</p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Anmerkung</h3><p xml:lang="de" lang="de">
Wenn Sie mehrere Einzelbilder (d.h. ohne Album) einscannen wollen, platzieren Sie sie nicht direkt an den Rand des Scanners.
Lassen Sie Platz, zum Rand und zu den anderen Bildern.
Dies reduziert das Risiko von Verschiebungen über den Rand des Scanners hinaus.
Außerdem erleichtern Sie der automatischen Erkennung von Fotografien die Arbeit.
</p><div class="figure"><a id="fig_multiphoto"></a><p class="title"><strong>Abbildung 3. <span class="emphasis"><em>Scanned Image Extractor</em></span> Mehrere Fotografien</strong></p><div class="figure-contents"><div class="mediaobject" align="center"><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="640"><tr><td align="center" valign="center"><img src="images/multiplace.png" align="middle" width="640" alt="Scanned Image Extractor Mehrere Fotografien" /></td></tr></table></div></div></div><br class="figure-break" /></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Anmerkung</h3><p xml:lang="de" lang="de">
Versuchen Sie immer das Seitenverhältnis zu erzwingen, mit so wenig wie nötigen Seitenverhältnisse.
Für den Betrachter der Ergebnisse ist das eine deutlich angenehmere Erfahrung.
</p></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp53641376"></a>5. Weitere Hilfe</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp53642256"></a>5.1. Hilfe für bestimmte Bedienelemente</h3></div></div></div><p xml:lang="de" lang="de">
Wenn bestimmte Bedienelemente der Anwendung nicht klar sind,
halten Sie ihren Mauszeiger über diesem Element.
In der Statusanzeige wird dann eine Hilfe angezeigt.
</p><p xml:lang="de" lang="de">
Auch können Sie in den Hilfe-Modus gehen, indem Sie auf das
Fragezeichen Symbol klicken und danach auf das unbekannte
Bedienelement.
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="donate"></a>5.2. Spenden an den Autor</h3></div></div></div><p xml:lang="de" lang="de">
Wenn Ihnen diese Anwendung gefällt, Sie danke schön sagen wollen oder Sie
einfach die weitere Entwicklung der Anwendung unterstützen möchten,
überlegen Sie sich zu spenden.
Sie können das direkt über "sourceforge donation page",
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/donate" target="_top">https://sourceforge.net/p/scannedimageextractor/donate</a>,
erledigen, oder schreiben Sie eine E-Mail an <span class="emphasis"><em>donate at dominik-ruess.de</em></span>.
Vielen Dank.
</p></div></div><div xml:lang="de" class="sect1" lang="de"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="gplde"></a>6. GNU General Public License</h2></div></div></div><p>Den offiziellen englischen Originaltext finden Sie unter
<a class="ulink" href="http://www.gnu.org/licenses/gpl.html" target="_top">http://www.gnu.org/licenses/gpl.html</a>.
Eine Kopie der Version 3 der Lizenz ist in den Quelldateien enthalten.
</p></div></div></body></html>

201
doc/scannerExtract_help_en.html Normal file
View File

@ -0,0 +1,201 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Scanned Image Extractor</title><link rel="stylesheet" type="text/css" href="scannerExtract.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /></head><body><p xmlns=""><a href="../">Back to main page</a>,
<a href="scannerExtract_help_de.html" style="margin-left:25px;">Deutsche Version</a></p><div class="article"><div class="titlepage"><div><div><h2 class="title"><a id="idp63190880"></a>Scanned Image Extractor</h2></div><div><p class="copyright">Copyright © 2015 Dominik Rueß</p></div><div><div class="legalnotice"><a id="idp63192656"></a><p class="legalnotice-title"><strong>Legal Notices</strong></p><p xml:lang="en" lang="en">
</p><p>
This article is part of <span class="emphasis"><em>Scanned Image Extractor</em></span>.
Scanned Image Extractor is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
</p><p xml:lang="en" lang="en">
</p><p>
Scanned Image Extractor is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
</p><p xml:lang="en" lang="en">
</p><p>
In <a class="xref" href="#gplen" title="6. GNU General Public License">Section 6, “GNU General Public License”</a> you can find a link to the license,
or go directly to:
<a class="ulink" href="http://www.gnu.org/licenses/" target="_top">http://www.gnu.org/licenses/</a>
</p><p xml:lang="en" lang="en">
</p></div></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="sect1"><a href="#preface">1. Preface 1: Open Source and Supported Platforms</a></span></dt><dt><span class="sect1"><a href="#backup">2. Preface 2: Do Backups !</a></span></dt><dt><span class="sect1"><a href="#idp64286432">3. What is <span class="emphasis"><em>Scanned Image Extractor</em></span> ?</a></span></dt><dd><dl><dt><span class="sect2"><a href="#features">3.1. Features of <span class="emphasis"><em>Scanned Image Extractor</em></span></a></span></dt><dt><span class="sect2"><a href="#download">3.2. Download <span class="emphasis"><em>Scanned Image Extractor</em></span></a></span></dt><dt><span class="sect2"><a href="#reports">3.3. Where to post language flaws, bugs and feature requests ?</a></span></dt><dt><span class="sect2"><a href="#errors">3.4. What if my scanned images are not recognized well?</a></span></dt></dl></dd><dt><span class="sect1"><a href="#usecases">4. How to:</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp64310096">4.1. Install <span class="emphasis"><em>Scanned Imaged Extractor</em></span></a></span></dt><dd><dl><dt><span class="sect3"><a href="#idp64313072">4.1.1. Microsoft Windows</a></span></dt><dt><span class="sect3"><a href="#idp64314672">4.1.2. GNU Linux</a></span></dt><dt><span class="sect3"><a href="#idp64321136">4.1.3. Building from Source</a></span></dt></dl></dd><dt><span class="sect2"><a href="#idp64325408">4.2. Overview of the whole album/photograph scanning process</a></span></dt><dt><span class="sect2"><a href="#howto">4.3. How to use <span class="emphasis"><em>Scanned Image Extractor</em></span></a></span></dt><dt><span class="sect2"><a href="#tips">4.4. Tips and Tricks for using <span class="emphasis"><em>Scanned Image Extractor</em></span></a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp64364112">5. More Help</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp64364992">5.1. Help on certain widgets</a></span></dt><dt><span class="sect2"><a href="#donate">5.2. Donate to the Author</a></span></dt></dl></dd><dt><span class="sect1"><a href="#gplen">6. GNU General Public License</a></span></dt></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="preface"></a>1. Preface 1: Open Source and Supported Platforms</h2></div></div></div><p xml:lang="en" lang="en">
This software app is open source.
This means I was not able to invest a lot of time and money into buying and testing different systems/platforms etc.
The advantage of open source being completely free and open (as compared to commercial software, freeware or shareware) is usually not always completely free -
the user may help the developers by sending them errors or improvement suggestions.
Lastly, a note: please respect the GPL: If you use (parts of) this software in your own project, publish the complete source code of your own project, as well.
</p><p xml:lang="en" lang="en">
I developed this software app for different platforms (e.g. Windows, Ubuntu, Fedora).
However, I can only develop for platforms which I own myself.
If you think an important platform is missing, send me a suggestion.
I would love to also deploy this software for <span class="emphasis"><em>Mac OS X</em></span>, too.
I just don't own a Mac.
If you're interested, consider donating to this project and I'll hopefully soon be able to buy a Mac (<a class="xref" href="#donate" title="5.2. Donate to the Author">Section 5.2, “Donate to the Author”</a>)
and adapt and permanently support this software for it.
</p></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="backup"></a>2. Preface 2: Do Backups !</h2></div></div></div><p xml:lang="en" lang="en">
Always backup your files, also before using Scanned Image Extractor!!!
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p xml:lang="en" lang="en">
The pure process of scanning pictures or albums is very time comsuming. Keep a copy of unedited original scans in a separate location.
</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp64286432"></a>3. What is <span class="emphasis"><em>Scanned Image Extractor</em></span> ?</h2></div></div></div><p xml:lang="en" lang="en">
</p><div><img src="images/SIE.png" /></div><p xml:lang="en" lang="en">
<span class="emphasis"><em>Scanned Image Extractor</em></span> is a tool for efficiently extracting rectangular photographs from album or (multiple) photograph scans. It is semi-automated, hence it tries to suggest recognized photographs but you have to verify, delete bad suggestions and possibly add missing photographs manually.
For a list of features, refer to <a class="xref" href="#features" title="3.1. Features of Scanned Image Extractor">Section 3.1, “Features of <span class="emphasis"><em>Scanned Image Extractor</em></span>”</a>.
</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="features"></a>3.1. Features of <span class="emphasis"><em>Scanned Image Extractor</em></span></h3></div></div></div><p xml:lang="en" lang="en">
<span class="emphasis"><em>Scanned Image Extractor</em></span> comes with an interesting list of features.
If you're not sure how to make use of these features, you may want to
refer to <a class="xref" href="#usecases" title="4. How to:">Section 4, “How to:”</a>.
With <span class="emphasis"><em>Scanned Image Extractor</em></span>, you can:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
efficiently extract one or more photographs per scanner image.
</p></li><li class="listitem"><p>
work on 16bit input images and have 16bit output images (useful e.g. for Gimp 2.9+ or Lightroom users).
</p></li><li class="listitem"><p>
have detections presented from automated photograph detection. If these detections are wrong, correct, delete or add them, manually.
</p></li><li class="listitem"><p>
constrain aspect ratios of output photographs
</p></li><li class="listitem"><p>
use keyboard shortcuts for an even more efficient work flow
</p></li></ul></div><p xml:lang="en" lang="en">
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="download"></a>3.2. Download <span class="emphasis"><em>Scanned Image Extractor</em></span></h3></div></div></div><p xml:lang="en" lang="en">
Go to sourceforge and download from there:
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/" target="_top">sourceforge.net/p/scannedimageextractor/</a> -&gt;
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/files/" target="_top">Files</a>. Make sure
you select the current version and an appropriate file for your operating system
(i.e. windows installer for 32/64 bit windows).
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reports"></a>3.3. Where to post language flaws, bugs and feature requests ?</h3></div></div></div><p xml:lang="en" lang="en">
Go to sourceforge and post your issue there:
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/" target="_top">sourceforge.net/p/scannedimageextractor/</a> -&gt;
<a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/tickets" target="_top">Tickets</a>
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="errors"></a>3.4. What if my scanned images are not recognized well?</h3></div></div></div><p xml:lang="en" lang="en">
Every Photo-Album looks different.
Whenever your type of album is difficult send me a couple of example scans (full resolution) to <span class="emphasis"><em>scannerextract at dominik-ruess.de</em></span>.
I will not use these for anything else than improving this software.
However, please also note there are some hints on how to properly scan the photographs in <a class="xref" href="#howto" title="4.3. How to use Scanned Image Extractor">Section 4.3, “How to use <span class="emphasis"><em>Scanned Image Extractor</em></span>”</a> and <a class="xref" href="#tips" title="4.4. Tips and Tricks for using Scanned Image Extractor">Section 4.4, “Tips and Tricks for using <span class="emphasis"><em>Scanned Image Extractor</em></span>”</a>.
</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="usecases"></a>4. How to:</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp64310096"></a>4.1. Install <span class="emphasis"><em>Scanned Imaged Extractor</em></span></h3></div></div></div><p xml:lang="en" lang="en">
Download the latest file for your operation system from <a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/files/" target="_top">Scanned Image Extractor Files</a>.
If your operation system is 64bit, I reccommend you choose the respective 64bit version of <span class="emphasis"><em>Scanned Imaged Extractor</em></span>.
</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp64313072"></a>4.1.1. Microsoft Windows</h4></div></div></div><p xml:lang="en" lang="en">
The binary installation package is self-explanatory.
Download and execute it (download file ending on win32.exe or win64.exe).
Tested with Windows 7 (64bit).
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp64314672"></a>4.1.2. GNU Linux</h4></div></div></div><p xml:lang="en" lang="en">
For Debian-like systems (tested with Ubuntu) download the respective .DEB files.
Install the pre-requisites:
<code class="code">
sudo apt-get install libqt5core5a libqt5network5
libqt5gui5 libqt5svg5 libqt5widgets5 liblbfgs0
libopencv-core2.4 libopencv-highgui2.4
libopencv-imgproc2.4
</code>.
Now install <span class="emphasis"><em>Scanned Imaged Extractor</em></span> with
<code class="code">sudo dpkg -i scannerExtract-x.y.z.deb</code>.
Start the program with <code class="code">scannedImagedExtractor</code>.
</p><p xml:lang="en" lang="en">
For RPM-based systems (tested with Fedora) install the following pre-requisites:
<code class="code">sudo dnf install opencv-core qt5-qtsvg
qt5-qtbase liblbfgs
opencv</code>.
Now install <span class="emphasis"><em>Scanned Imaged Extractor</em></span> with
<code class="code">rpm --install -p scannerExtract-x.y.z.rpm </code>
Start the program with <code class="code">scannedImagedExtractor</code>.
</p><p xml:lang="en" lang="en">
Tested with Ubuntu 14.04, 15.04 and Fedora 22-3 (for all with both 32, and 64bit).
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp64321136"></a>4.1.3. Building from Source</h4></div></div></div><p xml:lang="en" lang="en">
You will need cmake and the third-party modules OpenCV (version 2.4 or 3), liblbfgs and Qt5.
If you use version 2 of OpenCV, then you will need to add "-DOPENCV2=1" to the cmake command line.
If, for example you want to build in ubuntu, do:
<code class="code"> sudo apt-get install liblbfgs-dev libopencv-dev libqt5svg5-dev
qttools5-dev-tools qttools5-dev qtbase5-dev cmake </code>.
Now build <span class="emphasis"><em>Scanned Image Extractor:</em></span>
<code class="code"><div class="literallayout"><p><br />
                mkdir build<br />
                cd build<br />
                cmake path/to/scannerExtract-X.Y.Z/scannerExtract/ -DCMAKE_BUILD_TYPE=release -DOPENCV2=1<br />
                make<br />
                (make install)</p></div>
</code>
</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp64325408"></a>4.2. Overview of the whole album/photograph scanning process</h3></div></div></div><p xml:lang="en" lang="en">
This section roughly explains how to use <span class="emphasis"><em>Scanned Image Extractor</em></span> as part of a tool chain:
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
Scan an album page with at least 300dpi (however, especially for older photographs, 600dpi should be enough). As document type, choose picture/photograph.
The complete scanning process of all albums/album pages will cost you most of the time. So to improve the efficiency here, refer to the following notes.
Also make sure you have a look at <a class="xref" href="#tips" title="4.4. Tips and Tricks for using Scanned Image Extractor">Section 4.4, “Tips and Tricks for using <span class="emphasis"><em>Scanned Image Extractor</em></span>”</a>.
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
Do not use the preview system of the scanner, it will only cost a lot of time. Just scan the complete scanning area. Only use it to get used to how the result looks like
</p></div><p>
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
Do test your process before you start scanning all of your albums (i.e. follow this guide for some 2-3 album pages and test if everything's like you want it to be)
</p></div><p>
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
If you have good quality photographs and want to post-process the images with a 16-bit aware tool (Gimp 2.9+, Lightroom, ...), then use 16bit scanning.
</p></div><p>
</p></li><li class="listitem"><p>
Use <span class="emphasis"><em>Scanned Image Extractor</em></span> to extract the photographs of the scanned images (see <a class="xref" href="#howto" title="4.3. How to use Scanned Image Extractor">Section 4.3, “How to use <span class="emphasis"><em>Scanned Image Extractor</em></span>”</a>).
</p></li><li class="listitem"><p>
Organize your photographs on the file level. E.g. create folders and rename the files appropriately. Also copy comments to the filename, which people have next to their album images, quite often.
A tool like my <a class="ulink" href="http://dominik-ruess.de/pivot/" target="_top">pivot - photo, image and video organization tool</a> can help you here.
</p></li><li class="listitem"><p>
Organize your photographs on the (meta) data level. Add tags to your images, post-process them by adapting colors etc. Use a free open source tool like
<a class="ulink" href="https://www.digikam.org/" target="_top">digiKam</a> or a commercial tool like Lightroom for this.
</p></li></ol></div><p xml:lang="en" lang="en">
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="howto"></a>4.3. How to use <span class="emphasis"><em>Scanned Image Extractor</em></span></h3></div></div></div><p xml:lang="en" lang="en">
The user interface of <span class="emphasis"><em>Scanned Image Extractor</em></span> is not very sophisticated.
It consists of three main areas, one displaying the scanned image (1),
one for the preview of the current photograph (2)
and lastly, one area for the extraction settings (3), most importantly for the aspect ratio (4) and orientation (5) control.
Refer to <a class="xref" href="#fig_overview" title="Figure 1. Scanned Image Extractor Screenshot">Figure 1, “<span class="emphasis"><em>Scanned Image Extractor</em></span> Screenshot”</a> for a screenshot.
</p><div class="figure"><a id="fig_overview"></a><p class="title"><strong>Figure 1. <span class="emphasis"><em>Scanned Image Extractor</em></span> Screenshot</strong></p><div class="figure-contents"><div class="mediaobject" align="center"><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="640"><tr><td align="center" valign="center"><img src="images/overview.png" align="middle" width="640" alt="Scanned Image Extractor Screenshot" /></td></tr></table></div></div></div><br class="figure-break" /><p xml:lang="en" lang="en">
Start by loading a scanner image (File menu). If you want to process all, just choose the first scanned image in your directory.
Now, after some computation, the detected photographs are suggested as blue boxes in the input image.
These blue boxes will be extracted to a specified directory (see settings) as digital photograph.
When your done with the current scanned image, proceed to the next one by clicking on the respective button.
The output images of the last image will then be processed automatically, there's no need to press the "save" button every time.
</p><p xml:lang="en" lang="en">
Press the keys 1-9 and 0 to enforce a certain aspect ratio for the current target.
</p><p xml:lang="en" lang="en">
Press the keys "a", "s", "d" or "f" for fastly changing the orientation of the current target selection.
</p><p xml:lang="en" lang="en">
If you dislike the current detection(s) you can manipulate, delete or manually add them yourself.
Go to any edge or corner to change the size of the selected target.
If you press CTRL while dragging, this will be symmetric.
If you press SHIFT and then drag a corner of the selected rectangle, you can rotate it by dragging.
For adding a new selection, deselect all (click somewhere empty) and click at a corner of the photograph.
Keep the mouse pressed and drag the red line to another corner and release the mouse.
Now you have a new rectangle which you can resize by moving your mouse. Click to have a new target rectangle.
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="tips"></a>4.4. Tips and Tricks for using <span class="emphasis"><em>Scanned Image Extractor</em></span></h3></div></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p xml:lang="en" lang="en">
Most albums have a page format which doesn't completely fit on the scanner. Scan one page with two iterations: align the top-left page to your scanner and then turn the page upside-down and align the former bottom-right (now top-left) corner with your scanner. This will ensure - in most cases - that every photograph is contained completely in at least one of the two scans.
</p><div class="figure"><a id="fig_page_Format"></a><p class="title"><strong>Figure 2. <span class="emphasis"><em>Scanned Image Extractor</em></span> Album Placement</strong></p><div class="figure-contents"><div class="mediaobject" align="center"><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="640"><tr><td align="center" valign="center"><img src="images/scannerpos.png" align="middle" width="640" alt="Scanned Image Extractor Album Placement" /></td></tr></table></div></div></div><br class="figure-break" /></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p xml:lang="en" lang="en">
I DO NOT TAKE ANY RESPONSIBILITY if you damage your scanner, so do this on yor own responsibility: The results look a lot better, if you use one hand to press the album onto the scanner. It reduces bulges in your scans.
(Das ist in <a class="xref" href="#fig_page_Format" title="Figure 2. Scanned Image Extractor Album Placement">Figure 2, “<span class="emphasis"><em>Scanned Image Extractor</em></span> Album Placement”</a> angedeutet)
</p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p xml:lang="en" lang="en">
If you want to scan multiple single photographs (WITHOUT album), do not place them right at the scanner edge. Leave some space to the scanner boundaries and to the other photographs. This will make the automated recognition process easier and reduce the risk of the photograph overlapping the boundary when closing the lid.
There more space in between photographs and to the boundary, the better.
</p><div class="figure"><a id="fig_multiphoto"></a><p class="title"><strong>Figure 3. <span class="emphasis"><em>Scanned Image Extractor</em></span> Multiple Photographs</strong></p><div class="figure-contents"><div class="mediaobject" align="center"><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="640"><tr><td align="center" valign="center"><img src="images/multiplace.png" align="middle" width="640" alt="Scanned Image Extractor Multiple Photographs" /></td></tr></table></div></div></div><br class="figure-break" /></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p xml:lang="en" lang="en">
Always try to constrain the aspect ratio with as few different aspect ratios as possible.
Otherwise skipping through the resulting image is not a nice experience.
</p></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp64364112"></a>5. More Help</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp64364992"></a>5.1. Help on certain widgets</h3></div></div></div><p xml:lang="en" lang="en">
If certain widgets of the application are
not quite clear, hover the mouse over it.
Information about it will be displayed in a
hint and/or in the status bar of the application.
</p><p xml:lang="en" lang="en">
Additionally, sometimes it might be helpful to enter
the help mode. This is the button with the question mark.
Click it, then click the element which you want to
have help for.
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="donate"></a>5.2. Donate to the Author</h3></div></div></div><p xml:lang="en" lang="en">
If you like the software, if you wish to say thank you
or if wish to support further development of the
software, consider making a donation to the author
(<span class="emphasis"><em>no</em></span> tax deduction).
This can be done directly via the projects's sourceforge
donation page, <a class="ulink" href="https://sourceforge.net/p/scannedimageextractor/donate" target="_top">https://sourceforge.net/p/scannedimageextractor/donate</a>,
or by writing an email to <span class="emphasis"><em>donate at dominik-ruess.de</em></span>.
Thank you.
</p></div></div><div xml:lang="en" class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="gplen"></a>6. GNU General Public License</h2></div></div></div><p>You can find version 3 of the GNU GPL here:
<a class="ulink" href="http://www.gnu.org/licenses/gpl.html" target="_top">http://www.gnu.org/licenses/gpl.html</a>.
A copy of the license is also contained in the program source code.
</p></div></div></body></html>