© 2008-2010, Heymann Consulting
Miniaturen Generator EJaP - Version 8.0.0
 
Dokumentation
 

Inhalt

 

0 Einführung

1 Installation
 
   1.1 Demoversion

2 Anwendung
 
   2.1 Miniaturen laden
   2.2 Miniaturen aus Verzeichnis laden
   2.3 Miniaturen erzeugen mit Hilfe eines Konverter Programms
   2.4 Miniaturgröße

3 Konverter Einstellungen
 
   3.1 Miniatur mit Hilfe von Konverter-Programm erzeugen
 
      3.1.1 EPSF (Encapsulated Postscript Files) Miniatur erzeugen
      3.1.2 CGM (Computer Graphics Metafile) Miniatur erzeugen
      3.1.3 Wasserzeichen erstellen (mit ImageMagick)...
 
         3.1.3.1 ...unter Microsoft Windows
         3.1.3.2 ...unter Mac OS X

   3.2 Weitere Konverter-Programme

4 Zusätzliche Information

5 Versionshistorie & Produkt Support

 

0 Einführung

 

 
 
Der 'Miniaturen Generator' - Laden oder Erzeugen von Miniaturen zu Dateien in Canto Cumulus
 

Der Miniaturen Generator ist eine Erweiterung für den Canto Cumulus Workgroup oder Enterprise Client 7.5 oder neuer, der auf der Canto EJaP-Technologie (Embedded Java Plugins) basiert. Das Modul ermöglicht das Erzeugen, Laden, Modifizieren und Optimieren von Miniaturen für Canto Cumulus Kataloge.

Wenn Cumulus zu einer Datei keine Miniatur anzeigt, oder Sie mit der Miniatur im Cumulus Katalog nicht zufrieden sind, können Sie mit Hilfe des Miniaturen Generators vorhandene Bilder im JPEG-Format laden oder Miniaturen für diese Datensätze erzeugen. Mit Hilfe eines Konverter Programmes, welches die Originaldatei in das JPEG-Format konvertiert, können Sie automatisiert JPEG-Dateien erzeugen, die dann als Miniaturen geladen werden. Der Konverter kann direkt aus dem Miniaturen Generator aufgerufen werden. So können Sie die Cumulus Miniaturen optimieren oder z.B. auch mit einem Wasserzeichen versehen.

Bei Dateiformaten, für die Cumulus mit Hilfe seiner Erfassungsfilter keine Voransicht erzeugen kann, wird in Cumulus die Miniatur auch zur Darstellung der Voransicht verwendet. Daher ermöglicht der Miniaturen Generator das Laden und die Erzeugung von Miniaturen bis zur maximalen Größe von 1024x1024 Pixeln. In den Einstellungen des Miniaturen Generators können Sie die gewünschte Miniaturgröße einstellen und Konverter und deren Einstellungen konfigurieren.

Haben Sie Ideen oder Wünsche, die dieses Produkt für Sie noch produktiver macht? Wir erweitern die Software gerne auf Basis Ihrer Wünsche. Senden Sie einfach eine Email an uns, indem Sie hier klicken.

 

1 Installation

 

In dem Ordner 'Installation' befindet sich das Verzeichnis 'ThumbnailGenerator'. Kopieren Sie diesen Ordner samt Inhalt in den 'ejp'-Ordner des Installations-Ordners Ihrer Cumulus Client Anwendung. Dieser befindet sich nach einer Standard-Installation unter Windows unter 'C:\Programme\Canto\Cumulus 7 Workgroup Client', unter Mac OS X ist dies 'Macintosh HD/Programme/Cumulus 7 Workgroup Client'. Unter Mac OS X öffnen Sie diesen Ordner, indem Sie den Installations-Ordner Ihrer Cumulus Anwendung öffnen und dann die Taste STRG bzw. CTRL drücken und gleichzeitig das Symbol Ihrer Cumulus Client Anwendung auswählen, um das Kontextmenü für die Anwendung zu erhalten. In diesem Menü wählen Sie 'Paketinhalt zeigen' und öffnen erst 'Contents' und dann 'MacOS'. Dort finden Sie den 'ejp' Ordner.

Sobald Sie die Cumulus Applikation erneut starten, können Sie die Funktionen nutzen, die der Miniaturen Generator bietet. Der Miniaturen Generator erzeugt innerhalb der Cumulus Applikation sein eigenes Menü mit Namen 'Miniaturen'.

Wenn Sie eine Vollversion des Produktes erworben haben, müssen Sie vor der Verwendung die mitgelieferte Seriennummer im Lizenzdialog angeben, indem Sie den Menü-Befehl 'Miniaturen>Lizenz...' wählen:

 
 
Der 'Miniaturen Generator' Lizenz-Dialog
 

Die Lizenzangaben werden im Konfigurationsverzeichnis des Cumulus Clients lokal gespeichert. Wenn Sie den Miniaturen Generator auf verschiedenen Rechnern einsetzen möchten, müssen Sie also die Seriennummer auf all diesen Rechnern angeben, bevor Sie die Version voll nutzen können.


1.1 Demoversion

Die Demoversion ist eine voll funktionsfähige Version des Miniaturen Generators, so dass Sie die Software intensiv testen können. In dieser Demoversion werden alle geladenen Miniaturen mit einem Wasserzeichen versehen. Des weiteren wird ein Dialog angezeigt, der darauf hinweist, dass es sich um eine Demoversion handelt.

 
 
