Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -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 | |
| 17 | #ifndef ANDROID_GUI_SURFACE_CONTROL_H |
| 18 | #define ANDROID_GUI_SURFACE_CONTROL_H |
| 19 | |
| 20 | #include <stdint.h> |
| 21 | #include <sys/types.h> |
| 22 | |
| 23 | #include <utils/KeyedVector.h> |
| 24 | #include <utils/RefBase.h> |
| 25 | #include <utils/threads.h> |
| 26 | |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 27 | #include <ui/FrameStats.h> |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 28 | #include <ui/PixelFormat.h> |
| 29 | #include <ui/Region.h> |
| 30 | |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 31 | #include <gui/ISurfaceComposerClient.h> |
| 32 | |
| 33 | namespace android { |
| 34 | |
| 35 | // --------------------------------------------------------------------------- |
| 36 | |
| 37 | class IGraphicBufferProducer; |
| 38 | class Surface; |
| 39 | class SurfaceComposerClient; |
| 40 | |
| 41 | // --------------------------------------------------------------------------- |
| 42 | |
| 43 | class SurfaceControl : public RefBase |
| 44 | { |
| 45 | public: |
| 46 | static bool isValid(const sp<SurfaceControl>& surface) { |
| 47 | return (surface != 0) && surface->isValid(); |
| 48 | } |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 49 | |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 50 | bool isValid() { |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 51 | return mHandle!=0 && mClient!=0; |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 52 | } |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 53 | |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 54 | static bool isSameSurface( |
| 55 | const sp<SurfaceControl>& lhs, const sp<SurfaceControl>& rhs); |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 56 | |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 57 | // release surface data from java |
| 58 | void clear(); |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 59 | |
Chong Zhang | 1b3a9ac | 2016-02-29 16:47:47 -0800 | [diff] [blame] | 60 | // disconnect any api that's connected |
| 61 | void disconnect(); |
| 62 | |
Dan Stoza | d723bd7 | 2014-11-18 10:24:03 -0800 | [diff] [blame] | 63 | status_t setLayerStack(uint32_t layerStack); |
Robert Carr | ae06083 | 2016-11-28 10:51:00 -0800 | [diff] [blame^] | 64 | status_t setLayer(int32_t layer); |
Albert Chaulk | 6cf6af0 | 2016-11-22 13:52:43 -0500 | [diff] [blame] | 65 | status_t setLayerInfo(uint32_t type, uint32_t appid); |
Ramanan Rajeswaran | d6480c0 | 2013-03-21 15:49:59 +0000 | [diff] [blame] | 66 | status_t setPosition(float x, float y); |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 67 | status_t setSize(uint32_t w, uint32_t h); |
| 68 | status_t hide(); |
| 69 | status_t show(); |
| 70 | status_t setFlags(uint32_t flags, uint32_t mask); |
| 71 | status_t setTransparentRegionHint(const Region& transparent); |
| 72 | status_t setAlpha(float alpha=1.0f); |
| 73 | status_t setMatrix(float dsdx, float dtdx, float dsdy, float dtdy); |
| 74 | status_t setCrop(const Rect& crop); |
Pablo Ceballos | acbe678 | 2016-03-04 17:54:21 +0000 | [diff] [blame] | 75 | status_t setFinalCrop(const Rect& crop); |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 76 | |
Robert Carr | 99e27f0 | 2016-06-16 15:18:02 -0700 | [diff] [blame] | 77 | // If the size changes in this transaction, all geometry updates specified |
Robert Carr | 82364e3 | 2016-05-15 11:27:47 -0700 | [diff] [blame] | 78 | // in this transaction will not complete until a buffer of the new size |
Robert Carr | 99e27f0 | 2016-06-16 15:18:02 -0700 | [diff] [blame] | 79 | // arrives. As some elements normally apply immediately, this enables |
| 80 | // freezing the total geometry of a surface until a resize is completed. |
| 81 | status_t setGeometryAppliesWithResize(); |
Robert Carr | 82364e3 | 2016-05-15 11:27:47 -0700 | [diff] [blame] | 82 | |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 83 | // Defers applying any changes made in this transaction until the Layer |
| 84 | // identified by handle reaches the given frameNumber |
| 85 | status_t deferTransactionUntil(sp<IBinder> handle, uint64_t frameNumber); |
| 86 | |
Robert Carr | c3574f7 | 2016-03-24 12:19:32 -0700 | [diff] [blame] | 87 | // Set an override scaling mode as documented in <system/window.h> |
| 88 | // the override scaling mode will take precedence over any client |
| 89 | // specified scaling mode. -1 will clear the override scaling mode. |
| 90 | status_t setOverrideScalingMode(int32_t overrideScalingMode); |
| 91 | |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 92 | static status_t writeSurfaceToParcel( |
| 93 | const sp<SurfaceControl>& control, Parcel* parcel); |
| 94 | |
| 95 | sp<Surface> getSurface() const; |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 96 | sp<IBinder> getHandle() const; |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 97 | |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 98 | status_t clearLayerFrameStats() const; |
| 99 | status_t getLayerFrameStats(FrameStats* outStats) const; |
| 100 | |
Robert Carr | 367c568 | 2016-06-20 11:55:28 -0700 | [diff] [blame] | 101 | status_t getTransformToDisplayInverse(bool* outTransformToDisplayInverse) const; |
| 102 | |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 103 | private: |
| 104 | // can't be copied |
| 105 | SurfaceControl& operator = (SurfaceControl& rhs); |
| 106 | SurfaceControl(const SurfaceControl& rhs); |
| 107 | |
| 108 | friend class SurfaceComposerClient; |
| 109 | friend class Surface; |
| 110 | |
| 111 | SurfaceControl( |
| 112 | const sp<SurfaceComposerClient>& client, |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 113 | const sp<IBinder>& handle, |
| 114 | const sp<IGraphicBufferProducer>& gbp); |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 115 | |
| 116 | ~SurfaceControl(); |
| 117 | |
| 118 | status_t validate() const; |
| 119 | void destroy(); |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 120 | |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 121 | sp<SurfaceComposerClient> mClient; |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 122 | sp<IBinder> mHandle; |
Mathias Agopian | e3c697f | 2013-02-14 17:11:02 -0800 | [diff] [blame] | 123 | sp<IGraphicBufferProducer> mGraphicBufferProducer; |
| 124 | mutable Mutex mLock; |
| 125 | mutable sp<Surface> mSurfaceData; |
| 126 | }; |
| 127 | |
| 128 | }; // namespace android |
| 129 | |
| 130 | #endif // ANDROID_GUI_SURFACE_CONTROL_H |