CIB merge technical documentation (EN): Parameter --colors

CIB merge technical documentation (EN)

6. Call parameters in detail

6.9. Parameter --colors

The parameter --colors can be used to optionally disable optimizations that are performed for color tables in the header of the RTF document.

Syntax

--colors=<Option>
<Option>: keep, expand, optimize oder minimal

Every RTF document contains color tables in the header. Therefore CIB merge has to spend time for matching because of inserts or for optimization. But not every user is interested in this adjustment or optimization. Therefore they can be switched off with the parameter --colors.

Possible values for <Option> are:

Option	Description
keep	The main color table remains unchanged, even if the inserted text templates actually require an extension or unused colors could be removed.
expand	Colors are added to the main color table if the inserted text templates require an extension. Unused colors are not removed.
optimize	Colors are added to the main color table if the inserted text templates require an extension. Unused colors are removed if they are not among the 17 standard colors of MS Word.
minimal	Colors are added to the main color table if the inserted text templates require an extension. Unused colors are removed, even if they belong to the 17 standard colors including "automatic". MS Word usually has the color "automatic" at the position zero and then 16 standard colors at the positions one to 16. After that the additional colors are added.

Example

--colors=expand

New colors used in RTF components are added to the color table and unused colors are not removed. Therefore no optimization takes place.

The use of the parameter is described in detail in the use case example Templates.