2907d1ac8e15f487817bfb0b422faa61ae5a671e
[WebKit-https.git] / Source / WebCore / platform / graphics / texmap / TextureMapper.h
1 /*
2  Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies)
3
4  This library is free software; you can redistribute it and/or
5  modify it under the terms of the GNU Library General Public
6  License as published by the Free Software Foundation; either
7  version 2 of the License, or (at your option) any later version.
8
9  This library is distributed in the hope that it will be useful,
10  but WITHOUT ANY WARRANTY; without even the implied warranty of
11  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  Library General Public License for more details.
13
14  You should have received a copy of the GNU Library General Public License
15  along with this library; see the file COPYING.LIB.  If not, write to
16  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
17  Boston, MA 02110-1301, USA.
18  */
19
20 #ifndef TextureMapper_h
21 #define TextureMapper_h
22
23 #if USE(ACCELERATED_COMPOSITING)
24
25 #if PLATFORM(QT)
26 #include <qglobal.h>
27
28 #if defined(QT_OPENGL_LIB) || (QT_VERSION >= QT_VERSION_CHECK(5, 0, 0))
29     #if defined(QT_OPENGL_ES_2) && !defined(TEXMAP_OPENGL_ES_2)
30         #define TEXMAP_OPENGL_ES_2
31     #endif
32 #endif
33 #endif
34
35 #include "FilterOperations.h"
36 #include "GraphicsContext.h"
37 #include "IntRect.h"
38 #include "IntSize.h"
39 #include "TextureMapperPlatformLayer.h"
40 #include "TransformationMatrix.h"
41 #include <wtf/UnusedParam.h>
42
43 /*
44     TextureMapper is a mechanism that enables hardware acceleration of CSS animations (accelerated compositing) without
45     a need for a platform specific scene-graph library like CoreAnimations or QGraphicsView.
46 */
47
48 namespace WebCore {
49
50 class TextureMapper;
51
52 // A 2D texture that can be the target of software or GL rendering.
53 class BitmapTexture  : public RefCounted<BitmapTexture> {
54 public:
55     enum Flag {
56         SupportsAlpha = 0x01
57     };
58
59     typedef unsigned Flags;
60
61     BitmapTexture()
62         : m_flags(0)
63     {
64     }
65
66     virtual ~BitmapTexture() { }
67     virtual bool isBackedByOpenGL() const { return false; }
68
69     virtual IntSize size() const = 0;
70     virtual void updateContents(Image*, const IntRect&, const IntPoint& offset) = 0;
71     virtual void updateContents(const void*, const IntRect& target, const IntPoint& offset, int bytesPerLine) = 0;
72     virtual bool isValid() const = 0;
73     inline Flags flags() const { return m_flags; }
74
75     virtual int bpp() const { return 32; }
76     virtual bool canReuseWith(const IntSize& contentsSize, Flags flags = 0) { return false; }
77     void reset(const IntSize& size, Flags flags = 0)
78     {
79         m_flags = flags;
80         m_contentSize = size;
81         didReset();
82     }
83     virtual void didReset() { }
84
85     inline IntSize contentSize() const { return m_contentSize; }
86     inline int numberOfBytes() const { return size().width() * size().height() * bpp() >> 3; }
87     inline bool isOpaque() const { return !(m_flags & SupportsAlpha); }
88
89 #if ENABLE(CSS_FILTERS)
90     virtual PassRefPtr<BitmapTexture> applyFilters(const BitmapTexture& contentTexture, const FilterOperations&) { return this; }
91 #endif
92
93 protected:
94     IntSize m_contentSize;
95
96 private:
97     Flags m_flags;
98 };
99
100 // A "context" class used to encapsulate accelerated texture mapping functions: i.e. drawing a texture
101 // onto the screen or into another texture with a specified transform, opacity and mask.
102 class TextureMapper {
103     friend class BitmapTexture;
104
105 public:
106     enum AccelerationMode { SoftwareMode, OpenGLMode };
107     enum PaintFlag {
108         PaintingMirrored = 1 << 0,
109     };
110     typedef unsigned PaintFlags;
111
112     static PassOwnPtr<TextureMapper> create(AccelerationMode newMode = SoftwareMode);
113     virtual ~TextureMapper() { }
114
115     virtual void drawBorder(const Color&, float borderWidth, const FloatRect& targetRect, const TransformationMatrix& modelViewMatrix = TransformationMatrix()) = 0;
116     virtual void drawTexture(const BitmapTexture&, const FloatRect& target, const TransformationMatrix& modelViewMatrix = TransformationMatrix(), float opacity = 1.0f, const BitmapTexture* maskTexture = 0) = 0;
117
118     // makes a surface the target for the following drawTexture calls.
119     virtual void bindSurface(BitmapTexture* surface) = 0;
120     virtual void setGraphicsContext(GraphicsContext* context) { m_context = context; }
121     virtual GraphicsContext* graphicsContext() { return m_context; }
122     virtual void beginClip(const TransformationMatrix&, const FloatRect&) = 0;
123     virtual void endClip() = 0;
124     virtual PassRefPtr<BitmapTexture> createTexture() = 0;
125
126     void setImageInterpolationQuality(InterpolationQuality quality) { m_interpolationQuality = quality; }
127     void setTextDrawingMode(TextDrawingModeFlags mode) { m_textDrawingMode = mode; }
128
129     InterpolationQuality imageInterpolationQuality() const { return m_interpolationQuality; }
130     TextDrawingModeFlags textDrawingMode() const { return m_textDrawingMode; }
131     virtual AccelerationMode accelerationMode() const = 0;
132
133     virtual void beginPainting(PaintFlags flags = 0) { }
134     virtual void endPainting() { }
135
136     virtual IntSize maxTextureSize() const { return IntSize(INT_MAX, INT_MAX); }
137
138     // A surface is released implicitly when dereferenced.
139     virtual PassRefPtr<BitmapTexture> acquireTextureFromPool(const IntSize&);
140
141 protected:
142     TextureMapper()
143         : m_interpolationQuality(InterpolationDefault)
144         , m_textDrawingMode(TextModeFill)
145     {}
146
147 private:
148 #if USE(TEXTURE_MAPPER_GL)
149     static PassOwnPtr<TextureMapper> platformCreateAccelerated();
150 #else
151     static PassOwnPtr<TextureMapper> platformCreateAccelerated()
152     {
153         return PassOwnPtr<TextureMapper>();
154     }
155 #endif
156     InterpolationQuality m_interpolationQuality;
157     TextDrawingModeFlags m_textDrawingMode;
158     Vector<RefPtr<BitmapTexture> > m_texturePool;
159     GraphicsContext* m_context;
160 };
161
162 }
163
164 #endif
165
166 #endif