The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2007 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 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 17 | #include <stdlib.h> |
| 18 | #include <stdint.h> |
| 19 | #include <sys/types.h> |
| 20 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 21 | #include <cutils/compiler.h> |
Mathias Agopian | 076b1cc | 2009-04-10 14:24:30 -0700 | [diff] [blame] | 22 | #include <cutils/native_handle.h> |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 23 | #include <cutils/properties.h> |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 24 | |
| 25 | #include <utils/Errors.h> |
| 26 | #include <utils/Log.h> |
| 27 | #include <utils/StopWatch.h> |
| 28 | |
Mathias Agopian | 3330b20 | 2009-10-05 17:07:12 -0700 | [diff] [blame] | 29 | #include <ui/GraphicBuffer.h> |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 30 | #include <ui/PixelFormat.h> |
Mathias Agopian | 9cce325 | 2010-02-09 17:46:37 -0800 | [diff] [blame] | 31 | |
| 32 | #include <surfaceflinger/Surface.h> |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 33 | |
| 34 | #include "clz.h" |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 35 | #include "DisplayHardware/DisplayHardware.h" |
| 36 | #include "DisplayHardware/HWComposer.h" |
Mathias Agopian | 1f7bec6 | 2010-06-25 18:02:21 -0700 | [diff] [blame] | 37 | #include "GLExtensions.h" |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 38 | #include "Layer.h" |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 39 | #include "SurfaceFlinger.h" |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 40 | #include "SurfaceTextureLayer.h" |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 41 | |
| 42 | #define DEBUG_RESIZE 0 |
| 43 | |
| 44 | |
| 45 | namespace android { |
| 46 | |
| 47 | // --------------------------------------------------------------------------- |
| 48 | |
Mathias Agopian | 96f0819 | 2010-06-02 23:28:45 -0700 | [diff] [blame] | 49 | Layer::Layer(SurfaceFlinger* flinger, |
| 50 | DisplayID display, const sp<Client>& client) |
| 51 | : LayerBaseClient(flinger, display, client), |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 52 | mTextureName(-1U), |
| 53 | mQueuedFrames(0), |
| 54 | mCurrentTransform(0), |
Mathias Agopian | 933389f | 2011-07-18 16:15:08 -0700 | [diff] [blame] | 55 | mCurrentScalingMode(NATIVE_WINDOW_SCALING_MODE_FREEZE), |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 56 | mCurrentOpacity(true), |
Mathias Agopian | 5bf3abe | 2011-03-11 17:01:07 -0800 | [diff] [blame] | 57 | mFormat(PIXEL_FORMAT_NONE), |
Mathias Agopian | 1f7bec6 | 2010-06-25 18:02:21 -0700 | [diff] [blame] | 58 | mGLExtensions(GLExtensions::getInstance()), |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 59 | mOpaqueLayer(true), |
Mathias Agopian | d606de6 | 2010-05-10 20:06:11 -0700 | [diff] [blame] | 60 | mNeedsDithering(false), |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 61 | mSecure(false), |
Mathias Agopian | 933389f | 2011-07-18 16:15:08 -0700 | [diff] [blame] | 62 | mProtectedByApp(false) |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 63 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 64 | mCurrentCrop.makeInvalid(); |
| 65 | glGenTextures(1, &mTextureName); |
Mathias Agopian | d606de6 | 2010-05-10 20:06:11 -0700 | [diff] [blame] | 66 | } |
| 67 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 68 | void Layer::onFirstRef() |
Mathias Agopian | 96f0819 | 2010-06-02 23:28:45 -0700 | [diff] [blame] | 69 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 70 | LayerBaseClient::onFirstRef(); |
Mathias Agopian | ddc31c3 | 2011-06-12 18:05:53 -0700 | [diff] [blame] | 71 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 72 | struct FrameQueuedListener : public SurfaceTexture::FrameAvailableListener { |
| 73 | FrameQueuedListener(Layer* layer) : mLayer(layer) { } |
| 74 | private: |
| 75 | wp<Layer> mLayer; |
| 76 | virtual void onFrameAvailable() { |
| 77 | sp<Layer> that(mLayer.promote()); |
| 78 | if (that != 0) { |
| 79 | that->onFrameQueued(); |
| 80 | } |
| 81 | } |
| 82 | }; |
| 83 | mSurfaceTexture = new SurfaceTextureLayer(mTextureName, this); |
| 84 | mSurfaceTexture->setFrameAvailableListener(new FrameQueuedListener(this)); |
| 85 | mSurfaceTexture->setSynchronousMode(true); |
| 86 | mSurfaceTexture->setBufferCountServer(2); |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 87 | } |
| 88 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 89 | Layer::~Layer() |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 90 | { |
Mathias Agopian | 47d0812 | 2011-08-11 18:18:50 -0700 | [diff] [blame] | 91 | class MessageDestroyGLState : public MessageBase { |
| 92 | GLuint texture; |
| 93 | public: |
| 94 | MessageDestroyGLState(GLuint texture) : texture(texture) { } |
| 95 | virtual bool handler() { |
| 96 | glDeleteTextures(1, &texture); |
| 97 | return true; |
| 98 | } |
| 99 | }; |
| 100 | mFlinger->postMessageAsync( new MessageDestroyGLState(mTextureName) ); |
Mathias Agopian | 96f0819 | 2010-06-02 23:28:45 -0700 | [diff] [blame] | 101 | } |
| 102 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 103 | void Layer::onFrameQueued() { |
Jamie Gennis | 3d8063b | 2011-06-26 18:27:47 -0700 | [diff] [blame] | 104 | android_atomic_inc(&mQueuedFrames); |
| 105 | mFlinger->signalEvent(); |
Mathias Agopian | 579b3f8 | 2010-06-08 19:54:15 -0700 | [diff] [blame] | 106 | } |
| 107 | |
Mathias Agopian | d606de6 | 2010-05-10 20:06:11 -0700 | [diff] [blame] | 108 | // called with SurfaceFlinger::mStateLock as soon as the layer is entered |
| 109 | // in the purgatory list |
| 110 | void Layer::onRemoved() |
| 111 | { |
Jamie Gennis | dbe6486 | 2011-07-30 14:33:49 -0700 | [diff] [blame] | 112 | mSurfaceTexture->abandon(); |
Mathias Agopian | 48d819a | 2009-09-10 19:41:18 -0700 | [diff] [blame] | 113 | } |
Mathias Agopian | cbb288b | 2009-09-07 16:32:45 -0700 | [diff] [blame] | 114 | |
Jamie Gennis | a249f2d | 2011-09-16 17:31:54 -0700 | [diff] [blame] | 115 | void Layer::setName(const String8& name) { |
| 116 | LayerBase::setName(name); |
| 117 | mSurfaceTexture->setName(name); |
| 118 | } |
| 119 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 120 | sp<ISurface> Layer::createSurface() |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 121 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 122 | class BSurface : public BnSurface, public LayerCleaner { |
| 123 | wp<const Layer> mOwner; |
| 124 | virtual sp<ISurfaceTexture> getSurfaceTexture() const { |
| 125 | sp<ISurfaceTexture> res; |
| 126 | sp<const Layer> that( mOwner.promote() ); |
| 127 | if (that != NULL) { |
| 128 | res = that->mSurfaceTexture; |
| 129 | } |
| 130 | return res; |
| 131 | } |
| 132 | public: |
| 133 | BSurface(const sp<SurfaceFlinger>& flinger, |
| 134 | const sp<Layer>& layer) |
| 135 | : LayerCleaner(flinger, layer), mOwner(layer) { } |
| 136 | }; |
| 137 | sp<ISurface> sur(new BSurface(mFlinger, this)); |
Mathias Agopian | a1f47b9 | 2011-02-15 19:01:06 -0800 | [diff] [blame] | 138 | return sur; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 139 | } |
| 140 | |
Jamie Gennis | 582270d | 2011-08-17 18:19:00 -0700 | [diff] [blame] | 141 | wp<IBinder> Layer::getSurfaceTextureBinder() const |
| 142 | { |
| 143 | return mSurfaceTexture->asBinder(); |
| 144 | } |
| 145 | |
Mathias Agopian | f9d9327 | 2009-06-19 17:00:27 -0700 | [diff] [blame] | 146 | status_t Layer::setBuffers( uint32_t w, uint32_t h, |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 147 | PixelFormat format, uint32_t flags) |
| 148 | { |
Mathias Agopian | 401c257 | 2009-09-23 19:16:27 -0700 | [diff] [blame] | 149 | // this surfaces pixel format |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 150 | PixelFormatInfo info; |
| 151 | status_t err = getPixelFormatInfo(format, &info); |
| 152 | if (err) return err; |
| 153 | |
Mathias Agopian | 401c257 | 2009-09-23 19:16:27 -0700 | [diff] [blame] | 154 | // the display's pixel format |
| 155 | const DisplayHardware& hw(graphicPlane(0).displayHardware()); |
Mathias Agopian | ca99fb8 | 2010-04-14 16:43:44 -0700 | [diff] [blame] | 156 | uint32_t const maxSurfaceDims = min( |
| 157 | hw.getMaxTextureSize(), hw.getMaxViewportDims()); |
| 158 | |
| 159 | // never allow a surface larger than what our underlying GL implementation |
| 160 | // can handle. |
| 161 | if ((uint32_t(w)>maxSurfaceDims) || (uint32_t(h)>maxSurfaceDims)) { |
| 162 | return BAD_VALUE; |
| 163 | } |
| 164 | |
Mathias Agopian | 401c257 | 2009-09-23 19:16:27 -0700 | [diff] [blame] | 165 | PixelFormatInfo displayInfo; |
| 166 | getPixelFormatInfo(hw.getFormat(), &displayInfo); |
Mathias Agopian | a4b740e | 2009-10-05 18:20:39 -0700 | [diff] [blame] | 167 | const uint32_t hwFlags = hw.getFlags(); |
| 168 | |
Mathias Agopian | cbb288b | 2009-09-07 16:32:45 -0700 | [diff] [blame] | 169 | mFormat = format; |
Mathias Agopian | eff062c | 2010-08-25 14:59:15 -0700 | [diff] [blame] | 170 | |
Mathias Agopian | 3330b20 | 2009-10-05 17:07:12 -0700 | [diff] [blame] | 171 | mSecure = (flags & ISurfaceComposer::eSecure) ? true : false; |
Glenn Kasten | 16f0453 | 2011-01-19 15:27:27 -0800 | [diff] [blame] | 172 | mProtectedByApp = (flags & ISurfaceComposer::eProtectedByApp) ? true : false; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 173 | mOpaqueLayer = (flags & ISurfaceComposer::eOpaque); |
| 174 | mCurrentOpacity = getOpacityForFormat(format); |
| 175 | |
| 176 | mSurfaceTexture->setDefaultBufferSize(w, h); |
| 177 | mSurfaceTexture->setDefaultBufferFormat(format); |
Mathias Agopian | ca99fb8 | 2010-04-14 16:43:44 -0700 | [diff] [blame] | 178 | |
Mathias Agopian | 401c257 | 2009-09-23 19:16:27 -0700 | [diff] [blame] | 179 | // we use the red index |
| 180 | int displayRedSize = displayInfo.getSize(PixelFormatInfo::INDEX_RED); |
| 181 | int layerRedsize = info.getSize(PixelFormatInfo::INDEX_RED); |
| 182 | mNeedsDithering = layerRedsize > displayRedSize; |
| 183 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 184 | return NO_ERROR; |
| 185 | } |
| 186 | |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 187 | void Layer::setGeometry(hwc_layer_t* hwcl) |
| 188 | { |
Mathias Agopian | a537c0f | 2011-08-02 15:51:37 -0700 | [diff] [blame] | 189 | LayerBaseClient::setGeometry(hwcl); |
| 190 | |
| 191 | hwcl->flags &= ~HWC_SKIP_LAYER; |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 192 | |
| 193 | // we can't do alpha-fade with the hwc HAL |
| 194 | const State& s(drawingState()); |
| 195 | if (s.alpha < 0xFF) { |
| 196 | hwcl->flags = HWC_SKIP_LAYER; |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 197 | } |
| 198 | |
Mathias Agopian | 29a367b | 2011-07-12 14:51:45 -0700 | [diff] [blame] | 199 | /* |
| 200 | * Transformations are applied in this order: |
| 201 | * 1) buffer orientation/flip/mirror |
| 202 | * 2) state transformation (window manager) |
| 203 | * 3) layer orientation (screen orientation) |
Mathias Agopian | d992db3 | 2011-08-18 18:31:00 -0700 | [diff] [blame] | 204 | * mTransform is already the composition of (2) and (3) |
Mathias Agopian | 29a367b | 2011-07-12 14:51:45 -0700 | [diff] [blame] | 205 | * (NOTE: the matrices are multiplied in reverse order) |
| 206 | */ |
| 207 | |
| 208 | const Transform bufferOrientation(mCurrentTransform); |
Mathias Agopian | d992db3 | 2011-08-18 18:31:00 -0700 | [diff] [blame] | 209 | const Transform tr(mTransform * bufferOrientation); |
Mathias Agopian | 29a367b | 2011-07-12 14:51:45 -0700 | [diff] [blame] | 210 | |
| 211 | // this gives us only the "orientation" component of the transform |
| 212 | const uint32_t finalTransform = tr.getOrientation(); |
| 213 | |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 214 | // we can only handle simple transformation |
Mathias Agopian | 29a367b | 2011-07-12 14:51:45 -0700 | [diff] [blame] | 215 | if (finalTransform & Transform::ROT_INVALID) { |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 216 | hwcl->flags = HWC_SKIP_LAYER; |
Mathias Agopian | a537c0f | 2011-08-02 15:51:37 -0700 | [diff] [blame] | 217 | } else { |
| 218 | hwcl->transform = finalTransform; |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 219 | } |
Mathias Agopian | c7f3381 | 2011-08-30 15:02:41 -0700 | [diff] [blame] | 220 | |
| 221 | if (isCropped()) { |
| 222 | hwcl->sourceCrop.left = mCurrentCrop.left; |
| 223 | hwcl->sourceCrop.top = mCurrentCrop.top; |
| 224 | hwcl->sourceCrop.right = mCurrentCrop.right; |
| 225 | hwcl->sourceCrop.bottom = mCurrentCrop.bottom; |
| 226 | } else { |
| 227 | const sp<GraphicBuffer>& buffer(mActiveBuffer); |
| 228 | hwcl->sourceCrop.left = 0; |
| 229 | hwcl->sourceCrop.top = 0; |
| 230 | if (buffer != NULL) { |
| 231 | hwcl->sourceCrop.right = buffer->width; |
| 232 | hwcl->sourceCrop.bottom = buffer->height; |
| 233 | } else { |
| 234 | hwcl->sourceCrop.right = mTransformedBounds.width(); |
| 235 | hwcl->sourceCrop.bottom = mTransformedBounds.height(); |
| 236 | } |
| 237 | } |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 238 | } |
| 239 | |
| 240 | void Layer::setPerFrameData(hwc_layer_t* hwcl) { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 241 | const sp<GraphicBuffer>& buffer(mActiveBuffer); |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 242 | if (buffer == NULL) { |
Mathias Agopian | da9584d | 2010-12-13 18:51:59 -0800 | [diff] [blame] | 243 | // this can happen if the client never drew into this layer yet, |
| 244 | // or if we ran out of memory. In that case, don't let |
| 245 | // HWC handle it. |
| 246 | hwcl->flags |= HWC_SKIP_LAYER; |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 247 | hwcl->handle = NULL; |
Mathias Agopian | a537c0f | 2011-08-02 15:51:37 -0700 | [diff] [blame] | 248 | } else { |
| 249 | hwcl->handle = buffer->handle; |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 250 | } |
Mathias Agopian | a350ff9 | 2010-08-10 17:14:02 -0700 | [diff] [blame] | 251 | } |
| 252 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 253 | void Layer::onDraw(const Region& clip) const |
| 254 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 255 | if (CC_UNLIKELY(mActiveBuffer == 0)) { |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 256 | // the texture has not been created yet, this Layer has |
Mathias Agopian | 179169e | 2010-05-06 20:21:45 -0700 | [diff] [blame] | 257 | // in fact never been drawn into. This happens frequently with |
| 258 | // SurfaceView because the WindowManager can't know when the client |
| 259 | // has drawn the first time. |
| 260 | |
| 261 | // If there is nothing under us, we paint the screen in black, otherwise |
| 262 | // we just skip this update. |
| 263 | |
| 264 | // figure out if there is something below us |
| 265 | Region under; |
Mathias Agopian | f7ae69d | 2011-08-23 12:34:29 -0700 | [diff] [blame] | 266 | const SurfaceFlinger::LayerVector& drawingLayers( |
| 267 | mFlinger->mDrawingState.layersSortedByZ); |
Mathias Agopian | 179169e | 2010-05-06 20:21:45 -0700 | [diff] [blame] | 268 | const size_t count = drawingLayers.size(); |
| 269 | for (size_t i=0 ; i<count ; ++i) { |
| 270 | const sp<LayerBase>& layer(drawingLayers[i]); |
| 271 | if (layer.get() == static_cast<LayerBase const*>(this)) |
| 272 | break; |
| 273 | under.orSelf(layer->visibleRegionScreen); |
| 274 | } |
| 275 | // if not everything below us is covered, we plug the holes! |
| 276 | Region holes(clip.subtract(under)); |
| 277 | if (!holes.isEmpty()) { |
Mathias Agopian | 0a91775 | 2010-06-14 21:20:00 -0700 | [diff] [blame] | 278 | clearWithOpenGL(holes, 0, 0, 0, 1); |
Mathias Agopian | 179169e | 2010-05-06 20:21:45 -0700 | [diff] [blame] | 279 | } |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 280 | return; |
| 281 | } |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 282 | |
Jamie Gennis | 9575f60 | 2011-10-07 14:51:16 -0700 | [diff] [blame] | 283 | GLenum target = GL_TEXTURE_EXTERNAL_OES; |
| 284 | if (!isProtected()) { |
| 285 | glBindTexture(target, mTextureName); |
| 286 | if (getFiltering() || needsFiltering() || isFixedSize() || isCropped()) { |
| 287 | // TODO: we could be more subtle with isFixedSize() |
| 288 | glTexParameterx(target, GL_TEXTURE_MAG_FILTER, GL_LINEAR); |
| 289 | glTexParameterx(target, GL_TEXTURE_MIN_FILTER, GL_LINEAR); |
| 290 | } else { |
| 291 | glTexParameterx(target, GL_TEXTURE_MAG_FILTER, GL_NEAREST); |
| 292 | glTexParameterx(target, GL_TEXTURE_MIN_FILTER, GL_NEAREST); |
| 293 | } |
| 294 | glEnable(target); |
| 295 | glMatrixMode(GL_TEXTURE); |
| 296 | glLoadMatrixf(mTextureMatrix); |
| 297 | glMatrixMode(GL_MODELVIEW); |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 298 | } else { |
Jamie Gennis | 9575f60 | 2011-10-07 14:51:16 -0700 | [diff] [blame] | 299 | target = GL_TEXTURE_2D; |
| 300 | glBindTexture(target, mFlinger->getProtectedTexName()); |
| 301 | glEnable(target); |
| 302 | glMatrixMode(GL_TEXTURE); |
| 303 | glLoadIdentity(); |
| 304 | glMatrixMode(GL_MODELVIEW); |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 305 | } |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 306 | |
| 307 | drawWithOpenGL(clip); |
| 308 | |
| 309 | glDisable(target); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 310 | } |
| 311 | |
Eric Hassold | ac45e6b | 2011-02-10 14:41:26 -0800 | [diff] [blame] | 312 | // As documented in libhardware header, formats in the range |
| 313 | // 0x100 - 0x1FF are specific to the HAL implementation, and |
| 314 | // are known to have no alpha channel |
| 315 | // TODO: move definition for device-specific range into |
| 316 | // hardware.h, instead of using hard-coded values here. |
| 317 | #define HARDWARE_IS_DEVICE_FORMAT(f) ((f) >= 0x100 && (f) <= 0x1FF) |
| 318 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 319 | bool Layer::getOpacityForFormat(uint32_t format) |
Eric Hassold | ac45e6b | 2011-02-10 14:41:26 -0800 | [diff] [blame] | 320 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 321 | if (HARDWARE_IS_DEVICE_FORMAT(format)) { |
| 322 | return true; |
Eric Hassold | ac45e6b | 2011-02-10 14:41:26 -0800 | [diff] [blame] | 323 | } |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 324 | PixelFormatInfo info; |
| 325 | status_t err = getPixelFormatInfo(PixelFormat(format), &info); |
| 326 | // in case of error (unknown format), we assume no blending |
| 327 | return (err || info.h_alpha <= info.l_alpha); |
Eric Hassold | ac45e6b | 2011-02-10 14:41:26 -0800 | [diff] [blame] | 328 | } |
| 329 | |
Eric Hassold | ac45e6b | 2011-02-10 14:41:26 -0800 | [diff] [blame] | 330 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 331 | bool Layer::isOpaque() const |
Mathias Agopian | a7f6692 | 2010-05-26 22:08:52 -0700 | [diff] [blame] | 332 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 333 | // if we don't have a buffer yet, we're translucent regardless of the |
| 334 | // layer's opaque flag. |
Jamie Gennis | db5230f | 2011-07-28 14:54:07 -0700 | [diff] [blame] | 335 | if (mActiveBuffer == 0) { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 336 | return false; |
Jamie Gennis | db5230f | 2011-07-28 14:54:07 -0700 | [diff] [blame] | 337 | } |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 338 | |
| 339 | // if the layer has the opaque flag, then we're always opaque, |
| 340 | // otherwise we use the current buffer's format. |
| 341 | return mOpaqueLayer || mCurrentOpacity; |
Mathias Agopian | a7f6692 | 2010-05-26 22:08:52 -0700 | [diff] [blame] | 342 | } |
| 343 | |
Jamie Gennis | 7a4d0df | 2011-03-09 17:05:02 -0800 | [diff] [blame] | 344 | bool Layer::isProtected() const |
| 345 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 346 | const sp<GraphicBuffer>& activeBuffer(mActiveBuffer); |
Jamie Gennis | 7a4d0df | 2011-03-09 17:05:02 -0800 | [diff] [blame] | 347 | return (activeBuffer != 0) && |
| 348 | (activeBuffer->getUsage() & GRALLOC_USAGE_PROTECTED); |
| 349 | } |
Mathias Agopian | b5b7f26 | 2010-05-07 15:58:44 -0700 | [diff] [blame] | 350 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 351 | uint32_t Layer::doTransaction(uint32_t flags) |
| 352 | { |
| 353 | const Layer::State& front(drawingState()); |
| 354 | const Layer::State& temp(currentState()); |
| 355 | |
Mathias Agopian | a138f89 | 2010-05-21 17:24:35 -0700 | [diff] [blame] | 356 | const bool sizeChanged = (front.requested_w != temp.requested_w) || |
| 357 | (front.requested_h != temp.requested_h); |
| 358 | |
| 359 | if (sizeChanged) { |
Mathias Agopian | cbb288b | 2009-09-07 16:32:45 -0700 | [diff] [blame] | 360 | // the size changed, we need to ask our client to request a new buffer |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 361 | LOGD_IF(DEBUG_RESIZE, |
Mathias Agopian | 3fbce7c | 2011-07-25 19:56:08 -0700 | [diff] [blame] | 362 | "doTransaction: " |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 363 | "resize (layer=%p), requested (%dx%d), drawing (%d,%d), " |
Mathias Agopian | 3fbce7c | 2011-07-25 19:56:08 -0700 | [diff] [blame] | 364 | "scalingMode=%d", |
Mathias Agopian | a138f89 | 2010-05-21 17:24:35 -0700 | [diff] [blame] | 365 | this, |
| 366 | int(temp.requested_w), int(temp.requested_h), |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 367 | int(front.requested_w), int(front.requested_h), |
Mathias Agopian | 3fbce7c | 2011-07-25 19:56:08 -0700 | [diff] [blame] | 368 | mCurrentScalingMode); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 369 | |
Mathias Agopian | a138f89 | 2010-05-21 17:24:35 -0700 | [diff] [blame] | 370 | if (!isFixedSize()) { |
Mathias Agopian | a138f89 | 2010-05-21 17:24:35 -0700 | [diff] [blame] | 371 | // this will make sure LayerBase::doTransaction doesn't update |
| 372 | // the drawing state's size |
| 373 | Layer::State& editDraw(mDrawingState); |
| 374 | editDraw.requested_w = temp.requested_w; |
| 375 | editDraw.requested_h = temp.requested_h; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 376 | } |
Jamie Gennis | 2a0d5b6 | 2011-09-26 16:54:44 -0700 | [diff] [blame] | 377 | |
| 378 | // record the new size, form this point on, when the client request |
| 379 | // a buffer, it'll get the new size. |
| 380 | mSurfaceTexture->setDefaultBufferSize(temp.requested_w, |
| 381 | temp.requested_h); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 382 | } |
Mathias Agopian | cbb288b | 2009-09-07 16:32:45 -0700 | [diff] [blame] | 383 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 384 | return LayerBase::doTransaction(flags); |
| 385 | } |
| 386 | |
Mathias Agopian | a138f89 | 2010-05-21 17:24:35 -0700 | [diff] [blame] | 387 | bool Layer::isFixedSize() const { |
Mathias Agopian | 933389f | 2011-07-18 16:15:08 -0700 | [diff] [blame] | 388 | return mCurrentScalingMode != NATIVE_WINDOW_SCALING_MODE_FREEZE; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 389 | } |
| 390 | |
| 391 | bool Layer::isCropped() const { |
| 392 | return !mCurrentCrop.isEmpty(); |
| 393 | } |
| 394 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 395 | // ---------------------------------------------------------------------------- |
| 396 | // pageflip handling... |
| 397 | // ---------------------------------------------------------------------------- |
| 398 | |
| 399 | void Layer::lockPageFlip(bool& recomputeVisibleRegions) |
| 400 | { |
Jamie Gennis | 3d8063b | 2011-06-26 18:27:47 -0700 | [diff] [blame] | 401 | if (mQueuedFrames > 0) { |
Jamie Gennis | 351a513 | 2011-09-14 18:23:37 -0700 | [diff] [blame] | 402 | // Capture the old state of the layer for comparisons later |
Jamie Gennis | db5230f | 2011-07-28 14:54:07 -0700 | [diff] [blame] | 403 | const bool oldOpacity = isOpaque(); |
Jamie Gennis | 351a513 | 2011-09-14 18:23:37 -0700 | [diff] [blame] | 404 | sp<GraphicBuffer> oldActiveBuffer = mActiveBuffer; |
Jamie Gennis | db5230f | 2011-07-28 14:54:07 -0700 | [diff] [blame] | 405 | |
Jamie Gennis | 3d8063b | 2011-06-26 18:27:47 -0700 | [diff] [blame] | 406 | // signal another event if we have more frames pending |
| 407 | if (android_atomic_dec(&mQueuedFrames) > 1) { |
| 408 | mFlinger->signalEvent(); |
| 409 | } |
| 410 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 411 | if (mSurfaceTexture->updateTexImage() < NO_ERROR) { |
| 412 | // something happened! |
| 413 | recomputeVisibleRegions = true; |
| 414 | return; |
| 415 | } |
Mathias Agopian | 96f0819 | 2010-06-02 23:28:45 -0700 | [diff] [blame] | 416 | |
Jamie Gennis | 351a513 | 2011-09-14 18:23:37 -0700 | [diff] [blame] | 417 | // update the active buffer |
| 418 | mActiveBuffer = mSurfaceTexture->getCurrentBuffer(); |
Mathias Agopian | d343e3d | 2010-03-15 18:15:20 -0700 | [diff] [blame] | 419 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 420 | const Rect crop(mSurfaceTexture->getCurrentCrop()); |
| 421 | const uint32_t transform(mSurfaceTexture->getCurrentTransform()); |
Mathias Agopian | 933389f | 2011-07-18 16:15:08 -0700 | [diff] [blame] | 422 | const uint32_t scalingMode(mSurfaceTexture->getCurrentScalingMode()); |
| 423 | if ((crop != mCurrentCrop) || |
| 424 | (transform != mCurrentTransform) || |
| 425 | (scalingMode != mCurrentScalingMode)) |
| 426 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 427 | mCurrentCrop = crop; |
| 428 | mCurrentTransform = transform; |
Mathias Agopian | 933389f | 2011-07-18 16:15:08 -0700 | [diff] [blame] | 429 | mCurrentScalingMode = scalingMode; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 430 | mFlinger->invalidateHwcGeometry(); |
| 431 | } |
Mathias Agopian | da9584d | 2010-12-13 18:51:59 -0800 | [diff] [blame] | 432 | |
Mathias Agopian | c7f3381 | 2011-08-30 15:02:41 -0700 | [diff] [blame] | 433 | GLfloat textureMatrix[16]; |
| 434 | mSurfaceTexture->getTransformMatrix(textureMatrix); |
| 435 | if (memcmp(textureMatrix, mTextureMatrix, sizeof(textureMatrix))) { |
| 436 | memcpy(mTextureMatrix, textureMatrix, sizeof(textureMatrix)); |
| 437 | mFlinger->invalidateHwcGeometry(); |
| 438 | } |
| 439 | |
Jamie Gennis | 351a513 | 2011-09-14 18:23:37 -0700 | [diff] [blame] | 440 | uint32_t bufWidth = mActiveBuffer->getWidth(); |
| 441 | uint32_t bufHeight = mActiveBuffer->getHeight(); |
| 442 | if (oldActiveBuffer != NULL) { |
| 443 | if (bufWidth != uint32_t(oldActiveBuffer->width) || |
| 444 | bufHeight != uint32_t(oldActiveBuffer->height)) { |
Mathias Agopian | c7f3381 | 2011-08-30 15:02:41 -0700 | [diff] [blame] | 445 | mFlinger->invalidateHwcGeometry(); |
| 446 | } |
| 447 | } |
| 448 | |
Jamie Gennis | 351a513 | 2011-09-14 18:23:37 -0700 | [diff] [blame] | 449 | mCurrentOpacity = getOpacityForFormat(mActiveBuffer->format); |
Jamie Gennis | db5230f | 2011-07-28 14:54:07 -0700 | [diff] [blame] | 450 | if (oldOpacity != isOpaque()) { |
Eric Hassold | ac45e6b | 2011-02-10 14:41:26 -0800 | [diff] [blame] | 451 | recomputeVisibleRegions = true; |
| 452 | } |
| 453 | |
Mathias Agopian | f7ae69d | 2011-08-23 12:34:29 -0700 | [diff] [blame] | 454 | glTexParameterx(GL_TEXTURE_EXTERNAL_OES, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE); |
| 455 | glTexParameterx(GL_TEXTURE_EXTERNAL_OES, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE); |
Mathias Agopian | 076b1cc | 2009-04-10 14:24:30 -0700 | [diff] [blame] | 456 | |
Jamie Gennis | a402c4c | 2011-10-14 16:44:08 -0700 | [diff] [blame^] | 457 | // update the layer size if needed |
Mathias Agopian | d343e3d | 2010-03-15 18:15:20 -0700 | [diff] [blame] | 458 | const Layer::State& front(drawingState()); |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 459 | |
| 460 | // FIXME: mPostedDirtyRegion = dirty & bounds |
| 461 | mPostedDirtyRegion.set(front.w, front.h); |
| 462 | |
Mathias Agopian | 97c602c | 2011-07-19 15:24:46 -0700 | [diff] [blame] | 463 | if ((front.w != front.requested_w) || |
| 464 | (front.h != front.requested_h)) |
Mathias Agopian | df3e0b9 | 2009-09-30 14:07:22 -0700 | [diff] [blame] | 465 | { |
Mathias Agopian | 97c602c | 2011-07-19 15:24:46 -0700 | [diff] [blame] | 466 | // check that we received a buffer of the right size |
| 467 | // (Take the buffer's orientation into account) |
Mathias Agopian | 97c602c | 2011-07-19 15:24:46 -0700 | [diff] [blame] | 468 | if (mCurrentTransform & Transform::ROT_90) { |
| 469 | swap(bufWidth, bufHeight); |
| 470 | } |
| 471 | |
| 472 | if (isFixedSize() || |
| 473 | (bufWidth == front.requested_w && |
| 474 | bufHeight == front.requested_h)) |
Mathias Agopian | d343e3d | 2010-03-15 18:15:20 -0700 | [diff] [blame] | 475 | { |
| 476 | // Here we pretend the transaction happened by updating the |
| 477 | // current and drawing states. Drawing state is only accessed |
| 478 | // in this thread, no need to have it locked |
| 479 | Layer::State& editDraw(mDrawingState); |
| 480 | editDraw.w = editDraw.requested_w; |
| 481 | editDraw.h = editDraw.requested_h; |
Mathias Agopian | df3e0b9 | 2009-09-30 14:07:22 -0700 | [diff] [blame] | 482 | |
Mathias Agopian | d343e3d | 2010-03-15 18:15:20 -0700 | [diff] [blame] | 483 | // We also need to update the current state so that we don't |
| 484 | // end-up doing too much work during the next transaction. |
| 485 | // NOTE: We actually don't need hold the transaction lock here |
| 486 | // because State::w and State::h are only accessed from |
| 487 | // this thread |
| 488 | Layer::State& editTemp(currentState()); |
| 489 | editTemp.w = editDraw.w; |
| 490 | editTemp.h = editDraw.h; |
Mathias Agopian | df3e0b9 | 2009-09-30 14:07:22 -0700 | [diff] [blame] | 491 | |
Mathias Agopian | d343e3d | 2010-03-15 18:15:20 -0700 | [diff] [blame] | 492 | // recompute visible region |
| 493 | recomputeVisibleRegions = true; |
Mathias Agopian | 97c602c | 2011-07-19 15:24:46 -0700 | [diff] [blame] | 494 | } |
Mathias Agopian | 3fbce7c | 2011-07-25 19:56:08 -0700 | [diff] [blame] | 495 | |
| 496 | LOGD_IF(DEBUG_RESIZE, |
| 497 | "lockPageFlip : " |
| 498 | " (layer=%p), buffer (%ux%u, tr=%02x), " |
| 499 | "requested (%dx%d)", |
| 500 | this, |
| 501 | bufWidth, bufHeight, mCurrentTransform, |
| 502 | front.requested_w, front.requested_h); |
Mathias Agopian | df3e0b9 | 2009-09-30 14:07:22 -0700 | [diff] [blame] | 503 | } |
Mathias Agopian | caa600c | 2009-09-16 18:27:24 -0700 | [diff] [blame] | 504 | } |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 505 | } |
| 506 | |
| 507 | void Layer::unlockPageFlip( |
| 508 | const Transform& planeTransform, Region& outDirtyRegion) |
| 509 | { |
| 510 | Region dirtyRegion(mPostedDirtyRegion); |
| 511 | if (!dirtyRegion.isEmpty()) { |
| 512 | mPostedDirtyRegion.clear(); |
| 513 | // The dirty region is given in the layer's coordinate space |
| 514 | // transform the dirty region by the surface's transformation |
| 515 | // and the global transformation. |
| 516 | const Layer::State& s(drawingState()); |
| 517 | const Transform tr(planeTransform * s.transform); |
| 518 | dirtyRegion = tr.transform(dirtyRegion); |
| 519 | |
| 520 | // At this point, the dirty region is in screen space. |
| 521 | // Make sure it's constrained by the visible region (which |
| 522 | // is in screen space as well). |
| 523 | dirtyRegion.andSelf(visibleRegionScreen); |
| 524 | outDirtyRegion.orSelf(dirtyRegion); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 525 | } |
| 526 | } |
| 527 | |
Mathias Agopian | 1b5e102 | 2010-04-20 17:55:49 -0700 | [diff] [blame] | 528 | void Layer::dump(String8& result, char* buffer, size_t SIZE) const |
| 529 | { |
| 530 | LayerBaseClient::dump(result, buffer, SIZE); |
| 531 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 532 | sp<const GraphicBuffer> buf0(mActiveBuffer); |
| 533 | uint32_t w0=0, h0=0, s0=0, f0=0; |
Mathias Agopian | 1b5e102 | 2010-04-20 17:55:49 -0700 | [diff] [blame] | 534 | if (buf0 != 0) { |
| 535 | w0 = buf0->getWidth(); |
| 536 | h0 = buf0->getHeight(); |
| 537 | s0 = buf0->getStride(); |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 538 | f0 = buf0->format; |
Mathias Agopian | 1b5e102 | 2010-04-20 17:55:49 -0700 | [diff] [blame] | 539 | } |
| 540 | snprintf(buffer, SIZE, |
| 541 | " " |
Mathias Agopian | ad795ba | 2011-08-08 16:02:13 -0700 | [diff] [blame] | 542 | "format=%2d, activeBuffer=[%4ux%4u:%4u,%3X]," |
Jamie Gennis | a402c4c | 2011-10-14 16:44:08 -0700 | [diff] [blame^] | 543 | " transform-hint=0x%02x, queued-frames=%d\n", |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 544 | mFormat, w0, h0, s0,f0, |
Jamie Gennis | a402c4c | 2011-10-14 16:44:08 -0700 | [diff] [blame^] | 545 | getTransformHint(), mQueuedFrames); |
Mathias Agopian | 1b5e102 | 2010-04-20 17:55:49 -0700 | [diff] [blame] | 546 | |
| 547 | result.append(buffer); |
Mathias Agopian | 1b5e102 | 2010-04-20 17:55:49 -0700 | [diff] [blame] | 548 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 549 | if (mSurfaceTexture != 0) { |
| 550 | mSurfaceTexture->dump(result, " ", buffer, SIZE); |
Mathias Agopian | 579b3f8 | 2010-06-08 19:54:15 -0700 | [diff] [blame] | 551 | } |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 552 | } |
| 553 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 554 | uint32_t Layer::getEffectiveUsage(uint32_t usage) const |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 555 | { |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 556 | // TODO: should we do something special if mSecure is set? |
| 557 | if (mProtectedByApp) { |
| 558 | // need a hardware-protected path to external video sink |
| 559 | usage |= GraphicBuffer::USAGE_PROTECTED; |
Jamie Gennis | 54cc83e | 2010-11-02 11:51:32 -0700 | [diff] [blame] | 560 | } |
Jamie Gennis | 3599bf2 | 2011-08-10 11:48:07 -0700 | [diff] [blame] | 561 | usage |= GraphicBuffer::USAGE_HW_COMPOSER; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 562 | return usage; |
Mathias Agopian | b5b7f26 | 2010-05-07 15:58:44 -0700 | [diff] [blame] | 563 | } |
| 564 | |
Mathias Agopian | a458364 | 2011-08-23 18:03:18 -0700 | [diff] [blame] | 565 | uint32_t Layer::getTransformHint() const { |
| 566 | uint32_t orientation = 0; |
| 567 | if (!mFlinger->mDebugDisableTransformHint) { |
Jamie Gennis | 8d91b42 | 2011-09-23 15:54:34 -0700 | [diff] [blame] | 568 | orientation = getPlaneOrientation(); |
Mathias Agopian | a458364 | 2011-08-23 18:03:18 -0700 | [diff] [blame] | 569 | if (orientation & Transform::ROT_INVALID) { |
| 570 | orientation = 0; |
| 571 | } |
| 572 | } |
| 573 | return orientation; |
| 574 | } |
| 575 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 576 | // --------------------------------------------------------------------------- |
| 577 | |
| 578 | |
| 579 | }; // namespace android |