#include <SkFontMgr.h>

Inheritance diagram for SkFontMgr:

Public Member Functions
int	countFamilies () const

void	getFamilyName (int index, SkString *familyName) const

sk_sp< SkFontStyleSet >	createStyleSet (int index) const

sk_sp< SkFontStyleSet >	matchFamily (const char familyName[]) const

sk_sp< SkTypeface >	matchFamilyStyle (const char familyName[], const SkFontStyle &) const

sk_sp< SkTypeface >	matchFamilyStyleCharacter (const char familyName[], const SkFontStyle &, const char *bcp47[], int bcp47Count, SkUnichar character) const

sk_sp< SkTypeface >	makeFromData (sk_sp< SkData >, int ttcIndex=0) const

sk_sp< SkTypeface >	makeFromStream (std::unique_ptr< SkStreamAsset >, int ttcIndex=0) const

sk_sp< SkTypeface >	makeFromStream (std::unique_ptr< SkStreamAsset >, const SkFontArguments &) const

sk_sp< SkTypeface >	makeFromFile (const char path[], int ttcIndex=0) const

sk_sp< SkTypeface >	legacyMakeTypeface (const char familyName[], SkFontStyle style) const

Public Member Functions inherited from SkRefCntBase
	SkRefCntBase ()

virtual	~SkRefCntBase ()

bool	unique () const

void	ref () const

void	unref () const

Static Public Member Functions
static sk_sp< SkFontMgr >	RefEmpty ()

Protected Member Functions
virtual int	onCountFamilies () const =0

virtual void	onGetFamilyName (int index, SkString *familyName) const =0

virtual sk_sp< SkFontStyleSet >	onCreateStyleSet (int index) const =0

virtual sk_sp< SkFontStyleSet >	onMatchFamily (const char familyName[]) const =0

virtual sk_sp< SkTypeface >	onMatchFamilyStyle (const char familyName[], const SkFontStyle &) const =0

virtual sk_sp< SkTypeface >	onMatchFamilyStyleCharacter (const char familyName[], const SkFontStyle &, const char *bcp47[], int bcp47Count, SkUnichar character) const =0

virtual sk_sp< SkTypeface >	onMakeFromData (sk_sp< SkData >, int ttcIndex) const =0

virtual sk_sp< SkTypeface >	onMakeFromStreamIndex (std::unique_ptr< SkStreamAsset >, int ttcIndex) const =0

virtual sk_sp< SkTypeface >	onMakeFromStreamArgs (std::unique_ptr< SkStreamAsset >, const SkFontArguments &) const =0

virtual sk_sp< SkTypeface >	onMakeFromFile (const char path[], int ttcIndex) const =0

virtual sk_sp< SkTypeface >	onLegacyMakeTypeface (const char familyName[], SkFontStyle) const =0

Detailed Description

Definition at line 36 of file SkFontMgr.h.

Member Function Documentation

◆ countFamilies()

int SkFontMgr::countFamilies ( ) const

Definition at line 93 of file SkFontMgr.cpp.

                                   {
    return this->onCountFamilies();
}

◆ createStyleSet()

sk_sp< SkFontStyleSet > SkFontMgr::createStyleSet ( int index ) const

Definition at line 101 of file SkFontMgr.cpp.

                                                               {
    return emptyOnNull(this->onCreateStyleSet(index));
}

◆ getFamilyName()

void SkFontMgr::getFamilyName	(	int	index,
		SkString *	familyName
	)		const

Definition at line 97 of file SkFontMgr.cpp.

                                                                   {
    this->onGetFamilyName(index, familyName);
}

◆ legacyMakeTypeface()

sk_sp< SkTypeface > SkFontMgr::legacyMakeTypeface	(	const char	familyName[],
		SkFontStyle	style
	)		const

Definition at line 150 of file SkFontMgr.cpp.

                                                                                                {
    return this->onLegacyMakeTypeface(familyName, style);
}

◆ makeFromData()

sk_sp< SkTypeface > SkFontMgr::makeFromData	(	sk_sp< SkData >	data,
		int	ttcIndex = `0`
	)		const

Create a typeface for the specified data and TTC index (pass 0 for none) or NULL if the data is not recognized. The caller must call unref() on the returned object if it is not null.

Definition at line 120 of file SkFontMgr.cpp.

                                                                                {
    if (nullptr == data) {
        return nullptr;
    }
    return this->onMakeFromData(std::move(data), ttcIndex);
}

◆ makeFromFile()

sk_sp< SkTypeface > SkFontMgr::makeFromFile	(	const char	path[],
		int	ttcIndex = `0`
	)		const

Create a typeface for the specified fileName and TTC index (pass 0 for none) or NULL if the file is not found, or its contents are not recognized. The caller must call unref() on the returned object if it is not null.

Definition at line 143 of file SkFontMgr.cpp.

                                                                               {
    if (nullptr == path) {
        return nullptr;
    }
    return this->onMakeFromFile(path, ttcIndex);
}

