Q3DTheme Class
Q3DTheme class provides a visual style for graphs. More...
| Header: | #include <Q3DTheme> |
| Since: | QtDataVisualization 1.0 |
| Instantiated By: | Theme3D |
| Inherits: | QObject |
Public Types
| enum | ColorStyle { ColorStyleUniform, ColorStyleObjectGradient, ColorStyleRangeGradient } |
| enum | Theme { ThemeQt, ThemePrimaryColors, ThemeDigia, ThemeStoneMoss, ..., ThemeUserDefined } |
Properties
|
|
- 1 property inherited from QObject
Public Functions
| Q3DTheme(QObject *parent = Q_NULLPTR) | |
| Q3DTheme(Theme themeType, QObject *parent = Q_NULLPTR) | |
| virtual | ~Q3DTheme() |
| float | ambientLightStrength() const |
| QColor | backgroundColor() const |
| QList<QColor> | baseColors() const |
| QList<QLinearGradient> | baseGradients() const |
| ColorStyle | colorStyle() const |
| QFont | font() const |
| QColor | gridLineColor() const |
| float | highlightLightStrength() const |
| bool | isBackgroundEnabled() const |
| bool | isGridEnabled() const |
| bool | isLabelBackgroundEnabled() const |
| bool | isLabelBorderEnabled() const |
| QColor | labelBackgroundColor() const |
| QColor | labelTextColor() const |
| QColor | lightColor() const |
| float | lightStrength() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| void | setAmbientLightStrength(float strength) |
| void | setBackgroundColor(const QColor &color) |
| void | setBackgroundEnabled(bool enabled) |
| void | setBaseColors(const QList<QColor> &colors) |
| void | setBaseGradients(const QList<QLinearGradient> &gradients) |
| void | setColorStyle(ColorStyle style) |
| void | setFont(const QFont &font) |
| void | setGridEnabled(bool enabled) |
| void | setGridLineColor(const QColor &color) |
| void | setHighlightLightStrength(float strength) |
| void | setLabelBackgroundColor(const QColor &color) |
| void | setLabelBackgroundEnabled(bool enabled) |
| void | setLabelBorderEnabled(bool enabled) |
| void | setLabelTextColor(const QColor &color) |
| void | setLightColor(const QColor &color) |
| void | setLightStrength(float strength) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setSingleHighlightColor(const QColor &color) |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
| void | setType(Theme themeType) |
| void | setWindowColor(const QColor &color) |
| QColor | singleHighlightColor() const |
| QLinearGradient | singleHighlightGradient() const |
| Theme | type() const |
| QColor | windowColor() const |
- 31 public functions inherited from QObject
Signals
| void | ambientLightStrengthChanged(float strength) |
| void | backgroundColorChanged(const QColor &color) |
| void | backgroundEnabledChanged(bool enabled) |
| void | baseColorsChanged(const QList<QColor> &colors) |
| void | baseGradientsChanged(const QList<QLinearGradient> &gradients) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | fontChanged(const QFont &font) |
| void | gridEnabledChanged(bool enabled) |
| void | gridLineColorChanged(const QColor &color) |
| void | highlightLightStrengthChanged(float strength) |
| void | labelBackgroundColorChanged(const QColor &color) |
| void | labelBackgroundEnabledChanged(bool enabled) |
| void | labelBorderEnabledChanged(bool enabled) |
| void | labelTextColorChanged(const QColor &color) |
| void | lightColorChanged(const QColor &color) |
| void | lightStrengthChanged(float strength) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | typeChanged(Q3DTheme::Theme themeType) |
| void | windowColorChanged(const QColor &color) |
- 2 signals inherited from QObject
Additional Inherited Members
- 1 public slot inherited from QObject
- 11 static public members inherited from QObject
- 9 protected functions inherited from QObject
Detailed Description
Q3DTheme class provides a visual style for graphs.
Q3DTheme 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 ThemeUserDefined. Creating a theme using the default constructor produces a new user-defined theme.
Properties controlled by theme
| Property | Effect | Default in ThemeUserDefined |
|---|---|---|
| ambientLightStrength | The strength of the ambient light in the graph. This affects how evenly and brightly the colors are shown throughout the graph regardless of light position. | 0.25 |
| backgroundColor | Color of the graph background. | Qt::black |
| backgroundEnabled | Is the graph background drawn or not. | true |
| baseColors | List of colors for the objects in the graph. Colors are applied to series one by one. If there are more series than colors, the color list is reused from the start. The colors in this property are used if colorStyle is ColorStyleUniform. This can be overridden by setting the baseColor explicitly in series. | Qt::black |
| baseGradients | List of gradients for the objects in the graph. Gradients are applied to series one by one. If there are more series than gradients, the gradient list is reused from the start. The gradients in this property are used if colorStyle is ColorStyleObjectGradient or ColorStyleRangeGradient. This can be overridden by setting the baseGradient explicitly in series. | QLinearGradient(). Essentially fully black. |
| colorStyle | The color style of the objects in the graph. See ColorStyle for detailed description of the styles. This can be overridden by setting the colorStyle explicitly in series. | ColorStyleUniform |
| font | The font to be used for labels. | QFont() |
| gridEnabled | Is the grid on the background drawn or not. This affects all grid lines. | true |
| gridLineColor | The color for the grid lines. | Qt::white |
| highlightLightStrength | The specular light strength for highlighted objects. | 7.5 |
| labelBackgroundColor | The color of the label background. This property has no effect if labelBackgroundEnabled is false. | Qt::gray |
| labelBackgroundEnabled | Are the labels to be drawn with a background using labelBackgroundColor (including alpha), or with a fully transparent background. Labels with background are drawn to equal sizes per axis based on the longest label, and the text is centered in it. Labels without background are drawn as is and are left/right aligned based on their position in the graph. | true |
| labelBorderEnabled | Are the labels to be drawn with a border or not. This property affects only labels with a background. | true |
| labelTextColor | The color for the font used in labels. | Qt::white |
| lightColor | The color of the light. Affects both ambient and specular light. | Qt::white |
| lightStrength | The strength of the specular light in the graph. This affects the light specified in Q3DScene. | 5.0 |
| multiHighlightColor | The color to be used for highlighted objects, if selectionMode of the graph has QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn flag set. | Qt::blue |
| multiHighlightGradient | The gradient to be used for highlighted objects, if selectionMode of the graph has QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn flag set. | QLinearGradient(). Essentially fully black. |
| singleHighlightColor | The color to be used for a highlighted object, if selectionMode of the graph has QAbstract3DGraph::SelectionItem flag set. | Qt::red |
| singleHighlightGradient | The gradient to be used for a highlighted object, if selectionMode of the graph has QAbstract3DGraph::SelectionItem flag set. | QLinearGradient(). Essentially fully black. |
| windowColor | The color of the window the graph is drawn into. | Qt::black |
Usage examples
Creating a built-in theme without any modifications:
Creating a built-in theme and modifying some properties:
Q3DTheme *theme = new Q3DTheme(Q3DTheme::ThemeQt); theme->setBackgroundEnabled(false); theme->setLabelBackgroundEnabled(false);
Creating a user-defined theme:
Q3DTheme *theme = new Q3DTheme(); theme->setAmbientLightStrength(0.3f); theme->setBackgroundColor(QColor(QRgb(0x99ca53))); theme->setBackgroundEnabled(true); theme->setBaseColor(QColor(QRgb(0x209fdf))); theme->setColorStyle(Q3DTheme::ColorStyleUniform); theme->setFont(QFont(QStringLiteral("Impact"), 35)); theme->setGridEnabled(true); theme->setGridLineColor(QColor(QRgb(0x99ca53))); theme->setHighlightLightStrength(7.0f); theme->setLabelBackgroundColor(QColor(0xf6, 0xa6, 0x25, 0xa0)); theme->setLabelBackgroundEnabled(true); theme->setLabelBorderEnabled(true); theme->setLabelTextColor(QColor(QRgb(0x404044))); theme->setLightColor(Qt::white); theme->setLightStrength(6.0f); theme->setMultiHighlightColor(QColor(QRgb(0x6d5fd5))); theme->setSingleHighlightColor(QColor(QRgb(0xf6a625))); theme->setWindowColor(QColor(QRgb(0xffffff)));
Creating a built-in theme and modifying some properties after it has been set:
Member Type Documentation
enum Q3DTheme::ColorStyle
Color styles.
| Constant | Value | Description |
|---|---|---|
Q3DTheme::ColorStyleUniform | 0 | Objects are rendered in a single color. The color used is specified in baseColors, singleHighlightColor and multiHighlightColor properties. |
Q3DTheme::ColorStyleObjectGradient | 1 | Objects are colored using a full gradient for each object regardless of object height. The gradient used is specified in baseGradients, singleHighlightGradient and multiHighlightGradient properties. |
Q3DTheme::ColorStyleRangeGradient | 2 | Objects are colored using a portion of the full gradient determined by the object's height and its position on the Y-axis. The gradient used is specified in baseGradients, singleHighlightGradient and multiHighlightGradient properties. |
enum Q3DTheme::Theme
Built-in themes.
| Constant | Value | Description |
|---|---|---|
Q3DTheme::ThemeQt | 0 | A light theme with green as the base color. |
Q3DTheme::ThemePrimaryColors | 1 | A light theme with yellow as the base color. |
Q3DTheme::ThemeDigia | 2 | A light theme with gray as the base color. |
Q3DTheme::ThemeStoneMoss | 3 | A medium dark theme with yellow as the base color. |
Q3DTheme::ThemeArmyBlue | 4 | A medium light theme with blue as the base color. |
Q3DTheme::ThemeRetro | 5 | A medium light theme with brown as the base color. |
Q3DTheme::ThemeEbony | 6 | A dark theme with white as the base color. |
Q3DTheme::ThemeIsabelle | 7 | A dark theme with yellow as the base color. |
Q3DTheme::ThemeUserDefined | 8 | A user-defined theme. See Properties controlled by theme for theme defaults. |
Property Documentation
ambientLightStrength : float
Ambient light strength for the whole graph. Value must be between 0.0f and 1.0f.
Access functions:
| float | ambientLightStrength() const |
| void | setAmbientLightStrength(float strength) |
Notifier signal:
| void | ambientLightStrengthChanged(float strength) |
backgroundColor : QColor
Color for the graph background.
Access functions:
| QColor | backgroundColor() const |
| void | setBackgroundColor(const QColor &color) |
Notifier signal:
| void | backgroundColorChanged(const QColor &color) |
backgroundEnabled : bool
Set background enabled or disabled.
Access functions:
| bool | isBackgroundEnabled() const |
| void | setBackgroundEnabled(bool enabled) |
Notifier signal:
| void | backgroundEnabledChanged(bool enabled) |
baseColors : QList<QColor>
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 ColorStyleUniform.
Access functions:
| QList<QColor> | baseColors() const |
| void | setBaseColors(const QList<QColor> &colors) |
Notifier signal:
| void | baseColorsChanged(const QList<QColor> &colors) |
baseGradients : QList<QLinearGradient>
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 ColorStyleUniform.
Access functions:
| QList<QLinearGradient> | baseGradients() const |
| void | setBaseGradients(const QList<QLinearGradient> &gradients) |
Notifier signal:
| void | baseGradientsChanged(const QList<QLinearGradient> &gradients) |
colorStyle : ColorStyle
The style of the graph colors. One of ColorStyle.
Access functions:
| ColorStyle | colorStyle() const |
| void | setColorStyle(ColorStyle style) |
Notifier signal:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
font : QFont
Set font to be used for labels.
Access functions:
| QFont | font() const |
| void | setFont(const QFont &font) |
Notifier signal:
| void | fontChanged(const QFont &font) |
gridEnabled : bool
Set grid lines enabled or disabled.
Access functions:
| bool | isGridEnabled() const |
| void | setGridEnabled(bool enabled) |
Notifier signal:
| void | gridEnabledChanged(bool enabled) |
gridLineColor : QColor
Color for the grid lines.
Access functions:
| QColor | gridLineColor() const |
| void | setGridLineColor(const QColor &color) |
Notifier signal:
| void | gridLineColorChanged(const QColor &color) |
highlightLightStrength : float
Specular light strength for highlighted objects. Value must be between 0.0f and 10.0f.
Access functions:
| float | highlightLightStrength() const |
| void | setHighlightLightStrength(float strength) |
Notifier signal:
| void | highlightLightStrengthChanged(float strength) |
labelBackgroundColor : QColor
Color for the label backgrounds. Has no effect if labelBackgroundEnabled is false.
Access functions:
| QColor | labelBackgroundColor() const |
| void | setLabelBackgroundColor(const QColor &color) |
Notifier signal:
| void | labelBackgroundColorChanged(const QColor &color) |
labelBackgroundEnabled : bool
Set label backgrounds enabled or disabled.
Access functions:
| bool | isLabelBackgroundEnabled() const |
| void | setLabelBackgroundEnabled(bool enabled) |
Notifier signal:
| void | labelBackgroundEnabledChanged(bool enabled) |
labelBorderEnabled : bool
Set label borders enabled or disabled. Has no effect if labelBackgroundEnabled is false.
Access functions:
| bool | isLabelBorderEnabled() const |
| void | setLabelBorderEnabled(bool enabled) |
Notifier signal:
| void | labelBorderEnabledChanged(bool enabled) |
labelTextColor : QColor
Color for the font used for labels.
Access functions:
| QColor | labelTextColor() const |
| void | setLabelTextColor(const QColor &color) |
Notifier signal:
| void | labelTextColorChanged(const QColor &color) |
lightColor : QColor
Color for the specular light defined in Q3DScene.
Access functions:
| QColor | lightColor() const |
| void | setLightColor(const QColor &color) |
Notifier signal:
| void | lightColorChanged(const QColor &color) |
lightStrength : float
Specular light strength for the whole graph. Value must be between 0.0f and 10.0f.
Access functions:
| float | lightStrength() const |
| void | setLightStrength(float strength) |
Notifier signal:
| void | lightStrengthChanged(float strength) |
multiHighlightColor : QColor
Highlight color for highlighted objects. Used if selectionMode has QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn flag set.
Access functions:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(const QColor &color) |
Notifier signal:
| void | multiHighlightColorChanged(const QColor &color) |
multiHighlightGradient : QLinearGradient
Highlight gradient for highlighted objects. Used if selectionMode has QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn flag set.
Access functions:
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
Notifier signal:
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
singleHighlightColor : QColor
Highlight color for a highlighted object. Used if selectionMode has QAbstract3DGraph::SelectionItem flag set.
Access functions:
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(const QColor &color) |
Notifier signal:
| void | singleHighlightColorChanged(const QColor &color) |
singleHighlightGradient : QLinearGradient
Highlight gradient for a highlighted object. Used if selectionMode has QAbstract3DGraph::SelectionItem flag set.
Access functions:
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
Notifier signal:
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
type : Theme
The type of the theme. The type is automatically set when constructing a theme, but can also be changed later. Changing the theme type 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.
Access functions:
| Theme | type() const |
| void | setType(Theme themeType) |
Notifier signal:
| void | typeChanged(Q3DTheme::Theme themeType) |
windowColor : QColor
Color for the application window.
Access functions:
| QColor | windowColor() const |
| void | setWindowColor(const QColor &color) |
Notifier signal:
| void | windowColorChanged(const QColor &color) |
Member Function Documentation
Q3DTheme::Q3DTheme(QObject *parent = Q_NULLPTR)
Constructs a new theme of type ThemeUserDefined. An optional parent parameter can be given and is then passed to QObject constructor.
Q3DTheme::Q3DTheme(Theme themeType, QObject *parent = Q_NULLPTR)
Constructs a new theme with themeType, which can be one of the built-in themes from Theme. An optional parent parameter can be given and is then passed to QObject constructor.
[virtual] Q3DTheme::~Q3DTheme()
Destroys the theme.
© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.