/usr/include/thunderbird/gfxReusableSurfaceWrapper.h is in thunderbird-dev 1:24.4.0+build1-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 | /* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef GFXCOWSURFACEWRAPPER
#define GFXCOWSURFACEWRAPPER
#include "gfxASurface.h"
#include "nsISupportsImpl.h"
#include "nsAutoPtr.h"
class gfxImageSurface;
/**
* Provides a cross thread wrapper for a gfxImageSurface
* that has copy-on-write schemantics.
*
* Only the owner thread can write to the surface and aquire
* read locks.
*
* OMTC Usage:
* 1) Content creates a writable copy of this surface
* wrapper which be optimized to the same wrapper if there
* are no readers.
* 2) The surface is sent from content to the compositor once
* or potentially many time, each increasing a read lock.
* 3) When the compositor has processed the surface and uploaded
* the content it then releases the read lock.
*/
class gfxReusableSurfaceWrapper {
NS_INLINE_DECL_THREADSAFE_REFCOUNTING(gfxReusableSurfaceWrapper)
public:
/**
* Pass the gfxASurface to the wrapper.
* The wrapper should hold the only strong reference
* to the surface and its memebers.
*/
gfxReusableSurfaceWrapper(gfxImageSurface* aSurface);
~gfxReusableSurfaceWrapper();
const unsigned char* GetReadOnlyData() const {
NS_ABORT_IF_FALSE(mReadCount > 0, "Should have read lock");
return mSurfaceData;
}
const gfxASurface::gfxImageFormat& Format() { return mFormat; }
/**
* Get a writable copy of the image.
* If necessary this will copy the wrapper. If there are no contention
* the same wrapper will be returned.
*/
gfxReusableSurfaceWrapper* GetWritable(gfxImageSurface** aSurface);
/**
* A read only lock count is recorded, any attempts to
* call GetWritable() while this count is positive will
* create a new surface/wrapper pair.
*/
void ReadLock();
void ReadUnlock();
private:
NS_DECL_OWNINGTHREAD
nsRefPtr<gfxImageSurface> mSurface;
const gfxASurface::gfxImageFormat mFormat;
const unsigned char* mSurfaceData;
int32_t mReadCount;
};
#endif // GFXCOWSURFACEWRAPPER
|