QgsColorUtils Class Reference

Contains utility functions for working with colors. More...

#include <qgscolorutils.h>

Static Public Member Functions
static QColor	colorFromString (const QString &string)
	Decodes a string into a color value. More...
static QString	colorToString (const QColor &color)
	Encodes a color into a string value. More...
static QColor	readXml (const QDomElement &element, const QString &identifier, const QgsReadWriteContext &context)
	Reads a color from an XML element, matching the specified identifier string. More...
static void	writeXml (const QColor &color, const QString &identifier, QDomDocument &document, QDomElement &element, const QgsReadWriteContext &context)
	Writes a color to an XML element, storing it under the specified identifier. More...

Detailed Description

Contains utility functions for working with colors.

Since

QGIS 3.28

Definition at line 36 of file qgscolorutils.h.

Member Function Documentation

colorFromString()

QColor QgsColorUtils::colorFromString ( const QString &  string )

static

Decodes a string into a color value.

This method losslessly retrieves a color's definition from a string value. All properties of the color are restored, including the color specification and original values of the color's components. It is therefore suitable for restoring high color depth colors (such as 16 bit colors), or colors using alternative specifications such as CMYK colors.

An invalid color will be returned if the color could not be read.

See also

colorToString()

Definition at line 295 of file qgscolorutils.cpp.

colorToString()

QString QgsColorUtils::colorToString ( const QColor &  color )

static

Encodes a color into a string value.

This method losslessly stores a color's definition into a single string value. All properties of the color are stored, including the color specification and original values of the color's components. It is therefore suitable for storing high color depth colors (such as 16 bit colors), or colors using alternative specifications such as CMYK colors.

See also

colorFromString()

Definition at line 192 of file qgscolorutils.cpp.

readXml()

QColor QgsColorUtils::readXml ( const QDomElement &  element, const QString &  identifier, const QgsReadWriteContext &  context  )

static

Reads a color from an XML element, matching the specified identifier string.

This method losslessly retrieves a color's definition from an XML element. All properties of the color are restored, including the color specification and original values of the color's components. It is therefore suitable for restoring high color depth colors (such as 16 bit colors), or colors using alternative specifications such as CMYK colors.

An invalid color will be returned if the color could not be read.

See also

writeXml()

Definition at line 141 of file qgscolorutils.cpp.

writeXml()

void QgsColorUtils::writeXml ( const QColor &  color, const QString &  identifier, QDomDocument &  document, QDomElement &  element, const QgsReadWriteContext &  context  )

static

Writes a color to an XML element, storing it under the specified identifier.

This method losslessly stores a color's definition in an XML element. All properties of the color are stored, including the color specification and original values of the color's components. It is therefore suitable for storing high color depth colors (such as 16 bit colors), or colors using alternative specifications such as CMYK colors.

The identifier string is used to specify the element name for the stored color, allowing for multiple color definitions to be stored in a single element (assuming each uses a unique identifier string).

See also

readXml()

Definition at line 26 of file qgscolorutils.cpp.

---

The documentation for this class was generated from the following files:

• /build/qgis-3.28.0+99sid/src/core/qgscolorutils.h
• /build/qgis-3.28.0+99sid/src/core/qgscolorutils.cpp