Befehlszeilen-Renderer

Mit dem Befehlszeilen-Renderer kannst du eine beliebige Anzahl von gespeicherten Filtervorgaben im Stapelverfahren rendern. Er ist als separate ausführbare Datei verfügbar. Unter Microsoft Windows lautet der Dateiname FFXCmdRenderer-x64.exe.Unter Mac OS X lautet der Dateiname FFCmdRenderer. Der einzige Parameter, den der Befehlszeilen-Renderer akzeptiert, ist der Pfad zu einer .xml-Datei, die Rendering-Aufträge beschreibt.

Eine andere Möglichkeit, mehrere Bilder gleichzeitig zu verarbeiten, besteht darin, eine Bildsequenz in ein Artboard zu laden. Einzelheiten dazu findest du unter: Artboard Eigenschaften.

Fehlerbehandlung und Protokollierung

Alle Fehler, die beim Rendern aufgetreten sind, werden in die Protokolldatei geschrieben und in der Konsole angezeigt. Die Protokolldatei trägt den Namen FFX CmdRenderer.log und befindet sich im temporären Ordner des Systems (unter Windows 7 und neueren Versionen ist dies normalerweise C:\Users\User Name\AppData\Local\Temp).Terminal window. Die Protokolldatei trägt den Namen FFX CmdRenderer.log und befindet sich im temporären Ordner des Systems (under Mac OS ist dies normalerweise /tmp/).

Wenn der Renderer auf einen unkritischen Fehler stößt, z. B. Tippfehler im Filternamen oder unmögliche Bittiefenwerte, überspringt er die ungültige Aufgabe und geht zur nächsten Aufgabe in der Warteschlange über. Kritische Fehler, wie z. B. ein ungültiges xml-Schema, führen dazu, dass der Renderer alle Operationen abbricht.

Xml Datei Beispiele

<?xml version="1.0" encoding="utf-8" ?>
<Tasks>
    <Task>
        <Image value="" width="300" height="400" />
        <Selection value="" />
        <Result path="D:\Images\Wood.bmp" />
        <Filter value="C:\Documents and Settings\UserName\
Application Data\Filter Forge 8\System\Library\Library_284-1.ffxml" />
        <Preset value="0" />
    </Task>
    <Task>
        <Image value="" width="300" height="400" />
        <Selection value="" />
        <Result path="D:\Images\WetStone.jpg" format="JPG" />
        <Filter value="C:\Documents and Settings\UserName\
Application Data\Filter Forge 8\System\Library\Library_242-4.ffxml" />
        <Preset value="0" />
    </Task>
    <Task>
        <Image value="D:\1.jpg" />
        <Selection value="" />
        <Result path="D:\Images\ComicBook.bmp" format="BMP">
            <Options>
                <BitDepth value="32" />
                <FlipRowOrder value="false" />
            </Options>
        </Result>
        <RenderingOptions>
            <Dither value="false" />
            <AntiAliasBitmapComponentSources value="true" />
        </RenderingOptions>
        <Filter value="C:\Documents and Settings\UserName\
Application Data\Filter Forge 8\System\Library\Library_227-2.ffxml" />
        <Preset value="0" />
    </Task>
    <GlobalSettings>
        <RenderingOptions>
            <UseMultithreading value="true" />
            <Dither value="true" />
            <Progressive value="true" />
            <OptimizeBlurs value="true" />
            <AntiAliasBitmapComponentSources value="false" />
            <Jitter value="0" />
            <TemporaryFilesLocation value="" />
            <RAMUsageLimit value="60" />
            <NormalMapFlipY value="false" />
        </RenderingOptions>
        <BitmapFormatOptions>
            <DefaultFormat value="JPG" />
            <BMP>
                <BitDepth value="32" />
                <FlipRowOrder value="false" />
            </BMP>
            <JPG>
                <Quality value="98" />
                <FullPrecision value="true" />
            </JPG>
            <TIF>
                <BitDepth value="8" />
                <FloatFormat value="false" />
                <IncludeTransparency value="true" />
                <ImageCompression value="LZW" />
            </TIF>
            <TGA>
                <BitDepth value="32" />
                <IncludeTransparency value="true" />
                <FlipRowOrder value="false" />
            </TGA>
            <PNG>
                <BitDepth value="16" />
                <IncludeTransparency value="true" />
                <ImageCompression value="BEST" />
            </PNG>
            <EXR>
                <BitDepth value="32" />
                <IncludeTransparency value="true" />
                <ImageCompression value="PIZ" />
                <FlipRowOrder value="false" />
            </EXR>
            <PFM />
        </BitmapFormatOptions>
    </GlobalSettings>
