MinikinFont.h revision d692d6a9791145d41d7778cdf6b40b20c2be8cb4
1bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien/* 2bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * Copyright (C) 2013 The Android Open Source Project 3bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * 4bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * Licensed under the Apache License, Version 2.0 (the "License"); 5bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * you may not use this file except in compliance with the License. 6bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * You may obtain a copy of the License at 7bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * 8bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * http://www.apache.org/licenses/LICENSE-2.0 9bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * 10bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * Unless required by applicable law or agreed to in writing, software 11bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * distributed under the License is distributed on an "AS IS" BASIS, 12bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * See the License for the specific language governing permissions and 14bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien * limitations under the License. 15bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien */ 16bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 17bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien#ifndef MINIKIN_FONT_H 18bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien#define MINIKIN_FONT_H 19bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 205986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod#include <string> 215986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod 22b80c1f19c58b927820a8a24bf2218e5645724608Raph Levien#include <minikin/MinikinRefCounted.h> 239a5f713add8cfb91ac2c9ed5c917309053201ab6Raph Levien#include <minikin/FontFamily.h> 24b80c1f19c58b927820a8a24bf2218e5645724608Raph Levien 25bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien// An abstraction for platform fonts, allowing Minikin to be used with 26bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien// multiple actual implementations of fonts. 27bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 28bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Leviennamespace android { 29bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 30d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien// The hyphen edit represents an edit to the string when a word is 31d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien// hyphenated. The most common hyphen edit is adding a "-" at the end 32d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien// of a syllable, but nonstandard hyphenation allows for more choices. 33d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levienclass HyphenEdit { 34d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levienpublic: 35d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien HyphenEdit() : hyphen(0) { } 36d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien HyphenEdit(uint32_t hyphenInt) : hyphen(hyphenInt) { } 37d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien bool hasHyphen() const { return hyphen != 0; } 38d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levienprivate: 39d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien uint32_t hyphen; 40d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien}; 41d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien 42bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levienclass MinikinFont; 43bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 44bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien// Possibly move into own .h file? 455986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod// Note: if you add a field here, either add it to LayoutCacheKey or to skipCache() 46bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levienstruct MinikinPaint { 4783d5a3c53d77c34fbeac7012ab3612933982d494Behdad Esfahbod MinikinPaint() : font(0), size(0), scaleX(0), skewX(0), letterSpacing(0), paintFlags(0), 485986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod fakery(), fontFeatureSettings() { } 495986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod 505986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod bool skipCache() const { 51d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien // TODO: add hyphen to cache 52d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien return !fontFeatureSettings.empty() || hyphenEdit.hasHyphen(); 535986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod } 545986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod 55bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien MinikinFont *font; 56bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien float size; 57448b0fd720d7ba902b9be224a287d08abe3ebea8Raph Levien float scaleX; 58448b0fd720d7ba902b9be224a287d08abe3ebea8Raph Levien float skewX; 598e7a3dae37e9a22b2c054aec852615843d71caf6Behdad Esfahbod float letterSpacing; 603164d1a77eecf3185347a44342131f4275de824fRaph Levien uint32_t paintFlags; 619a5f713add8cfb91ac2c9ed5c917309053201ab6Raph Levien FontFakery fakery; 62d692d6a9791145d41d7778cdf6b40b20c2be8cb4Raph Levien HyphenEdit hyphenEdit; 635986f6048ae21e0ec094c1f2ca0169d0ca6ec6b5Behdad Esfahbod std::string fontFeatureSettings; 64bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien}; 65bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 666740536e3927d25bf5c2567e5f6e8c175973cbb7Raph Levien// Only a few flags affect layout, but those that do should have values 676740536e3927d25bf5c2567e5f6e8c175973cbb7Raph Levien// consistent with Android's paint flags. 686740536e3927d25bf5c2567e5f6e8c175973cbb7Raph Levienenum MinikinPaintFlags { 696740536e3927d25bf5c2567e5f6e8c175973cbb7Raph Levien LinearTextFlag = 0x40, 706740536e3927d25bf5c2567e5f6e8c175973cbb7Raph Levien}; 716740536e3927d25bf5c2567e5f6e8c175973cbb7Raph Levien 72ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levienstruct MinikinRect { 73ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien float mLeft, mTop, mRight, mBottom; 74ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien bool isEmpty() const { 75ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien return mLeft == mRight || mTop == mBottom; 76ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien } 77ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien void set(const MinikinRect& r) { 78ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mLeft = r.mLeft; 79ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mTop = r.mTop; 80ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mRight = r.mRight; 81ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mBottom = r.mBottom; 82ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien } 83ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien void offset(float dx, float dy) { 84ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mLeft += dx; 85ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mTop += dy; 86ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mRight += dx; 87ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mBottom += dy; 88ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien } 89ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien void setEmpty() { 90ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien mLeft = mTop = mRight = mBottom = 0; 91ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien } 92ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien void join(const MinikinRect& r); 93ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien}; 94ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien 95bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levienclass MinikinFontFreeType; 96bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 97b80c1f19c58b927820a8a24bf2218e5645724608Raph Levienclass MinikinFont : public MinikinRefCounted { 98bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levienpublic: 99bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien virtual bool GetGlyph(uint32_t codepoint, uint32_t *glyph) const = 0; 100bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 101bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien virtual float GetHorizontalAdvance(uint32_t glyph_id, 102bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien const MinikinPaint &paint) const = 0; 103bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 104ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien virtual void GetBounds(MinikinRect* bounds, uint32_t glyph_id, 105ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien const MinikinPaint &paint) const = 0; 106ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien 107bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien // If buf is NULL, just update size 108bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien virtual bool GetTable(uint32_t tag, uint8_t *buf, size_t *size) = 0; 109bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 110bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien virtual int32_t GetUniqueId() const = 0; 111bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 112bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien static uint32_t MakeTag(char c1, char c2, char c3, char c4) { 113bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien return ((uint32_t)c1 << 24) | ((uint32_t)c2 << 16) | 114bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien ((uint32_t)c3 << 8) | (uint32_t)c4; 115bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien } 116bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien}; 117bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 118bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien} // namespace android 119bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien 120bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien#endif // MINIKIN_FONT_H 121