CIB merge technischer Leitfaden

6. Aufrufparameter im Detail

6.7. Parameter --chart-…

Allgemein
Parameter --chart-output-format
Parameter --chart-source
Parameter --chart-target

Allgemein

Die --chart-Parameter ermöglichen das Erzeugen und Einfügen dynamischer Geschäftsgrafiken. CIB merge kann in diesem Fall die Grafikanweisung im Text belassen oder sie durch die aktualisierte Grafik ersetzen. CIB merge aktualisiert (überschreibt) die ursprüngliche Datei automatisch und entfernt die binären Grafikdaten aus dem Ergebnis, wenn die Grafikanweisung erhalten bleibt. Sonst bleibt die Datei unverändert erhalten und nur das Ergebnis wird anstatt der Anweisung in die RTF-Ausgabe eingebettet.

Außerdem besteht auch die Möglichkeit Grafik-Daten aus Nicht-Chart-Grafiken aus einer Datei ins RTF einzubetten. Dabei werden folgende Bildformate unterstützt: BMP bzw. DIB, EMF (Chart- und Nicht-Chart-Grafiken), PNG, JPG und WMF.

Es stehen folgende Parameter zur Verfügung:

--chart-output-format	Bestimmt das Ausgabeformat der Grafik (nur für Chart-Grafiken relevant)
--chart-source	CIB merge nimmt die Grafikbeschreibung aus der angegebenen Quelle
--chart-target	CIB merge schreibt die aktualisierte Grafik in das angegebene Ziel.

Parameter --chart-output-format

CIB merge kann alle im CIB chart designer angebotenen Grafikformate als Ergebnis liefern. Soll die Grafikanweisung im Text belassen werden, kann entweder pauschal für alle Felder “--keep-fields” gesetzt werden oder in ausgewählten Grafikanweisungen der Schalter “\* lassen” eingefügt werden.

Der Parameter --chart-output-format bestimmt das Ausgabeformat der Grafik.

Syntax:

--chart-output-format=<Bildformat>

<Bildformat>: ccr (CIB chart resources), emf (Enhanced Metafile), oder emfccr (Enhanced Metafile erweitert um CIB chart resources (eingebettet))

Parameter --chart-source

Mit --chart-source wird angegeben, ob die Grafik aus den eingebetteten Daten, oder, im Falle einer Einfügengrafik-Anweisung, für den Inhalt der angegebenen Datei oder nie berechnet werden soll. ({\pict} nicht berechnen).

Syntax:

--chart-source=<Option>
<Option>: 
auto, file/datei, none/ignore/ignorieren/kein/keine oder
document/dokument/embed/embedded/einbetten/eingebettet

Beschreibung

Für die Grafikquelle sind folgende Einstellungen für <Option> möglich:

Option	Bedeutung
none ignore/ignorieren kein/keine	Keine {\pict}-Gruppe wird aktualisiert.
file/datei	CIB merge nimmt die Grafikbeschreibung aus der Datei, die in der {INCLUDEPICTURE} Anweisung angegeben wurde, wenn sich die {\pict}-Gruppe in deren Ergebnis befindet.
document/dokument embed/embedded einbetten/eingebettet	CIB merge nimmt die eingebetteten Daten als Quelle
auto	CIB merge nimmt vorranging die Datei. Wenn das nicht funktioniert, werden die eingebetteten Daten verwendet. (Standard und Vorbelegung)

Parameter --chart-target

Der Parameter --chart-target bestimmt, wohin die Ausgabe der aktualisierten Grafikdaten geschrieben werden soll: in

das Dokument eingebettet oder über den alten Inhalt der angegebenen Datei.

Syntax:

--chart-target=<Option>
<Option>:
auto, file/datei, none/ignore/ignorieren/kein/keine oder
document/dokument/embed/embedded/einbetten/eingebettet

Beschreibung:

Für das Grafikziel sind folgende Einstellungen für <Option> möglich:

Option	Bedeutung
none ignore/ignorieren kein/keine	Keine {\pict}-Gruppe wird aktualisiert.
file/datei	CIB merge schreibt die aktualisierten Grafikdaten in die Datei, die in der {INCLUDEPICTURE} Anweisung angegeben wurde, wenn sich die {\pict} Gruppe in deren Ergebnis befindet.
document/dokument embed/embedded einbetten/eingebettet	CIB merge bettet die Daten in das Zieldokument ein.
auto	CIB merge schreibt vorranging die Datei, wenn die {INCLUDEPICTURE} Anweisung mit --keep oder \* lassen in die Ausgabe kommt. Wenn das nicht funktioniert oder die Anweisung entfernt wird, werden die Daten eingebettet. (Standard und Vorbelegung)

Ist keine Chart-Library verfügbar, werden Chart-Grafiken wie normale Grafiken behandelt.

Durch Setzen des Parameters --chart-target=embed werden, wenn --chart-source nicht „embed“ ist, die Bilddaten von EMF, JPG (JPEG), PNG, WMF und BMP bzw. DIP Grafikdateien in das Ergebnis-RTF eingebettet. Die Art des Dateiformats wird durch den Dateiinhalt, nicht durch den Suffix, bestimmt.

Beispiel:

--chart-source=file
--chart-target=embed

Die Grafikdaten stammen hier aus einer Datei. Alle Grafiken (Chart- und Nicht-Chart-Grafiken) sollen in das Ergebnis-RTF eingebettet werden.

Die Parameter werden im Anwendungsbeispiel Bausteine veranschaulicht.

Eine Übersicht liefert folgende Tabelle:

Grafikquelle	Grafikziel	Nicht Chart einbetten	Chart aus Text	Chart aus Datei	Chart ak- tualisieren	Chart einbetten	Chart in Datei schreiben
ignore	ignore	–	–	–	–	–	–
ignore	file	–	–	–	–	–	–
ignore	embed	+	–	+	–	+	–
ignore	auto	–	–	–	–	–	–
file	ignore	–	–	–	–	–	–
file	file	–	–	+	+	–	+
file	embed	+	–	+	+	+	–
file	auto	–	–	+	+	+ (1)	+ (2)
embed	ignore	–	–	–	–	–	–
embed	file	–	+	–	+	–	+
embed	embed	–	+	–	+	+	–
embed	auto	–	+	–	+	+ (1)	+ (2)
auto	ignore	–	–	–	–	–	–
auto	file	–	+ (3)	+ (4)	+	–	+
auto	embed	+	+ (3)	+ (4)	+	+	–
auto	auto	–	+ (3)	+ (4)	+	+ (1)	+ (2)

(1) „Keep“ - Schalter nicht gesetzt

(2) „Keep“ - Schalter gesetzt

(3) Daten konnten nicht aus der Datei gelesen werden

(4) Daten konnten aus der Datei gelesen werden