1bbe50131413098bffed9186660c41f047d881596bungeman@google.com/* 2bbe50131413098bffed9186660c41f047d881596bungeman@google.com * Copyright 2006 The Android Open Source Project 3bbe50131413098bffed9186660c41f047d881596bungeman@google.com * 4bbe50131413098bffed9186660c41f047d881596bungeman@google.com * Use of this source code is governed by a BSD-style license that can be 5bbe50131413098bffed9186660c41f047d881596bungeman@google.com * found in the LICENSE file. 6bbe50131413098bffed9186660c41f047d881596bungeman@google.com */ 7bbe50131413098bffed9186660c41f047d881596bungeman@google.com 8bbe50131413098bffed9186660c41f047d881596bungeman@google.com#ifndef SkGlyph_DEFINED 9bbe50131413098bffed9186660c41f047d881596bungeman@google.com#define SkGlyph_DEFINED 10bbe50131413098bffed9186660c41f047d881596bungeman@google.com 11bbe50131413098bffed9186660c41f047d881596bungeman@google.com#include "SkTypes.h" 12bbe50131413098bffed9186660c41f047d881596bungeman@google.com#include "SkFixed.h" 13bbe50131413098bffed9186660c41f047d881596bungeman@google.com#include "SkMask.h" 14bbe50131413098bffed9186660c41f047d881596bungeman@google.com 15bbe50131413098bffed9186660c41f047d881596bungeman@google.comclass SkPath; 16b69d0e0ac45e13f667bc11a937dcb547072bc93dherbclass SkGlyphCache; 17bbe50131413098bffed9186660c41f047d881596bungeman@google.com 18bbe50131413098bffed9186660c41f047d881596bungeman@google.com// needs to be != to any valid SkMask::Format 19bbe50131413098bffed9186660c41f047d881596bungeman@google.com#define MASK_FORMAT_UNKNOWN (0xFF) 20bbe50131413098bffed9186660c41f047d881596bungeman@google.com#define MASK_FORMAT_JUST_ADVANCE MASK_FORMAT_UNKNOWN 21bbe50131413098bffed9186660c41f047d881596bungeman@google.com 22bbe50131413098bffed9186660c41f047d881596bungeman@google.com#define kMaxGlyphWidth (1<<13) 23bbe50131413098bffed9186660c41f047d881596bungeman@google.com 24b69d0e0ac45e13f667bc11a937dcb547072bc93dherbclass SkGlyph { 25b69d0e0ac45e13f667bc11a937dcb547072bc93dherb enum { 26b69d0e0ac45e13f667bc11a937dcb547072bc93dherb kSubBits = 2, 27b69d0e0ac45e13f667bc11a937dcb547072bc93dherb kSubMask = ((1 << kSubBits) - 1), 28b69d0e0ac45e13f667bc11a937dcb547072bc93dherb kSubShift = 24, // must be large enough for glyphs and unichars 29b69d0e0ac45e13f667bc11a937dcb547072bc93dherb kCodeMask = ((1 << kSubShift) - 1), 30b69d0e0ac45e13f667bc11a937dcb547072bc93dherb // relative offsets for X and Y subpixel bits 31b69d0e0ac45e13f667bc11a937dcb547072bc93dherb kSubShiftX = kSubBits, 32b69d0e0ac45e13f667bc11a937dcb547072bc93dherb kSubShiftY = 0 33b69d0e0ac45e13f667bc11a937dcb547072bc93dherb }; 34b69d0e0ac45e13f667bc11a937dcb547072bc93dherb 35b69d0e0ac45e13f667bc11a937dcb547072bc93dherb public: 36b69d0e0ac45e13f667bc11a937dcb547072bc93dherb static const SkFixed kSubpixelRound = SK_FixedHalf >> SkGlyph::kSubBits; 37c1e97b372e21edf9c7e45cfea0eca7f1a52fe9e5herb // A value that can never be generated by MakeID. 38c1e97b372e21edf9c7e45cfea0eca7f1a52fe9e5herb static const uint32_t kImpossibleID = ~0; 39bbe50131413098bffed9186660c41f047d881596bungeman@google.com void* fImage; 40bbe50131413098bffed9186660c41f047d881596bungeman@google.com SkPath* fPath; 41bbe50131413098bffed9186660c41f047d881596bungeman@google.com SkFixed fAdvanceX, fAdvanceY; 42bbe50131413098bffed9186660c41f047d881596bungeman@google.com 43bbe50131413098bffed9186660c41f047d881596bungeman@google.com uint16_t fWidth, fHeight; 44bbe50131413098bffed9186660c41f047d881596bungeman@google.com int16_t fTop, fLeft; 45bbe50131413098bffed9186660c41f047d881596bungeman@google.com 46bbe50131413098bffed9186660c41f047d881596bungeman@google.com uint8_t fMaskFormat; 47bbe50131413098bffed9186660c41f047d881596bungeman@google.com int8_t fRsbDelta, fLsbDelta; // used by auto-kerning 48b2f7fce9e034c3b6749e75a129e7836df3529706Ben Wagner int8_t fForceBW; 49bbe50131413098bffed9186660c41f047d881596bungeman@google.com 50b69d0e0ac45e13f667bc11a937dcb547072bc93dherb void initWithGlyphID(uint32_t glyph_id) { 51b69d0e0ac45e13f667bc11a937dcb547072bc93dherb this->initCommon(MakeID(glyph_id)); 52b69d0e0ac45e13f667bc11a937dcb547072bc93dherb } 53b69d0e0ac45e13f667bc11a937dcb547072bc93dherb 54b69d0e0ac45e13f667bc11a937dcb547072bc93dherb void initGlyphIdFrom(const SkGlyph& glyph) { 55b69d0e0ac45e13f667bc11a937dcb547072bc93dherb this->initCommon(glyph.fID); 56bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 57bbe50131413098bffed9186660c41f047d881596bungeman@google.com 58e70de9e4f0b7bf73f7cd1a20dbabcb233ffbb7f1herb void initGlyphFromCombinedID(uint32_t combined_id) { 59e70de9e4f0b7bf73f7cd1a20dbabcb233ffbb7f1herb this->initCommon(combined_id); 60e70de9e4f0b7bf73f7cd1a20dbabcb233ffbb7f1herb } 61e70de9e4f0b7bf73f7cd1a20dbabcb233ffbb7f1herb 62bbe50131413098bffed9186660c41f047d881596bungeman@google.com /** 63bbe50131413098bffed9186660c41f047d881596bungeman@google.com * Compute the rowbytes for the specified width and mask-format. 64bbe50131413098bffed9186660c41f047d881596bungeman@google.com */ 65bbe50131413098bffed9186660c41f047d881596bungeman@google.com static unsigned ComputeRowBytes(unsigned width, SkMask::Format format) { 66bbe50131413098bffed9186660c41f047d881596bungeman@google.com unsigned rb = width; 67bbe50131413098bffed9186660c41f047d881596bungeman@google.com if (SkMask::kBW_Format == format) { 68bbe50131413098bffed9186660c41f047d881596bungeman@google.com rb = (rb + 7) >> 3; 69d54d3fc82456f8789b3e4dff40faeb7b670bcf4breed } else if (SkMask::kARGB32_Format == format) { 70bbe50131413098bffed9186660c41f047d881596bungeman@google.com rb <<= 2; 71bbe50131413098bffed9186660c41f047d881596bungeman@google.com } else if (SkMask::kLCD16_Format == format) { 72bbe50131413098bffed9186660c41f047d881596bungeman@google.com rb = SkAlign4(rb << 1); 73bbe50131413098bffed9186660c41f047d881596bungeman@google.com } else { 74bbe50131413098bffed9186660c41f047d881596bungeman@google.com rb = SkAlign4(rb); 75bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 76bbe50131413098bffed9186660c41f047d881596bungeman@google.com return rb; 77bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 78bbe50131413098bffed9186660c41f047d881596bungeman@google.com 79bbe50131413098bffed9186660c41f047d881596bungeman@google.com unsigned rowBytes() const { 80bbe50131413098bffed9186660c41f047d881596bungeman@google.com return ComputeRowBytes(fWidth, (SkMask::Format)fMaskFormat); 81bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 82bbe50131413098bffed9186660c41f047d881596bungeman@google.com 83bbe50131413098bffed9186660c41f047d881596bungeman@google.com bool isJustAdvance() const { 84bbe50131413098bffed9186660c41f047d881596bungeman@google.com return MASK_FORMAT_JUST_ADVANCE == fMaskFormat; 85bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 86bbe50131413098bffed9186660c41f047d881596bungeman@google.com 87bbe50131413098bffed9186660c41f047d881596bungeman@google.com bool isFullMetrics() const { 88bbe50131413098bffed9186660c41f047d881596bungeman@google.com return MASK_FORMAT_JUST_ADVANCE != fMaskFormat; 89bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 90bbe50131413098bffed9186660c41f047d881596bungeman@google.com 91bbe50131413098bffed9186660c41f047d881596bungeman@google.com uint16_t getGlyphID() const { 92bbe50131413098bffed9186660c41f047d881596bungeman@google.com return ID2Code(fID); 93bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 94bbe50131413098bffed9186660c41f047d881596bungeman@google.com 95bbe50131413098bffed9186660c41f047d881596bungeman@google.com unsigned getSubX() const { 96bbe50131413098bffed9186660c41f047d881596bungeman@google.com return ID2SubX(fID); 97bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 98bbe50131413098bffed9186660c41f047d881596bungeman@google.com 99bbe50131413098bffed9186660c41f047d881596bungeman@google.com SkFixed getSubXFixed() const { 100bbe50131413098bffed9186660c41f047d881596bungeman@google.com return SubToFixed(ID2SubX(fID)); 101bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 102bbe50131413098bffed9186660c41f047d881596bungeman@google.com 103bbe50131413098bffed9186660c41f047d881596bungeman@google.com SkFixed getSubYFixed() const { 104bbe50131413098bffed9186660c41f047d881596bungeman@google.com return SubToFixed(ID2SubY(fID)); 105bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 106bbe50131413098bffed9186660c41f047d881596bungeman@google.com 107bbe50131413098bffed9186660c41f047d881596bungeman@google.com size_t computeImageSize() const; 108bbe50131413098bffed9186660c41f047d881596bungeman@google.com 109bbe50131413098bffed9186660c41f047d881596bungeman@google.com /** Call this to set all of the metrics fields to 0 (e.g. if the scaler 110bbe50131413098bffed9186660c41f047d881596bungeman@google.com encounters an error measuring a glyph). Note: this does not alter the 111bbe50131413098bffed9186660c41f047d881596bungeman@google.com fImage, fPath, fID, fMaskFormat fields. 112bbe50131413098bffed9186660c41f047d881596bungeman@google.com */ 113bbe50131413098bffed9186660c41f047d881596bungeman@google.com void zeroMetrics(); 114bbe50131413098bffed9186660c41f047d881596bungeman@google.com 115b69d0e0ac45e13f667bc11a937dcb547072bc93dherb void toMask(SkMask* mask) const; 116b69d0e0ac45e13f667bc11a937dcb547072bc93dherb 117b69d0e0ac45e13f667bc11a937dcb547072bc93dherb private: 118b69d0e0ac45e13f667bc11a937dcb547072bc93dherb // TODO(herb) remove friend statement after SkGlyphCache cleanup. 119b69d0e0ac45e13f667bc11a937dcb547072bc93dherb friend class SkGlyphCache; 120b69d0e0ac45e13f667bc11a937dcb547072bc93dherb 121b69d0e0ac45e13f667bc11a937dcb547072bc93dherb void initCommon(uint32_t id) { 122b69d0e0ac45e13f667bc11a937dcb547072bc93dherb fID = id; 123b69d0e0ac45e13f667bc11a937dcb547072bc93dherb fImage = NULL; 124b69d0e0ac45e13f667bc11a937dcb547072bc93dherb fPath = NULL; 125b69d0e0ac45e13f667bc11a937dcb547072bc93dherb fMaskFormat = MASK_FORMAT_UNKNOWN; 126b69d0e0ac45e13f667bc11a937dcb547072bc93dherb fForceBW = 0; 127b69d0e0ac45e13f667bc11a937dcb547072bc93dherb } 128e70de9e4f0b7bf73f7cd1a20dbabcb233ffbb7f1herb 129bbe50131413098bffed9186660c41f047d881596bungeman@google.com static unsigned ID2Code(uint32_t id) { 130e70de9e4f0b7bf73f7cd1a20dbabcb233ffbb7f1herb return id & kCodeMask; 131bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 132bbe50131413098bffed9186660c41f047d881596bungeman@google.com 133bbe50131413098bffed9186660c41f047d881596bungeman@google.com static unsigned ID2SubX(uint32_t id) { 134bbe50131413098bffed9186660c41f047d881596bungeman@google.com return id >> (kSubShift + kSubShiftX); 135bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 136bbe50131413098bffed9186660c41f047d881596bungeman@google.com 137bbe50131413098bffed9186660c41f047d881596bungeman@google.com static unsigned ID2SubY(uint32_t id) { 138bbe50131413098bffed9186660c41f047d881596bungeman@google.com return (id >> (kSubShift + kSubShiftY)) & kSubMask; 139bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 140bbe50131413098bffed9186660c41f047d881596bungeman@google.com 141bbe50131413098bffed9186660c41f047d881596bungeman@google.com static unsigned FixedToSub(SkFixed n) { 142bbe50131413098bffed9186660c41f047d881596bungeman@google.com return (n >> (16 - kSubBits)) & kSubMask; 143bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 144bbe50131413098bffed9186660c41f047d881596bungeman@google.com 145bbe50131413098bffed9186660c41f047d881596bungeman@google.com static SkFixed SubToFixed(unsigned sub) { 146bbe50131413098bffed9186660c41f047d881596bungeman@google.com SkASSERT(sub <= kSubMask); 147bbe50131413098bffed9186660c41f047d881596bungeman@google.com return sub << (16 - kSubBits); 148bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 149bbe50131413098bffed9186660c41f047d881596bungeman@google.com 150bbe50131413098bffed9186660c41f047d881596bungeman@google.com static uint32_t MakeID(unsigned code) { 151e70de9e4f0b7bf73f7cd1a20dbabcb233ffbb7f1herb SkASSERT(code <= kCodeMask); 152c1e97b372e21edf9c7e45cfea0eca7f1a52fe9e5herb SkASSERT(code != kImpossibleID); 1535a2a5e729c081aa8ddfaab3311b7730622689abfmtklein return code; 154bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 155bbe50131413098bffed9186660c41f047d881596bungeman@google.com 156bbe50131413098bffed9186660c41f047d881596bungeman@google.com static uint32_t MakeID(unsigned code, SkFixed x, SkFixed y) { 1575a2a5e729c081aa8ddfaab3311b7730622689abfmtklein SkASSERT(code <= kCodeMask); 158bbe50131413098bffed9186660c41f047d881596bungeman@google.com x = FixedToSub(x); 159bbe50131413098bffed9186660c41f047d881596bungeman@google.com y = FixedToSub(y); 160c1e97b372e21edf9c7e45cfea0eca7f1a52fe9e5herb uint32_t ID = (x << (kSubShift + kSubShiftX)) | 161c1e97b372e21edf9c7e45cfea0eca7f1a52fe9e5herb (y << (kSubShift + kSubShiftY)) | 162c1e97b372e21edf9c7e45cfea0eca7f1a52fe9e5herb code; 163c1e97b372e21edf9c7e45cfea0eca7f1a52fe9e5herb SkASSERT(ID != kImpossibleID); 164c1e97b372e21edf9c7e45cfea0eca7f1a52fe9e5herb return ID; 165bbe50131413098bffed9186660c41f047d881596bungeman@google.com } 166bbe50131413098bffed9186660c41f047d881596bungeman@google.com 167b69d0e0ac45e13f667bc11a937dcb547072bc93dherb // FIXME - This is needed because the Android frame work directly 168b69d0e0ac45e13f667bc11a937dcb547072bc93dherb // accesses fID. Remove when fID accesses are cleaned up. 169b69d0e0ac45e13f667bc11a937dcb547072bc93dherb#ifdef SK_BUILD_FOR_ANDROID_FRAMEWORK 170b69d0e0ac45e13f667bc11a937dcb547072bc93dherb public: 171b69d0e0ac45e13f667bc11a937dcb547072bc93dherb#endif 172b69d0e0ac45e13f667bc11a937dcb547072bc93dherb uint32_t fID; 173bbe50131413098bffed9186660c41f047d881596bungeman@google.com}; 174bbe50131413098bffed9186660c41f047d881596bungeman@google.com 175bbe50131413098bffed9186660c41f047d881596bungeman@google.com#endif 176