Theme3D QML Type
A visual style for graphs. More...
| Import Statement: | import QtDataVisualization 1.2 |
| Since: | QtDataVisualization 1.0 |
| Instantiates: | Q3DTheme |
Properties
- ambientLightStrength : real
- backgroundColor : color
- backgroundEnabled : bool
- baseColors : list<ThemeColor>
- baseGradients : list<ColorGradient>
- colorStyle : Theme3D.ColorStyle
- font : font
- gridEnabled : bool
- gridLineColor : color
- highlightLightStrength : real
- labelBackgroundColor : color
- labelBackgroundEnabled : bool
- labelBorderEnabled : bool
- labelTextColor : color
- lightColor : color
- lightStrength : real
- multiHighlightColor : color
- multiHighlightGradient : ColorGradient
- singleHighlightColor : color
- singleHighlightGradient : ColorGradient
- type : Theme3D.Theme
- windowColor : color
Detailed Description
This type is used to specify visual properties that affect the whole graph. There are several built-in themes that can be used directly, or be modified freely. User can also create a theme from scratch using Theme3D.ThemeUserDefined.
For a more complete description, see Q3DTheme.
Usage examples
Using a built-in theme without any modifications:
Scatter3D {
...
theme: Theme3D { type: Theme3D.ThemeRetro }
...
}
Using a built-in theme and modifying some properties:
Bars3D {
...
theme: Theme3D {
type: Theme3D.ThemeRetro
labelBorderEnabled: true
font.pointSize: 35
labelBackgroundEnabled: false
}
...
}
Using a user-defined theme:
Surface3D {
...
theme: Theme3D {
ambientLightStrength: 0.5
backgroundColor: "red"
backgroundEnabled: true
baseColor: "blue"
colorStyle: Theme3D.ColorStyleUniform
font.family: "Lucida Handwriting"
font.pointSize: 35
gridEnabled: false
gridLineColor: "black"
highlightLightStrength: 0.5
labelBackgroundColor: "black"
labelBackgroundEnabled: true
labelBorderEnabled: false
labelTextColor: "white"
lightColor: "yellow"
lightStrength: 0.4
multiHighlightColor: "green"
singleHighlightColor: "darkRed"
windowColor: "white"
}
...
}
For Theme3D enums, see Q3DTheme::ColorStyle and Q3DTheme::Theme.
Property Documentation
Ambient light strength for the whole graph. Value must be between 0.0 and 1.0.
baseColors : list<ThemeColor> |
List of base colors to be used for all the objects in the graph, series by series. If there are more series than colors, color list wraps and starts again with the first color in the list. Has no immediate effect if colorStyle is not Theme3D.ColorStyleUniform.
baseGradients : list<ColorGradient> |
List of base gradients to be used for all the objects in the graph, series by series. If there are more series than gradients, gradient list wraps and starts again with the first gradient in the list Has no immediate effect if colorStyle is Theme3D.ColorStyleUniform.
colorStyle : Theme3D.ColorStyle |
The style of the graph colors. One of Theme3D.ColorStyle.
font : font |
Set font to be used for labels.
Specular light strength for highlighted objects. Value must be between 0.0 and 10.0.
Color for the label backgrounds. Has no effect if labelBackgroundEnabled is false.
Set label borders enabled or disabled. Has no effect if labelBackgroundEnabled is false.
Color for the specular light defined in Scene3D.
Specular light strength for the whole graph. Value must be between 0.0 and 10.0.
Highlight color for highlighted objects. Used if selectionMode has AbstractGraph3D.SelectionRow or AbstractGraph3D.SelectionColumn flag set.
multiHighlightGradient : ColorGradient |
Highlight gradient for highlighted objects. Used if selectionMode has AbstractGraph3D.SelectionRow or AbstractGraph3D.SelectionColumn flag set.
Highlight color for a highlighted object. Used if selectionMode has AbstractGraph3D.SelectionItem flag set.
singleHighlightGradient : ColorGradient |
Highlight gradient for a highlighted object. Used if selectionMode has AbstractGraph3D.SelectionItem flag set.
type : Theme3D.Theme |
The type of the theme. If no type is set, the type is Theme3D.ThemeUserDefined. Changing the theme type after the item has been constructed will change all other properties of the theme to what the predefined theme specifies. Changing the theme type of the active theme of the graph will also reset all attached series to use the new theme.