Das Wasserzeichen der 'Miniaturen Generator' Demoversion
 

Die Demoversion ist nur zum Testen der Software gedacht. Wenn Sie das Produkt erwerben möchten, senden Sie bitte eine Email an Heymann Consulting, wir senden Ihnen dann gern ein Angebot zur Bestellung.

 

2 Anwendung

 

Der Miniaturen Generator ermöglicht das Laden von JPEG-Dateien als Miniaturen in Cumulus Kataloge. Dabei können vorhandene Dateien von der Festplatte oder aus dem Netzwerk geladen werden oder die Dateien können direkt aus dem Miniaturen Generator mit Hilfe eines Konverter Programms erzeugt werden, die dann in den Cumulus Datensatz geladen werden.

Es gibt 3 verschieden Methoden, die JPEG-Dateien als Miniatur zu laden:

1) vorhandene JPEG-Datei laden (einzeln auswählen)

Sie können über einen Auswahldialog die einzelnen JPEG-Dateien auswählen, die Sie als Miniatur laden möchten.

2) vorhandene JPEG-Dateien aus Verzeichnis laden

Der Miniaturen Generator sucht nach gleichnamigen Dateien im Asset- oder in einem gewählten Verzeichnis. Dabei wird nach dem Originaldateinamen (ohne Suffix) mit Erweiterung '.jpg' gesucht. Die entsprechenden Dateien werden dann, wenn verfügbar, als Miniatur geladen.

3) Miniaturen erzeugen

Auf Basis von Konverter-Einstellungen, die in den Benutzereinstellungen festgelegt werden können, werden die Originaldateien ins JPEG-Format konvertiert und diese Versionen werden dann als Miniaturen geladen.


2.1 Miniaturen laden

Wenn Sie bereits JPEG-Dateien zu Ihren Assets erzeugt haben, die Sie als Miniaturen verwenden möchten, können Sie diese mit Hilfe des Menübefehls

Miniaturen>Miniaturen laden...

in die selektierten Datensätze laden. Sie können die Dateien in einem Auswahldialog wählen.

 
 
Wählen Sie die JPEG-Datei, die Sie als Miniatur laden möchten
 

Für jeden selektierten Datensatz erhalten Sie einen neuen Auswahldialog, um die Miniaturdatei zu spezifizieren.


2.2 Miniaturen aus Verzeichnis laden

Wenn Sie bereits JPEG-Dateien zu Ihren Assets erzeugt haben, können Sie diese mit Hilfe des Menübefehls

Miniaturen>Miniaturen aus Verzeichnis laden...

in die selektierten Datensätze laden. Dabei kann der Miniaturen Generator diese Dateien entweder im Verzeichnis, in dem sich auch das Asset befindet suchen, oder Sie können ein anderes Verzeichnis auswählen.

 
 
Laden der Miniaturdateien aus einem gewählten Verzeichnis
 

Beispiel: Sie möchten eine Miniatur in den Datensatz zu der EPS-Datei 'Bild.eps' laden, die sich im Verzeichnis '\\Server\Bilder\' befindet. Wenn Sie im Dialog JPEG-Datei im Asset-Verzeichnis suchen wählen, wird der Miniaturen Generator versuchen, die Datei '\\Server\Bilder\Bild.jpg' (also eine gleichnamige Datei mit Suffix .jpg im selben Verzeichnis) zu laden. Sie können auch ein anderes Verzeichnis auswählen, indem Sie JPEG-Datei befindet sich im folgenden Verzeichnis wählen und dann über den Button '...' das Verzeichnis auswählen. Im obigen Beispiel würde der Miniaturen Generator nach der Datei 'D:\MEDIA\Bilder.jpg' suchen und diese in die Miniatur des Datensatzes laden.

Die Funktion wird für alle selektierten Datensätze ausgeführt.


2.3 Miniaturen erzeugen mit Hilfe eines Konverter Programms

Der Miniaturen Generator kann die benötigten JPEG-Dateien auch mit Hilfe von Konverter Programmen vor dem Laden erzeugen. Dazu benötigen Sie ein Konverter Programm, welches über die Kommandozeile / Shell aktiviert werden kann und das Format der in Cumulus katalogisierten Datei in das JPEG-Format konvertieren kann.

Auf Basis der Voreinstellungen, die Sie für jeden Konverter einzeln setzen können, werden die Miniaturdateien erzeugt. Um diese Voreinstellungen für die verwendeten Konverter zu setzen, öffnen Sie die Benutzereinstellungen zum Miniaturen Generator:

Miniaturen>Einstellungen...>Benutzereinstellungen>Allgemein>Miniaturen Generator

In diesem Beispiel verwenden wir den Konverter ImageMagick®, um die Originaldatei in das JPEG-Format zu konvertieren:

 
 
Die Konverter-Einstellungen zu 'ImageMagick'
 

 

1. Klicken Sie auf 'Neu...', um neue Konverter-Einstellungen zu definieren.

2. Geben Sie dem Konverter einen eindeutigen Namen, im obigen Beispiel 'ImageMagick'.

3. Wählen Sie unter 'Konverter Programm:' den Konverter, in dem Sie den Pfad zum Programm angeben oder den Button '...' auswählen, um das Programm im Auswahldialog zu wählen.

