Layout.h revision 09f1901d6befcab49ed46cb77151a5d4af14a3b9
1/* 2 * Copyright (C) 2013 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17#ifndef MINIKIN_LAYOUT_H 18#define MINIKIN_LAYOUT_H 19 20#include <hb.h> 21 22#include <vector> 23 24#include <minikin/CssParse.h> 25#include <minikin/FontCollection.h> 26#include <minikin/MinikinFontFreeType.h> 27 28namespace android { 29 30// The Bitmap class is for debugging. We'll probably move it out 31// of here into a separate lightweight software rendering module 32// (optional, as we'd hope most clients would do their own) 33class Bitmap { 34public: 35 Bitmap(int width, int height); 36 ~Bitmap(); 37 void writePnm(std::ofstream& o) const; 38 void drawGlyph(const GlyphBitmap& bitmap, int x, int y); 39private: 40 int width; 41 int height; 42 uint8_t* buf; 43}; 44 45struct LayoutGlyph { 46 // index into mFaces and mHbFonts vectors. We could imagine 47 // moving this into a run length representation, because it's 48 // more efficient for long strings, and we'll probably need 49 // something like that for paint attributes (color, underline, 50 // fake b/i, etc), as having those per-glyph is bloated. 51 int font_ix; 52 53 unsigned int glyph_id; 54 float x; 55 float y; 56}; 57 58// Internal state used during layout operation 59class LayoutContext; 60 61// Lifecycle and threading assumptions for Layout: 62// The object is assumed to be owned by a single thread; multiple threads 63// may not mutate it at the same time. 64// The lifetime of the FontCollection set through setFontCollection must 65// extend through the lifetime of the Layout object. 66class Layout { 67public: 68 void dump() const; 69 void setFontCollection(const FontCollection* collection); 70 71 // Deprecated. Will be removed. 72 void doLayout(const uint16_t* buf, size_t start, size_t count, size_t bufSize, 73 const std::string& css); 74 75 void doLayout(const uint16_t* buf, size_t start, size_t count, size_t bufSize, 76 int bidiFlags, const FontStyle &style, const MinikinPaint &paint); 77 78 void draw(Bitmap*, int x0, int y0, float size) const; 79 80 // This must be called before any invocations. 81 // TODO: probably have a factory instead 82 static void init(); 83 84 // public accessors 85 size_t nGlyphs() const; 86 // Does not bump reference; ownership is still layout 87 MinikinFont *getFont(int i) const; 88 FontFakery getFakery(int i) const; 89 unsigned int getGlyphId(int i) const; 90 float getX(int i) const; 91 float getY(int i) const; 92 93 float getAdvance() const; 94 95 // Get advances, copying into caller-provided buffer. The size of this 96 // buffer must match the length of the string (nchars arg to doLayout). 97 void getAdvances(float* advances); 98 99 void getBounds(MinikinRect* rect); 100 101 // Purge all caches, useful in low memory conditions 102 static void purgeCaches(); 103 104private: 105 // Find a face in the mFaces vector, or create a new entry 106 int findFace(FakedFont face, LayoutContext* ctx); 107 108 // Lay out a single bidi run 109 void doLayoutRunCached(const uint16_t* buf, size_t start, size_t count, size_t bufSize, 110 bool isRtl, LayoutContext* ctx, size_t dstStart); 111 112 // Lay out a single word 113 void doLayoutWord(const uint16_t* buf, size_t start, size_t count, size_t bufSize, 114 bool isRtl, LayoutContext* ctx, size_t bufStart); 115 116 // Lay out a single bidi run 117 void doLayoutRun(const uint16_t* buf, size_t start, size_t count, size_t bufSize, 118 bool isRtl, LayoutContext* ctx); 119 120 // Append another layout (for example, cached value) into this one 121 void appendLayout(Layout* src, size_t start); 122 123 std::vector<LayoutGlyph> mGlyphs; 124 std::vector<float> mAdvances; 125 126 const FontCollection* mCollection; 127 std::vector<FakedFont> mFaces; 128 float mAdvance; 129 MinikinRect mBounds; 130}; 131 132} // namespace android 133 134#endif // MINIKIN_LAYOUT_H 135