QFontVariableAxis Class
The QFontVariableAxis class represents a variable axis in a font. More...
| Header: | #include <QFontVariableAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Since: | Qt 6.9 |
- List of all members, including inherited members
- QFontVariableAxis is part of Implicitly Shared Classes.
Note: All functions in this class are reentrant.
Public Functions
| QFontVariableAxis(const QFontVariableAxis &axis) | |
| ~QFontVariableAxis() | |
| qreal | defaultValue() const |
| qreal | maximumValue() const |
| qreal | minimumValue() const |
| QString | name() const |
| void | setDefaultValue(qreal defaultValue) |
| void | setMaximumValue(qreal maximumValue) |
| void | setMinimumValue(qreal minimumValue) |
| void | setName(const QString &name) |
| void | setTag(QFont::Tag tag) |
| QFont::Tag | tag() const |
| QFontVariableAxis & | operator=(const QFontVariableAxis &axis) |
Detailed Description
Variable fonts provide a way to store multiple variations (with different weights, widths or styles) in the same font file. The variations are given as floating point values for a pre-defined set of parameters, called "variable axes".
Specific parameterizations (sets of values for the axes in a font) can be selected using the properties in QFont, same as with traditional subfamilies that are defined as stand-alone font files. But with variable fonts, arbitrary values can be provided for each axis to gain a fine-grained customization of the font's appearance.
QFontVariableAxis contains information of one axis. Use QFontInfo::variableAxes() to retrieve a list of the variable axes defined for a given font. Specific values can be provided for an axis by using QFont::setVariableAxis() and passing in the tag().
Note: On Windows, variable axes are not supported if the optional GDI font backend is in use.
Member Function Documentation
QFontVariableAxis::QFontVariableAxis(const QFontVariableAxis &axis)
Creates a QFontVariableAxis object that is a copy of the given axis.
See also operator=().
[noexcept] QFontVariableAxis::~QFontVariableAxis()
Destroys this QFontVariableAxis object.
qreal QFontVariableAxis::defaultValue() const
Returns the default value of the axis. This is the value the axis will have if none has been provided in the QFont query.
Note: Getter function for property defaultValue.
See also setDefaultValue(), minimumValue(), and maximumValue().
qreal QFontVariableAxis::maximumValue() const
Returns the maximum value of the axis. Setting the axis to a value which is higher than this is not supported.
Note: Getter function for property maximumValue.
See also setMaximumValue(), minimumValue(), and defaultValue().
qreal QFontVariableAxis::minimumValue() const
Returns the minimum value of the axis. Setting the axis to a value which is lower than this is not supported.
Note: Getter function for property minimumValue.
See also setMinimumValue(), maximumValue(), and defaultValue().
QString QFontVariableAxis::name() const
Returns the name of the axis, if provided by the font.
Note: Getter function for property name.
void QFontVariableAxis::setDefaultValue(qreal defaultValue)
Sets the default value of this QFontVariableAxis to defaultValue.
Note: Typically, there will be no need to call this function as it will not affect the font itself, only this particular representation.
See also defaultValue().
void QFontVariableAxis::setMaximumValue(qreal maximumValue)
Sets the maximum value of this QFontVariableAxis to maximumValue.
Note: Typically, there will be no need to call this function as it will not affect the font itself, only this particular representation.
See also maximumValue().
void QFontVariableAxis::setMinimumValue(qreal minimumValue)
Sets the minimum value of this QFontVariableAxis to minimumValue.
Note: Typically, there will be no need to call this function as it will not affect the font itself, only this particular representation.
See also minimumValue().
void QFontVariableAxis::setName(const QString &name)
Sets the name of this QFontVariableAxis to name.
Note: Typically, there will be no need to call this function as it will not affect the font itself, only this particular representation.
See also name().
void QFontVariableAxis::setTag(QFont::Tag tag)
Sets the tag of QFontVariableAxis to tag.
Note: Typically, there will be no need to call this function as it will not affect the font itself, only this particular representation.
See also tag().
QFont::Tag QFontVariableAxis::tag() const
Returns the tag of the axis. This is a four-character sequence which identifies the axis. Certain tags have standardized meanings, such as "wght" (weight) and "wdth" (width), but any sequence of four latin-1 characters is a valid tag. By convention, non-standard/custom axes are denoted by tags in all uppercase.
See also setTag(), QFont::setVariableAxis(), and name().
QFontVariableAxis &QFontVariableAxis::operator=(const QFontVariableAxis &axis)
Assigns the given axis to this QFontVariableAxis.
See also QFontVariableAxis().
© 2024 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.