4. Geben Sie unter 'Parameter' die Kommandozeilen Parameter an, die der von Ihnen verwendete Konverter erfordert. (Weiter Informationen zu der Definition der Kommandozeilen Parameter finden Sie in Kapitel 3.1 Konverter-Programme direkt aus dem Miniaturen Generator verwenden.

5 . Setzen Sie unter 'Arbeitsverzeichnis:' den Verzeichnispfad, in dem die JPEG-Dateien erzeugt werden sollen, indem Sie es über den Button '...' auswählen.

6. Unter Mac OS X können Sie ein Shellscript angeben, welches die Konvertierung durchführt. Dies kann notwendig sein, wenn das Konverter Programm bestimmte Umgebungsvariablen benötigt, die vor der Konvertierung gesetzt sein müssen.

7 . Setzen Sie den Schalter 'Arbeitsverzeichnis nach der Erzeugung der Miniaturen leeren', wenn die JPEG- und evtl. erzeugte Logdateien im Arbeitsverzeichnis nach der Erzeugung wieder automatisch gelöscht werden sollen. Hinweis: es wird der gesamte Inhalt dieses Verzeichnisses gelöscht. Es werden also auch evtl. Dateien gelöscht, die nicht vom Konverter erzeugt wurden!

8 . In den Log-Einstellungen können Sie spezifizieren, ob Sie die Meldungen des Miniaturen Generators angezeigt bekommen möchten ('Meldungen und Fehler protokollieren'). Wenn Sie beide Logfunktionen abschalten, erhalten Sie die Anzahl der Fehler angezeigt, aber keine weiteren Hinweise zu diesen. Ansonsten können Sie sich die Meldungen in einem Dialog anzeigen lassen oder zusätzlich in eine Logdatei schreiben lassen ('Logdatei erzeugen'). Die Logdatei finden Sie im Logverzeichnis Ihres Cumulus Clients.

Nach der Konfiguration der Voreinstellungen können Sie den konfigurierten Konverter verwenden.

9. Selektieren Sie die Datensätze, zu deren Assets eine Miniatur erzeugt werden soll und wählen Sie aus dem Menü Miniaturen>Miniaturen erzeugen...

10. Überprüfen Sie noch einmal die Einstellungen des Konverters und ändern Sie diese evtl. wie gewünscht, bevor die Konvertierung gestartet wird. Hinweis: wenn Sie die Einstellungen ändern, gelten diese nur für diese eine Konvertierung.

11 . Nach der Bestätigung werden dann die einzelnen Datensätze abgearbeitet und auf Basis der Voreinstellungen werden die Miniaturen in der gewünschten Größe erzeugt und in den Katalog geladen.

12 . Wenn Sie in den Voreinstellungen das Log aktiviert haben, werden Log Informationen angezeigt, die genauer informieren, welche Aktionen durchgeführt wurden und welche Fehler aufgetreten sind.


2.4 Miniaturgröße

In den Voreinstellungen können Sie die Miniaturgröße setzen. Sie können zwischen 64, 128, 256 und einer beliebigen Größe wählen. Die Miniatur darf in der aktuellen Cumulus Version maximal 1024x1024 Pixel groß sein, daher beschränkt der Miniaturen Generator die beliebige Größe auf diesen Wert.

Wenn die erzeugte JPEG-Datei größer ist als die eingestellte Miniaturgröße, dann wird das Bild entsprechend auf die eingestellte Miniaturgröße skaliert.

Bei Dateiformaten, für die Cumulus mit Hilfe seiner Erfassungsfilter keine Voransicht erzeugen kann, wird in Cumulus die Miniatur auch zur Darstellung der Voransicht verwendet. Daher ermöglicht der Miniaturen Generator das Laden von Miniaturen bis zur maximalen Größe von 1024x1024 Pixeln, die dann als Voransicht verwendet werden. In der Vorschau-Darstellung wird von Cumulus oberhalb der Miniatur dann die Info 'Asset nicht unterstützt. Unterstützendes Modul deaktiviert oder nicht verfügbar. (Miniatur wird statt dessen angezeigt)' angezeigt. Leider kann diese Meldung nicht unterdrückt werden.

 

3 Konverter Einstellungen

 

Die automatisierte Erzeugung der Miniaturen erfolgt mit Hilfe von Programmen, die das jeweilige Dateiformat unterstützen und die Konvertierung dieses Formates in das JPEG-Dateiformat erlauben. Diese JPEG-Datei wird dann vom Miniaturen Generator als Miniatur in den Cumulus Katalog eingelesen.

Es gibt eine Vielzahl von Konverter-Programmen für die verschiedenen Plattformen und die unterschiedlichsten Dateiformate. Die Art der Anwendung ist aber unabhängig vom Dateiformat:

Schritt 1) Erzeugen von Dateien im JPEG-Format durch Konvertierung der Originaldatei
Schritt 2) Laden dieser JPEG-Versionen als Miniatur in Cumulus

Einige Konverter lassen sich nur innerhalb einer Programm-Oberflläche starten, so dass Sie die Konvertierung ins JPEG-Format 'von Hand' innerhalb der Programm-Oberfläche vornehmen müssen. Danach können Sie dann die erzeugten Dateien über die Menübefehle Miniaturen>Miniaturen laden... oder Miniaturen>Miniaturen aus Verzeichnis laden... in die Datensätze importieren.