◆ makeFromStream() [1/2]

sk_sp< SkTypeface > SkFontMgr::makeFromStream	(	std::unique_ptr< SkStreamAsset >	stream,
		const SkFontArguments &	args
	)		const

Definition at line 135 of file SkFontMgr.cpp.

                                                                               {
    if (nullptr == stream) {
        return nullptr;
    }
    return this->onMakeFromStreamArgs(std::move(stream), args);
}

◆ makeFromStream() [2/2]

sk_sp< SkTypeface > SkFontMgr::makeFromStream	(	std::unique_ptr< SkStreamAsset >	stream,
		int	ttcIndex = `0`
	)		const

Create a typeface for the specified stream and TTC index (pass 0 for none) or NULL if the stream is not recognized. The caller must call unref() on the returned object if it is not null.

Definition at line 127 of file SkFontMgr.cpp.

                                                                {
    if (nullptr == stream) {
        return nullptr;
    }
    return this->onMakeFromStreamIndex(std::move(stream), ttcIndex);
}

◆ matchFamily()

sk_sp< SkFontStyleSet > SkFontMgr::matchFamily ( const char familyName[] ) const

The caller must call unref() on the returned object. Never returns NULL; will return an empty set if the name is not found.

Passing nullptr as the parameter will return the default system family. Note that most systems don't have a default system family, so passing nullptr will often result in the empty set.

It is possible that this will return a style set not accessible from createStyleSet(int) due to hidden or auto-activated fonts.

Definition at line 105 of file SkFontMgr.cpp.

                                                                          {
    return emptyOnNull(this->onMatchFamily(familyName));
}

◆ matchFamilyStyle()

sk_sp< SkTypeface > SkFontMgr::matchFamilyStyle	(	const char	familyName[],
		const SkFontStyle &	fs
	)		const

Find the closest matching typeface to the specified familyName and style and return a ref to it. The caller must call unref() on the returned object. Will return nullptr if no 'good' match is found.

Passing |nullptr| as the parameter for |familyName| will return the default system font.

It is possible that this will return a style set not accessible from createStyleSet(int) or matchFamily(const char[]) due to hidden or auto-activated fonts.

Definition at line 109 of file SkFontMgr.cpp.

                                                                     {
    return this->onMatchFamilyStyle(familyName, fs);
}

◆ matchFamilyStyleCharacter()

sk_sp< SkTypeface > SkFontMgr::matchFamilyStyleCharacter	(	const char	familyName[],
		const SkFontStyle &	style,
		const char *	bcp47[],
		int	bcp47Count,
		SkUnichar	character
	)		const

Use the system fallback to find a typeface for the given character. Note that bcp47 is a combination of ISO 639, 15924, and 3166-1 codes, so it is fine to just pass a ISO 639 here.

Will return NULL if no family can be found for the character in the system fallback.

Passing |nullptr| as the parameter for |familyName| will return the default system font.

bcp47[0] is the least significant fallback, bcp47[bcp47Count-1] is the most significant. If no specified bcp47 codes match, any font with the requested character will be matched.

Definition at line 114 of file SkFontMgr.cpp.

                                                                            {
    return this->onMatchFamilyStyleCharacter(familyName, style, bcp47, bcp47Count, character);
}

◆ onCountFamilies()

virtual int SkFontMgr::onCountFamilies ( ) const

protectedpure virtual

Implemented in OneFontMgr, SkOrderedFontMgr, skia::textlayout::TypefaceFontProvider, SkEmptyFontMgr, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_fontconfig, SkFontMgr_FCI, SkFontMgr_Fuchsia, and txt::AssetFontManager.

◆ onCreateStyleSet()

virtual sk_sp< SkFontStyleSet > SkFontMgr::onCreateStyleSet ( int index ) const

protectedpure virtual

Implemented in OneFontMgr, SkOrderedFontMgr, SkEmptyFontMgr, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_fontconfig, SkFontMgr_FCI, SkFontMgr_Fuchsia, txt::AssetFontManager, and skia::textlayout::TypefaceFontProvider.

◆ onGetFamilyName()

virtual void SkFontMgr::onGetFamilyName	(	int	index,
		SkString *	familyName
	)		const

protectedpure virtual

Implemented in OneFontMgr, SkOrderedFontMgr, skia::textlayout::TypefaceFontProvider, SkEmptyFontMgr, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_fontconfig, SkFontMgr_FCI, SkFontMgr_Fuchsia, and txt::AssetFontManager.

◆ onLegacyMakeTypeface()

virtual sk_sp< SkTypeface > SkFontMgr::onLegacyMakeTypeface	(	const char	familyName[],
		SkFontStyle
	)		const

protectedpure virtual

Implemented in SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_fontconfig, SkOrderedFontMgr, SkFontMgr_Fuchsia, txt::AssetFontManager, SkFontMgr_FCI, OneFontMgr, skia::textlayout::TypefaceFontProvider, and SkEmptyFontMgr.

