Blend2D
2D Vector Graphics Engine
About
Roadmap
Performance
Docs
Blog
Research
Support
Download
{Fiddle}
Index ⭢ Text ⭢ BLFontVariationSettings
BLFontVariationSettings Class Referencefinal

Font variation settings [C++ API].

Member Functions

Construction & Destruction
BLFontVariationSettings() noexcept
BLFontVariationSettings(BLFontVariationSettings&& other) noexcept
BLFontVariationSettings(const BLFontVariationSettings& other) noexcept
~BLFontVariationSettings() noexcept
Overloaded Operators
BLFontVariationSettings& operator=(BLFontVariationSettings&& other) noexcept
BLFontVariationSettings& operator=(const BLFontVariationSettings& other) noexcept
bool operator==(const BLFontVariationSettings& other) const noexcept
bool operator!=(const BLFontVariationSettings& other) const noexcept
Common Functionality
BLResult reset() noexcept
BLResult clear() noexcept
void swap(BLFontVariationSettings& other) noexcept
BLResult assign(BLFontVariationSettings&& other) noexcept
BLResult assign(const BLFontVariationSettings& other) noexcept
Accessors
bool empty() const noexcept
size_t size() const noexcept
size_t capacity() const noexcept
BLResult getView(BLFontVariationSettingsView* out) const noexcept
bool hasValue(BLTag variationTag) const noexcept
float getValue(BLTag variationTag) const noexcept
BLResult setValue(BLTag variationTag, float value) noexcept
BLResult removeValue(BLTag variationTag) noexcept
Equality & Comparison
bool equals(const BLFontVariationSettings& other) const noexcept

Additional Inherited Members

- Public Attributes inherited from BLObjectCore

bool BLFontVariationSettings::empty() constnoexcept[¶]

Tests whether the container is empty, which means that no tag/value pairs are stored in it.

size_t BLFontVariationSettings::size() constnoexcept[¶]

Returns the number of tag/value pairs stored in the container.

size_t BLFontVariationSettings::capacity() constnoexcept[¶]

Returns the container capacity.

Note
If the container is in SSO mode, it would return the SSO capacity, however, such capacity can only be used for simple tag/value pairs (where the tag is known by Blend2D and has associated an internal ID that represents it).

BLResult BLFontVariationSettings::getView(
BLFontVariationSettingsView* out
) constnoexcept[¶]

Returns a normalized view of tag/value pairs as an iterable BLFontVariationItem array in the output view.

Note
If the container is in SSO mode then all BLFontVariationItem values will be created from the underlying SSO representation and BLFontVariationSettingsView::data will point to BLFontVariationSettingsView::ssoData. If the container is dynamic, BLFontVariationSettingsView::ssoData won't be initialized and BLFontVariationSettingsView::data will point to the container's data. This means that the view cannot outlive the container, and also during iteration the view the container cannot be modified as that could invalidate the entire view.

bool BLFontVariationSettings::hasValue(
BLTag variationTag
) constnoexcept[¶]

Tests whether the settings contains the given variationTag.

float BLFontVariationSettings::getValue(
BLTag variationTag
) constnoexcept[¶]

Returns the value associated with the given variationTag.

If the variationTag doesn't exist or is invalid NaN is returned.

BLResult BLFontVariationSettings::setValue(
BLTag variationTag,
float value
)noexcept[¶]

Sets or inserts the given variationTag to the settings and associates it with the given value.

BLResult BLFontVariationSettings::removeValue(
BLTag variationTag
)noexcept[¶]

Removes the given variationTag and its value from the settings.

Nothing happens if the variationTag is not in the settings (BL_SUCCESS is returned).

bool BLFontVariationSettings::equals(
const BLFontVariationSettings& other
) constnoexcept[¶]

Tests whether this font variation settings is equal to other - equality means that it has the same tag/value pairs.

© 2017-2024 Blend2D Team | GitHub | Chat | Support | Download
Blend2D library and its dependencies are open source software released under the Zlib license and can be used safely in any open-source or commercial product, statically or dynamically linked, and without advertising the use of Blend2D. Code snippets and examples are released into public domain, see Unlicense for more details.