Andere Programme erlauben die Konvertierung innerhalb der Kommandozeile, so dass die Konvertierung automatisiert angestossen werden kann. Am Komfortabelsten ist die Arbeit mit dem Miniaturen Generator also, wenn Ihr Konverter über die Kommandozeile aufgerufen werden kann, also unter Windows in einer MS-DOS Kommandozeile bzw. unter Mac OS X in einer Shell über die Kommandozeile. So können Sie die Konvertierung der Dateien direkt aus dem Cumulus Client über den Miniaturen Generator starten. Die Kommandozeilenparameter, die für die Konvertierung notwendig sind, können in den Voreinstellungen des Miniaturen Generator gesetzt werden und werden bei Bedarf im Hintergrund an den Konverter übergeben.

Die eingelesene Miniatur wird in der erzeugten Größe in das Cumulus Feld 'Miniatur' geschrieben. In der aktuellen Cumulus-Version sind nur Miniaturen bis zu einer Größe von 1024x1024 Pixeln erlaubt. Sollte die Größe des JPEG-Bildes diese maximale Miniaturgröße überschreiten, wird das Bild auf die maximale Miniaturgröße skaliert.


3.1 Miniatur mit Hilfe von Konverter-Programm erzeugen

Um neue Voreinstellungen für die verwendeten Konverter zu setzen, öffnen Sie die Benutzereinstellungen zum Miniaturen Generator:

Miniaturen>Einstellungen...>Benutzereinstellungen>Allgemein>Miniaturen Generator

Bei der Definition der Kommandozeilen Parameter können Sie Variablen verwenden. Da sich ja der Assetname und die Asset-Referenz bei jedem zu bearbeitenden Datensatz ändern, müssen diese Parameter in der Kommandozeile durch Variablen ersetzt werden. Diese werden dann beim Start der Konvertierung durch die Pfade und Werte aus dem Datensatz bzw. den Voreinstellungen ersetzt. Andere Parameter wie z.B. die Miniaturgröße können Sie als Wert explizit angeben oder aber die Variable verwenden, die dann die Größe aus den Voreinstellungen des Konverters setzt.

Folgende Variablen stehen bei der Definition zur Verfügung, die Sie sich über den 'Hilfe...'-Button einblenden können:

 
 
Diese Variablen können bei der Definition der Konvertierung verwendet werden
 

Die nächsten Kapitel dieser Dokumentation werden die Verwendung der Variablen an Hand von Beispielen erläutern.


3.1.1 EPSF (Encapsulated Postscript Files) Miniatur erzeugen

In diesem Beispiel verwenden wir den Miniaturen Generator, um eine Miniatur für eine Datei im EPS Format zu erzeugen, zu der Canto Cumulus keine Miniatur erzeugen kann. Cumulus kann PostScript Dateien nicht selbständig interpretieren, daher wird nur das Icon der Datei als Miniatur angezeigt.

 
 
Asset ohne Miniatur, das Icon
des Betriebssystems wird verwendet

 

Wir verwenden die Konverter-Software ImageMagick®, um die EPS-Datei in das JPEG-Format zu konvertieren und dieses Bild dann als Miniatur zu laden. Die Software erlaubt die Verwendung der Kommandozeile, so dass die Konvertierung der Originaldateien ins JPEG-Format über die Kommandozeile gestartet werden kann.

Beispiel: Die folgende Kommandozeile öffnet eine Datei namens 'hamburg.eps', die sich im Verzeichnis '\\Server\Bilder\' befindet und rechnet dieses Bild in das JPEG-Format um. Die Erzeugung der Datei erfolgt im temporären Verzeichnis 'c:\temp'. Die neue JPEG-Datei wird dann in das Cumulus Feld 'Miniatur' geladen.

"C:\Program Files\ImageMagick-6.4.0-Q16\convert.exe" -colorspace rgb "\\Server\Bilder\hamburg.eps" "C:\temp\hamburg.jpg"

Es wird das Tool 'convert' aus der ImageMagick Produktpalette verwendet. Dabei haben die Parameter die folgende Bedeutung:

-colorspace rgb = die erzeugte JPEG-Datei soll in den RGB Farbraum konvertiert werden, falls nötig
"\\Server\Bilder\hamburg.eps" = Originaldatei, diese Datei soll konvertiert werden
C:\temp\hamburg.jpg = Zieldatei, die dann als Miniatur geladen werden kann

Hinweis: die Parameter müssen in Anführungsstriche gesetzt werden, falls sie Pfade mit Leerzeichen enthalten. Weitere Informationen zu den Parametern von 'convert' in der Kommandozeile finden Sie in der Dokumentation des Herstellers.

Zur Definition der Konverter-Einstellungen im Miniaturen Generator öffnen Sie die Voreinstellungen unter:

Miniaturen>Einstellungen...>Benutzereinstellungen>Allgemein>Miniaturen Generator

Dabei können die in Kapitel 3.1 Konverter-Programme direkt aus dem Miniaturen Generator verwenden aufgelisteten Variablen verwendet werden. Eine Liste der verfügbaren Variablen können Sie sich während der Konfiguration anzeigen lassen, wenn Sie auf den Button 'Hilfe...' klicken.

Da sich ja der Assetname und die Asset-Referenz bei jedem zu bearbeitenden Datensatz ändern, muss die Kommandozeile im Miniaturen Generator durch Variablen ersetzt werden. Diese werden dann beim Start der Konvertierung durch die Pfade und Werte aus dem Datensatz bzw. den Voreinstellungen ersetzt.

