Perspec

Perspektiv

App und Workflow zur perspektivischen Korrektur von Bildern. Zum Beispiel Whiteboards, Dokumentenscans oder Fassaden.

• App-Workflow
• Installation
  • Vorgefertigt
  • Von der Quelle
• Nutzung über CLI
• Foto-Digitalisierungs-Workflow
  • Zusätzliche Schritte
• Merkmale
• Algorithmen
  • Perspektivische Transformation
  • Graustufenkonvertierung
  • BW-Konvertierung
  • Interpolation fehlender Teile
• Technologien
• Verwandt

App-Workflow

Schritt	Beschreibung	Ergebnis
1	Fotografieren
2	Öffnen Sie die Perspec-App
3	Lassen Sie die Bilder auf dem Fenster fallen
4	Markieren Sie die Ecken, indem Sie darauf klicken
5	Klicken Sie auf eine der Speichern-Schaltflächen (oder [Enter]).

Installation

WARNUNG: Perspec funktioniert derzeit nur auf macOS und Linux. Jede Hilfe, damit es unter Microsoft (Ticket) funktioniert, wäre sehr dankbar!

Vorgefertigt

Sie können diese (und frühere) Versionen auf der Release-Seite herunterladen.

Die aktuelle Nightly-Version kann unter https://github.com/feramhq/Perspec/actions heruntergeladen werden. Allerdings ist es notwendig, die Dateiberechtigungen nach dem Download zu korrigieren:

chmod +x 
  ./Perspec.app/Contents/MacOS/Perspec 
  ./Perspec.app/Contents/Resources/{perspec,script,imagemagick/bin/convert}

Unter macOS können Sie es auch über diesen Homebrew-Tipp installieren:

brew install --cask ad-si/tap/perspec

Von der Quelle

Erstellen Sie es aus dem Quellcode mit Haskells Stack.

Zum Erstellen aus dem Quellcode ist Platypus mit aktivierten Befehlszeilentools erforderlich.

git clone https://github.com/feramhq/Perspec
cd Perspec
make install

Dadurch wird die Perspec.app in Ihr /Applications -Verzeichnis kopiert und der perspec Befehl in Ihrem Pfad verfügbar gemacht. Anschließend können Sie Bilder entweder im App-Fenster ablegen oder sie über die CLI wie perspec fix image.jpeg verwenden

Nutzung über CLI

Es ist auch möglich, Perspec wie folgt direkt über die CLI aufzurufen:

/Applications/Perspec.app/Contents/Resources/perspec fix path/to/image.jpeg

Sie können auch mehrere Bilder übergeben und diese werden alle nacheinander geöffnet. Dies ist sehr nützlich für die Stapelkorrektur einer großen Anzahl von Bildern.

Foto-Digitalisierungs-Workflow

1. Fotografieren
   1. Verwenden Sie eine Kamera-App, mit der Sie die Drehung sperren können (z. B. OpenCamera). Ansonsten schauen Sie sich die Anleitung unten an, um die Drehung zu korrigieren.
   2. Verwenden Sie eine geräuschaktivierte Kamera, um Fotos aufzunehmen, indem Sie einfach mit der Zunge schnalzen oder mit dem Finger schnippen. ZB mit:
   • Pluto-Trigger – Hardware-Gerät
   • Magic Lantern – Drittanbieter-Firmware für Canon
   • iSoundCam – Android-App
2. Verwenden Sie den Unterbefehl perspec rename um die Reihenfolge und Namen der gescannten Dateien festzulegen.
3. Überprüfen Sie das
   • Alle Seiten wurden erfasst und haben den korrekten Dateinamen
   • Bilder sind scharf genug
   • Bilder haben einen hohen Kontrast
   • Bilder haben die richtige Ausrichtung
4. Um die beste Bildqualität zu erzielen, konvertieren Sie Bilder optional in ein verlustfreies Format (z. B. png ), wenden Sie Drehungen an und konvertieren Sie sie in Graustufen. Achtung: Abdeckungen ausschließen!

   mogrify -verbose -format png 
     -auto-orient -colorspace gray photos/ * .jpeg

5. Verwenden Sie Perspec, um Bilder zuzuschneiden

   perspec fix photos/ * .png

Zusätzliche Schritte

Verbessern Sie die Farben mit einem der folgenden Schritte:

1. Dynamikbereich normalisieren:

mogrify -verbose -normalize photos/ * .png

1. In Schwarzweiß konvertieren:

    #! /usr/bin/env bash
   
   find . -iname " *.png " | 
   while read -r file
   do
     convert 
       -verbose 
       " $file " 
       ( +clone -blur 0x60 -brightness-contrast 40 ) 
       -compose minus 
       -composite 
       -negate 
       -auto-threshold otsu 
       " $( basename " $file " " .png " ) " -fixed.png
   done

Um alle Fotos in den Hochformatmodus zu drehen, können Sie beides verwenden

mogrify -verbose -auto-orient -rotate " 90> " photos/ * .jpeg

oder

mogrify -verbose -auto-orient -rotate " -90> " photos/ * .jpeg

Merkmale

• Bild bei Änderung des Ansichtsfensters neu skalieren
• Behandeln Sie die JPEG-Rotation
• Zeichnen Sie Linien zwischen den Ecken, um das Erraten abgeschnittener Ecken zu erleichtern
• Bundle Imagemagick
• Besserer Fehler, wenn falsches Dateiformat gelöscht wird (images/error-message.jpg)
• Zentrieren Sie das Perspec-Fenster auf dem Bildschirm
• Drag'n'Drop für Eckmarkierungen
• Schaltfläche „Senden“.
• Schaltfläche „In Graustufen konvertieren“.
• Unterstützung für benutzerdefinierte Ausgabegröße hinzufügen (z. B. A4)
• Manuelle Rotationstasten
• Zoomansicht für Ecken
• Eckmarkierungen beschriften

Algorithmen

Perspektivische Transformation

Sobald die Ecken markiert sind, entspricht die Korrektur:

convert 
  images/example.jpg 
  -distort Perspective 
    ' 8,35 0,0 27,73 0,66 90,72 63,66 67,10 63,0 ' 
  -crop 63x66+0+0 
  images/example-fixed.jpg

Graustufenkonvertierung

Konvertiert das Bild in Graustufen und normalisiert anschließend den Wertebereich. (Verwendet Imagemagicks -colorspace gray -normalize )

BW-Konvertierung

Konvertiert das Bild mit der OTSU-Methode in das Binärformat. (Verwendet Imagemagicks -auto-threshold OTSU -monochrome )

Interpolation fehlender Teile

Perspec interpoliert fehlende Teile automatisch unter Verwendung des nächstgelegenen Pixels. (https://www.imagemagick.org/Usage/misc/#edge)

Technologien

• Der Kern ist in Haskell geschrieben
• Die Perspektivtransformation wird von ImageMagick übernommen
• Das App-Bundle wird mit Platypus erstellt

Verwandt

Eine ausführliche Liste verwandter Projekte finden Sie unter ad-si/awesome-scanning.