OpenGLRenderer.h revision 8a4ac610e1aaf04931ac1af54b146a7fc8e66114
15460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao/* 25460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * Copyright (C) 2010 The Android Open Source Project 35460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * 45460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * Licensed under the Apache License, Version 2.0 (the "License"); 55460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * you may not use this file except in compliance with the License. 65460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * You may obtain a copy of the License at 75460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * 85460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * http://www.apache.org/licenses/LICENSE-2.0 937b74a387bb3993387029859c2d9d051c41c724eStephen Hines * 1037b74a387bb3993387029859c2d9d051c41c724eStephen Hines * Unless required by applicable law or agreed to in writing, software 1137b74a387bb3993387029859c2d9d051c41c724eStephen Hines * distributed under the License is distributed on an "AS IS" BASIS, 1237b74a387bb3993387029859c2d9d051c41c724eStephen Hines * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1337b74a387bb3993387029859c2d9d051c41c724eStephen Hines * See the License for the specific language governing permissions and 1437b74a387bb3993387029859c2d9d051c41c724eStephen Hines * limitations under the License. 155460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao */ 165460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 176f75755c9204b1d8817ae5a65a2f7e5af0ec3f70Stephen Hines#ifndef ANDROID_HWUI_OPENGL_RENDERER_H 185460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#define ANDROID_HWUI_OPENGL_RENDERER_H 195460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 205460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <GLES2/gl2.h> 215460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <GLES2/gl2ext.h> 225460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 235460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <SkBitmap.h> 245460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <SkMatrix.h> 255460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <SkPaint.h> 265460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <SkRegion.h> 275460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <SkShader.h> 28551ae4ebd3e9d137ea668fb83ae4a55b8cfba451Stephen Hines#include <SkXfermode.h> 295460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 305460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <utils/Functor.h> 3137b74a387bb3993387029859c2d9d051c41c724eStephen Hines#include <utils/RefBase.h> 3237b74a387bb3993387029859c2d9d051c41c724eStephen Hines#include <utils/SortedVector.h> 3337b74a387bb3993387029859c2d9d051c41c724eStephen Hines#include <utils/Vector.h> 345460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 355460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include <cutils/compiler.h> 3637b74a387bb3993387029859c2d9d051c41c724eStephen Hines 3737b74a387bb3993387029859c2d9d051c41c724eStephen Hines#include "Debug.h" 3837b74a387bb3993387029859c2d9d051c41c724eStephen Hines#include "Extensions.h" 395460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include "Matrix.h" 405460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include "Program.h" 4137b74a387bb3993387029859c2d9d051c41c724eStephen Hines#include "Rect.h" 425460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include "Snapshot.h" 435460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include "Vertex.h" 445460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include "SkiaShader.h" 455460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include "SkiaColorFilter.h" 465460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao#include "Caches.h" 475460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 485460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liaonamespace android { 495460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liaonamespace uirenderer { 505460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 515460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao/////////////////////////////////////////////////////////////////////////////// 525460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao// Renderer 535460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao/////////////////////////////////////////////////////////////////////////////// 545460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 555460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liaoclass DisplayList; 565460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 575460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao/** 585460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * OpenGL renderer used to draw accelerated 2D graphics. The API is a 595460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao * simplified version of Skia's Canvas API. 605460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao */ 615460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liaoclass OpenGLRenderer { 625460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liaopublic: 635460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao ANDROID_API OpenGLRenderer(); 645460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual ~OpenGLRenderer(); 655460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 665460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual bool isDeferred(); 675460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 685460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual void setViewport(int width, int height); 695460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 7037b74a387bb3993387029859c2d9d051c41c724eStephen Hines ANDROID_API int prepare(bool opaque); 715460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual int prepareDirty(float left, float top, float right, float bottom, bool opaque); 7237b74a387bb3993387029859c2d9d051c41c724eStephen Hines virtual void finish(); 735460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 745460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao // These two calls must not be recorded in display lists 755460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual void interrupt(); 765460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual void resume(); 775460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 785460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao ANDROID_API status_t invokeFunctors(Rect& dirty); 795460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao ANDROID_API void detachFunctor(Functor* functor); 805460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao ANDROID_API void attachFunctor(Functor* functor); 815460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual status_t callDrawGLFunction(Functor* functor, Rect& dirty); 825460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 835460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao ANDROID_API int getSaveCount() const; 845460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual int save(int flags); 855460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual void restore(); 865460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual void restoreToCount(int saveCount); 875460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao 885460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual int saveLayer(float left, float top, float right, float bottom, 895460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao SkPaint* p, int flags); 905460a1f25d9ddecb5c70667267d66d51af177a99Shih-wei Liao virtual int saveLayerAlpha(float left, float top, float right, float bottom, 9137b74a387bb3993387029859c2d9d051c41c724eStephen Hines int alpha, int flags); 92affc150dc44fab1911775a49636d0ce85333b634Zonr Chang 9337b74a387bb3993387029859c2d9d051c41c724eStephen Hines void setAlpha(float alpha) { 94 mSnapshot->alpha = alpha; 95 } 96 97 virtual void translate(float dx, float dy); 98 virtual void rotate(float degrees); 99 virtual void scale(float sx, float sy); 100 virtual void skew(float sx, float sy); 101 102 ANDROID_API void getMatrix(SkMatrix* matrix); 103 virtual void setMatrix(SkMatrix* matrix); 104 virtual void concatMatrix(SkMatrix* matrix); 105 106 ANDROID_API const Rect& getClipBounds(); 107 ANDROID_API bool quickReject(float left, float top, float right, float bottom); 108 bool quickRejectNoScissor(float left, float top, float right, float bottom); 109 virtual bool clipRect(float left, float top, float right, float bottom, SkRegion::Op op); 110 virtual Rect* getClipRect(); 111 112 virtual status_t drawDisplayList(DisplayList* displayList, Rect& dirty, int32_t flags, 113 uint32_t level = 0); 114 virtual void outputDisplayList(DisplayList* displayList, uint32_t level = 0); 115 virtual status_t drawLayer(Layer* layer, float x, float y, SkPaint* paint); 116 virtual status_t drawBitmap(SkBitmap* bitmap, float left, float top, SkPaint* paint); 117 virtual status_t drawBitmap(SkBitmap* bitmap, SkMatrix* matrix, SkPaint* paint); 118 virtual status_t drawBitmap(SkBitmap* bitmap, float srcLeft, float srcTop, 119 float srcRight, float srcBottom, float dstLeft, float dstTop, 120 float dstRight, float dstBottom, SkPaint* paint); 121 virtual status_t drawBitmapData(SkBitmap* bitmap, float left, float top, SkPaint* paint); 122 virtual status_t drawBitmapMesh(SkBitmap* bitmap, int meshWidth, int meshHeight, 123 float* vertices, int* colors, SkPaint* paint); 124 virtual status_t drawPatch(SkBitmap* bitmap, const int32_t* xDivs, const int32_t* yDivs, 125 const uint32_t* colors, uint32_t width, uint32_t height, int8_t numColors, 126 float left, float top, float right, float bottom, SkPaint* paint); 127 status_t drawPatch(SkBitmap* bitmap, const int32_t* xDivs, const int32_t* yDivs, 128 const uint32_t* colors, uint32_t width, uint32_t height, int8_t numColors, 129 float left, float top, float right, float bottom, int alpha, SkXfermode::Mode mode); 130 virtual status_t drawColor(int color, SkXfermode::Mode mode); 131 virtual status_t drawRect(float left, float top, float right, float bottom, SkPaint* paint); 132 virtual status_t drawRoundRect(float left, float top, float right, float bottom, 133 float rx, float ry, SkPaint* paint); 134 virtual status_t drawCircle(float x, float y, float radius, SkPaint* paint); 135 virtual status_t drawOval(float left, float top, float right, float bottom, SkPaint* paint); 136 virtual status_t drawArc(float left, float top, float right, float bottom, 137 float startAngle, float sweepAngle, bool useCenter, SkPaint* paint); 138 virtual status_t drawPath(SkPath* path, SkPaint* paint); 139 virtual status_t drawLines(float* points, int count, SkPaint* paint); 140 virtual status_t drawPoints(float* points, int count, SkPaint* paint); 141 virtual status_t drawText(const char* text, int bytesCount, int count, float x, float y, 142 SkPaint* paint, float length = -1.0f); 143 virtual status_t drawTextOnPath(const char* text, int bytesCount, int count, SkPath* path, 144 float hOffset, float vOffset, SkPaint* paint); 145 virtual status_t drawPosText(const char* text, int bytesCount, int count, 146 const float* positions, SkPaint* paint); 147 148 virtual void resetShader(); 149 virtual void setupShader(SkiaShader* shader); 150 151 virtual void resetColorFilter(); 152 virtual void setupColorFilter(SkiaColorFilter* filter); 153 154 virtual void resetShadow(); 155 virtual void setupShadow(float radius, float dx, float dy, int color); 156 157 virtual void resetPaintFilter(); 158 virtual void setupPaintFilter(int clearBits, int setBits); 159 160 SkPaint* filterPaint(SkPaint* paint); 161 162 ANDROID_API static uint32_t getStencilSize(); 163 164 void startMark(const char* name) const; 165 void endMark() const; 166 167protected: 168 /** 169 * Compose the layer defined in the current snapshot with the layer 170 * defined by the previous snapshot. 171 * 172 * The current snapshot *must* be a layer (flag kFlagIsLayer set.) 173 * 174 * @param curent The current snapshot containing the layer to compose 175 * @param previous The previous snapshot to compose the current layer with 176 */ 177 virtual void composeLayer(sp<Snapshot> current, sp<Snapshot> previous); 178 179 /** 180 * Marks the specified region as dirty at the specified bounds. 181 */ 182 void dirtyLayerUnchecked(Rect& bounds, Region* region); 183 184 /** 185 * Returns the current snapshot. 186 */ 187 sp<Snapshot> getSnapshot() { 188 return mSnapshot; 189 } 190 191 /** 192 * Returns the region of the current layer. 193 */ 194 virtual Region* getRegion() { 195 return mSnapshot->region; 196 } 197 198 /** 199 * Indicates whether rendering is currently targeted at a layer. 200 */ 201 virtual bool hasLayer() { 202 return (mSnapshot->flags & Snapshot::kFlagFboTarget) && mSnapshot->region; 203 } 204 205 /** 206 * Returns the name of the FBO this renderer is rendering into. 207 */ 208 virtual GLint getTargetFbo() { 209 return 0; 210 } 211 212 /** 213 * Renders the specified layer as a textured quad. 214 * 215 * @param layer The layer to render 216 * @param rect The bounds of the layer 217 */ 218 void drawTextureLayer(Layer* layer, const Rect& rect); 219 220 /** 221 * Gets the alpha and xfermode out of a paint object. If the paint is null 222 * alpha will be 255 and the xfermode will be SRC_OVER. 223 * 224 * @param paint The paint to extract values from 225 * @param alpha Where to store the resulting alpha 226 * @param mode Where to store the resulting xfermode 227 */ 228 inline void getAlphaAndMode(SkPaint* paint, int* alpha, SkXfermode::Mode* mode); 229 230 /** 231 * Gets the alpha and xfermode out of a paint object. If the paint is null 232 * alpha will be 255 and the xfermode will be SRC_OVER. This method does 233 * not multiply the paint's alpha by the current snapshot's alpha. 234 * 235 * @param paint The paint to extract values from 236 * @param alpha Where to store the resulting alpha 237 * @param mode Where to store the resulting xfermode 238 */ 239 static inline void getAlphaAndModeDirect(SkPaint* paint, int* alpha, SkXfermode::Mode* mode) { 240 if (paint) { 241 *mode = getXfermode(paint->getXfermode()); 242 243 // Skia draws using the color's alpha channel if < 255 244 // Otherwise, it uses the paint's alpha 245 int color = paint->getColor(); 246 *alpha = (color >> 24) & 0xFF; 247 if (*alpha == 255) { 248 *alpha = paint->getAlpha(); 249 } 250 } else { 251 *mode = SkXfermode::kSrcOver_Mode; 252 *alpha = 255; 253 } 254 } 255 256 /** 257 * Safely retrieves the mode from the specified xfermode. If the specified 258 * xfermode is null, the mode is assumed to be SkXfermode::kSrcOver_Mode. 259 */ 260 static inline SkXfermode::Mode getXfermode(SkXfermode* mode) { 261 SkXfermode::Mode resultMode; 262 if (!SkXfermode::AsMode(mode, &resultMode)) { 263 resultMode = SkXfermode::kSrcOver_Mode; 264 } 265 return resultMode; 266 } 267 268private: 269 /** 270 * Ensures the state of the renderer is the same as the state of 271 * the GL context. 272 */ 273 void syncState(); 274 275 /** 276 * Saves the current state of the renderer as a new snapshot. 277 * The new snapshot is saved in mSnapshot and the previous snapshot 278 * is linked from mSnapshot->previous. 279 * 280 * @param flags The save flags; see SkCanvas for more information 281 * 282 * @return The new save count. This value can be passed to #restoreToCount() 283 */ 284 int saveSnapshot(int flags); 285 286 /** 287 * Restores the current snapshot; mSnapshot becomes mSnapshot->previous. 288 * 289 * @return True if the clip was modified. 290 */ 291 bool restoreSnapshot(); 292 293 /** 294 * Sets the clipping rectangle using glScissor. The clip is defined by 295 * the current snapshot's clipRect member. 296 */ 297 void setScissorFromClip(); 298 299 /** 300 * Creates a new layer stored in the specified snapshot. 301 * 302 * @param snapshot The snapshot associated with the new layer 303 * @param left The left coordinate of the layer 304 * @param top The top coordinate of the layer 305 * @param right The right coordinate of the layer 306 * @param bottom The bottom coordinate of the layer 307 * @param alpha The translucency of the layer 308 * @param mode The blending mode of the layer 309 * @param flags The layer save flags 310 * @param previousFbo The name of the current framebuffer 311 * 312 * @return True if the layer was successfully created, false otherwise 313 */ 314 bool createLayer(sp<Snapshot> snapshot, float left, float top, float right, float bottom, 315 int alpha, SkXfermode::Mode mode, int flags, GLuint previousFbo); 316 317 /** 318 * Creates a new layer stored in the specified snapshot as an FBO. 319 * 320 * @param layer The layer to store as an FBO 321 * @param snapshot The snapshot associated with the new layer 322 * @param bounds The bounds of the layer 323 * @param previousFbo The name of the current framebuffer 324 */ 325 bool createFboLayer(Layer* layer, Rect& bounds, sp<Snapshot> snapshot, 326 GLuint previousFbo); 327 328 /** 329 * Compose the specified layer as a region. 330 * 331 * @param layer The layer to compose 332 * @param rect The layer's bounds 333 */ 334 void composeLayerRegion(Layer* layer, const Rect& rect); 335 336 /** 337 * Compose the specified layer as a simple rectangle. 338 * 339 * @param layer The layer to compose 340 * @param rect The layer's bounds 341 * @param swap If true, the source and destination are swapped 342 */ 343 void composeLayerRect(Layer* layer, const Rect& rect, bool swap = false); 344 345 /** 346 * Clears all the regions corresponding to the current list of layers. 347 * This method MUST be invoked before any drawing operation. 348 */ 349 void clearLayerRegions(); 350 351 /** 352 * Mark the layer as dirty at the specified coordinates. The coordinates 353 * are transformed with the supplied matrix. 354 */ 355 void dirtyLayer(const float left, const float top, 356 const float right, const float bottom, const mat4 transform); 357 358 /** 359 * Mark the layer as dirty at the specified coordinates. 360 */ 361 void dirtyLayer(const float left, const float top, 362 const float right, const float bottom); 363 364 /** 365 * Draws a colored rectangle with the specified color. The specified coordinates 366 * are transformed by the current snapshot's transform matrix. 367 * 368 * @param left The left coordinate of the rectangle 369 * @param top The top coordinate of the rectangle 370 * @param right The right coordinate of the rectangle 371 * @param bottom The bottom coordinate of the rectangle 372 * @param color The rectangle's ARGB color, defined as a packed 32 bits word 373 * @param mode The Skia xfermode to use 374 * @param ignoreTransform True if the current transform should be ignored 375 * @param ignoreBlending True if the blending is set by the caller 376 */ 377 void drawColorRect(float left, float top, float right, float bottom, 378 int color, SkXfermode::Mode mode, bool ignoreTransform = false); 379 380 /** 381 * Draws the shape represented by the specified path texture. 382 * This method invokes drawPathTexture() but takes into account 383 * the extra left/top offset and the texture offset to correctly 384 * position the final shape. 385 * 386 * @param left The left coordinate of the shape to render 387 * @param top The top coordinate of the shape to render 388 * @param texture The texture reprsenting the shape 389 * @param paint The paint to draw the shape with 390 */ 391 status_t drawShape(float left, float top, const PathTexture* texture, SkPaint* paint); 392 393 /** 394 * Renders the rect defined by the specified bounds as a shape. 395 * This will render the rect using a path texture, which is used to render 396 * rects with stroke effects. 397 * 398 * @param left The left coordinate of the rect to draw 399 * @param top The top coordinate of the rect to draw 400 * @param right The right coordinate of the rect to draw 401 * @param bottom The bottom coordinate of the rect to draw 402 * @param p The paint to draw the rect with 403 */ 404 status_t drawRectAsShape(float left, float top, float right, float bottom, SkPaint* p); 405 406 /** 407 * Draws the specified texture as an alpha bitmap. Alpha bitmaps obey 408 * different compositing rules. 409 * 410 * @param texture The texture to draw with 411 * @param left The x coordinate of the bitmap 412 * @param top The y coordinate of the bitmap 413 * @param paint The paint to render with 414 */ 415 void drawAlphaBitmap(Texture* texture, float left, float top, SkPaint* paint); 416 417 /** 418 * Renders the rect defined by the specified bounds as an anti-aliased rect. 419 * 420 * @param left The left coordinate of the rect to draw 421 * @param top The top coordinate of the rect to draw 422 * @param right The right coordinate of the rect to draw 423 * @param bottom The bottom coordinate of the rect to draw 424 * @param color The color of the rect 425 * @param mode The blending mode to draw the rect 426 */ 427 void drawAARect(float left, float top, float right, float bottom, 428 int color, SkXfermode::Mode mode); 429 430 /** 431 * Draws a textured rectangle with the specified texture. The specified coordinates 432 * are transformed by the current snapshot's transform matrix. 433 * 434 * @param left The left coordinate of the rectangle 435 * @param top The top coordinate of the rectangle 436 * @param right The right coordinate of the rectangle 437 * @param bottom The bottom coordinate of the rectangle 438 * @param texture The texture name to map onto the rectangle 439 * @param alpha An additional translucency parameter, between 0.0f and 1.0f 440 * @param mode The blending mode 441 * @param blend True if the texture contains an alpha channel 442 */ 443 void drawTextureRect(float left, float top, float right, float bottom, GLuint texture, 444 float alpha, SkXfermode::Mode mode, bool blend); 445 446 /** 447 * Draws a textured rectangle with the specified texture. The specified coordinates 448 * are transformed by the current snapshot's transform matrix. 449 * 450 * @param left The left coordinate of the rectangle 451 * @param top The top coordinate of the rectangle 452 * @param right The right coordinate of the rectangle 453 * @param bottom The bottom coordinate of the rectangle 454 * @param texture The texture to use 455 * @param paint The paint containing the alpha, blending mode, etc. 456 */ 457 void drawTextureRect(float left, float top, float right, float bottom, 458 Texture* texture, SkPaint* paint); 459 460 /** 461 * Draws a textured mesh with the specified texture. If the indices are omitted, 462 * the mesh is drawn as a simple quad. The mesh pointers become offsets when a 463 * VBO is bound. 464 * 465 * @param left The left coordinate of the rectangle 466 * @param top The top coordinate of the rectangle 467 * @param right The right coordinate of the rectangle 468 * @param bottom The bottom coordinate of the rectangle 469 * @param texture The texture name to map onto the rectangle 470 * @param alpha An additional translucency parameter, between 0.0f and 1.0f 471 * @param mode The blending mode 472 * @param blend True if the texture contains an alpha channel 473 * @param vertices The vertices that define the mesh 474 * @param texCoords The texture coordinates of each vertex 475 * @param elementsCount The number of elements in the mesh, required by indices 476 * @param swapSrcDst Whether or not the src and dst blending operations should be swapped 477 * @param ignoreTransform True if the current transform should be ignored 478 * @param vbo The VBO used to draw the mesh 479 * @param ignoreScale True if the model view matrix should not be scaled 480 * @param dirty True if calling this method should dirty the current layer 481 */ 482 void drawTextureMesh(float left, float top, float right, float bottom, GLuint texture, 483 float alpha, SkXfermode::Mode mode, bool blend, 484 GLvoid* vertices, GLvoid* texCoords, GLenum drawMode, GLsizei elementsCount, 485 bool swapSrcDst = false, bool ignoreTransform = false, GLuint vbo = 0, 486 bool ignoreScale = false, bool dirty = true); 487 488 /** 489 * Draws text underline and strike-through if needed. 490 * 491 * @param text The text to decor 492 * @param bytesCount The number of bytes in the text 493 * @param length The length in pixels of the text, can be <= 0.0f to force a measurement 494 * @param x The x coordinate where the text will be drawn 495 * @param y The y coordinate where the text will be drawn 496 * @param paint The paint to draw the text with 497 */ 498 void drawTextDecorations(const char* text, int bytesCount, float length, 499 float x, float y, SkPaint* paint); 500 501 /** 502 * Draws a path texture. Path textures are alpha8 bitmaps that need special 503 * compositing to apply colors/filters/etc. 504 * 505 * @param texture The texture to render 506 * @param x The x coordinate where the texture will be drawn 507 * @param y The y coordinate where the texture will be drawn 508 * @param paint The paint to draw the texture with 509 */ 510 void drawPathTexture(const PathTexture* texture, float x, float y, SkPaint* paint); 511 512 /** 513 * Resets the texture coordinates stored in mMeshVertices. Setting the values 514 * back to default is achieved by calling: 515 * 516 * resetDrawTextureTexCoords(0.0f, 0.0f, 1.0f, 1.0f); 517 * 518 * @param u1 The left coordinate of the texture 519 * @param v1 The bottom coordinate of the texture 520 * @param u2 The right coordinate of the texture 521 * @param v2 The top coordinate of the texture 522 */ 523 void resetDrawTextureTexCoords(float u1, float v1, float u2, float v2); 524 525 /** 526 * Binds the specified texture. The texture unit must have been selected 527 * prior to calling this method. 528 */ 529 inline void bindTexture(GLuint texture) { 530 glBindTexture(GL_TEXTURE_2D, texture); 531 } 532 533 /** 534 * Binds the specified EGLImage texture. The texture unit must have been selected 535 * prior to calling this method. 536 */ 537 inline void bindExternalTexture(GLuint texture) { 538 glBindTexture(GL_TEXTURE_EXTERNAL_OES, texture); 539 } 540 541 /** 542 * Enable or disable blending as necessary. This function sets the appropriate 543 * blend function based on the specified xfermode. 544 */ 545 inline void chooseBlending(bool blend, SkXfermode::Mode mode, ProgramDescription& description, 546 bool swapSrcDst = false); 547 548 /** 549 * Use the specified program with the current GL context. If the program is already 550 * in use, it will not be bound again. If it is not in use, the current program is 551 * marked unused and the specified program becomes used and becomes the new 552 * current program. 553 * 554 * @param program The program to use 555 * 556 * @return true If the specified program was already in use, false otherwise. 557 */ 558 inline bool useProgram(Program* program); 559 560 /** 561 * Invoked before any drawing operation. This sets required state. 562 */ 563 void setupDraw(bool clear = true); 564 /** 565 * Various methods to setup OpenGL rendering. 566 */ 567 void setupDrawWithTexture(bool isAlpha8 = false); 568 void setupDrawWithExternalTexture(); 569 void setupDrawNoTexture(); 570 void setupDrawAALine(); 571 void setupDrawPoint(float pointSize); 572 void setupDrawColor(int color); 573 void setupDrawColor(int color, int alpha); 574 void setupDrawColor(float r, float g, float b, float a); 575 void setupDrawAlpha8Color(int color, int alpha); 576 void setupDrawTextGamma(const SkPaint* paint); 577 void setupDrawShader(); 578 void setupDrawColorFilter(); 579 void setupDrawBlending(SkXfermode::Mode mode = SkXfermode::kSrcOver_Mode, 580 bool swapSrcDst = false); 581 void setupDrawBlending(bool blend = true, SkXfermode::Mode mode = SkXfermode::kSrcOver_Mode, 582 bool swapSrcDst = false); 583 void setupDrawProgram(); 584 void setupDrawDirtyRegionsDisabled(); 585 void setupDrawModelViewIdentity(bool offset = false); 586 void setupDrawModelView(float left, float top, float right, float bottom, 587 bool ignoreTransform = false, bool ignoreModelView = false); 588 void setupDrawModelViewTranslate(float left, float top, float right, float bottom, 589 bool ignoreTransform = false); 590 void setupDrawPointUniforms(); 591 void setupDrawColorUniforms(); 592 void setupDrawPureColorUniforms(); 593 void setupDrawShaderIdentityUniforms(); 594 void setupDrawShaderUniforms(bool ignoreTransform = false); 595 void setupDrawColorFilterUniforms(); 596 void setupDrawSimpleMesh(); 597 void setupDrawTexture(GLuint texture); 598 void setupDrawExternalTexture(GLuint texture); 599 void setupDrawTextureTransform(); 600 void setupDrawTextureTransformUniforms(mat4& transform); 601 void setupDrawTextGammaUniforms(); 602 void setupDrawMesh(GLvoid* vertices, GLvoid* texCoords = NULL, GLuint vbo = 0); 603 void setupDrawMeshIndices(GLvoid* vertices, GLvoid* texCoords); 604 void setupDrawVertices(GLvoid* vertices); 605 void setupDrawAALine(GLvoid* vertices, GLvoid* distanceCoords, GLvoid* lengthCoords, 606 float strokeWidth, int& widthSlot, int& lengthSlot); 607 void finishDrawAALine(const int widthSlot, const int lengthSlot); 608 void finishDrawTexture(); 609 void accountForClear(SkXfermode::Mode mode); 610 611 void drawRegionRects(const Region& region); 612 613 /** 614 * Should be invoked every time the glScissor is modified. 615 */ 616 inline void dirtyClip() { 617 mDirtyClip = true; 618 } 619 620 // Dimensions of the drawing surface 621 int mWidth, mHeight; 622 623 // Matrix used for ortho projection in shaders 624 mat4 mOrthoMatrix; 625 626 // Model-view matrix used to position/size objects 627 mat4 mModelView; 628 629 // Number of saved states 630 int mSaveCount; 631 // Base state 632 sp<Snapshot> mFirstSnapshot; 633 // Current state 634 sp<Snapshot> mSnapshot; 635 636 // Shaders 637 SkiaShader* mShader; 638 639 // Color filters 640 SkiaColorFilter* mColorFilter; 641 642 // Used to draw textured quads 643 TextureVertex mMeshVertices[4]; 644 645 // Drop shadow 646 bool mHasShadow; 647 float mShadowRadius; 648 float mShadowDx; 649 float mShadowDy; 650 int mShadowColor; 651 652 // Draw filters 653 bool mHasDrawFilter; 654 int mPaintFilterClearBits; 655 int mPaintFilterSetBits; 656 SkPaint mFilteredPaint; 657 658 // Various caches 659 Caches& mCaches; 660 661 // List of rectangles to clear after saveLayer() is invoked 662 Vector<Rect*> mLayers; 663 // List of functors to invoke after a frame is drawn 664 SortedVector<Functor*> mFunctors; 665 666 // Indentity matrix 667 const mat4 mIdentity; 668 669 // Indicates whether the clip must be restored 670 bool mDirtyClip; 671 672 // The following fields are used to setup drawing 673 // Used to describe the shaders to generate 674 ProgramDescription mDescription; 675 // Color description 676 bool mColorSet; 677 float mColorA, mColorR, mColorG, mColorB; 678 // Indicates that the shader should get a color 679 bool mSetShaderColor; 680 // Current texture unit 681 GLuint mTextureUnit; 682 // Track dirty regions, true by default 683 bool mTrackDirtyRegions; 684 685 friend class DisplayListRenderer; 686 687}; // class OpenGLRenderer 688 689}; // namespace uirenderer 690}; // namespace android 691 692#endif // ANDROID_HWUI_OPENGL_RENDERER_H 693