Blend2D

2D Vector Graphics Engine

About

Roadmap

Performance

Docs

Blog

Research

Support

Download

{Fiddle}

API Reference

Index Class List Globals Containers Geometries Imaging Styling Text Rendering Runtime Filesystem Miscellaneous Impl API Macros C API Object Model

Topics

Getting StartedBuild InstructionsMultithreaded Rendering

Index ⭢ Text ⭢ BLFontManager

BLFontManager Class Reference

Font manager [C++ API].

Member Functions

size_t faceCount() const noexcept

size_t familyCount() const noexcept

Construction & Destruction

BLFontManager() noexcept

BLFontManager(BLFontManager&& other) noexcept

BLFontManager(const BLFontManager& other) noexcept

~BLFontManager() noexcept

Overloaded Operators

BLFontManager& operator=(BLFontManager&& other) noexcept

BLFontManager& operator=(const BLFontManager& other) noexcept

bool operator==(const BLFontManager& other) const noexcept

bool operator!=(const BLFontManager& other) const noexcept

Common Functionality

BLResult reset() noexcept

void swap(BLFontManager& other) noexcept

BLResult assign(BLFontManager&& other) noexcept

BLResult assign(const BLFontManager& other) noexcept

bool isValid() const noexcept

bool equals(const BLFontManager& other) const noexcept

Create Functionality

BLResult create() noexcept

Face Management

bool hasFace(const BLFontFaceCore& face) const noexcept

BLResult addFace(const BLFontFaceCore& face) noexcept

BLResult queryFace(const char* name, BLFontFaceCore& out) const noexcept

BLResult queryFace(BLStringView name, BLFontFaceCore& out) const noexcept

BLResult queryFace(const char* name, const BLFontQueryProperties& properties, BLFontFaceCore& out) const noexcept

BLResult queryFace(BLStringView name, const BLFontQueryProperties& properties, BLFontFaceCore& out) const noexcept

BLResult queryFacesByFamilyName(const char* name, BLArray<BLFontFace>& out) const noexcept

BLResult queryFacesByFamilyName(BLStringView name, BLArray<BLFontFace>& out) const noexcept

Additional Inherited Members

 Public Attributes inherited from BLObjectCore

BLObjectDetail _d

bool BLFontManager::isValid() constnoexcept

Tests whether the font-manager is a valid FontManager and not a built-in default instance.

size_t BLFontManager::faceCount() constnoexcept

Returns the number of BLFontFace instances the font manager holds.

size_t BLFontManager::familyCount() constnoexcept

Returns the number of unique font families the font manager holds.

bool BLFontManager::hasFace(

const BLFontFaceCore& face

) constnoexcept

Tests whether the font manager contains the given font face.

BLResult BLFontManager::addFace(

const BLFontFaceCore& face

)noexcept

Adds a font face to the font manager.

Important result conditions:

• BL_SUCCESS is returned if the face was successfully added to font manager or if font manager already held it.
• BL_ERROR_FONT_NOT_INITIALIZED is returned if the font face is invalid.
• BL_ERROR_OUT_OF_MEMORY is returned if memory allocation failed.

BLResult BLFontManager::queryFace(

const char* name,

BLFontFaceCore& out

) constnoexcept[1/4]

Queries a font face by family name and stores the result to out.

BLResult BLFontManager::queryFace(

BLStringView name,

BLFontFaceCore& out

) constnoexcept[2/4]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLResult BLFontManager::queryFace(

const char* name,

const BLFontQueryProperties& properties,

BLFontFaceCore& out

) constnoexcept[3/4]

Queries a font face by family name and stores the result to out.

A properties parameter contains query properties that the query engine will consider when doing the match. The best candidate will be selected based on the following rules:

• Style has the highest priority.
• Weight has the lowest priority.

BLResult BLFontManager::queryFace(

BLStringView name,

const BLFontQueryProperties& properties,

BLFontFaceCore& out

) constnoexcept[4/4]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLResult BLFontManager::queryFacesByFamilyName(

const char* name,

BLArray<BLFontFace>& out

) constnoexcept[1/2]

Queries all font faces by family name and stores the result to out.

BLResult BLFontManager::queryFacesByFamilyName(

BLStringView name,

BLArray<BLFontFace>& out

) constnoexcept[2/2]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

More Information

About Blend2D

Project Roadmap

Performance Comparison

Documentation

Getting Started

Build Instructions

C/C++ API Reference

Support

Contact

Donation Options

Commercial Support

Get Blend2D

Download Page

Blend2D on GitHub

© 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.