2009-03-04 03:31:44 +00:00
|
|
|
/*
|
|
|
|
* Copyright (C) 2007 The Android Open Source Project
|
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef ANDROID_LAYER_BASE_H
|
|
|
|
#define ANDROID_LAYER_BASE_H
|
|
|
|
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <sys/types.h>
|
|
|
|
|
2009-06-24 01:08:22 +00:00
|
|
|
#include <EGL/egl.h>
|
|
|
|
#include <EGL/eglext.h>
|
2010-02-22 11:15:57 +00:00
|
|
|
#include <GLES/gl.h>
|
2009-06-24 01:08:22 +00:00
|
|
|
|
2009-04-10 21:24:30 +00:00
|
|
|
#include <utils/RefBase.h>
|
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
#include <ui/Region.h>
|
|
|
|
|
2012-02-26 02:48:35 +00:00
|
|
|
#include <gui/ISurfaceComposerClient.h>
|
2010-02-10 01:46:37 +00:00
|
|
|
|
2012-02-26 02:48:35 +00:00
|
|
|
#include <private/gui/LayerState.h>
|
2009-03-04 03:31:44 +00:00
|
|
|
|
2010-12-08 07:41:55 +00:00
|
|
|
#include "DisplayHardware/DisplayHardware.h"
|
2009-03-04 03:31:44 +00:00
|
|
|
#include "Transform.h"
|
|
|
|
|
|
|
|
namespace android {
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class Client;
|
2011-04-20 21:20:59 +00:00
|
|
|
class DisplayHardware;
|
2009-10-06 00:07:12 +00:00
|
|
|
class GraphicBuffer;
|
|
|
|
class GraphicPlane;
|
2011-09-20 22:13:14 +00:00
|
|
|
class Layer;
|
2010-06-01 22:12:58 +00:00
|
|
|
class LayerBaseClient;
|
2009-10-06 00:07:12 +00:00
|
|
|
class SurfaceFlinger;
|
2009-03-04 03:31:44 +00:00
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
2009-04-10 21:24:30 +00:00
|
|
|
class LayerBase : public RefBase
|
2009-03-04 03:31:44 +00:00
|
|
|
{
|
2010-08-11 01:09:09 +00:00
|
|
|
static int32_t sSequence;
|
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
public:
|
2010-04-21 00:55:49 +00:00
|
|
|
LayerBase(SurfaceFlinger* flinger, DisplayID display);
|
2009-03-04 03:31:44 +00:00
|
|
|
|
|
|
|
DisplayID dpy;
|
|
|
|
mutable bool contentDirty;
|
|
|
|
Region visibleRegionScreen;
|
|
|
|
Region transparentRegionScreen;
|
|
|
|
Region coveredRegionScreen;
|
2010-08-11 01:09:09 +00:00
|
|
|
int32_t sequence;
|
2009-03-04 03:31:44 +00:00
|
|
|
|
2012-05-17 00:07:49 +00:00
|
|
|
struct Geometry {
|
2012-05-17 01:21:32 +00:00
|
|
|
uint32_t w;
|
|
|
|
uint32_t h;
|
|
|
|
Rect crop;
|
|
|
|
inline bool operator == (const Geometry& rhs) const {
|
|
|
|
return (w==rhs.w && h==rhs.h && crop==rhs.crop);
|
|
|
|
}
|
|
|
|
inline bool operator != (const Geometry& rhs) const {
|
|
|
|
return !operator == (rhs);
|
|
|
|
}
|
2012-05-17 00:07:49 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct State {
|
|
|
|
Geometry active;
|
|
|
|
Geometry requested;
|
2009-03-04 03:31:44 +00:00
|
|
|
uint32_t z;
|
|
|
|
uint8_t alpha;
|
|
|
|
uint8_t flags;
|
|
|
|
uint8_t reserved[2];
|
|
|
|
int32_t sequence; // changes when visible regions can change
|
|
|
|
Transform transform;
|
|
|
|
Region transparentRegion;
|
|
|
|
};
|
|
|
|
|
2011-09-17 00:31:54 +00:00
|
|
|
virtual void setName(const String8& name);
|
2010-03-10 03:17:47 +00:00
|
|
|
String8 getName() const;
|
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
// modify current state
|
2011-08-31 01:51:54 +00:00
|
|
|
bool setPosition(float x, float y);
|
2009-03-04 03:31:44 +00:00
|
|
|
bool setLayer(uint32_t z);
|
|
|
|
bool setSize(uint32_t w, uint32_t h);
|
|
|
|
bool setAlpha(uint8_t alpha);
|
|
|
|
bool setMatrix(const layer_state_t::matrix22_t& matrix);
|
|
|
|
bool setTransparentRegionHint(const Region& opaque);
|
|
|
|
bool setFlags(uint8_t flags, uint8_t mask);
|
2012-05-11 03:43:55 +00:00
|
|
|
bool setCrop(const Rect& crop);
|
2009-03-04 03:31:44 +00:00
|
|
|
|
2009-09-30 05:32:36 +00:00
|
|
|
void commitTransaction();
|
2009-03-04 03:31:44 +00:00
|
|
|
bool requestTransaction();
|
|
|
|
void forceVisibilityTransaction();
|
|
|
|
|
|
|
|
uint32_t getTransactionFlags(uint32_t flags);
|
|
|
|
uint32_t setTransactionFlags(uint32_t flags);
|
|
|
|
|
|
|
|
Rect visibleBounds() const;
|
|
|
|
|
2010-06-01 22:12:58 +00:00
|
|
|
virtual sp<LayerBaseClient> getLayerBaseClient() const { return 0; }
|
2011-09-20 22:13:14 +00:00
|
|
|
virtual sp<Layer> getLayer() const { return 0; }
|
2010-06-01 22:12:58 +00:00
|
|
|
|
2010-04-21 00:55:49 +00:00
|
|
|
virtual const char* getTypeId() const { return "LayerBase"; }
|
|
|
|
|
2012-05-14 03:42:01 +00:00
|
|
|
virtual void setGeometry(HWComposer::HWCLayerInterface& layer);
|
|
|
|
virtual void setPerFrameData(HWComposer::HWCLayerInterface& layer);
|
2011-09-09 01:31:55 +00:00
|
|
|
|
2010-08-11 00:14:02 +00:00
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
/**
|
|
|
|
* draw - performs some global clipping optimizations
|
|
|
|
* and calls onDraw().
|
|
|
|
* Typically this method is not overridden, instead implement onDraw()
|
|
|
|
* to perform the actual drawing.
|
|
|
|
*/
|
|
|
|
virtual void draw(const Region& clip) const;
|
2011-04-20 21:20:59 +00:00
|
|
|
virtual void drawForSreenShot();
|
2009-03-04 03:31:44 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* onDraw - draws the surface.
|
|
|
|
*/
|
|
|
|
virtual void onDraw(const Region& clip) const = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* initStates - called just after construction
|
|
|
|
*/
|
|
|
|
virtual void initStates(uint32_t w, uint32_t h, uint32_t flags);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* doTransaction - process the transaction. This is a good place to figure
|
|
|
|
* out which attributes of the surface have changed.
|
|
|
|
*/
|
|
|
|
virtual uint32_t doTransaction(uint32_t transactionFlags);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* setVisibleRegion - called to set the new visible region. This gives
|
|
|
|
* a chance to update the new visible region or record the fact it changed.
|
|
|
|
*/
|
|
|
|
virtual void setVisibleRegion(const Region& visibleRegion);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* setCoveredRegion - called when the covered region changes. The covered
|
2010-03-16 23:41:46 +00:00
|
|
|
* region corresponds to any area of the surface that is covered
|
2009-03-04 03:31:44 +00:00
|
|
|
* (transparently or not) by another surface.
|
|
|
|
*/
|
|
|
|
virtual void setCoveredRegion(const Region& coveredRegion);
|
2010-03-16 23:41:46 +00:00
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
/**
|
|
|
|
* validateVisibility - cache a bunch of things
|
|
|
|
*/
|
|
|
|
virtual void validateVisibility(const Transform& globalTransform);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* lockPageFlip - called each time the screen is redrawn and returns whether
|
|
|
|
* the visible regions need to be recomputed (this is a fairly heavy
|
|
|
|
* operation, so this should be set only if needed). Typically this is used
|
|
|
|
* to figure out if the content or size of a surface has changed.
|
|
|
|
*/
|
|
|
|
virtual void lockPageFlip(bool& recomputeVisibleRegions);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* unlockPageFlip - called each time the screen is redrawn. updates the
|
|
|
|
* final dirty region wrt the planeTransform.
|
|
|
|
* At this point, all visible regions, surface position and size, etc... are
|
|
|
|
* correct.
|
|
|
|
*/
|
|
|
|
virtual void unlockPageFlip(const Transform& planeTransform, Region& outDirtyRegion);
|
|
|
|
|
|
|
|
/**
|
2011-04-20 21:20:59 +00:00
|
|
|
* isOpaque - true if this surface is opaque
|
2009-03-04 03:31:44 +00:00
|
|
|
*/
|
2011-04-20 21:20:59 +00:00
|
|
|
virtual bool isOpaque() const { return true; }
|
2009-03-04 03:31:44 +00:00
|
|
|
|
2009-09-24 02:16:27 +00:00
|
|
|
/**
|
|
|
|
* needsDithering - true if this surface needs dithering
|
|
|
|
*/
|
|
|
|
virtual bool needsDithering() const { return false; }
|
|
|
|
|
2010-05-27 05:08:52 +00:00
|
|
|
/**
|
2011-04-20 21:20:59 +00:00
|
|
|
* needsLinearFiltering - true if this surface's state requires filtering
|
2010-05-27 05:08:52 +00:00
|
|
|
*/
|
2011-04-20 21:20:59 +00:00
|
|
|
virtual bool needsFiltering() const { return mNeedsFiltering; }
|
2010-05-27 05:08:52 +00:00
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
/**
|
|
|
|
* isSecure - true if this surface is secure, that is if it prevents
|
2009-04-18 02:36:26 +00:00
|
|
|
* screenshots or VNC servers.
|
2009-03-04 03:31:44 +00:00
|
|
|
*/
|
|
|
|
virtual bool isSecure() const { return false; }
|
|
|
|
|
2011-01-19 23:27:27 +00:00
|
|
|
/**
|
2011-03-10 01:05:02 +00:00
|
|
|
* isProtected - true if the layer may contain protected content in the
|
|
|
|
* GRALLOC_USAGE_PROTECTED sense.
|
2011-01-19 23:27:27 +00:00
|
|
|
*/
|
2011-03-10 01:05:02 +00:00
|
|
|
virtual bool isProtected() const { return false; }
|
2011-01-19 23:27:27 +00:00
|
|
|
|
2009-10-03 01:12:30 +00:00
|
|
|
/** called with the state lock when the surface is removed from the
|
|
|
|
* current list */
|
2012-02-01 02:24:27 +00:00
|
|
|
virtual void onRemoved() { }
|
2012-01-16 02:54:57 +00:00
|
|
|
|
2012-02-01 02:24:27 +00:00
|
|
|
/** called after page-flip
|
|
|
|
*/
|
|
|
|
virtual void onLayerDisplayed() { }
|
|
|
|
|
|
|
|
/** called before composition.
|
|
|
|
* returns true if the layer has pending updates.
|
|
|
|
*/
|
|
|
|
virtual bool onPreComposition() { return false; }
|
2012-01-16 02:54:57 +00:00
|
|
|
|
2010-04-21 00:55:49 +00:00
|
|
|
/** always call base class first */
|
|
|
|
virtual void dump(String8& result, char* scratch, size_t size) const;
|
2011-01-20 00:15:53 +00:00
|
|
|
virtual void shortDump(String8& result, char* scratch, size_t size) const;
|
2012-01-20 02:34:40 +00:00
|
|
|
virtual void dumpStats(String8& result, char* buffer, size_t SIZE) const;
|
2012-01-29 06:31:55 +00:00
|
|
|
virtual void clearStats();
|
2010-04-21 00:55:49 +00:00
|
|
|
|
|
|
|
|
2009-04-18 02:36:26 +00:00
|
|
|
enum { // flags for doTransaction()
|
2012-05-23 21:35:49 +00:00
|
|
|
eDontUpdateGeometryState = 0x00000001,
|
|
|
|
eVisibleRegion = 0x00000002,
|
2009-04-18 02:36:26 +00:00
|
|
|
};
|
2009-03-04 03:31:44 +00:00
|
|
|
|
|
|
|
|
|
|
|
inline const State& drawingState() const { return mDrawingState; }
|
|
|
|
inline const State& currentState() const { return mCurrentState; }
|
|
|
|
inline State& currentState() { return mCurrentState; }
|
|
|
|
|
|
|
|
int32_t getOrientation() const { return mOrientation; }
|
2011-09-23 22:54:34 +00:00
|
|
|
int32_t getPlaneOrientation() const { return mPlaneOrientation; }
|
2012-04-16 06:34:59 +00:00
|
|
|
|
|
|
|
void clearWithOpenGL(const Region& clip) const;
|
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
protected:
|
|
|
|
const GraphicPlane& graphicPlane(int dpy) const;
|
|
|
|
GraphicPlane& graphicPlane(int dpy);
|
|
|
|
|
2010-05-27 05:26:12 +00:00
|
|
|
void clearWithOpenGL(const Region& clip, GLclampf r, GLclampf g,
|
|
|
|
GLclampf b, GLclampf alpha) const;
|
2011-04-20 21:20:59 +00:00
|
|
|
void drawWithOpenGL(const Region& clip) const;
|
|
|
|
|
|
|
|
void setFiltering(bool filtering);
|
|
|
|
bool getFiltering() const;
|
2010-08-20 00:01:19 +00:00
|
|
|
|
2009-04-18 02:36:26 +00:00
|
|
|
sp<SurfaceFlinger> mFlinger;
|
2009-03-04 03:31:44 +00:00
|
|
|
uint32_t mFlags;
|
|
|
|
|
2011-04-20 21:20:59 +00:00
|
|
|
private:
|
|
|
|
// accessed only in the main thread
|
|
|
|
// Whether filtering is forced on or not
|
|
|
|
bool mFiltering;
|
2010-08-20 00:01:19 +00:00
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
// cached during validateVisibility()
|
2011-04-20 21:20:59 +00:00
|
|
|
// Whether filtering is needed b/c of the drawingstate
|
2010-05-27 05:08:52 +00:00
|
|
|
bool mNeedsFiltering;
|
2011-04-20 21:20:59 +00:00
|
|
|
|
|
|
|
protected:
|
|
|
|
// cached during validateVisibility()
|
2009-03-04 03:31:44 +00:00
|
|
|
int32_t mOrientation;
|
2011-09-23 22:54:34 +00:00
|
|
|
int32_t mPlaneOrientation;
|
2011-08-19 01:31:00 +00:00
|
|
|
Transform mTransform;
|
2010-04-20 21:51:04 +00:00
|
|
|
GLfloat mVertices[4][2];
|
2012-04-16 10:14:05 +00:00
|
|
|
size_t mNumVertices;
|
2009-03-04 03:31:44 +00:00
|
|
|
Rect mTransformedBounds;
|
|
|
|
|
|
|
|
// these are protected by an external lock
|
|
|
|
State mCurrentState;
|
|
|
|
State mDrawingState;
|
|
|
|
volatile int32_t mTransactionFlags;
|
|
|
|
|
|
|
|
// don't change, don't need a lock
|
|
|
|
bool mPremultipliedAlpha;
|
2010-03-10 03:17:47 +00:00
|
|
|
String8 mName;
|
|
|
|
mutable bool mDebug;
|
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
|
2011-05-19 22:38:14 +00:00
|
|
|
public:
|
|
|
|
// called from class SurfaceFlinger
|
2009-04-10 21:24:30 +00:00
|
|
|
virtual ~LayerBase();
|
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
private:
|
2009-04-10 21:24:30 +00:00
|
|
|
LayerBase(const LayerBase& rhs);
|
2009-03-04 03:31:44 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class LayerBaseClient : public LayerBase
|
|
|
|
{
|
|
|
|
public:
|
2010-06-03 06:28:45 +00:00
|
|
|
LayerBaseClient(SurfaceFlinger* flinger, DisplayID display,
|
|
|
|
const sp<Client>& client);
|
2009-03-04 03:31:44 +00:00
|
|
|
|
2011-04-20 21:20:59 +00:00
|
|
|
virtual ~LayerBaseClient();
|
|
|
|
|
|
|
|
sp<ISurface> getSurface();
|
2011-01-26 04:17:45 +00:00
|
|
|
wp<IBinder> getSurfaceBinder() const;
|
2011-08-18 01:19:00 +00:00
|
|
|
virtual wp<IBinder> getSurfaceTextureBinder() const;
|
2011-04-20 21:20:59 +00:00
|
|
|
|
2010-06-01 22:12:58 +00:00
|
|
|
virtual sp<LayerBaseClient> getLayerBaseClient() const {
|
|
|
|
return const_cast<LayerBaseClient*>(this); }
|
2011-04-20 21:20:59 +00:00
|
|
|
|
2010-04-21 00:55:49 +00:00
|
|
|
virtual const char* getTypeId() const { return "LayerBaseClient"; }
|
2010-03-02 00:09:43 +00:00
|
|
|
|
2010-06-03 06:28:45 +00:00
|
|
|
uint32_t getIdentity() const { return mIdentity; }
|
|
|
|
|
2010-04-21 00:55:49 +00:00
|
|
|
protected:
|
|
|
|
virtual void dump(String8& result, char* scratch, size_t size) const;
|
2011-01-20 00:15:53 +00:00
|
|
|
virtual void shortDump(String8& result, char* scratch, size_t size) const;
|
2010-04-21 00:55:49 +00:00
|
|
|
|
2011-04-20 21:20:59 +00:00
|
|
|
class LayerCleaner {
|
|
|
|
sp<SurfaceFlinger> mFlinger;
|
|
|
|
wp<LayerBaseClient> mLayer;
|
|
|
|
protected:
|
|
|
|
~LayerCleaner();
|
|
|
|
public:
|
|
|
|
LayerCleaner(const sp<SurfaceFlinger>& flinger,
|
|
|
|
const sp<LayerBaseClient>& layer);
|
|
|
|
};
|
|
|
|
|
2009-04-10 21:24:30 +00:00
|
|
|
private:
|
2011-04-20 21:20:59 +00:00
|
|
|
virtual sp<ISurface> createSurface();
|
|
|
|
|
2010-06-03 06:28:45 +00:00
|
|
|
mutable Mutex mLock;
|
2011-02-16 03:01:06 +00:00
|
|
|
mutable bool mHasSurface;
|
2011-01-26 04:17:45 +00:00
|
|
|
wp<IBinder> mClientSurfaceBinder;
|
2010-06-01 22:12:58 +00:00
|
|
|
const wp<Client> mClientRef;
|
2009-06-24 03:06:46 +00:00
|
|
|
// only read
|
2010-06-03 06:28:45 +00:00
|
|
|
const uint32_t mIdentity;
|
|
|
|
static int32_t sIdentity;
|
2009-03-04 03:31:44 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
}; // namespace android
|
|
|
|
|
|
|
|
#endif // ANDROID_LAYER_BASE_H
|