/* * Copyright (C) 2013 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef MINIKIN_FONT_FAMILY_H #define MINIKIN_FONT_FAMILY_H #include #include #include #include #include #include namespace android { class MinikinFont; // FontStyle represents all style information needed to select an actual font // from a collection. The implementation is packed into two 32-bit words // so it can be efficiently copied, embedded in other objects, etc. class FontStyle { public: FontStyle() : FontStyle(0 /* variant */, 4 /* weight */, false /* italic */) {} FontStyle(int weight, bool italic) : FontStyle(0 /* variant */, weight, italic) {} FontStyle(uint32_t langListId) : FontStyle(langListId, 0 /* variant */, 4 /* weight */, false /* italic */) {} FontStyle(int variant, int weight, bool italic); FontStyle(uint32_t langListId, int variant, int weight, bool italic); int getWeight() const { return bits & kWeightMask; } bool getItalic() const { return (bits & kItalicMask) != 0; } int getVariant() const { return (bits >> kVariantShift) & kVariantMask; } uint32_t getLanguageListId() const { return mLanguageListId; } bool operator==(const FontStyle other) const { return bits == other.bits && mLanguageListId == other.mLanguageListId; } hash_t hash() const; // Looks up a language list from an internal cache and returns its ID. // If the passed language list is not in the cache, registers it and returns newly assigned ID. static uint32_t registerLanguageList(const std::string& languages); private: static const uint32_t kWeightMask = (1 << 4) - 1; static const uint32_t kItalicMask = 1 << 4; static const int kVariantShift = 5; static const uint32_t kVariantMask = (1 << 2) - 1; static uint32_t pack(int variant, int weight, bool italic); uint32_t bits; uint32_t mLanguageListId; }; enum FontVariant { VARIANT_DEFAULT = 0, VARIANT_COMPACT = 1, VARIANT_ELEGANT = 2, }; inline hash_t hash_type(const FontStyle &style) { return style.hash(); } // attributes representing transforms (fake bold, fake italic) to match styles class FontFakery { public: FontFakery() : mFakeBold(false), mFakeItalic(false) { } FontFakery(bool fakeBold, bool fakeItalic) : mFakeBold(fakeBold), mFakeItalic(fakeItalic) { } // TODO: want to support graded fake bolding bool isFakeBold() { return mFakeBold; } bool isFakeItalic() { return mFakeItalic; } private: bool mFakeBold; bool mFakeItalic; }; struct FakedFont { // ownership is the enclosing FontCollection MinikinFont* font; FontFakery fakery; }; class FontFamily : public MinikinRefCounted { public: FontFamily(); FontFamily(int variant); FontFamily(uint32_t langId, int variant) : mLangId(langId), mVariant(variant), mHasVSTable(false), mCoverageValid(false) { } ~FontFamily(); // Add font to family, extracting style information from the font bool addFont(MinikinFont* typeface); void addFont(MinikinFont* typeface, FontStyle style); FakedFont getClosestMatch(FontStyle style) const; uint32_t langId() const { return mLangId; } int variant() const { return mVariant; } // API's for enumerating the fonts in a family. These don't guarantee any particular order size_t getNumFonts() const; MinikinFont* getFont(size_t index) const; FontStyle getStyle(size_t index) const; bool isColorEmojiFamily() const; // Get Unicode coverage. Lifetime of returned bitset is same as receiver. May return nullptr on // error. const SparseBitSet* getCoverage(); // Returns true if the font has a glyph for the code point and variation selector pair. // Caller should acquire a lock before calling the method. bool hasGlyph(uint32_t codepoint, uint32_t variationSelector); // Returns true if this font family has a variaion sequence table (cmap format 14 subtable). bool hasVSTable() const; private: void addFontLocked(MinikinFont* typeface, FontStyle style); class Font { public: Font(MinikinFont* typeface, FontStyle style) : typeface(typeface), style(style) { } MinikinFont* typeface; FontStyle style; }; uint32_t mLangId; int mVariant; std::vector mFonts; SparseBitSet mCoverage; bool mHasVSTable; bool mCoverageValid; }; } // namespace android #endif // MINIKIN_FONT_FAMILY_H