diff -r 000000000000 -r 6474c204b198 gfx/thebes/gfxDrawable.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/gfx/thebes/gfxDrawable.h Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,151 @@ +/* -*- Mode: C++; tab-width: 20; indent-tabs-mode: nil; c-basic-offset: 4 -*- + * 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 GFX_DRAWABLE_H +#define GFX_DRAWABLE_H + +#include "nsAutoPtr.h" +#include "gfxRect.h" +#include "gfxMatrix.h" +#include "GraphicsFilter.h" +#include "mozilla/gfx/2D.h" + +class gfxASurface; +class gfxImageSurface; +class gfxContext; +class gfxPattern; + +/** + * gfxDrawable + * An Interface representing something that has an intrinsic size and can draw + * itself repeatedly. + */ +class gfxDrawable { + NS_INLINE_DECL_REFCOUNTING(gfxDrawable) +public: + gfxDrawable(const gfxIntSize aSize) + : mSize(aSize) {} + + /** + * Draw into aContext filling aFillRect, possibly repeating, using aFilter. + * aTransform is a userspace to "image"space matrix. For example, if Draw + * draws using a gfxPattern, this is the matrix that should be set on the + * pattern prior to rendering it. + * @return whether drawing was successful + */ + virtual bool Draw(gfxContext* aContext, + const gfxRect& aFillRect, + bool aRepeat, + const GraphicsFilter& aFilter, + const gfxMatrix& aTransform = gfxMatrix()) = 0; + virtual already_AddRefed GetAsImageSurface() { return nullptr; } + virtual gfxIntSize Size() { return mSize; } + +protected: + // Protected destructor, to discourage deletion outside of Release(): + virtual ~gfxDrawable() {} + + const gfxIntSize mSize; +}; + +/** + * gfxSurfaceDrawable + * A convenience implementation of gfxDrawable for surfaces. + */ +class gfxSurfaceDrawable : public gfxDrawable { +public: + gfxSurfaceDrawable(gfxASurface* aSurface, const gfxIntSize aSize, + const gfxMatrix aTransform = gfxMatrix()); + gfxSurfaceDrawable(mozilla::gfx::DrawTarget* aDT, const gfxIntSize aSize, + const gfxMatrix aTransform = gfxMatrix()); + gfxSurfaceDrawable(mozilla::gfx::SourceSurface* aSurface, const gfxIntSize aSize, + const gfxMatrix aTransform = gfxMatrix()); + virtual ~gfxSurfaceDrawable() {} + + virtual bool Draw(gfxContext* aContext, + const gfxRect& aFillRect, + bool aRepeat, + const GraphicsFilter& aFilter, + const gfxMatrix& aTransform = gfxMatrix()); + + virtual already_AddRefed GetAsImageSurface(); + +protected: + nsRefPtr mSurface; + mozilla::RefPtr mDrawTarget; + mozilla::RefPtr mSourceSurface; + const gfxMatrix mTransform; +}; + +/** + * gfxDrawingCallback + * A simple drawing functor. + */ +class gfxDrawingCallback { + NS_INLINE_DECL_REFCOUNTING(gfxDrawingCallback) +protected: + // Protected destructor, to discourage deletion outside of Release(): + virtual ~gfxDrawingCallback() {} + +public: + /** + * Draw into aContext filling aFillRect using aFilter. + * aTransform is a userspace to "image"space matrix. For example, if Draw + * draws using a gfxPattern, this is the matrix that should be set on the + * pattern prior to rendering it. + * @return whether drawing was successful + */ + virtual bool operator()(gfxContext* aContext, + const gfxRect& aFillRect, + const GraphicsFilter& aFilter, + const gfxMatrix& aTransform = gfxMatrix()) = 0; + +}; + +/** + * gfxCallbackDrawable + * A convenience implementation of gfxDrawable for callbacks. + */ +class gfxCallbackDrawable : public gfxDrawable { +public: + gfxCallbackDrawable(gfxDrawingCallback* aCallback, const gfxIntSize aSize); + virtual ~gfxCallbackDrawable() {} + + virtual bool Draw(gfxContext* aContext, + const gfxRect& aFillRect, + bool aRepeat, + const GraphicsFilter& aFilter, + const gfxMatrix& aTransform = gfxMatrix()); + +protected: + already_AddRefed MakeSurfaceDrawable(const GraphicsFilter aFilter = GraphicsFilter::FILTER_FAST); + + nsRefPtr mCallback; + nsRefPtr mSurfaceDrawable; +}; + +/** + * gfxPatternDrawable + * A convenience implementation of gfxDrawable for patterns. + */ +class gfxPatternDrawable : public gfxDrawable { +public: + gfxPatternDrawable(gfxPattern* aPattern, + const gfxIntSize aSize); + virtual ~gfxPatternDrawable(); + + virtual bool Draw(gfxContext* aContext, + const gfxRect& aFillRect, + bool aRepeat, + const GraphicsFilter& aFilter, + const gfxMatrix& aTransform = gfxMatrix()); + +protected: + already_AddRefed MakeCallbackDrawable(); + + nsRefPtr mPattern; +}; + +#endif /* GFX_DRAWABLE_H */