🛠 Merge Color Gradients and Colors

When working with different systems or parallel installations it might happen, that the fresh installed System does not have the Colors or Color Gradients, I used to have.
How can I import these settings or probably merge them?

You will find the specific data in path %AppData%\ecue\SYMPHOLIGHT <version>, where <version> is e.g. 3.0 or 5.0.
The files are GradientLibrary.xml and ColorLibrary.xml .
If you want to replace the file
1. Quit SYMPHOLIGHT.
2. Rename the original file by adding ".old" to the name. So you keep a backup.
3. Copy the file you want to use.
4. Paste it in the version folder, where you want to use it.
5. Start SYMPHOLIGHT again.
âž¡ The Colors or Color Gradients are available, now.

The files are xml files and human readable. The problem is, that syntax errors will make the file useless.
So we really do not recommend to edit or merge those files.
âš  There is no support from our side for correcting broken xml files.

If you really need to do this, get an editor, that checks xml syntax and is able to compare and merge files.
Get some knowledge regarding xml files, the syntax and structure, before trying to modify those.
Make backups from your files, that you can replace broken files with the original ones.
Keep close to the internal structure of the files.
The structure of those files may change, so it is not guaranteed, that this manual will do with later versions of SYMPHOLIGHT.

The structure is as follows:
<?xml version="1.0" encoding="utf-8"?> âž¡ The header
<GradientLibrary> âž¡ Type of library and object
    <GradientLibraryItem Name="Hue Fader"> ➡ ProPhotoGradient and name
        <Gradient> ➡ Start of list
            <Stop Position="0" Color="1;0;0;1" /> ➡ on or more stop positions
        </Gradient> ➡ end of gradient list
     </GradientLibraryItem> ➡ end of gradient item
     <GradientLibraryItem Name="Next Item"> ➡ next ProPhotoGradient and name, this block may repeat
        <Gradient> ➡ next list with items
            <Stop Position="0" Color="0;0;0;0" />
            <Stop Position="0.5" Color="0;0;0;1" />
            <Stop Position="0.5" Color="1;1;1;1" />
            <Stop Position="1" Color="1;1;1;0" />
       </Gradient> ➡ end of list
    </GradientLibraryItem> ➡ end of gradient item
</GradientLibrary> âž¡ end of library
âž¡ end of file

So you can exchange complete blocks from <GradientLibraryItem ... to </GradientLibraryItem> without any problems.

For colors the structure is as follows:
<?xml version="1.0" encoding="utf-8"?> âž¡ The header
<PaletteLibrary> âž¡ Type of library and object and start of color list
 <PaletteLibraryItem Name="Dark Blue" Color="0.03921569;0.2352941;0.3490196;1" /> ➡ Color object with name and value
<PaletteLibraryItem Name="Lime" Color="0.5;1;0;1" /> ➡ next Color object
</PaletteLibrary> âž¡ end of library
âž¡ end of file

So you can exchange complete blocks <PaletteLibraryItem ... /> without any problems.