Qt 5.11 | Qt Data Visualization | C++ Classes | Q3DTheme

Qt Data Visualization | Commercial or GPLv3

# Q3DTheme Class

Q3DTheme class provides a visual style for graphs. More...

Header: | #include <Q3DTheme>
Since: | QtDataVisualization 1.0
Instantiated By: | Theme3D

- List of all members, including inherited members

## Public Types

enum | ColorStyle { ColorStyleUniform, ColorStyleObjectGradient, ColorStyleRangeGradient }
enum | Theme { ThemeQt, ThemePrimaryColors, ThemeDigia, ThemeStoneMoss, ..., ThemeUserDefined }

## Properties

- ambientLightStrength : float
- backgroundColor : QColor
- backgroundEnabled : bool
- baseColors : QList<QColor>
- baseGradients : QList<QLinearGradient>
- colorStyle : ColorStyle
- font : QFont
- gridEnabled : bool
- gridLineColor : QColor
- highlightLightStrength : float
- labelBackgroundColor : QColor

- labelBackgroundEnabled : bool
- labelBorderEnabled : bool
- labelTextColor : QColor
- lightColor : QColor
- lightStrength : float
- multiHighlightColor : QColor
- multiHighlightGradient : QLinearGradient
- singleHighlightColor : QColor
- singleHighlightGradient : QLinearGradient
- type : Theme
- windowColor : QColor

## Public Functions