"\\Server\Bilder\hamburg.eps" => "$ASSETREF$" (Asset-Referenz aus dem Cumulus Datensatz)
C:\temp\hamburg.jpg => "$WORKINGDIR$\$ASSETNAME.jpg$" (Zieldatei im eingestellten Arbeitsverzeichnis mit Assetname und '.jpg' Suffix statt Original-Suffix)

Die korrekte Einstellung für diesen Konverter lautet damit wie folgt:

"$CONVERTERAPP$" -colorspace rgb "$ASSETREF$" "$WORKINGDIR$\$ASSETNAME.jpg$"

Der Parameter -colorspace rgb ist notwendig, da die Originaldatei evtl. den CMYK Farbraum verwendet. Es können nur JPEG-Dateien im RGB-Farbraum als Miniaturen in Cumulus geladen werden.

Definieren Sie die Konverter Einstellungen, indem Sie einen neuen Konverter Namen erzeugen (hier z.B. 'ImageMagick') und das Konverter Programm, dessen Parameter und das Arbeitsverzeichnis, in dem die erzeugten Dateien temporär abgelegt werden sollen, angeben und speichern Sie diese. Danach kann die Einstellung zur Konvertierung aller selektierten Datensätze verwendet werden.

 
 
Die Voreinstellungen zur Konvertierung der Datei
mit Hilfe von ImageMagick unter MS Windows

 

Verwenden Sie nun diese Konvertierung, indem Sie die Datensätze auswählen, für die Sie Miniaturen erzeugen möchten und wählen Sie aus dem Menü

Miniaturen>Miniaturen erzeugen...>ImageMagick

wählen.

 
 
Datensatz mit Miniatur nach
Anwendung des Miniaturen Generators

 

Diese Einstellung der Konvertierung mit ImageMagick können Sie natürlich nicht nur für Dateien im EPS-Format anwenden, sondern für alle Dateiformate, die ImageMagick unterstützt (und da bleiben bei ImageMagick kaum Wünsche offen!)

Mit Hilfe des Parameters '-resize' können Sie in ImageMagick die Bildbreite und Bildhöhe der zu erzeugenden JPEG-Datei einstellen. Wenn Sie die Bildgröße auf 128x128 Pixel setzen, die Miniaturgröße des Miniaturen Generators aber z.B. auf 256x256 Pixel eingestellt ist, wird der Miniaturen Generator das Bild auf die entsprechende Größe hochrechnen, was natürlich mit dem Verlust der Bildqualität einhergeht. Es macht also Sinn, mit Hilfe des Konverters JPEG-Dateien zu erzeugen, deren Bildbreiten und -höhen größer oder gleich der eingestellten Miniaturgröße sind.

Wenn Sie die Miniatur also auch für die Voransicht verwenden, können Sie in ImageMagick mit dem Parameter '-resize 1024x1024' die JPEG-Datei in der Größe 1024x1024 Pixel erzeugen. Setzen Sie dann in der Voreinstellung des Miniaturen Generators die Miniaturgröße auf 1024, damit diese Größe auch in den Datensatz eingetragen wird.


3.1.2 CGM (Computer Graphics Metafile) Miniatur erzeugen

In diesem Beispiel verwenden wir den Miniaturen Generator, um eine Miniatur für eine Datei im CGM Format zu erzeugen, zu der Canto Cumulus keine Miniatur erzeugen kann. Cumulus kann CGM Dateien nicht selbständig interpretieren, daher wird das Icon der Datei statt der Miniatur angzeigt.

 
 
Asset ohne Miniatur, das Icon
des Betriebssystems wird verwendet

 

Zur Konvertierung von Dateien im CGM-Format (Computer Graphics Metafile) verwenden wir die Konvertierungssoftware der Firma Larson Software Technology, Inc.: CGM to Image. Weitere Informationen und eine Demoversion zum Produkt finden Sie unter www.cgmlarson.com.

Die Software, die nur unter Windows verfügbar ist, erlaubt die Verwendung der Kommandozeile, so dass die Konvertierung der .cgm Dateien ins JPEG-Format über die Kommandozeile gestartet werden kann.

Beispiel: Die folgende Kommandozeile konvertiert eine Datei namens 'Bild.cgm', die sich im Verzeichnis '\\Server\Bilder\CGM\' befindet in eine JPEG-Datei. Die Konvertierung wird in dem temporären Verzeichnis 'c:\temp' durchgeführt.

"C:\Program Files\Larson Software Technology\Larson CGM to Image\cgm2img.exe" "\\Server\Bilder\CGM\Bild.cgm" -jpg -out c:\temp\Bild.jpg -s 1024,0,2 -log c:\temp\Bild.txt

Dabei haben die Parameter die folgende Bedeutung:

"\\Server\Bilder\CGM\Bild.cgm" = Originaldatei, diese Datei soll konvertiert werden
-jpg = Konvertierung ins JPEG-Format
-out c:\temp\Bild.jpg = diese JPEG-Datei soll erzeugt werden
-s 1024,0,2 = die Datei soll auf max. 1024x1024 Pixel skaliert werden, das Seitenverhältnis soll erhalten bleiben
-log c:\test\Bild.txt = eine Logdatei mit Informationen zur Konvertierung wird erzeugt

