| /* |
| * 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_COLLECTION_H |
| #define MINIKIN_FONT_COLLECTION_H |
| |
| #include <memory> |
| #include <unordered_set> |
| #include <vector> |
| |
| #include "minikin/FontFamily.h" |
| #include "minikin/MinikinFont.h" |
| #include "minikin/U16StringPiece.h" |
| |
| namespace minikin { |
| |
| // The maximum number of font families. |
| constexpr uint32_t MAX_FAMILY_COUNT = 254; |
| |
| class FontCollection { |
| public: |
| explicit FontCollection(const std::vector<std::shared_ptr<FontFamily>>& typefaces); |
| explicit FontCollection(std::shared_ptr<FontFamily>&& typeface); |
| |
| struct Run { |
| FakedFont fakedFont; |
| int start; |
| int end; |
| }; |
| |
| // Perform the itemization until given max runs. |
| std::vector<Run> itemize(U16StringPiece text, FontStyle style, uint32_t localeListId, |
| FamilyVariant familyVariant, uint32_t runMax) const; |
| |
| // Perform the itemization until end of the text. |
| std::vector<Run> itemize(U16StringPiece text, FontStyle style, uint32_t localeListId, |
| FamilyVariant familyVariant) const { |
| return itemize(text, style, localeListId, familyVariant, text.size()); |
| } |
| |
| // Returns true if there is a glyph for the code point and variation selector pair. |
| // Returns false if no fonts have a glyph for the code point and variation |
| // selector pair, or invalid variation selector is passed. |
| bool hasVariationSelector(uint32_t baseCodepoint, uint32_t variationSelector) const; |
| |
| // Get base font with fakery information (fake bold could affect metrics) |
| FakedFont baseFontFaked(FontStyle style); |
| |
| // Creates new FontCollection based on this collection while applying font variations. Returns |
| // nullptr if none of variations apply to this collection. |
| std::shared_ptr<FontCollection> createCollectionWithVariation( |
| const std::vector<FontVariation>& variations); |
| |
| const std::unordered_set<AxisTag>& getSupportedTags() const { return mSupportedAxes; } |
| |
| uint32_t getId() const; |
| |
| private: |
| static const int kLogCharsPerPage = 8; |
| static const int kPageMask = (1 << kLogCharsPerPage) - 1; |
| |
| // mFamilyVec holds the indices of the mFamilies and mRanges holds the range of indices of |
| // mFamilyVec. The maximum number of pages is 0x10FF (U+10FFFF >> 8). The maximum number of |
| // the fonts is 0xFF. Thus, technically the maximum length of mFamilyVec is 0x10EE01 |
| // (0x10FF * 0xFF). However, in practice, 16-bit integers are enough since most fonts supports |
| // only limited range of code points. |
| struct Range { |
| uint16_t start; |
| uint16_t end; |
| }; |
| |
| // Initialize the FontCollection. |
| void init(const std::vector<std::shared_ptr<FontFamily>>& typefaces); |
| |
| const std::shared_ptr<FontFamily>& getFamilyForChar(uint32_t ch, uint32_t vs, |
| uint32_t localeListId, |
| FamilyVariant variant) const; |
| |
| uint32_t calcFamilyScore(uint32_t ch, uint32_t vs, FamilyVariant variant, uint32_t localeListId, |
| const std::shared_ptr<FontFamily>& fontFamily) const; |
| |
| uint32_t calcCoverageScore(uint32_t ch, uint32_t vs, uint32_t localeListId, |
| const std::shared_ptr<FontFamily>& fontFamily) const; |
| |
| static uint32_t calcLocaleMatchingScore(uint32_t userLocaleListId, |
| const FontFamily& fontFamily); |
| |
| static uint32_t calcVariantMatchingScore(FamilyVariant variant, const FontFamily& fontFamily); |
| |
| // unique id for this font collection (suitable for cache key) |
| uint32_t mId; |
| |
| // Highest UTF-32 code point that can be mapped |
| uint32_t mMaxChar; |
| |
| // This vector has pointers to the all font family instances in this collection. |
| // This vector can't be empty. |
| std::vector<std::shared_ptr<FontFamily>> mFamilies; |
| |
| // Following two vectors are pre-calculated tables for resolving coverage faster. |
| // For example, to iterate over all fonts which support Unicode code point U+XXYYZZ, |
| // iterate font families index from mFamilyVec[mRanges[0xXXYY].start] to |
| // mFamilyVec[mRange[0xXXYY].end] instead of whole mFamilies. |
| // This vector contains indices into mFamilies. |
| // This vector can't be empty. |
| std::vector<Range> mRanges; |
| std::vector<uint8_t> mFamilyVec; |
| |
| // This vector has pointers to the font family instances which have cmap 14 subtables. |
| std::vector<std::shared_ptr<FontFamily>> mVSFamilyVec; |
| |
| // Set of supported axes in this collection. |
| std::unordered_set<AxisTag> mSupportedAxes; |
| }; |
| |
| } // namespace minikin |
| |
| #endif // MINIKIN_FONT_COLLECTION_H |