◆ onMakeFromData()

virtual sk_sp< SkTypeface > SkFontMgr::onMakeFromData	(	sk_sp< SkData >	,
		int	ttcIndex
	)		const

protectedpure virtual

Implemented in SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_fontconfig, SkFontMgr_FCI, SkOrderedFontMgr, SkFontMgr_Fuchsia, txt::AssetFontManager, OneFontMgr, skia::textlayout::TypefaceFontProvider, and SkEmptyFontMgr.

◆ onMakeFromFile()

virtual sk_sp< SkTypeface > SkFontMgr::onMakeFromFile	(	const char	path[],
		int	ttcIndex
	)		const

protectedpure virtual

Implemented in SkOrderedFontMgr, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_fontconfig, SkFontMgr_FCI, SkFontMgr_Fuchsia, txt::AssetFontManager, OneFontMgr, skia::textlayout::TypefaceFontProvider, and SkEmptyFontMgr.

◆ onMakeFromStreamArgs()

virtual sk_sp< SkTypeface > SkFontMgr::onMakeFromStreamArgs	(	std::unique_ptr< SkStreamAsset >	,
		const SkFontArguments &
	)		const

protectedpure virtual

Implemented in SkFontMgr_fontconfig, SkFontMgr_FCI, OneFontMgr, SkOrderedFontMgr, skia::textlayout::TypefaceFontProvider, SkEmptyFontMgr, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_Fuchsia, and txt::AssetFontManager.

◆ onMakeFromStreamIndex()

virtual sk_sp< SkTypeface > SkFontMgr::onMakeFromStreamIndex	(	std::unique_ptr< SkStreamAsset >	,
		int	ttcIndex
	)		const

protectedpure virtual

Implemented in SkFontMgr_fontconfig, SkFontMgr_FCI, SkOrderedFontMgr, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_Fuchsia, txt::AssetFontManager, OneFontMgr, skia::textlayout::TypefaceFontProvider, and SkEmptyFontMgr.

◆ onMatchFamily()

virtual sk_sp< SkFontStyleSet > SkFontMgr::onMatchFamily ( const char familyName[] ) const

protectedpure virtual

May return NULL if the name is not found.

Implemented in txt::TestFontManager, SkOrderedFontMgr, skia::textlayout::TypefaceFontProvider, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_fontconfig, SkFontMgr_FCI, SkFontMgr_Fuchsia, txt::AssetFontManager, OneFontMgr, and SkEmptyFontMgr.

◆ onMatchFamilyStyle()

virtual sk_sp< SkTypeface > SkFontMgr::onMatchFamilyStyle	(	const char	familyName[],
		const SkFontStyle &
	)		const

protectedpure virtual

Implemented in SkOrderedFontMgr, SkFontMgr_Fuchsia, txt::AssetFontManager, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, skia::textlayout::TypefaceFontProvider, SkFontMgr_fontconfig, SkFontMgr_FCI, OneFontMgr, and SkEmptyFontMgr.

◆ onMatchFamilyStyleCharacter()

virtual sk_sp< SkTypeface > SkFontMgr::onMatchFamilyStyleCharacter	(	const char	familyName[],
		const SkFontStyle &	,
		const char *	bcp47[],
		int	bcp47Count,
		SkUnichar	character
	)		const

protectedpure virtual

Implemented in SkOrderedFontMgr, SkFontMgr_Custom, SkFontMgr_Fontations_Empty, SkFontMgr_FCI, SkFontMgr_Fuchsia, txt::AssetFontManager, OneFontMgr, SkEmptyFontMgr, SkFontMgr_fontconfig, and skia::textlayout::TypefaceFontProvider.

◆ RefEmpty()

sk_sp< SkFontMgr > SkFontMgr::RefEmpty ( )

static

Definition at line 154 of file SkFontMgr.cpp.

                                     {
    static sk_sp<SkFontMgr> singleton(new SkEmptyFontMgr);
    return singleton;
}

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

third_party/skia/include/core/SkFontMgr.h
third_party/skia/src/core/SkFontMgr.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Member Function Documentation

◆ countFamilies()

◆ createStyleSet()

◆ getFamilyName()

◆ legacyMakeTypeface()

◆ makeFromData()

◆ makeFromFile()

◆ makeFromStream() [1/2]

◆ makeFromStream() [2/2]

◆ matchFamily()

◆ matchFamilyStyle()

◆ matchFamilyStyleCharacter()

◆ onCountFamilies()

◆ onCreateStyleSet()

◆ onGetFamilyName()

◆ onLegacyMakeTypeface()

◆ onMakeFromData()

◆ onMakeFromFile()

◆ onMakeFromStreamArgs()

◆ onMakeFromStreamIndex()

◆ onMatchFamily()

◆ onMatchFamilyStyle()

◆ onMatchFamilyStyleCharacter()

◆ RefEmpty()