Hinweis: die Parameter müssen in Anführungsstriche gesetzt werden, falls sie Pfade mit Leerzeichen enthalten. Weitere Informationen zu den Parametern von 'CGM to Image' in der Kommandozeile finden Sie in der Dokumentation des Herstellers.

Zur Definition der Konverter-Einstellungen im Miniaturen Generator öffnen Sie die Voreinstellungen unter:

Miniaturen>Einstellungen...>Benutzereinstellungen>Allgemein>Miniaturen Generator

Dabei können die in Kapitel 3.1 Konverter-Programme direkt aus dem Miniaturen Generator verwenden aufgelisteten Variable verwendet werden. Eine Liste der verfügbaren Variablen können Sie sich während der Konfiguration anzeigen lassen, wenn Sie auf den Button 'Hilfe...' klicken.

Da sich ja der Assetname und die Asset-Referenz bei jedem zu bearbeitenden Datensatz ändern, muss die Kommandozeile im Miniaturen Generator durch Variablen ersetzt werden. Diese werden dann beim Start der Konvertierung durch die Pfade und Werte aus dem Datensatz bzw. den Voreinstellungen ersetzt.

"\\Server\Bilder\CGM\Bild.cgm" => "$ASSETREF$" (Asset-Referenz aus dem Cumulus Datensatz)
-out c:\temp\Bild.jpg => "$WORKINGDIR$\$ASSETNAME.jpg$" (Zieldatei im eingestellten Arbeitsverzeichnis mit Assetname und '.jpg' Suffix statt des Original Suffix)
-s 1024,0,2 => $THUMBNAILSIZE$,0,2 (voreingestellte Miniaturgröße in Pixeln, Seitenverhältnis bleibt erhalten)
-log c:\test\Bild.txt => "$WORKINGDIR$\$ASSETNAME.txt$" (Logdatei im eingestellten Arbeitsverzeichnis mit Assetname und '.txt' Suffix)

Die korrekte Einstellung für diesen Konverter lautet damit wie folgt:

"$CONVERTERAPP$" "$ASSETREF$" -jpg -out "$WORKINGDIR$\$ASSETNAME.jpg$" -s $THUMBNAILSIZE$,0,2 -log "$WORKINGDIR$\$ASSETNAME.txt$"

Definieren Sie die Konverter Einstellungen, indem Sie einen neuen Konverter Namen erzeugen und das Konverter Programm, dessen Parameter und das Arbeitsverzeichnis, in dem die erzeugten Dateien temporär abgelegt werden sollen, angeben und speichern Sie diese. Danach kann die Einstellung zur Konvertierung aller selektierten Datensätze (mit Dateien im CGM-Format) verwendet werden.

 
 
Die Voreinstellungen zur Konvertierung von CGM Dateien mit Larson's CGM to Image

 

Verwenden Sie nun diese Konvertierung, indem Sie die Datensätze auswählen, für die Sie Miniaturen erzeugen möchten und wählen Sie aus dem Menü

Miniaturen>Miniaturen erzeugen...>Larson CGM to Image Converter

wählen.

 
 
Datensatz mit Miniatur nach
Anwendung des Miniaturen Generators

 

Diese Einstellung der Konvertierung können Sie für alle Dateien im CGM Format anwenden. Weitere Formate werden von Larson CGM to Image nicht unterstützt, so dass Sie ein Fehlermeldung erhalten, wenn Sie ein anderes Dateiformat als CGM mit dem Programm konvertieren möchten.


3.1.3 Wasserzeichen erstellen (mit ImageMagick)

In diesem Beispiel verwenden wir den Miniaturen Generator, um eine Miniatur mit Wasserzeichen zu erzeugen. Dabei verwenden wir die Konverter-Software ImageMagick®. Die Software erlaubt die Verwendung der Kommandozeile, so dass die Konvertierung der Originaldateien ins JPEG-Format über die Kommandozeile gestartet werden kann.

Wenn Sie den Miniaturen Generator unter Mac OS X verwenden, kann sich die Konfiguration leicht von der Konfiguration unter Windows unterscheiden, wenn der Konverter das Setzen von Umgebungsvariablen erfordert. Daher können Sie bei der Konfiguration unter Mac OS X vor der Konvertierung ein Shellskript aufrufen, welches das Setzen der Umgebungsvariablen ermöglicht, bevor der Befehl zum Konvertieren aktiviert wird. Hier ein Beispiel für ein solches Shellskript, welches die Variablen für ImageMagick unter Mac OS X setzt:

 
 
Shellskript zum Setzen der Umgebungsvariablen
für ImageMagick unter Mac OS X

 

Sie finden diese Shellscript für ImageMagick unter Mac OS X im Produkt-Verzeichnis des Miniaturen Generators im Verzeichnis 'MacOSX Shellscripts'.

Danach wird der Befehl zum Konvertieren an Stelle der Variablen $COMMAND$ eingetragen und ausgeführt. Weitere Informationen zum Setzen von Umgebungsvariablen unter Mac OS X finden Sie im Kapitel 3.1.3.2 Wasserzeichen erstellen (mit ImageMagick) unter Mac OS X.


3.1.3.1 Wasserzeichen erstellen (mit ImageMagick) unter Microsoft Windows

In diesem Beispiel verwenden wir den Miniaturen Generator, um eine Miniatur mit Wasserzeichen zu erzeugen. Dabei verwenden wir die Konverter-Software ImageMagick®. Die Software erlaubt die Verwendung der Kommandozeile, so dass die Konvertierung der Originaldateien ins JPEG-Format über die Kommandozeile gestartet werden kann.

 
 