</Tasks>
<?xml version="1.0" encoding="utf-8"?>
<Tasks>
    <Task>
        <Image value="" width="300" height="400" />
        <Selection value="" />
        <Result path="~/Documents/Wood.bmp" />
        <Filter value="~/Library/Application Support/Filter Forge 4/
System/Library/Library_284-1.ffxml" />
        <Preset value="0" />
    </Task>
    <Task>
        <Image value="" width="300" height="400" />
        <Selection value="" />
        <Result path="~/Documents/WetStone.jpg" format="JPG" />
        <Filter value="~/Library/Application Support/Filter Forge 8/
System/Library/Library_242-4.ffxml" />
        <Preset value="0" />
    </Task>
    <Task>
        <Image value="~/Documents/1.jpg" />
        <Selection value="" />
        <Result path="~/Documents/ComicBook.bmp" format="BMP">
            <Options>
                <BitDepth value="32" />
                <FlipRowOrder value="false" />
            </Options>
        </Result>
        <RenderingOptions>
            <Dither value="false" />
            <AntiAliasBitmapComponentSources value="true" />
        </RenderingOptions>
        <Filter value="~/Library/Application Support/Filter Forge 8/
System/Library/Library_227-2.ffxml" />
        <Preset value="0" />
    </Task>
    <GlobalSettings>
        <RenderingOptions>
            <UseMultithreading value="true" />
            <Dither value="true" />
            <Progressive value="true" />
            <OptimizeBlurs value="true" />
            <AntiAliasBitmapComponentSources value="false" />
            <Jitter value="0" />
            <TemporaryFilesLocation value="" />
            <RAMUsageLimit value="60" />
            <NormalMapFlipY value="false" />
        </RenderingOptions>
        <BitmapFormatOptions>
            <DefaultFormat value="JPG" />
            <BMP>
                <BitDepth value="32" />
                <FlipRowOrder value="false" />
            </BMP>
            <JPG>
                <Quality value="98" />
                <FullPrecision value="true" />
            </JPG>
            <TIF>
                <BitDepth value="8" />
                <FloatFormat value="false" />
                <IncludeTransparency value="true" />
                <ImageCompression value="LZW" />
            </TIF>
            <TGA>
                <BitDepth value="32" />
                <IncludeTransparency value="true" />
                <FlipRowOrder value="false" />
            </TGA>
            <PNG>
                <BitDepth value="16" />
                <IncludeTransparency value="true" />
                <ImageCompression value="BEST" />
            </PNG>
            <EXR>
                <BitDepth value="32" />
                <IncludeTransparency value="true" />
                <ImageCompression value="PIZ" />
                <FlipRowOrder value="false" />
            </EXR>
            <PFM />
        </BitmapFormatOptions>
    </GlobalSettings>
</Tasks>

Xml Dateihierarchie

Die .xml-Datei hat drei Hierarchieebenen mit verschachtelten Abschnitten. Einige von ihnen sind obligatorisch, andere sind optional.

<Tasks>
    <Task>
        <Options></Options>
        <RenderingOptions></RenderingOptions>
    </Task>
    <GlobalSettings></GlobalSettings>
</Tasks>

Xml Datei Inhalt

Die .xml-Datei beschreibt Rendering-Aufträge. Ein einzelner Auftrag rendert eine einzelne Filtervoreinstellung und speichert das Ergebnis in einer Bilddatei. Die Aufträge werden in der gleichen Reihenfolge abgearbeitet, wie sie in der .xml-Datei aufgeführt sind. Ein einzelner Rendering-Auftrag ist in <Task></Task> tags eingeschlossen. Er hat fünf obligatorische Tags:

• <image value="path_to_the_source_image.jpg" width="number" hight="number"/>. Gibt die Parameter des Quellbildes an, auf das der aktuelle Filter angewendet wird. Bei Effektfiltern enthält das Wert Attribut den Pfad zum Quellbild, und die Attribute Breite und Höhe können weggelassen werden. Bei Texturfiltern, die das Quellbild nicht benötigen, geben die Attribute Breite und Höhe die neuen Bildabmessungen an, und das Attribut Wert kann leer sein.
• <Selection value=""/>. Gibt den Pfad zu dem Bild an, das als Auswahl für die aktuelle Rendering-Aufgabe verwendet werden soll. Wenn der Filter keine Auswahl erfordert, kann das Attribut Wert leer sein.
• <Filter value="path_to_the_filter.ffxml"/>. Gibt den Pfad zu dem zu rendernden Filter an. Die Filter befinden sich normalerweise im Ordner C:\Users\User Name\AppData\Filter Forge\System\Library und im Ordner C:\Users\User Name\AppData\Filter Forge 8\My Filters.~/Library/Application Support/Filter Forge 8/System/Library/ and in the ~/Library/Application Support/Filter Forge 8/My Filters directories.
• <Preset value="preset_number"/>. Gibt die Nummer der gespeicherten Voreinstellungen an, beginnend bei 0. Alle Filtereinstellungen wie Steuerung, Beleuchtung, Kantenglättung usw. werden in der Voreinstellung gespeichert.
• <Result path="path_to_the_result.jpg" format="JPG"/>. Gibt den Pfad für das Ergebnisbild und sein Format an. Es werden alle von deiner Filter Forge-Edition unterstützten Formate akzeptiert. Das Attribut Format ist optional und gibt das Format des Ergebnisbildes an. Wird es weggelassen (wie im ersten Auftrag in der obigen Beispiel-.xml-Datei), wird das Standardformat Jpeg verwendet. Außerdem kann das Attribut Format einen zusätzlichen Abschnitt <Optionen> enthalten. Weitere Informationen findest du unter Bildformat Optionen weiter unten.

Bildformat Optionen

Der <Result> Tag kann einen zusätzlichen <Options> Abschnitt haben, der Parameter für das Bildformat beschreibt, das durch das Attribut Format im <Result> Tag angegeben ist. Wenn der Abschnitt <Options> weggelassen wird, werden die Formatparameter aus dem Abschnitt <GlobalSettings> gelesen, und wenn <GlobalSettings> weggelassen wird – aus der Datei C:\Documents and Settings\User Name\Application Data\Filter Forge 8\FileFormatOptions.xml.~/Library/Application Support/Filter Forge 8/FileFormatOptions.xml file. Wenn das Attribut Format selbst im <Result> Tag fehlt, wird der Abschnitt <Options> ignoriert.

Dies sind mögliche Tags für den Abschnitt <Options>. Die Tags in diesem Abschnitt sollten dem im <Result> Tag angegebenen Format entsprechen.

• <BitDepth value="32"/>. Gibt die Bittiefe des resultierenden Bildes an. Erlaubte Werte: 24 und 32.
• <FlipRowOrder value="false"/>. Bei "false" ist die Zeilenreihenfolge normal, bei "true" wird die Reihenfolge umgekehrt.

• <Quality value="98"/>. Gibt den Wert der JPEG-Qualität an. Erlaubte Werte: 0-100.
• <FullPrecision value="true"/>. Die Einstellung "true" ist gleichbedeutend mit der Aktivierung der Checkbox "hochpräzise Farbkodierung" im Dialogfeld "JPEG-Optionen" in der Filter Forge-Benutzeroberfläche.

• <BitDepth value="8"/>. Gibt die Bittiefe des resultierenden Bildes an. Erlaubte Werte: 8, 16 und 32.
• <FloatFormat value="false"/>. Bei "false" werden die Farbkanäle als Ganzzahl-Werte gespeichert, andernfalls werden halbgenaue Floats verwendet.
• <IncludeTransparency value="true"/>. Bei der Einstellung "false" wird der Alphakanal nicht gespeichert.
• <ImageCompression value="LZW"/>. Gibt die Komprimierungsmethode an. Erlaubte Werte: NONE, LZW und DEFLATE.

• <BitDepth value="32"/>. Gibt die Bittiefe des resultierenden Bildes an. Erlaubte Werte: 24 und 32.
• <IncludeTransparency value="true"/>. Bei der Einstellung "false" wird der Alphakanal nicht gespeichert.
• <FlipRowOrder value="false"/> Bei "false" ist die Zeilenreihenfolge normal, bei "true" wird die Reihenfolge umgekehrt.

