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