[[Vorlage(Getestet, focal)]]
{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
}}}
[[Inhaltsverzeichnis(1)]]

[[Bild(Wiki/Icons/terminal.png, 48, align=left)]]
[http://fukuchi.org/works/qrencode qrencode] {en} ist ein von Kentaro Fukuchi entwickeltes Kommandozeilenprogramm, das Zeichenketten in einen [:QR-Code:] umwandelt und als Bild im PNG-Format speichert. Wer eine grafische Oberfläche sucht, findet diese in [:QtQR:]. Dieser Artikel beschränkt sich auf die Nutzung im Terminal.

= Installation =
Folgendes Paket muss installiert werden [1]:

{{{#!vorlage Paketinstallation
qrencode, universe
}}}

=Bedienung=
Anschließend wird qrencode über ein Terminal [2] gestartet und gesteuert. Der Grundbefehl lautet immer

{{{#!vorlage Befehl
qrencode [OPTIONEN] ZEICHENKETTE
}}}

Optionen können kombiniert genutzt werden. Die [:man:Manpage] gibt detailliert Auskunft.

{{{#!vorlage Tabelle
<-2 tablestyle="width: 97%;" rowclass="titel">Optionen von qrencode
+++
<rowclass="kopf" > Parameter 
 Beschreibung 
+++
`-h` oder `--help`
Hilfe anzeigen – hier werden alle möglichen Parameter erläutert. `--help` erzeugt dabei eine ausführlichere Ausgabe.
+++
<rowclass="highlight">`-o FILENAME` oder `--output=FILENAME`
Das Ergebnisbild in FILENAME schreiben. Wird hier "`-`" verwendet, wird das Ergebnis auf der Standardausgabe ausgegeben.
+++
`-s NUMBER` oder `--size=NUMBER`
Die Pixelgröße bestimmen (Standard = 3)
+++
<rowclass="highlight">`-l {LMQH}` oder `--level={LMQH}`
Die Fehlerkorrektur-Stufe spezifizieren (`L` = niedrig bis `H` = hoch; Standard = `L`)
+++
`-v NUMBER` oder `--symversion=NUMBER`
Die Version des Symbols spezifizieren (Standard = `Auto`)
+++
<rowclass="highlight">`-m NUMBER` oder `--margin=NUMBER`
Die Randbreite spezifizieren (Standard = `4`)
+++
`-d NUMBER` oder `--dpi=NUMBER`
Die Punktdichte (dpi) des generierten PNG-Bildes spezifizieren  (Standard = `72`).
+++
<rowclass="highlight">`-t TYP` oder `--type=TYP`
Den Typ des generierten Bildes festlegen. Mögliche Werte für `TYP`: `PNG`, `PNG32`, `EPS`, `SVG`, `XPM`, `ANSI`, `ANSI256`, `ASCII`, `ASCIIi`, `UTF8`, `ANSIUTF8` (Standard = `PNG`).
+++
`-S` oder `--structured`
Strukturierte Symbole erstellen. Version muss angegeben werden.
+++
<rowclass="highlight">`-k` oder `--kanji`
Nur nötig, falls der umzuwandelnde Text [wikipedia:Kanji:] enthält
+++
`-c` oder `--casesensitive`
Kleinbuchstaben in 8-bit-Modus kodieren
+++
<rowclass="highlight">`-i` oder `--ignorecase`
Groß-/Kleinschreibung ignorieren und nur Großbuchstaben verwenden
+++
`-8` oder `--8bit`
Ausgabe in den 8-bit-Modus kodieren (die Optionen `-k`, `-c` und `-i` werden ignoriert)
+++
<rowclass="highlight">`-V` oder `--version`
Versionsnummer und Copyright des Programms anzeigen
+++
`--verbose`
Ausführliche Ausgabe auf '''stderr'''
+++
<rowclass="highlight">`ZEICHENKETTE`
Wird mittels der Eingabedaten nichts angegeben, wird die Standardeingabe benutzt
}}}

== Beispiele ==

 * QR-Code mit dem Dateinamen '''ubuntuusers.png''', der auf die URL `http://www.ubuntuusers.de` verweist: {{{#!vorlage Befehl
qrencode -o ubuntuusers.png http://www.ubuntuusers.de
}}}

 * QR-Code in Version 1 (kleinster „Error Correction Level“), mit dem Dateinamen '''output.png''' und dem Text "Hallo Welt!": {{{#!vorlage Befehl
qrencode -l L -v 1 -o output.png 'Hallo Welt!'
}}}

 * QR-Code in ASCII-Zeichen im Terminal, der auf die URL `http://www.ubuntuusers.de` verweist: {{{#!vorlage Befehl
qrencode -o - -t ASCII http://www.ubuntuusers.de
}}} Für Terminals mit heller Schrift auf dunklem Hintergrund empfiehlt sich als Typ `ASCIIi` zu nutzen, um dunkle "Pixel" auf hellem Grund zu erzeugen.

[[Bild(./qr_mecard.png, 100, align=right)]]
 * Eine Visitenkarte als QR-Code: {{{#!vorlage Befehl
qrencode -o qr_mecard.png 'MECARD:N:Max Mustermann;TEL:+49-123-45678;EMAIL:muster@mann.de;URL:http://home.page.com;ADR:Adresse;BDAY:19701228;NICK:musti;NOTE:keine Notizen;;'
}}} Diese wird nach dem [wikipedia_en:MeCard_(QR_code):MECARD Standard] kodiert, welcher von QR-Code-Lesern unterstützt wird. Auf einem iPhone sieht es dann beispielsweise aus wie in nebenstehendem Abbildung.

= Links =
 * [http://fukuchi.org/works/qrencode/ Projektseite] {en}
 * [http://blog.dsiw-it.de/2011/09/06/kontaktinformationen-als-qr-code/ Kontaktinformationen als QR-Code (MECARD)] {de} - Blogbeitrag 09/2011
 * [topic:gui-script-fuer-qrencode:QR-enCode_GUI.sh] - [:Zenity:]-Script für qrencode (nicht für KDE), Forumsdiskussion
 * [:QR-Code:] {Übersicht} Übersichtsartkel

#tag: Multimedia, Barcode, Kommunikation, Grafik