Miniatur ohne Wasserzeichen vor
Anwendung der Konvertierung

 

 

Beispiel: Die folgende Kommandozeile öffnet eine Datei namens 'Bild.jpg', die sich im Verzeichnis '\\Server\Bilder\' befindet und rechnet in dieses Bild ein Wasserzeichen, welches sich in der Datei 'hclogo.png' im Verzeichnis 'D:\Media\HC' befindet. Das Wasserzeichen wird zentriert und 50% durchscheinend in das Bild hineingerechnet. Dieses Komposing wird in dem temporären Verzeichnis 'c:\temp' durchgeführt. Die erzeugte neue JPEG-Datei mit Wasserzeichen wird dann in das Feld 'Miniatur' geladen.

"C:\Program Files\ImageMagick-6.4.0-Q16\composite.exe" -gravity center -dissolve 50 "D:\Media\HC\hclogo.png" "\\Server\Bilder\Bild.jpg" "C:\temp\Bild.jpg"

Es wird das Tool 'composite' aus der ImageMagick Produktpalette verwendet. Dabei haben die Parameter die folgende Bedeutung:

-gravity center das Wasserzeichen soll zentriert werden
-dissolve 50 = das Wasserzeichen soll 50% durchscheinend berechnet werden
"D:\Media\HC\hclogo.png" = diese Datei enthält das Wasserzeichen
"\\Server\Bilder\Bild.jpg" = Originaldatei, diese Datei soll konvertiert werden
C:\temp\Bild.jpg = Zieldatei, die dann als Miniatur geladen wird

Hinweis: die Parameter müssen in Anführungsstriche gesetzt werden, falls sie Pfade mit Leerzeichen enthalten. Weitere Informationen zu den Parametern von 'composite.exe' in der Kommandozeile finden Sie in der Dokumentation des Herstellers.

Zur Definition der Konverter-Einstellungen im Miniaturen Generator öffnen Sie die Voreinstellungen unter:

Miniaturen>Einstellungen...>Benutzereinstellungen>Allgemein>Miniaturen Generator

Dabei können die in Kapitel 3.1 Konverter-Programme direkt aus dem Miniaturen Generator verwenden aufgelisteten Variable verwendet werden. Eine Liste der verfügbaren Variablen können Sie sich während der Konfiguration anzeigen lassen, wenn Sie auf den Button 'Hilfe...' klicken.

Da sich ja der Assetname und die Asset-Referenz bei jedem zu bearbeitenden Datensatz ändern, muss die Kommandozeile im Miniaturen Generator durch Variablen ersetzt werden. Diese werden dann beim Start der Konvertierung durch die Pfade und Werte aus dem Datensatz bzw. den Voreinstellungen ersetzt.

"\\Server\Bilder\Bild.jpg" => "$ASSETREF$" (Asset-Referenz aus dem Cumulus Datensatz)
C:\temp\Bild.jpg => "$WORKINGDIR$\$ASSETNAME.jpg$" (Zieldatei im eingestellten Arbeitsverzeichnis mit Assetname und '.jpg' Suffix)

Die korrekte Einstellung für diesen Konverter lautet damit wie folgt:

"$CONVERTERAPP$" -gravity center -dissolve 50 "D:\Media\HC\hclogo.png" "$ASSETREF$" "$WORKINGDIR$\$ASSETNAME.jpg$"

Definieren Sie die Konverter Einstellungen, indem Sie einen neuen Konverter Namen erzeugen (hier z.B. 'Wasserzeichen mit ImageMagick') und das Konverter Programm, dessen Parameter und das Arbeitsverzeichnis, in dem die erzeugten Dateien temporär abgelegt werden sollen, angeben und speichern Sie diese. Danach kann die Einstellung zur Konvertierung aller selektierten Datensätze verwendet werden.

 
 
Die Voreinstellungen zur Erzeugung von Wasserzeichen mit Hilfe von ImageMagick unter MS Windows

 

Verwenden Sie nun diese Konvertierung, indem Sie die Datensätze auswählen, für die Sie neue Miniaturen erzeugen möchten und wählen Sie aus dem Menü

Miniaturen>Miniaturen erzeugen...>Wasserzeichen mit ImageMagick

wählen.

 
 

Miniatur mit Wasserzeichen nach
Anwendung der Konvertierung

 

Nach der Anwendung enthält die Miniatur das Wasserzeichen (zentriert und 50% durchscheinend).


3.1.3.2 Wasserzeichen erstellen (mit ImageMagick) unter Mac OS X

Das Vorgehen zur Erstellung von Wasserzeichen in den Miniaturen unter Mac OS X entspricht dem Vorgehen unter Microsoft Windows, welches in Kapitel 3.1.3.1 Wasserzeichen erstellen (mit ImageMagick) unter Microsoft Windows beschrieben wurde.

Die Verwendung von ImageMagick erfordert das Setzen von Umgebungsvariablen, bevor eine Konvertierung gestartet werden kann. Wenn Sie versuchen, die Applikation 'composite' direkt aufzurufen, erhalten Sie die Fehlermeldung:

/Applications/ImageMagick/bin/composite: not found

