[[Vorlage(Getestet, general)]] {{{#!vorlage Wissen [:Pakete installieren: Installation von Programmen] [:Programme_starten: Starten von Programmen] [:Terminal: Ein Terminal öffnen] [:sudo: Root-Rechte] }}} [[Inhaltsverzeichnis(1)]] [[Bild(./potrace-logo.png, 48, align=left)]] [sourceforge2:potrace:Potrace] {en} ist ein freies, von Peter Selinger aktiv entwickeltes, unter GNU General Public License ([wikipedia:Gpl:GPL]) herausgegebenes Kommandozeilenpogramm zur Umwandlung von als [wikipedia:Rastergrafik:] (Bitmap) vorliegenden Bilddateien in skalierbare [wikipedia:Vektorgrafik:Vektorgrafiken]. Potrace kann folgende Formate importieren und verarbeiten: * [wikipedia:Windows_Bitmap:BMP] * [wikipedia:Portable_Bitmap:PBM] * [wikipedia:Portable_Graymap:PGM] * [wikipedia:Portable_Pixmap:PPM] Mögliche Ausgabeformate: * [wikipedia:Encapsulated_PostScript:EPS] (Standardeinstellung) * [wikipedia:Postscript:] * [wikipedia:Pdf:PDF] * [wikipedia:Svg:SVG] * [wikipedia:DXF:] * [wikipedia:Xfig:XFIG] * [wikipedia:Portable_Graymap:PGM] * GIMPPATH = Installation = Das Programm ist in den offiziellen Paketquellen vorhanden. Folgendes Paket muss installiert [1] werden: {{{#!vorlage Paketinstallation potrace, universe }}} = Benutzung = == Programmaufruf == Das Programm wird im Terminal [3] verwendet. Der allgemeine Befehlsaufruf lautet {{{#!vorlage Befehl potrace [OPTION(EN)] EINGABEDATEI(EN) }}} Es können auch mehrere Dateien per Platzhalter in einem Ordner bearbeitet werden. Die Bearbeitung aller BMP-Bilder im Arbeitsverzeichnis erfolgt z.B. durch folgenden Befehl: {{{#!vorlage Befehl potrace [OPTION(EN)...] *.bmp }}} Sollen dagegen alle BMP-Bilder im Arbeitsverzeichnis, deren Namen mit "Bild" beginnen, zur Konvertierung herangezogen werden, kann dies auf folgende Weise erreicht werden: {{{#!vorlage Befehl potrace [OPTION(EN)...] Bild*.bmp }}} Eine rekursive Verarbeitung ist im Programm nicht vorgesehen, das heißt die zu bearbeitenden Dateien müssen im Arbeitsverzeichnis liegen oder die Pfade manuell angegeben werden. Ohne explizite Angabe einer Ausgabedatei schreibt potrace das Ergebnis der Umwandlung unter Beibehaltung des Dateinamens mit neuer Dateiendung in das Arbeitsverzeichnis. Soll bei einer einzelnen Eingabedatei der Pfad zur Ausgabedatei oder deren Name individuell festgelegt werden, so kann dies mittels der Option `-o` bzw. `--output DATEINAME` vorgenommen werden. Mithilfe dieser Option können bei bestimmten Ausgabedateitypen wie z.B. '''.pdf''' auch mehrere Bilder in eine einzelne Ergebnisdatei vereint werden. Beispiel: {{{#!vorlage Befehl potrace -b pdf Bild1.bmp Bild2.bmp Bild3.bmp -o Ausgabedatei.pdf }}} {{{#!vorlage Hinweis Zu beachten ist generell, dass, falls im Zielverzechnis unter dem Namen der angegebenen oder zu erwartenden Ausgabedatei bereits eine Datei existiert, diese ohne Nachfrage überschrieben wird. }}} = Optionen = == Ausgabeformat-Optionen == Ohne Angabe eines Ausgabeformats werden Eingabedateien in der Standardeinstellung als EPS-Datei (Encapsulated PostScript) ausgegeben. Dies entspricht der Option `-e` bzw. `--eps`. Soll ein davon abweichendes Ausgabeformat festgelegt werden, so wird dies mittels der Syntax `-b DATEITYP` bzw. `--backend DATEITYP` oder der für bestimme Dateitypen alternativ vorgesehenen Ausgabeformat-Optionen erreicht: {{{#!vorlage Tabelle Übersicht über die Ausgabeformat-Optionen +++ Kurzform Langform Erklärung +++ `-b pdf` `--backend pdf` Ausgabe im PDF-Format. +++ `-b pdfpage` `--backend pdfpage` Einheitliche Seitengröße bei Ausgabe als mehrseitiges PDF-Dokument. Standardformat ist hierbei `letter`; davon abweichende Formatgrößen müssen über Option `-P FORMAT` bzw. `--pagesize FORMAT` festgelegt werden. +++ `-b dxf` `--backend dxf` Ausgabe im DXF-Format. +++ `-b gimppath` `--backend gimppath` Ausgabe im Gimppath-Format (siehe [:GIMP:]). +++ `-b xfig` `--backend xfig` Ausgabe im XFig-Format. +++ `-p`[[BR]]oder[[BR]]`-b ps` `--postscript`[[BR]]oder[[BR]]`--backend ps` Ausgabe im PostScript-Format. +++ `-e`[[BR]]oder[[BR]]`-b eps` `--eps`[[BR]]oder[[BR]]`--backend eps` Ausgabe EPS-Format (Encapsulated PostScript) (Standardeinstellung). +++ `-s`[[BR]]oder[[BR]]`-b svg` `--svg`[[BR]]oder[[BR]]`--backend svg` Ausgabe im SVG-Format. +++ `-g`[[BR]]oder[[BR]]`-b pgm` `--pgm`[[BR]]oder[[BR]]`--backend pgm` Ausgabe im PGM-Format. }}} == Bearbeitungsoptionen == {{{#!vorlage Tabelle Übersicht über die Bearbeitungsoptionen +++ Kurzform Langform Erklärung +++ `-P FORMAT` `--pagesize FORMAT` Legt das Seitenformat fest. Mögliche Werte für `FORMAT`: `a4`, `a3`, `a5`, `b5`, `letter`, `legal`, `tabloid`, `statement`, `executive`, `folio`, `quarto`, `10x14` oder benutzerdefiniert mittels `DIMENSIONxDIMENSION` (Beispiel: `20x30cm`). Das amerikanische Format `letter` ist hierbei die Standardeinstellung. +++ `-W DIMENSION` `--width DIMENSION` Legt die Breite des Ausgabebildes fest. +++ `-H DIMENSION` `--height DIMENSION` Legt die Höhe des Ausgabebildes fest. Hinweis: Sofern bei manueller Angabe von Breite und/oder Höhe deren Relation nicht mehr mit der Relation des Ausgangsmaterials übereinstimmt, führt dies zu einer Verzerrung des Bildes. +++ `-A WINKEL` `--rotate WINKEL` Rotiert das Bild im angegebenen WINKEL gegen den Uhrzeigersinn. +++ `-M DIMENSION` `--margin DIMENSION` Legt einen Rand in der Breite der angegebenen DIMENSION fest. Hinweis: soll nur links, rechts, oben oder unten ein Rand festgelegt werden, so sind die Optionen `-L`/`--leftmargin`, `-R`/`--rightmargin`, `-T`/`--topmargin` oder `-B`/`--bottommargin` unter Angabe der gewünschten `DIMENSION` zu verwenden. +++ `--tight` Beschneidet das Bild nahtlos, indem weiße Bereiche um den Bildinhalt entfernt werden. +++ `-i` `--invert` Invertiert die Farben der angegebenen BMP-Datei. +++ `-k` `--blacklevel n` Festlegen der Toleranzgrenze beim Umwandeln von Farbinformationen der Eingangsdatei in schwarze oder weiße Werte. Die Standardeinstellung für `n` ist `0.5`). +++ `--opaque` Verarbeitet weiße Innenbereiche undurchsichtig (weiß) statt transparent. }}} {{{#!vorlage Hinweis Der Wert für `DIMENSION` kann in verschiedenen Einheiten angegeben werden, z.B. `6.5in`, `15cm`, `100pt`. Standardeinstellung ist `in` ([wikipedia:Inch:] = engl. Zoll) bzw. Pixel (nur für PGM-, DXF- oder GIMPPATH-Ausgabedateien). }}} == Weitere Programmoptionen == {{{#!vorlage Tabelle Übersicht über die weiteren Programmoptionen +++ Kurzform Langform Erklärung +++ `--progress` Zeigt einen Fortschrittsbalken zum optischen Verfolgen des Verlaufs der Operationen an. +++ `--` Markiert das Ende der Optionseingabe und signalisiert dem Programm, dass nur noch Dateinamen folgen. +++ `-h` `--help` Hilfe anzeigen und Programm beenden. +++ `-v` `--version` Versionsinformationene anzeigen und Programm beenden. +++ `-l` `--license` Lizenzinformationen anzeigen und Programm beenden. }}} = Grafische Oberflächen = Das Kommandozeilenprogramm potrace ist in verschiedene Programme mit grafischer Benutzeroberfläche integriert und wird von ihnen zur Umwandlung von Pixelgrafik in Vektorgrafik verwendet. Beispiele hierfür sind: * [:Inkscape:] * [:LilyPond:] * [wikipedia:Mftrace:] * [sourceforge2:potracegui:] {en} und viele andere. = Weitere Tipps = Mit potrace zusammen wird das Programm [:mkbitmap:] ausgeliefert. Mithilfe dieses Programms können Graustufen- oder Farb-Eingangsdateien zur Erzielung besserer Ergebnisse bei der Umwandlung in Vektorgrafiken vorbereitet und optimiert werden. = Hilfe/Handbuch = Für über diese Einführung hinausgehende Optionen und Bedienhinweise lohnt ein Blick in die [:man:Manpage]. = Links = * [sourceforge2:potrace:Projektseite] {en} * [wikipedia:Potrace:] * [:Grafik:] {Übersicht} Programmübersicht #tag: Grafik