0aa758d64a
First, the window manager tells us when a surface is no longer needed. At this point, several things happen: - the surface is removed from the active/visible list - it is added to a purgatory list, where it waits for all clients to release their reference - it destroys all data/state that can be spared Later, when all clients are done, the remains of the Surface are disposed off: it is removed from the purgatory and destroyed. In particular its gralloc buffers are destroyed at that point (when we're sure nobody is using them anymore).
362 lines
11 KiB
C++
362 lines
11 KiB
C++
/*
|
|
* 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>
|
|
|
|
#include <private/ui/LayerState.h>
|
|
|
|
#include <utils/RefBase.h>
|
|
|
|
#include <ui/Region.h>
|
|
#include <ui/Overlay.h>
|
|
|
|
#include <pixelflinger/pixelflinger.h>
|
|
|
|
#include "Transform.h"
|
|
|
|
namespace android {
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
class SurfaceFlinger;
|
|
class DisplayHardware;
|
|
class GraphicPlane;
|
|
class Client;
|
|
class SurfaceBuffer;
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
class LayerBase : public RefBase
|
|
{
|
|
// poor man's dynamic_cast below
|
|
template<typename T>
|
|
struct getTypeInfoOfAnyType {
|
|
static uint32_t get() { return T::typeInfo; }
|
|
};
|
|
|
|
template<typename T>
|
|
struct getTypeInfoOfAnyType<T*> {
|
|
static uint32_t get() { return getTypeInfoOfAnyType<T>::get(); }
|
|
};
|
|
|
|
public:
|
|
static const uint32_t typeInfo;
|
|
static const char* const typeID;
|
|
virtual char const* getTypeID() const { return typeID; }
|
|
virtual uint32_t getTypeInfo() const { return typeInfo; }
|
|
|
|
template<typename T>
|
|
static T dynamicCast(LayerBase* base) {
|
|
uint32_t mostDerivedInfo = base->getTypeInfo();
|
|
uint32_t castToInfo = getTypeInfoOfAnyType<T>::get();
|
|
if ((mostDerivedInfo & castToInfo) == castToInfo)
|
|
return static_cast<T>(base);
|
|
return 0;
|
|
}
|
|
|
|
|
|
static Vector<GLuint> deletedTextures;
|
|
|
|
LayerBase(SurfaceFlinger* flinger, DisplayID display);
|
|
|
|
DisplayID dpy;
|
|
mutable bool contentDirty;
|
|
Region visibleRegionScreen;
|
|
Region transparentRegionScreen;
|
|
Region coveredRegionScreen;
|
|
|
|
struct State {
|
|
uint32_t w;
|
|
uint32_t h;
|
|
uint32_t z;
|
|
uint8_t alpha;
|
|
uint8_t flags;
|
|
uint8_t reserved[2];
|
|
int32_t sequence; // changes when visible regions can change
|
|
uint32_t tint;
|
|
Transform transform;
|
|
Region transparentRegion;
|
|
};
|
|
|
|
// modify current state
|
|
bool setPosition(int32_t x, int32_t y);
|
|
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);
|
|
|
|
void commitTransaction(bool skipSize);
|
|
bool requestTransaction();
|
|
void forceVisibilityTransaction();
|
|
|
|
uint32_t getTransactionFlags(uint32_t flags);
|
|
uint32_t setTransactionFlags(uint32_t flags);
|
|
|
|
Rect visibleBounds() const;
|
|
void drawRegion(const Region& reg) const;
|
|
|
|
void invalidate();
|
|
|
|
/**
|
|
* 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;
|
|
|
|
/**
|
|
* 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);
|
|
|
|
/**
|
|
* setSizeChanged - called when the *current* state's size is changed.
|
|
*/
|
|
virtual void setSizeChanged(uint32_t w, uint32_t h);
|
|
|
|
/**
|
|
* 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
|
|
* region correspond to any area of the surface that is covered
|
|
* (transparently or not) by another surface.
|
|
*/
|
|
virtual void setCoveredRegion(const Region& coveredRegion);
|
|
|
|
/**
|
|
* getPhysicalSize - returns the physical size of the drawing state of
|
|
* the surface. If the surface is backed by a bitmap, this is the size of
|
|
* the bitmap (as opposed to the size of the drawing state).
|
|
*/
|
|
virtual Point getPhysicalSize() const;
|
|
|
|
/**
|
|
* 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);
|
|
|
|
/**
|
|
* finishPageFlip - called after all surfaces have drawn.
|
|
*/
|
|
virtual void finishPageFlip();
|
|
|
|
/**
|
|
* needsBlending - true if this surface needs blending
|
|
*/
|
|
virtual bool needsBlending() const { return false; }
|
|
|
|
/**
|
|
* transformed -- true is this surface needs a to be transformed
|
|
*/
|
|
virtual bool transformed() const { return mTransformed; }
|
|
|
|
/**
|
|
* isSecure - true if this surface is secure, that is if it prevents
|
|
* screenshots or VNC servers.
|
|
*/
|
|
virtual bool isSecure() const { return false; }
|
|
|
|
/** signal this layer that it's not needed any longer. called from the
|
|
* main thread */
|
|
virtual status_t ditch() { return NO_ERROR; }
|
|
|
|
|
|
|
|
enum { // flags for doTransaction()
|
|
eVisibleRegion = 0x00000002,
|
|
eRestartTransaction = 0x00000008
|
|
};
|
|
|
|
|
|
inline const State& drawingState() const { return mDrawingState; }
|
|
inline const State& currentState() const { return mCurrentState; }
|
|
inline State& currentState() { return mCurrentState; }
|
|
|
|
static int compareCurrentStateZ(
|
|
sp<LayerBase> const * layerA,
|
|
sp<LayerBase> const * layerB) {
|
|
return layerA[0]->currentState().z - layerB[0]->currentState().z;
|
|
}
|
|
|
|
int32_t getOrientation() const { return mOrientation; }
|
|
int tx() const { return mLeft; }
|
|
int ty() const { return mTop; }
|
|
|
|
protected:
|
|
const GraphicPlane& graphicPlane(int dpy) const;
|
|
GraphicPlane& graphicPlane(int dpy);
|
|
|
|
GLuint createTexture() const;
|
|
|
|
void drawWithOpenGL(const Region& clip,
|
|
GLint textureName,
|
|
const GGLSurface& surface,
|
|
int transform = 0) const;
|
|
|
|
void clearWithOpenGL(const Region& clip) const;
|
|
|
|
void loadTexture(const Region& dirty,
|
|
GLint textureName, const GGLSurface& t,
|
|
GLuint& textureWidth, GLuint& textureHeight) const;
|
|
|
|
sp<SurfaceFlinger> mFlinger;
|
|
uint32_t mFlags;
|
|
|
|
// cached during validateVisibility()
|
|
bool mTransformed;
|
|
int32_t mOrientation;
|
|
GLfixed mVertices[4][2];
|
|
Rect mTransformedBounds;
|
|
int mLeft;
|
|
int mTop;
|
|
|
|
// 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;
|
|
|
|
// only read
|
|
const uint32_t mIdentity;
|
|
|
|
// atomic
|
|
volatile int32_t mInvalidate;
|
|
|
|
|
|
protected:
|
|
virtual ~LayerBase();
|
|
|
|
private:
|
|
LayerBase(const LayerBase& rhs);
|
|
void validateTexture(GLint textureName) const;
|
|
static int32_t sIdentity;
|
|
};
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
class LayerBaseClient : public LayerBase
|
|
{
|
|
public:
|
|
class Surface;
|
|
static const uint32_t typeInfo;
|
|
static const char* const typeID;
|
|
virtual char const* getTypeID() const { return typeID; }
|
|
virtual uint32_t getTypeInfo() const { return typeInfo; }
|
|
|
|
LayerBaseClient(SurfaceFlinger* flinger, DisplayID display,
|
|
Client* client, int32_t i);
|
|
virtual ~LayerBaseClient();
|
|
virtual void onFirstRef();
|
|
|
|
Client* const client;
|
|
layer_cblk_t* const lcblk;
|
|
|
|
inline uint32_t getIdentity() const { return mIdentity; }
|
|
inline int32_t clientIndex() const { return mIndex; }
|
|
int32_t serverIndex() const;
|
|
|
|
|
|
sp<Surface> getSurface();
|
|
virtual sp<Surface> createSurface() const;
|
|
|
|
|
|
class Surface : public BnSurface
|
|
{
|
|
public:
|
|
|
|
virtual void getSurfaceData(
|
|
ISurfaceFlingerClient::surface_data_t* params) const;
|
|
|
|
protected:
|
|
Surface(const sp<SurfaceFlinger>& flinger,
|
|
SurfaceID id, int identity,
|
|
const sp<LayerBaseClient>& owner);
|
|
virtual ~Surface();
|
|
virtual status_t onTransact(uint32_t code, const Parcel& data,
|
|
Parcel* reply, uint32_t flags);
|
|
sp<LayerBaseClient> getOwner() const;
|
|
|
|
private:
|
|
virtual sp<SurfaceBuffer> getBuffer();
|
|
virtual status_t registerBuffers(const ISurface::BufferHeap& buffers);
|
|
virtual void postBuffer(ssize_t offset);
|
|
virtual void unregisterBuffers();
|
|
virtual sp<OverlayRef> createOverlay(uint32_t w, uint32_t h,
|
|
int32_t format);
|
|
|
|
protected:
|
|
friend class LayerBaseClient;
|
|
sp<SurfaceFlinger> mFlinger;
|
|
int32_t mToken;
|
|
int32_t mIdentity;
|
|
wp<LayerBaseClient> mOwner;
|
|
};
|
|
|
|
friend class Surface;
|
|
|
|
private:
|
|
int32_t mIndex;
|
|
mutable Mutex mLock;
|
|
mutable wp<Surface> mClientSurface;
|
|
};
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
}; // namespace android
|
|
|
|
#endif // ANDROID_LAYER_BASE_H
|