GUI basics

All SeisComP3 graphical user interfaces are based on a common libraries. This chapter describes what configuration and styling options are available for all GUI applications. The GUI specific configuration options are additional to the standard application options. Setup the e.g. messaging connection and database is equal to the CLI (command line interface) applications.

Styling

To adjust the look-and-feel to the host desktop system and the personal taste several styling options are available. Since all GUI applications are using the Qt4 library the tool "qtconfig-qt4" can used to adjust the widget theme and the colors. If KDE is used as desktop system the same style is used since KDE bases on Qt as well.

The style options supported by SC3 (and not covered by the general Qt setup) have to be given in the applications (or global) configuration file. The parameters are prefixed with scheme..

It follows a list of all available options:

# Show menu bar: default = true
scheme.showMenu

# Show status bar: default = true
scheme.showStatusBar

# Set position if tab bar: default = let the application decide
# This option might not be supported by all applications
# Positions: off, north, south, east, west
scheme.tabPosition

# A general application background color. Can be uses to give
# each application a different background color.
# Default: let Qt decide
scheme.colors.background

# A general trace color of records.
# Default: 808080
scheme.colors.records.foreground

# A general trace color of the alternate trace
# (e.g. scheli).
# Default: 808080
scheme.colors.records.alternateForeground

# The color of gaps in trace views.
# Default: FFFF0032
scheme.colors.records.gaps

# The color of manual picks (e.g. scrttv,
# manual picker).
# Default: 00FF00
scheme.colors.picks.manual

# The color of automatic picks.
# Default: FF0000
scheme.colors.picks.automatic

# The color of picks with undefined state.
# Default: A0A0A4
scheme.colors.picks.undefined

# The color of disabled picks.
# Default: A0A0A4
scheme.colors.picks.disabled

# The color of manual arrivals (arrivals
# that bind manual picks, e.g. residual
# plot of scolv, manual picker, ...)
# Default: 00A000
scheme.colors.arrivals.manual

# The color of automatic arrivals
# Default: A00000
scheme.colors.arrivals.automatic

# The color of theoretical arrivals
# Default: 0000A0
scheme.colors.arrivals.theoretical

# The color of undefined arrivals
# Default: A00000
scheme.colors.arrivals.undefined

# The color of disabled arrivals
# Default: A0A0A4
scheme.colors.arrivals.disabled

# The gradient of arrivals residuals. A gradient is defined as
# a list of tuples separated by colon where the first item is
# the value and the second is the color. Colors can be given in
# rgb notation or hex. when rgb is used double quotes are needed to
# protect the comma inside the rgb definition.
# Default: -8:"rgb(0,0,100)", -4:"rgb(0,0,255)", -3:"rgb(100,100,255)", ...
scheme.colors.arrivals.residuals

# The color of active magnitudes
# Default: 00A000
scheme.colors.magnitudes.set

# The color of inactive magnitudes
# Default: 00000000
scheme.colors.magnitudes.unset

# The color of disabled magnitudes
# Default: A0A0A4
scheme.colors.magnitudes.disabled

# The gradient of magnitude residuals
scheme.colors.magnitudes.residuals

# The color of associated stations (e.g. in scmv)
# Default: 82AD58
scheme.colors.stations.associated

# The color of triggered stations
scheme.colors.stations.triggering
scheme.colors.stations.triggered0
scheme.colors.stations.triggered1
scheme.colors.stations.triggered2

# The color of disabled stations
scheme.colors.stations.disabled

# The color of idle stations
scheme.colors.stations.idle

# The color of QC.delay in scmv
scheme.colors.qc.delay0
scheme.colors.qc.delay1
scheme.colors.qc.delay2
scheme.colors.qc.delay3
scheme.colors.qc.delay4
scheme.colors.qc.delay5
scheme.colors.qc.delay6
scheme.colors.qc.delay7
scheme.colors.qc.qcWarning
scheme.colors.qc.qcError
scheme.colors.qc.qcOk
scheme.colors.qc.qcNotSet

