General
Parameter --chart-output-format
Parameter --chart-source
Parameter --chart-target

---

General

The --chart parameter allow the creation and insertion of dynamic business graphics. In this case, CIB merge can leave the graphic statement in the text or replace it with the updated graphic. CIB merge automatically updates (overwrites) the original file and removes the binary graphic data from the result if the graphic statement is kept. Otherwise, the file remains unchanged and only the result will be embedded in the RTF output instead of the instruction.

It is also possible to embed graphic data from non-chart graphics from a file into the RTF. The following image formats are supported: BMP / DIB, EMF (chart and non-chart graphics), PNG, JPG and WMF.

The following parameters are provided:

--chart-output-format	Determines the output format of the graphic (only relevant for chart graphics)
--chart-source	CIB merge takes the graphic description from the given source
--chart-target	CIB merge writes the updated graphic to the specified destination.

Parameter --chart-output-format

CIB merge can deliver all graphic formats offered in CIB chart designer as result. S If you want to leave the graphics statement in the text, you can either set "--keep-fields" for all fields or insert the switch "\* leave" in selected graphics statements.

The --chart-output-format parameter determines the output format of the graphic.

Syntax:

--chart-output-format=<Bildformat>

<image format>: ccr (CIB chart resources), emf (Enhanced Metafile), or emfccr (Enhanced Metafile extended by CIB chart resources (embedded))

Parameter --chart-source

With --chart-source you specify whether the chart should be calculated from the embedded data, or, in the case of an INCLUDEPICTURE instruction, for the contents of the specified file or never. ({\pict} do not calculate).

 Syntax:

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

Description

For the graphic source, the following settings are available <Option> :

Option	Description
none ignore kein	No {\pict} group will be updated.
file/datei	CIB merge takes the graphic description from the file specified in the {INCLUDEPICTURE} statement if the {\pict} group is in its result.
document/dokument embed/embedded einbetten/eingebettet	CIB merge takes the embedded data as source
auto	CIB merge takes the file with priority. If this does not work, the embedded data is used. (Default and default)

Parameter --chart-target

The --chart-target parameter determines where the output of the updated graphic data is to be written: embedded in the document or over the old content of the specified file.

Syntax:

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

Description:

For the graphic target, the following settings are available for <Option> :

Option	Description
none ignore/ignorieren kein/keine	No {\pict} group will be updated.
file/datei	CIB merge writes the graphic description in the file specified in the {INCLUDEPICTURE} statement if the {\pict} group is in its result.
document/dokument embed/embedded einbetten/eingebettet	CIB merge embeds the data in the target document.
auto	CIB merge writes the file with priority if the {INCLUDEPICTURE} statement comes with --keep or \* lassen into the output. If this does not work or the statement is removed, the data will be embedded. (Standard and default)

 

If no chart library is available, chart graphics are treated like normal graphics.

By setting the parameter --chart-target=embed, if --chart-source is not "embed", the image data of EMF, JPG (JPEG), PNG, WMF and BMP or DIP graphic files are embedded in the result RTF. The type of file format is determined by the file content, not by the suffix.

Example:

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

The graphic data here origins from one file. All graphics (chart and non-chart graphics) should be embedded in the result RTF.

The parameter are described in detail in the use case example Templates.

The following table provides an overview:

Graphic source	Graphic target	Not embed chart	Chart from text	Chart from file	Update chart	Embed chart	Write chart in file
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“ switch not set

(2) „Keep“ switch set

(3) Data could not be read from the file

(4) Data could be read from the file