QR-Code auf die Schnelle (Hotline)
--------------------------------------------------------
c't 14/2015, Seite 153, ciw@ct.de

genQrCode.pl		das Perl-Script


Einfhrung
==========
Um das Script genQrCode.pl verwenden zu knnen bentigen Sie eine
funktionierende Perl-Installation und einige Perl-Module (Digest::MD5,
File::Path, File::Spec::Functions, Getopt::Long::Descriptive, Imager::QRCode,
POSIX, Regexp::Common, Switch und Try::Tiny).


Installation
============
Unter Linux sollte Perl selbst bereits durch Ihre Distribution installiert
sein. Fr Debian und abgeleitete Distributionen wie Ubuntu knnen Sie die nicht
in der Basisinstallation enthaltenen Pakete mittels:
  apt-get install libgetopt-long-descriptive-perl libimager-qrcode-perl \
   libregexp-common-perl libswitch-perl libtry-tiny-perl
von einer Shell aus nachinstallieren.

Unter Mac OS X ist Perl selbst bereits installiert. Die fehlenden Pakete knnen
Sie mittels des Befehls cpan installieren. Damit dieser Befehl funktioniert
muss XCode (<https://developer.apple.com/xcode/downloads/>) oder die Command
Line Tools for XCode (<https://developer.apple.com/downloads/>) installiert
sein. Dafr bentigen Sie einen kostenlosen Apple Developer Account.
Anschlieend knnen Sie z.B. Getopt::Long::Descriptive in einem
Terminal-Fenster mittels
  cpan Getopt::Long::Descriptive
installieren.

Unter Windows mssen Sie Perl selbst installieren (<http://strawberryperl.com/>).
Der Windows-Port enthlt je nach installierter Version schon diverse Pakete,
welche das sind, knnen Sie in den Release Notes fr Ihre Version nachsehen
(<http://strawberryperl.com/releases.html>). Fehlende Pakete mssen Sie mittels
cpan nachinstallieren. Da Strawberry-Perl bereits einen passenden Compiler
mitbringt, knnen Sie cpan direkt in einem Eingabeaufforderungsfenster aufrufen.
Fr die aktuelle Perl-Version 5.22.0.1 gengt
  cpan Getopt::Long::Descriptive Imager::QRCode Regexp::Common Switch
um die fehlenden Perl-Module nachzursten.


Um zu berprfen, ob alle Abhngigkeiten erfllt sind, knnen Sie das Script
mittels
  perl -cw /Pfad/zu/genQrCode.pl
aufrufen. Wenn alles in Ordung ist, erscheint die Meldung
  /Pfad/zu/genQrCode.pl syntax OK


Unter Mac OS X und Linux knnen Sie das Script ausfhrbar machen und dann direkt
von Ihrem Terminal/Ihrer Shell aus aufrufen und sich etwa die Hilfe mit allen
Optionen anzeigen lassen:
  /Pfad/zu/genQrCode.pl -h
Wenn Sie das Script im ausfhrbar im Suchpfad fr Programme (z.B.
/usr/local/bin) ablegen, knnen Sie es auch ohne vollstndige Pfadangabe
ausfhren.

Unter Windows sollten Sie mittels:
  perl C:\Pfad\zu\genQrCode.pl -h
die gleiche Ausgabe erhalten.


Benutzung
=========
Im Folgenden wird der Aufruf fr unixoide Systeme verwandt, bei denen das Script
im Suchpfad liegt. Windows-Nutzer ergnzen den Aufruf bitte um ein
vorangestelltes
  perl C:\Pfad\zum\script\

Wenn Sie die Standardeinstellungen (s. genQrCode.pl -h) beibehalten und nur
einen QR-Code fr eine URL erzeugen wollen, gengt
  genQrCode.pl <URL>
um im aktuellen Arbeitsverzeichnis einen Unterordner qrcodes entstehen zu
lassen, der das PNG mit dem Code enthlt. Fr die URL <http://heise.de/> she
der Aufruf also wie folgt aus:
  genQrCode.pl http://heise.de/
Als Ausgabe sollte
  Successfully written URL <http://heise.de/> QR-encoded to /tmp/qrcodes/qrcode_46cd0c5bebb42b63037a935c394acf01.png (level=1, dot-size=85)
erscheinen, wenn Ihr aktuelles Arbeitsverzeichnis /tmp war.

Um mehrere URLs auf einmal in QR-Codes zu verwandeln, schreiben Sie diese in
eine Textdatei (eine URL pro Zeile) und rufen das Script mit dem Parameter -f
auf:
  genQrCode.pl -f /Pfad/zur/url-liste.txt

Die weiteren Optionen entnehmen Sie bitte der Hilfe, die Sie sich mit dem
Parameter -h anzeigen lassen knnen.
