FontRenderer.h revision e4d9a01bfc7451afff1ed399a5801c7aa2af2831 
1/*
2 * Copyright (C) 2010 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 ANDROID_HWUI_FONT_RENDERER_H
18#define ANDROID_HWUI_FONT_RENDERER_H
19
20#include <utils/LruCache.h>
21#include <utils/Vector.h>
22
23#include <SkPaint.h>
24
25#include <GLES2/gl2.h>
26
27#include "font/FontUtil.h"
28#include "font/CacheTexture.h"
29#include "font/CachedGlyphInfo.h"
30#include "font/Font.h"
31#include "utils/SortedList.h"
32#include "Matrix.h"
33#include "Properties.h"
34
35#ifdef ANDROID_ENABLE_RENDERSCRIPT
36namespace RSC {
37    class Element;
38    class RS;
39    class ScriptIntrinsicBlur;
40}
41#endif
42
43class Functor;
44
45namespace android {
46namespace uirenderer {
47
48///////////////////////////////////////////////////////////////////////////////
49// Renderer
50///////////////////////////////////////////////////////////////////////////////
51
52class FontRenderer {
53public:
54    FontRenderer();
55    ~FontRenderer();
56
57    void flushLargeCaches();
58
59    void setGammaTable(const uint8_t* gammaTable) {
60        mGammaTable = gammaTable;
61    }
62
63    void setFont(SkPaint* paint, const mat4& matrix);
64
65    void precache(SkPaint* paint, const char* text, int numGlyphs, const mat4& matrix);
66
67    // bounds is an out parameter
68    bool renderPosText(SkPaint* paint, const Rect* clip, const char *text, uint32_t startIndex,
69            uint32_t len, int numGlyphs, int x, int y, const float* positions, Rect* bounds,
70            Functor* functor);
71    // bounds is an out parameter
72    bool renderTextOnPath(SkPaint* paint, const Rect* clip, const char *text, uint32_t startIndex,
73            uint32_t len, int numGlyphs, SkPath* path, float hOffset, float vOffset, Rect* bounds);
74
75    struct DropShadow {
76        DropShadow() { };
77
78        DropShadow(const DropShadow& dropShadow):
79            width(dropShadow.width), height(dropShadow.height),
80            image(dropShadow.image), penX(dropShadow.penX),
81            penY(dropShadow.penY) {
82        }
83
84        uint32_t width;
85        uint32_t height;
86        uint8_t* image;
87        int32_t penX;
88        int32_t penY;
89    };
90
91    // After renderDropShadow returns, the called owns the memory in DropShadow.image
92    // and is responsible for releasing it when it's done with it
93    DropShadow renderDropShadow(SkPaint* paint, const char *text, uint32_t startIndex,
94            uint32_t len, int numGlyphs, uint32_t radius, const float* positions);
95
96    void setTextureFiltering(bool linearFiltering) {
97        mLinearFiltering = linearFiltering;
98    }
99
100    uint32_t getCacheSize() const {
101        uint32_t size = 0;
102        for (uint32_t i = 0; i < mCacheTextures.size(); i++) {
103            CacheTexture* cacheTexture = mCacheTextures[i];
104            if (cacheTexture && cacheTexture->getTexture()) {
105                size += cacheTexture->getWidth() * cacheTexture->getHeight();
106            }
107        }
108        return size;
109    }
110
111private:
112    friend class Font;
113
114    const uint8_t* mGammaTable;
115
116    void allocateTextureMemory(CacheTexture* cacheTexture);
117    void deallocateTextureMemory(CacheTexture* cacheTexture);
118    void initTextTexture();
119    CacheTexture* createCacheTexture(int width, int height, bool allocate);
120    void cacheBitmap(const SkGlyph& glyph, CachedGlyphInfo* cachedGlyph,
121            uint32_t *retOriginX, uint32_t *retOriginY, bool precaching);
122    CacheTexture* cacheBitmapInTexture(const SkGlyph& glyph, uint32_t* startX, uint32_t* startY);
123
124    void flushAllAndInvalidate();
125    void initVertexArrayBuffers();
126
127    void checkInit();
128    void initRender(const Rect* clip, Rect* bounds, Functor* functor);
129    void finishRender();
130
131    void issueDrawCommand();
132    void appendMeshQuadNoClip(float x1, float y1, float u1, float v1,
133            float x2, float y2, float u2, float v2,
134            float x3, float y3, float u3, float v3,
135            float x4, float y4, float u4, float v4, CacheTexture* texture);
136    void appendMeshQuad(float x1, float y1, float u1, float v1,
137            float x2, float y2, float u2, float v2,
138            float x3, float y3, float u3, float v3,
139            float x4, float y4, float u4, float v4, CacheTexture* texture);
140    void appendRotatedMeshQuad(float x1, float y1, float u1, float v1,
141            float x2, float y2, float u2, float v2,
142            float x3, float y3, float u3, float v3,
143            float x4, float y4, float u4, float v4, CacheTexture* texture);
144
145    void removeFont(const Font* font);
146
147    void checkTextureUpdate();
148
149    void setTextureDirty() {
150        mUploadTexture = true;
151    }
152
153    uint32_t mSmallCacheWidth;
154    uint32_t mSmallCacheHeight;
155    uint32_t mLargeCacheWidth;
156    uint32_t mLargeCacheHeight;
157
158    Vector<CacheTexture*> mCacheTextures;
159
160    Font* mCurrentFont;
161    LruCache<Font::FontDescription, Font*> mActiveFonts;
162
163    CacheTexture* mCurrentCacheTexture;
164
165    bool mUploadTexture;
166
167    uint32_t mMaxNumberOfQuads;
168    uint32_t mIndexBufferID;
169
170    Functor* mFunctor;
171    const Rect* mClip;
172    Rect* mBounds;
173    bool mDrawn;
174
175    bool mInitialized;
176
177    bool mLinearFiltering;
178
179#ifdef ANDROID_ENABLE_RENDERSCRIPT
180    // RS constructs
181    sp<RSC::RS> mRs;
182    sp<const RSC::Element> mRsElement;
183    sp<RSC::ScriptIntrinsicBlur> mRsScript;
184#endif
185
186    static void computeGaussianWeights(float* weights, int32_t radius);
187    static void horizontalBlur(float* weights, int32_t radius, const uint8_t *source, uint8_t *dest,
188            int32_t width, int32_t height);
189    static void verticalBlur(float* weights, int32_t radius, const uint8_t *source, uint8_t *dest,
190            int32_t width, int32_t height);
191
192    // the input image handle may have its pointer replaced (to avoid copies)
193    void blurImage(uint8_t** image, int32_t width, int32_t height, int32_t radius);
194};
195
196}; // namespace uirenderer
197}; // namespace android
198
199#endif // ANDROID_HWUI_FONT_RENDERER_H
200