Specifications

Appendix E. Documents for

developers

Monitor database structure

The monitor database is written in XML, it can be found in the db directory of ddccontrol-db

package.

This directory contains the following files:

• options.xml

• monitor/%monitor_id%.xml

Control list

XML file: options.xml

control elements (e.g. “brightness”) are contained in group elements (e.g. “color

settings”). group and subgroup elements allow the GUI to separate the controls in different

branches on the tree.

options attributes:

• date: indicates the release date of the current database (YYYYMMDD format).

• dbversion: indicates which version of database format is used (must be set to 2).

group attributes:

• name: full English group name.

subgroup attributes:

• name: full English subgroup name.

• pattern: name of the fullscreen pattern gddccontrol must display to help the user to ad-

just subgroup's controls (optional). For possible values, see ddccontrol/

src/gddccontrol/fspatterns.c.

control attributes:

• id: abbreviated control name.

• name: full English control name.

• address: DDC/CI address (optional).

• type: one of these values:

• “value”: The control accepts values in a continuous range (e.g. brightness).