# The color of ground motion amplitudes
scheme.colors.gm.gm0
scheme.colors.gm.gm1
scheme.colors.gm.gm2
scheme.colors.gm.gm3
scheme.colors.gm.gm4
scheme.colors.gm.gm5
scheme.colors.gm.gm6
scheme.colors.gm.gm7
scheme.colors.gm.gm8
scheme.colors.gm.gm9
scheme.colors.gm.gmNotSet

# The color of the selected zoom are
# (e.g. manual picker).
# Default: C0C0FFC0
scheme.colors.recordView.selectedTraceZoom

# The color of lines in the map (e.g. lines
# connecting the origin and a station).
scheme.colors.map.lines

# The color of station outlines in the map.
scheme.colors.map.outlines

# The color grid line color of the map.
scheme.colors.map.grid

# The color of station annotations.
scheme.colors.map.stationAnnotations

# The color of city labels.
scheme.colors.map.cityLabels

# The color of city outlines.
scheme.colors.map.cityOutlines

# The color of a capital.
scheme.colors.map.cityCapital

# The color of a "normal" city.
scheme.colors.map.cityNormal

# The map legend background color.
scheme.colors.legend.background

# The map legend border color.
scheme.colors.legend.border

# The map legend text color.
scheme.colors.legend.text

# The map legend header color.
scheme.colors.legend.headerText

# The origin symbol depth colors.
scheme.colors.originSymbol.depth50
scheme.colors.originSymbol.depth100
scheme.colors.originSymbol.depth250
scheme.colors.originSymbol.depth600
scheme.colors.originSymbol.depthDeep

# The origin status colors (e.g. in event list)
scheme.colors.originStatus.automatic
scheme.colors.originStatus.manual

# The line width of the marker (e.g. picks of manual picker)
scheme.marker.lineWidth

# The font definitions.
scheme.fonts.base
scheme.fonts.small
scheme.fonts.normal
scheme.fonts.large
scheme.fonts.highlight
scheme.fonts.heading1
scheme.fonts.heading2
scheme.fonts.heading3
scheme.fonts.cityLabels

# The station symbol size (e.g. in scmv).
scheme.map.stationSize

# Should the vector layer in the map use
# antialiasing? This improves the visual
# quality but decreases the performance.
scheme.map.vectorLayerAntiAlias

# Should the map use a bilinear filter?
# The bilinear filter improves the visual quality
# but decreases the performance slightly. It is only
# used for static map images. Not while dragging.
# Default: true
scheme.map.bilinearFilter

# Should the map display the grid?
# Default: true
scheme.map.showGrid

# Should the map display the custom layers?
# Default: true
scheme.map.showLayers

# Should the map display the cities?
# Default: true
scheme.map.showCities

# The precision of displayed depth values.
# Default: 0
scheme.precision.depth

# The precision of displayed distance values.
# Default: 1
scheme.precision.distance

# The precision of displayed lat/lon values.
# Default: 2
scheme.precision.location

# The precision of displayed pick times.
# Default: 1
scheme.precision.pickTime

# Display distances in km?
# Default: false
scheme.unit.distanceInKM

Configuration syntax

Beside the usual integer, float, boolean and string parameters GUI applications support also color, color gradient and font parameters. The syntax is explained below:

Colors

color = RRGGBBAA | "rgb(red,green,blue)" | "rgba(red,green,blue,alpha)"

Colors are specified either in a hexadecimal notation or in a rgb(a) notation. When using the rgb(a) notation it should be quoted. Otherwise the configuration parser would tokenize the value into 3 or 4 strings due to the comma.

Color gradients

gradient = 1:FF0000, 2:00FF00, 3:0000FF

This defines a gradient from red through green to blue for the nodes 1, 2 and 3. Values out of range are clipped to the lower or upper bound.

Fonts

# The font family
font.family = "Arial"

# Point size
font.size = 12

# Bold?
# Default: false
font.bold = false

# Italic?
# Default: false
font.italic = false

# Underline?
# Default: false
font.underline = false

# Overline?
# Default: false
font.overline = false

An example to configure the SC3 base font:

scheme.fonts.base.family = "Arial"
scheme.fonts.base.size = 10