| Q3DTheme(QObject *parent = nullptr)
| Q3DTheme(Q3DTheme::Theme themeType, QObject *parent = nullptr)
virtual | ~Q3DTheme()
float | ambientLightStrength() const
QColor | backgroundColor() const
QList<QColor> | baseColors() const
QList<QLinearGradient> | baseGradients() const
Q3DTheme::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(Q3DTheme::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(Q3DTheme::Theme themeType)
void | setWindowColor(const QColor &color)
QColor | singleHighlightColor() const
QLinearGradient | singleHighlightGradient() const
Q3DTheme::Theme | type() const
QColor | windowColor() const

## 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)

## Detailed Description

Q3DTheme class provides a visual style for graphs.

Specifies visual properties that affect the whole graph. There are several built-in themes that can be used as is or modified freely.

The following properties can be overridden by using QAbstract3DSeries properties to set them explicitly in the series: baseColors, baseGradients, and colorStyle.

Themes can be created from scratch using the ThemeUserDefined enum value. Creating a theme using the default constructor produces a new user-defined theme.

### Default Theme

The following table lists the properties controlled by themes and the default values for ThemeUserDefined.

Property | Default Value
--- | ---
ambientLightStrength | 0.25
backgroundColor | Qt::black
backgroundEnabled | `true`
baseColors | Qt::black
baseGradients | QLinearGradient. Essentially fully black.
colorStyle | ColorStyleUniform
font | QFont
gridEnabled | `true`
gridLineColor | Qt::white
highlightLightStrength | 7.5
labelBackgroundColor | Qt::gray
labelBackgroundEnabled | `true`
labelBorderEnabled | `true`
labelTextColor | Qt::white
lightColor | Qt::white
lightStrength | 5.0
multiHighlightColor | Qt::blue
multiHighlightGradient | QLinearGradient. Essentially fully black.
singleHighlightColor | Qt::red
singleHighlightGradient | QLinearGradient. Essentially fully black.
windowColor | Qt::black

### Usage Examples

Creating a built-in theme without any modifications:

      Q3DTheme *theme = new Q3DTheme(Q3DTheme::ThemeQt);

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:

      Q3DBars *graph = new Q3DBars();
      graph->activeTheme()->setType(Q3DTheme::ThemePrimaryColors);
      graph->activeTheme()->setBaseColor(Qt::red);
      graph->activeTheme()->setSingleHighlightColor(Qt::yellow);

## 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. For more information, see Default Theme.

## Property Documentation

### ambientLightStrength : float

This property holds the ambient light strength for the whole graph.

This value determines how evenly and brightly the colors are shown throughout the graph regardless of the light position.

The 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

This property holds the color of the graph background.

Access functions:

QColor | backgroundColor() const
void | setBackgroundColor(const QColor &color)

Notifier signal:

void | backgroundColorChanged(const QColor &color)

### backgroundEnabled : bool

This property holds whether the background is visible.

The background is drawn by using the value of backgroundColor.

Access functions:

bool | isBackgroundEnabled() const
void | setBackgroundEnabled(bool enabled)

Notifier signal:

void | backgroundEnabledChanged(bool enabled)

### baseColors : QList<QColor>

This property holds the list of base colors to be used for all the objects in the graph, series by series.

If there are more series than colors, the color list wraps and starts again with the first color in the list.

Has no immediate effect if colorStyle is not ColorStyleUniform.

This value can be overridden by setting the baseColor explicitly in the series.

Access functions:

QList<QColor> | baseColors() const
void | setBaseColors(const QList<QColor> &colors)

Notifier signal:

void | baseColorsChanged(const QList<QColor> &colors)

### baseGradients : QList<QLinearGradient>

This property holds the list of base gradients to be used for all the objects in the graph, series by series.

If there are more series than gradients, the gradient list wraps and starts again with the first gradient in the list

Has no immediate effect if colorStyle is ColorStyleUniform.

This value can be overridden by setting the baseGradient explicitly in the series.

Access functions:

QList<QLinearGradient> | baseGradients() const
void | setBaseGradients(const QList<QLinearGradient> &gradients)

Notifier signal:

void | baseGradientsChanged(const QList<QLinearGradient> &gradients)

### colorStyle : ColorStyle

This property holds the style of the graph colors.

One of the ColorStyle enum values.

This value can be overridden by setting colorStyle explicitly in the series.

Access functions:

Q3DTheme::ColorStyle | colorStyle() const
void | setColorStyle(Q3DTheme::ColorStyle style)

Notifier signal:

void | colorStyleChanged(Q3DTheme::ColorStyle style)

### font : QFont

This property holds the 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

This property holds whether the grid lines are drawn.

This value affects all grid lines.

Access functions:

bool | isGridEnabled() const
void | setGridEnabled(bool enabled)

Notifier signal:

void | gridEnabledChanged(bool enabled)

### gridLineColor : QColor

This property holds the color of the grid lines.

Access functions:

QColor | gridLineColor() const
void | setGridLineColor(const QColor &color)

Notifier signal:

void | gridLineColorChanged(const QColor &color)

### highlightLightStrength : float

This property holds the specular light strength for selected objects.

The 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

This property holds the color of 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

This property holds whether the label is drawn with a color background or with a fully transparent background.

The labelBackgroundColor value (including alpha) is used for drawing the background.

Labels with a background are drawn to equal sizes per axis based on the longest label, and the text is centered in them. Labels without a background are drawn as is and are left or right aligned based on their position in the graph.

Access functions:

bool | isLabelBackgroundEnabled() const
void | setLabelBackgroundEnabled(bool enabled)

Notifier signal:

void | labelBackgroundEnabledChanged(bool enabled)

### labelBorderEnabled : bool

This property holds whether label borders are drawn for labels that have a background.

Has no effect if labelBackgroundEnabled is `false`.

Access functions:

bool | isLabelBorderEnabled() const
void | setLabelBorderEnabled(bool enabled)

Notifier signal:

void | labelBorderEnabledChanged(bool enabled)

### labelTextColor : QColor

This property holds the color of the font used for labels.

Access functions:

QColor | labelTextColor() const
void | setLabelTextColor(const QColor &color)

Notifier signal:

void | labelTextColorChanged(const QColor &color)

### lightColor : QColor

This property holds the color for the ambient and specular light.

This value affects the light specified in Q3DScene.

Access functions:

QColor | lightColor() const
void | setLightColor(const QColor &color)

Notifier signal:

void | lightColorChanged(const QColor &color)

### lightStrength : float

This property holds the specular light strength for the whole graph.

The value must be between `0.0f` and `10.0f`.

This value affects the light specified in Q3DScene.

Access functions:

float | lightStrength() const
void | setLightStrength(float strength)

Notifier signal:

void | lightStrengthChanged(float strength)

### multiHighlightColor : QColor

This property holds the highlight color for selected objects.

Used if selectionMode has the `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

This property holds the highlight gradient for selected objects.

Used if selectionMode has the `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

This property holds the highlight color for a selected object.

Used if selectionMode has the `QAbstract3DGraph::SelectionItem` flag set.

Access functions:

QColor | singleHighlightColor() const
void | setSingleHighlightColor(const QColor &color)

Notifier signal:

void | singleHighlightColorChanged(const QColor &color)

### singleHighlightGradient : QLinearGradient

This property holds the highlight gradient for a selected object.

Used if selectionMode has the `QAbstract3DGraph::SelectionItem` flag set.

Access functions:

QLinearGradient | singleHighlightGradient() const
void | setSingleHighlightGradient(const QLinearGradient &gradient)

Notifier signal:

void | singleHighlightGradientChanged(const QLinearGradient &gradient)

### type : Theme

This property holds 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:

Q3DTheme::Theme | type() const
void | setType(Q3DTheme::Theme themeType)

Notifier signal:

void | typeChanged(Q3DTheme::Theme themeType)

### windowColor : QColor

This property holds the color of the application window the graph is drawn into.

Access functions:

QColor | windowColor() const
void | setWindowColor(const QColor &color)

Notifier signal:

void | windowColorChanged(const QColor &color)

## Member Function Documentation

### Q3DTheme::Q3DTheme(QObject *parent = nullptr)

Constructs a new theme of type ThemeUserDefined. An optional parent parameter can be given and is then passed to QObject constructor.

### Q3DTheme::Q3DTheme(Q3DTheme::Theme themeType, QObject *parent = 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.