2ca79399b9
since the transparent region hint really depends on the content of the window containing the SurfaceView (it's calculated by the view hierarchy based on overlapping views), it makes sense to latch it only when the content of the window (the app) changes. This should help fixing drawing artifacts when changing the layout of a window containing a SurfaceView. Bug: 8511430 Change-Id: Ic3aa668495293cb4d82a2cd7dcf3b6a337287678
218 lines
7.9 KiB
C++
218 lines
7.9 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_UI_REGION_H
|
|
#define ANDROID_UI_REGION_H
|
|
|
|
#include <stdint.h>
|
|
#include <sys/types.h>
|
|
|
|
#include <utils/Vector.h>
|
|
|
|
#include <ui/Rect.h>
|
|
#include <utils/Flattenable.h>
|
|
|
|
namespace android {
|
|
// ---------------------------------------------------------------------------
|
|
|
|
class SharedBuffer;
|
|
class String8;
|
|
|
|
// ---------------------------------------------------------------------------
|
|
class Region : public LightFlattenable<Region>
|
|
{
|
|
public:
|
|
Region();
|
|
Region(const Region& rhs);
|
|
explicit Region(const Rect& rhs);
|
|
~Region();
|
|
|
|
static Region createTJunctionFreeRegion(const Region& r);
|
|
|
|
Region& operator = (const Region& rhs);
|
|
|
|
inline bool isEmpty() const { return getBounds().isEmpty(); }
|
|
inline bool isRect() const { return mStorage.size() == 1; }
|
|
|
|
inline Rect getBounds() const { return mStorage[mStorage.size() - 1]; }
|
|
inline Rect bounds() const { return getBounds(); }
|
|
|
|
// the region becomes its bounds
|
|
Region& makeBoundsSelf();
|
|
|
|
void clear();
|
|
void set(const Rect& r);
|
|
void set(uint32_t w, uint32_t h);
|
|
|
|
Region& orSelf(const Rect& rhs);
|
|
Region& xorSelf(const Rect& rhs);
|
|
Region& andSelf(const Rect& rhs);
|
|
Region& subtractSelf(const Rect& rhs);
|
|
|
|
// boolean operators, applied on this
|
|
Region& orSelf(const Region& rhs);
|
|
Region& xorSelf(const Region& rhs);
|
|
Region& andSelf(const Region& rhs);
|
|
Region& subtractSelf(const Region& rhs);
|
|
|
|
// boolean operators
|
|
const Region merge(const Rect& rhs) const;
|
|
const Region mergeExclusive(const Rect& rhs) const;
|
|
const Region intersect(const Rect& rhs) const;
|
|
const Region subtract(const Rect& rhs) const;
|
|
|
|
// boolean operators
|
|
const Region merge(const Region& rhs) const;
|
|
const Region mergeExclusive(const Region& rhs) const;
|
|
const Region intersect(const Region& rhs) const;
|
|
const Region subtract(const Region& rhs) const;
|
|
|
|
// these translate rhs first
|
|
Region& translateSelf(int dx, int dy);
|
|
Region& orSelf(const Region& rhs, int dx, int dy);
|
|
Region& xorSelf(const Region& rhs, int dx, int dy);
|
|
Region& andSelf(const Region& rhs, int dx, int dy);
|
|
Region& subtractSelf(const Region& rhs, int dx, int dy);
|
|
|
|
// these translate rhs first
|
|
const Region translate(int dx, int dy) const;
|
|
const Region merge(const Region& rhs, int dx, int dy) const;
|
|
const Region mergeExclusive(const Region& rhs, int dx, int dy) const;
|
|
const Region intersect(const Region& rhs, int dx, int dy) const;
|
|
const Region subtract(const Region& rhs, int dx, int dy) const;
|
|
|
|
// convenience operators overloads
|
|
inline const Region operator | (const Region& rhs) const;
|
|
inline const Region operator ^ (const Region& rhs) const;
|
|
inline const Region operator & (const Region& rhs) const;
|
|
inline const Region operator - (const Region& rhs) const;
|
|
inline const Region operator + (const Point& pt) const;
|
|
|
|
inline Region& operator |= (const Region& rhs);
|
|
inline Region& operator ^= (const Region& rhs);
|
|
inline Region& operator &= (const Region& rhs);
|
|
inline Region& operator -= (const Region& rhs);
|
|
inline Region& operator += (const Point& pt);
|
|
|
|
|
|
// returns true if the regions share the same underlying storage
|
|
bool isTriviallyEqual(const Region& region) const;
|
|
|
|
|
|
/* various ways to access the rectangle list */
|
|
|
|
|
|
// STL-like iterators
|
|
typedef Rect const* const_iterator;
|
|
const_iterator begin() const;
|
|
const_iterator end() const;
|
|
|
|
// returns an array of rect which has the same life-time has this
|
|
// Region object.
|
|
Rect const* getArray(size_t* count) const;
|
|
|
|
// returns a SharedBuffer as well as the number of rects.
|
|
// ownership is transfered to the caller.
|
|
// the caller must call SharedBuffer::release() to free the memory.
|
|
SharedBuffer const* getSharedBuffer(size_t* count) const;
|
|
|
|
/* no user serviceable parts here... */
|
|
|
|
// add a rectangle to the internal list. This rectangle must
|
|
// be sorted in Y and X and must not make the region invalid.
|
|
void addRectUnchecked(int l, int t, int r, int b);
|
|
|
|
inline bool isFixedSize() const { return false; }
|
|
size_t getSize() const;
|
|
status_t flatten(void* buffer) const;
|
|
status_t unflatten(void const* buffer, size_t size);
|
|
|
|
void dump(String8& out, const char* what, uint32_t flags=0) const;
|
|
void dump(const char* what, uint32_t flags=0) const;
|
|
|
|
private:
|
|
class rasterizer;
|
|
friend class rasterizer;
|
|
|
|
Region& operationSelf(const Rect& r, int op);
|
|
Region& operationSelf(const Region& r, int op);
|
|
Region& operationSelf(const Region& r, int dx, int dy, int op);
|
|
const Region operation(const Rect& rhs, int op) const;
|
|
const Region operation(const Region& rhs, int op) const;
|
|
const Region operation(const Region& rhs, int dx, int dy, int op) const;
|
|
|
|
static void boolean_operation(int op, Region& dst,
|
|
const Region& lhs, const Region& rhs, int dx, int dy);
|
|
static void boolean_operation(int op, Region& dst,
|
|
const Region& lhs, const Rect& rhs, int dx, int dy);
|
|
|
|
static void boolean_operation(int op, Region& dst,
|
|
const Region& lhs, const Region& rhs);
|
|
static void boolean_operation(int op, Region& dst,
|
|
const Region& lhs, const Rect& rhs);
|
|
|
|
static void translate(Region& reg, int dx, int dy);
|
|
static void translate(Region& dst, const Region& reg, int dx, int dy);
|
|
|
|
static bool validate(const Region& reg,
|
|
const char* name, bool silent = false);
|
|
|
|
// mStorage is a (manually) sorted array of Rects describing the region
|
|
// with an extra Rect as the last element which is set to the
|
|
// bounds of the region. However, if the region is
|
|
// a simple Rect then mStorage contains only that rect.
|
|
Vector<Rect> mStorage;
|
|
};
|
|
|
|
|
|
const Region Region::operator | (const Region& rhs) const {
|
|
return merge(rhs);
|
|
}
|
|
const Region Region::operator ^ (const Region& rhs) const {
|
|
return mergeExclusive(rhs);
|
|
}
|
|
const Region Region::operator & (const Region& rhs) const {
|
|
return intersect(rhs);
|
|
}
|
|
const Region Region::operator - (const Region& rhs) const {
|
|
return subtract(rhs);
|
|
}
|
|
const Region Region::operator + (const Point& pt) const {
|
|
return translate(pt.x, pt.y);
|
|
}
|
|
|
|
|
|
Region& Region::operator |= (const Region& rhs) {
|
|
return orSelf(rhs);
|
|
}
|
|
Region& Region::operator ^= (const Region& rhs) {
|
|
return xorSelf(rhs);
|
|
}
|
|
Region& Region::operator &= (const Region& rhs) {
|
|
return andSelf(rhs);
|
|
}
|
|
Region& Region::operator -= (const Region& rhs) {
|
|
return subtractSelf(rhs);
|
|
}
|
|
Region& Region::operator += (const Point& pt) {
|
|
return translateSelf(pt.x, pt.y);
|
|
}
|
|
// ---------------------------------------------------------------------------
|
|
}; // namespace android
|
|
|
|
#endif // ANDROID_UI_REGION_H
|
|
|