• <BitDepth value="16"/>. Gibt die Bittiefe des resultierenden Bildes an. Erlaubte Werte: 8 und 16.
• <IncludeTransparency value="true"/>. Bei der Einstellung "false" wird der Alphakanal nicht gespeichert.
• <ImageCompression value="BEST"/>. Gibt die Qualität der Komprimierung an. Erlaubte Werte: NONE, FAST und BEST.

• <BitDepth value="32"/>. Gibt die Genauigkeit des resultierenden Bildes an. Erlaubte Werte: 16 (Halbpräzisions-Float) und 32 (Einfachpräzisions-Float).
• <IncludeTransparency value="true"/>. Bei der Einstellung "false" wird der Alphakanal nicht gespeichert.
• <ImageCompression value="PIZ"/>. Gibt die Komprimierungsmethode an. Erlaubte Werte: KEINE, RLE, ZIP, PIZ und PXR24.
• <FlipRowOrder value="false"/>. Bei "false" ist die Zeilenreihenfolge normal, bei "true" wird die Reihenfolge umgekehrt.

• Das PFM-Bildformat hat keine Optionen.

Render Optionen

<Task> kann einen optionalen <RenderingOptions> Abschnitt haben, der Rendering-Parameter für die Ausgabedatei beschreibt. Wenn der Abschnitt <RenderingOptions> weggelassen wird, werden die Rendering-Parameter aus dem Abschnitt <GlobalSettings> gelesen. Wenn der Abschnitt <GlobalSettings> weggelassen wird, werden stattdessen die Standardparameter von Filter Forge verwendet.

Dies sind mögliche Tags für den Abschnitt <RenderingOptions>. Die Tags in diesem Abschnitt entsprechen dem Render Tab im Dialogfeld Optionen in der Filter Forge-Benutzeroberfläche.

• <UseMultithreading value="true" />. Schaltet den Renderer zwischen der Verwendung einer einzelnen CPU/Kern oder aller verfügbaren CPUs/Kerne um. Bei der Einstellung "false" wird ein einzelner Kern/CPU verwendet.
• <Dither value="true" />. Wenn diese Option auf "true" gesetzt ist, wendet der Renderer Dithering auf das Ausgabebild an.
• <Progressive value="true" />. Dieses Tag wurde aus Kompatibilitätsgründen hinzugefügt und hat keine Auswirkungen auf den Befehlszeilen-Renderer.
• <OptimizeBlurs value="true" />. Wenn diese Option auf "true" gesetzt ist, verwenden alle auf Weichzeichnen basierenden Komponenten (wie Unschärfe, Hochpass oder Scharfzeichnen) einen ganzzahligen Weichzeichner-Radius anstelle eines Fließkomma-Radius, wenn der interne Weichzeichner-Radius 40 Pixel überschreitet.
• <AntiAliasBitmapComponentSources value="false" /> . Wenn diese Option auf "true" gesetzt ist, arbeiten alle Bitmap-basierten Komponenten mit kantengeglätteten Quellen.
• <Jitter value="0" />. Bei einem Wert ungleich 0 werden die Abtastpositionen innerhalb eines Pixels, das kantengeglättet wird, randomisiert, wodurch unerwünschte Artefakte vermieden werden, die bei hochfrequenten Mustertexturen während der Kantenglättung auftreten. Erlaubte Werte: innerhalb des Bereichs 0-1, auf 1 Dezimalstelle genau.
• <TemporaryFilesLocation value="" />. Ermöglicht die Angabe des Speicherorts für temporäre Dateien, die Filter Forge während des Renderings erstellen kann.
• <RAMUsageLimit value="60" />. Legt den maximalen Prozentsatz des für Filter Forge verfügbaren physischen Speichers fest. Erlaubte Werte: 10–90.
• <NormalMapFlipY value="false" />. Legt fest, wie die Normal Maps generiert werden. Bei "false" wird eine Karte im DirectX-Stil erzeugt, bei "true" eine Karte im OpenGL-Stil.

Globale Einstellungen

Der oberste <Tasks> Abschnitt kann einen optionalen <GlobalSettings> Abschnitt enthalten, der globale Rendering- und Bildformatparameter für die gesamte Datei beschreibt. Wenn der Abschnitt <GlobalSettings> weggelassen wird, werden stattdessen die Standardparameter von Filter Forge verwendet.

Die Tags im Abschnitt <GlobalSettings> sind die gleichen wie die in den Abschnitten <RenderingOptions> und <Options> oben.