1 /* 2 * Copyright (C) 2011 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_DRAW_GL_INFO_H 18 #define ANDROID_HWUI_DRAW_GL_INFO_H 19 20 namespace android { 21 namespace uirenderer { 22 23 /** 24 * Structure used by OpenGLRenderer::callDrawGLFunction() to pass and 25 * receive data from OpenGL functors. 26 */ 27 struct DrawGlInfo { 28 // Input: current clip rect 29 int clipLeft; 30 int clipTop; 31 int clipRight; 32 int clipBottom; 33 34 // Input: current width/height of destination surface 35 int width; 36 int height; 37 38 // Input: is the render target an FBO 39 bool isLayer; 40 41 // Input: current transform matrix, in OpenGL format 42 float transform[16]; 43 44 // Output: dirty region to redraw 45 float dirtyLeft; 46 float dirtyTop; 47 float dirtyRight; 48 float dirtyBottom; 49 50 /** 51 * Values used as the "what" parameter of the functor. 52 */ 53 enum Mode { 54 // Indicates that the functor is called to perform a draw 55 kModeDraw, 56 // Indicates the the functor is called only to perform 57 // processing and that no draw should be attempted 58 kModeProcess, 59 // Same as kModeProcess, however there is no GL context because it was 60 // lost or destroyed 61 kModeProcessNoContext, 62 // Invoked every time the UI thread pushes over a frame to the render thread 63 // *and the owning view has a dirty display list*. This is a signal to sync 64 // any data that needs to be shared between the UI thread and the render thread. 65 // During this time the UI thread is blocked. 66 kModeSync 67 }; 68 69 /** 70 * Values used by OpenGL functors to tell the framework 71 * what to do next. 72 */ 73 enum Status { 74 // The functor is done 75 kStatusDone = 0x0, 76 // DisplayList actually issued GL drawing commands. 77 // This is used to signal the HardwareRenderer that the 78 // buffers should be flipped - otherwise, there were no 79 // changes to the buffer, so no need to flip. Some hardware 80 // has issues with stale buffer contents when no GL 81 // commands are issued. 82 kStatusDrew = 0x4 83 }; 84 }; // struct DrawGlInfo 85 86 }; // namespace uirenderer 87 }; // namespace android 88 89 #endif // ANDROID_HWUI_DRAW_GL_INFO_H 90