/* * 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_LAYOUT_H #define MINIKIN_LAYOUT_H #include #include #include #include #include namespace android { // The Bitmap class is for debugging. We'll probably move it out // of here into a separate lightweight software rendering module // (optional, as we'd hope most clients would do their own) class Bitmap { public: Bitmap(int width, int height); ~Bitmap(); void writePnm(std::ofstream& o) const; void drawGlyph(const GlyphBitmap& bitmap, int x, int y); private: int width; int height; uint8_t* buf; }; struct LayoutGlyph { // index into mFaces and mHbFonts vectors. We could imagine // moving this into a run length representation, because it's // more efficient for long strings, and we'll probably need // something like that for paint attributes (color, underline, // fake b/i, etc), as having those per-glyph is bloated. int font_ix; unsigned int glyph_id; float x; float y; }; // Internal state used during layout operation class LayoutContext; // Lifecycle and threading assumptions for Layout: // The object is assumed to be owned by a single thread; multiple threads // may not mutate it at the same time. // The lifetime of the FontCollection set through setFontCollection must // extend through the lifetime of the Layout object. class Layout { public: void dump() const; void setFontCollection(const FontCollection* collection); // deprecated - missing functionality void doLayout(const uint16_t* buf, size_t nchars); void doLayout(const uint16_t* buf, size_t start, size_t count, size_t bufSize, const std::string& css); void draw(Bitmap*, int x0, int y0, float size) const; // deprecated - pass as argument to doLayout instead void setProperties(const std::string& css); // This must be called before any invocations. // TODO: probably have a factory instead static void init(); // public accessors size_t nGlyphs() const; // Does not bump reference; ownership is still layout MinikinFont *getFont(int i) const; FontFakery getFakery(int i) const; unsigned int getGlyphId(int i) const; float getX(int i) const; float getY(int i) const; float getAdvance() const; // Get advances, copying into caller-provided buffer. The size of this // buffer must match the length of the string (nchars arg to doLayout). void getAdvances(float* advances); void getBounds(MinikinRect* rect); private: // Find a face in the mFaces vector, or create a new entry int findFace(FakedFont face, LayoutContext* ctx); // Lay out a single bidi run void doLayoutRunCached(const uint16_t* buf, size_t start, size_t count, size_t bufSize, bool isRtl, LayoutContext* ctx, size_t dstStart); // Lay out a single word void doLayoutWord(const uint16_t* buf, size_t start, size_t count, size_t bufSize, bool isRtl, LayoutContext* ctx, size_t bufStart); // Lay out a single bidi run void doLayoutRun(const uint16_t* buf, size_t start, size_t count, size_t bufSize, bool isRtl, LayoutContext* ctx); // Append another layout (for example, cached value) into this one void appendLayout(Layout* src, size_t start); // deprecated - remove when setProperties is removed std::string mCssString; std::vector mGlyphs; std::vector mAdvances; const FontCollection* mCollection; std::vector mFaces; float mAdvance; MinikinRect mBounds; }; } // namespace android #endif // MINIKIN_LAYOUT_H