Layout.h revision 86fa46c5ebb0d2c3319e08f4fbf487d8c2abbbfc
19cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien/* 29cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * Copyright (C) 2013 The Android Open Source Project 39cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * 49cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * Licensed under the Apache License, Version 2.0 (the "License"); 59cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * you may not use this file except in compliance with the License. 69cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * You may obtain a copy of the License at 79cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * 89cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * http://www.apache.org/licenses/LICENSE-2.0 99cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * 109cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * Unless required by applicable law or agreed to in writing, software 119cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * distributed under the License is distributed on an "AS IS" BASIS, 129cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * See the License for the specific language governing permissions and 149cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien * limitations under the License. 159cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien */ 169cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 179cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien#ifndef MINIKIN_LAYOUT_H 189cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien#define MINIKIN_LAYOUT_H 199cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 209cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien#include <hb.h> 219cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 229cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien#include <vector> 239cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 249cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien#include <minikin/CssParse.h> 259cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien#include <minikin/FontCollection.h> 26bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien#include <minikin/MinikinFontFreeType.h> 279cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 289cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Leviennamespace android { 299cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 309cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien// The Bitmap class is for debugging. We'll probably move it out 319cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien// of here into a separate lightweight software rendering module 329cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien// (optional, as we'd hope most clients would do their own) 339cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levienclass Bitmap { 349cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levienpublic: 359cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien Bitmap(int width, int height); 369cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien ~Bitmap(); 379cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien void writePnm(std::ofstream& o) const; 38bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien void drawGlyph(const GlyphBitmap& bitmap, int x, int y); 399cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levienprivate: 409cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien int width; 419cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien int height; 429cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien uint8_t* buf; 439cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien}; 449cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 459cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levienstruct LayoutGlyph { 469cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // index into mFaces and mHbFonts vectors. We could imagine 479cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // moving this into a run length representation, because it's 489cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // more efficient for long strings, and we'll probably need 499cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // something like that for paint attributes (color, underline, 509cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // fake b/i, etc), as having those per-glyph is bloated. 519cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien int font_ix; 529cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 539cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien unsigned int glyph_id; 549cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien float x; 559cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien float y; 569cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien}; 579cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 58c31e3883456e018d742e9f29815ba5ff8b315ea1Raph Levien// Lifecycle and threading assumptions for Layout: 59c31e3883456e018d742e9f29815ba5ff8b315ea1Raph Levien// The object is assumed to be owned by a single thread; multiple threads 60c31e3883456e018d742e9f29815ba5ff8b315ea1Raph Levien// may not mutate it at the same time. 61c31e3883456e018d742e9f29815ba5ff8b315ea1Raph Levien// The lifetime of the FontCollection set through setFontCollection must 62c31e3883456e018d742e9f29815ba5ff8b315ea1Raph Levien// extend through the lifetime of the Layout object. 639cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levienclass Layout { 649cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levienpublic: 65c31e3883456e018d742e9f29815ba5ff8b315ea1Raph Levien ~Layout(); 66ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien 679cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien void dump() const; 68ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien void setFontCollection(const FontCollection* collection); 699cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien void doLayout(const uint16_t* buf, size_t nchars); 709cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien void draw(Bitmap*, int x0, int y0) const; 719cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien void setProperties(const std::string css); 729cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 739cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // This must be called before any invocations. 749cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // TODO: probably have a factory instead 759cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien static void init(); 76ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien 77ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien // public accessors 78ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien size_t nGlyphs() const; 79ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien // Does not bump reference; ownership is still layout 80ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien MinikinFont *getFont(int i) const; 81ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien unsigned int getGlyphId(int i) const; 82ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien float getX(int i) const; 83ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien float getY(int i) const; 84ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien 85ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien float getAdvance() const; 86ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien 87ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien // Get advances, copying into caller-provided buffer. The size of this 88ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien // buffer must match the length of the string (nchars arg to doLayout). 89ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien void getAdvances(float* advances); 90ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien 91ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien void getBounds(MinikinRect* rect); 92ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien 939cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levienprivate: 949cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // Find a face in the mFaces vector, or create a new entry 95bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien int findFace(MinikinFont* face, MinikinPaint* paint); 969cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 9786fa46c5ebb0d2c3319e08f4fbf487d8c2abbbfcRaph Levien // Lay out a single bidi run 9886fa46c5ebb0d2c3319e08f4fbf487d8c2abbbfcRaph Levien void doLayoutRun(const uint16_t* buf, size_t start, size_t count, size_t bufSize, 9986fa46c5ebb0d2c3319e08f4fbf487d8c2abbbfcRaph Levien bool isRtl, FontStyle style, MinikinPaint& paint); 10086fa46c5ebb0d2c3319e08f4fbf487d8c2abbbfcRaph Levien 1019cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien CssProperties mProps; // TODO: want spans 1029cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien std::vector<LayoutGlyph> mGlyphs; 103ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien std::vector<float> mAdvances; 1049cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 1059cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // In future, this will be some kind of mapping from the 1069cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // identifier used to represent font-family to a font collection. 1079cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // But for the time being, it should be ok to have just one 1089cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien // per layout. 109ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien const FontCollection* mCollection; 110bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien std::vector<MinikinFont *> mFaces; 1119cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien std::vector<hb_font_t *> mHbFonts; 112bcc3dc5a2591a95a57e379e27cbad69c18e91e67Raph Levien float mAdvance; 113ecc2d34ac23a497988f21e5f415b53c007b9d8c5Raph Levien MinikinRect mBounds; 1149cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien}; 1159cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 1169cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien} // namespace android 1179cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien 1189cc9bbe1461f359f0b27c5e7645c17dda001ab1dRaph Levien#endif // MINIKIN_LAYOUT_H 119