Daher können Sie im Miniaturen Generator ein Shellskript aufrufen, welches das Setzen der Umgebungsvariablen erledigt, bevor der Befehl zum Konvertieren aktiviert wird. Hier ein Beispiel für ein solches Shellskript, welches die Variablen für ImageMagick unter Mac OS X setzen:

 
 
Shellskript zum Setzen der Umgebungsvariablen
für ImageMagick unter Mac OS X

 

Danach wird der Befehl zum Konvertieren an Stelle der Variablen $COMMAND$ eingetragen und ausgeführt. Sie finden diese Shellscript für ImageMagick unter Mac OS X im Produkt-Verzeichnis des Miniaturen Generators im Verzeichnis 'MacOSX Shellscripts'.

Die Einstellungen des Miniaturen Generators, die dieses Shellscript aufrufen, kann wie folgt aussehen:

 
 
Die Voreinstellungen zur Erzeugung von Wasserzeichen mit Hilfe von ImageMagick unter MS Windows

 

Vor der Konvertierung wird also erst einmal das Shellscript (hier 'composite.sh') aufgerufen, welches die Umgebungsvariablen für ImageMagick setzt. Das Script startet dann den Befehl, um die Datei zu konvertieren.


3.2 Weitere Konverter-Programme

Sie können mit dem Miniaturen Generator jeden beliebigen Konverter verwenden, der für die von Ihnen verwendete Plattform (Windows oder Mac OS X) verfügbar ist und Dateien in das JPEG-Format konvertieren kann.

Wenn das Konverter-Programm die Verwendung der Komammando-Zeile unterstützt, können Sie die Voreinstellungen wie in Kapitel 3.1 Konverter-Programme direkt aus dem Miniaturen Generator verwenden beschrieben vornehmen, um den Konverter automatisiert direkt aus dem Cumulus Client heraus zu starten.

Wird die Verwendung der Kommandozeile nicht unterstützt, müssen Sie die Umwandlung ins JPEG-Format aus der Programm-Oberfläche starten und danach in einem 2. Schritt diese neu erzeugten JPEG-Dateien als Miniaturen laden. Dies kann evtl. bei Originaldateien im EPS-Format interessant sein. Sie können JPEG-Dateien direkt aus Illustrator oder Freehand speichern und diese dann als Miniaturen laden.

 

4 Zusätzliche Information

 

1. Es können nur JPEG-Dateien im RGB-Farbraum als Miniaturen in Cumulus geladen werden.

2. Wenn die Bildgröße der JPEG-Dateien kleiner ist als die eingestellte Miniaturgröße des Miniaturen Generators, wird dieser das Bild auf die entsprechende Größe hochrechnen, was natürlich mit dem Verlust der Bildqualität einhergeht. Es macht also Sinn JPEG-Dateien zu erzeugen, deren Bildbreiten und -höhen größer oder zumindest gleich der eingestellten Miniaturgröße sind.

3. Die JPEG Dateien werden in dem angegebenen temporären Verzeichnis erzeugt. Die Parameter der Voreinstellungen werden entsprechend der Anforderungen des Konverter Programms umgesetzt und an die Applikation übergeben. Es wird die JPEG-Datei und evtl. eine Logdatei durch das Tool erzeugt. Diese werden, wenn gewünscht, nach der Konvertierung automatisch gelöscht.

4. Die Applikation verwendet die deutsche oder englische Sprache in Abhängigkeit von der gerade gewählten Sprache des Cumulus Clients (Default: Englisch).

5. In der Vorschau-Darstellung wird von Cumulus oberhalb der Miniatur die Info 'Asset nicht unterstützt. Unterstützendes Modul deaktiviert oder nicht verfügbar. (Miniatur wird statt dessen angezeigt)' angezeigt. Dies geschieht, wenn Cumulus keinen Erfasssungsfilter für das jeweilige Dateiformat besitzt (welcher für die Erzeugung der Voransicht notwendig wäre). Diese Meldung kann leider nicht unterdrückt werden.

6. Wenn Sie die Miniatur wieder zurücksetzen möchten, wählen Sie einfach

Datei>Datensatz aktualisieren>Jetzt aktualisieren

Die Miniatur wird dann wieder mit Hilfe der Canto Cumulus Erfassungsfilter berechnet.

7. Der Miniaturen Generator erzeugt, wenn entsprechend konfiguriert, eine Logdatei. Diese Datei finden Sie im Verzeichnis 'logs' Ihres Cumulus Clients.

 
 
Die Logdatei informiert über die Konvertierungen der Assets
 

8. Ein Beispiel für die Verwendung dieser Ereiterung für Canto Cumulus basiert auf der Software der Firma Larson Software Technology, Inc.: CGM to Image. Weitere Informationen und eine Demoversion zum Produkt finden Sie unter www.cgmlarson.com.

 

5 Versionshistorie & Produkt Support

 

Version 8.0.0 - Februar 2010

Die Version wurde für die Cumulus 8 Produktfamilie angepasst und optimiert.

Version 1.0.0 - Juli 2008

Es handelt sich um die erste Version des Miniaturen Generator EJaPs für Canto Cumulus 7.5 und neuer.

Bitte senden Sie alle Fragen zum Produkt an die Email-Adresse support@heymann-consulting.de. Wir versuchen Ihre Fragen umgehend zu beantworten und unsere Produkte auf Basis Ihres Feedbacks laufend zu optimieren.

 

 

© 2008-2010, Heymann Consulting

Heymann Consulting
Brandstwiete 36
20457 Hamburg
GERMANY