Source/WebCore/platform/graphics/GraphicsContext3D.h

   1 /*
   2  * Copyright (C) 2009 Apple Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  * 1. Redistributions of source code must retain the above copyright
   8  *    notice, this list of conditions and the following disclaimer.
   9  * 2. Redistributions in binary form must reproduce the above copyright
  10  *    notice, this list of conditions and the following disclaimer in the
  11  *    documentation and/or other materials provided with the distribution.
  12  *
  13  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
  14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
  17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24  */
  25
  26 #ifndef GraphicsContext3D_h
  27 #define GraphicsContext3D_h
  28
  29 #include "GraphicsTypes3D.h"
  30 #include "Image.h"
  31 #include "IntRect.h"
  32 #include "PlatformLayer.h"
  33 #include <memory>
  34 #include <wtf/HashMap.h>
  35 #include <wtf/ListHashSet.h>
  36 #include <wtf/Noncopyable.h>
  37 #include <wtf/RefCounted.h>
  38 #include <wtf/text/WTFString.h>
  39
  40 #if USE(CA)
  41 #include "PlatformCALayer.h"
  42 #endif
  43
  44 // FIXME: Find a better way to avoid the name confliction for NO_ERROR.
  45 #if PLATFORM(WIN)
  46 #undef NO_ERROR
  47 #elif PLATFORM(GTK)
  48 // This define is from the X11 headers, but it's used below, so we must undefine it.
  49 #undef VERSION
  50 #endif
  51
  52 #if PLATFORM(MAC) || PLATFORM(GTK) || PLATFORM(EFL) || PLATFORM(BLACKBERRY) || PLATFORM(WIN) || PLATFORM(NIX)
  53 #include "ANGLEWebKitBridge.h"
  54 #endif
  55
  56 #if PLATFORM(MAC)
  57 #include <wtf/RetainPtr.h>
  58 OBJC_CLASS CALayer;
  59 OBJC_CLASS WebGLLayer;
  60 #elif PLATFORM(GTK) || PLATFORM(EFL) || PLATFORM(NIX)
  61 typedef unsigned int GLuint;
  62 #endif
  63
  64 #if PLATFORM(MAC)
  65 typedef struct _CGLContextObject *CGLContextObj;
  66
  67 typedef CGLContextObj PlatformGraphicsContext3D;
  68 #else
  69 typedef void* PlatformGraphicsContext3D;
  70 typedef void* PlatformGraphicsSurface3D;
  71 #endif
  72
  73 // These are currently the same among all implementations.
  74 const PlatformGraphicsContext3D NullPlatformGraphicsContext3D = 0;
  75 const Platform3DObject NullPlatform3DObject = 0;
  76
  77 namespace WebCore {
  78 class DrawingBuffer;
  79 class Extensions3D;
  80 #if USE(OPENGL_ES_2)
  81 class Extensions3DOpenGLES;
  82 #else
  83 class Extensions3DOpenGL;
  84 #endif
  85 class HostWindow;
  86 class Image;
  87 class ImageBuffer;
  88 class ImageSource;
  89 class ImageData;
  90 class IntRect;
  91 class IntSize;
  92 #if USE(CAIRO)
  93 class PlatformContextCairo;
  94 #elif PLATFORM(BLACKBERRY)
  95 class GraphicsContext;
  96 #endif
  97
  98 typedef WTF::HashMap<CString, uint64_t> ShaderNameHash;
  99
 100 struct ActiveInfo {
 101     String name;
 102     GC3Denum type;
 103     GC3Dint size;
 104 };
 105
 106 class GraphicsContext3DPrivate;
 107
 108 class GraphicsContext3D : public RefCounted<GraphicsContext3D> {
 109 public:
 110     enum {
 111         DEPTH_BUFFER_BIT = 0x00000100,
 112         STENCIL_BUFFER_BIT = 0x00000400,
 113         COLOR_BUFFER_BIT = 0x00004000,
 114         POINTS = 0x0000,
 115         LINES = 0x0001,
 116         LINE_LOOP = 0x0002,
 117         LINE_STRIP = 0x0003,
 118         TRIANGLES = 0x0004,
 119         TRIANGLE_STRIP = 0x0005,
 120         TRIANGLE_FAN = 0x0006,
 121         ZERO = 0,
 122         ONE = 1,
 123         SRC_COLOR = 0x0300,
 124         ONE_MINUS_SRC_COLOR = 0x0301,
 125         SRC_ALPHA = 0x0302,
 126         ONE_MINUS_SRC_ALPHA = 0x0303,
 127         DST_ALPHA = 0x0304,
 128         ONE_MINUS_DST_ALPHA = 0x0305,
 129         DST_COLOR = 0x0306,
 130         ONE_MINUS_DST_COLOR = 0x0307,
 131         SRC_ALPHA_SATURATE = 0x0308,
 132         FUNC_ADD = 0x8006,
 133         BLEND_EQUATION = 0x8009,
 134         BLEND_EQUATION_RGB = 0x8009,
 135         BLEND_EQUATION_ALPHA = 0x883D,
 136         FUNC_SUBTRACT = 0x800A,
 137         FUNC_REVERSE_SUBTRACT = 0x800B,
 138         BLEND_DST_RGB = 0x80C8,
 139         BLEND_SRC_RGB = 0x80C9,
 140         BLEND_DST_ALPHA = 0x80CA,
 141         BLEND_SRC_ALPHA = 0x80CB,
 142         CONSTANT_COLOR = 0x8001,
 143         ONE_MINUS_CONSTANT_COLOR = 0x8002,
 144         CONSTANT_ALPHA = 0x8003,
 145         ONE_MINUS_CONSTANT_ALPHA = 0x8004,
 146         BLEND_COLOR = 0x8005,
 147         ARRAY_BUFFER = 0x8892,
 148         ELEMENT_ARRAY_BUFFER = 0x8893,
 149         ARRAY_BUFFER_BINDING = 0x8894,
 150         ELEMENT_ARRAY_BUFFER_BINDING = 0x8895,
 151         STREAM_DRAW = 0x88E0,
 152         STATIC_DRAW = 0x88E4,
 153         DYNAMIC_DRAW = 0x88E8,
 154         BUFFER_SIZE = 0x8764,
 155         BUFFER_USAGE = 0x8765,
 156         CURRENT_VERTEX_ATTRIB = 0x8626,
 157         FRONT = 0x0404,
 158         BACK = 0x0405,
 159         FRONT_AND_BACK = 0x0408,
 160         TEXTURE_2D = 0x0DE1,
 161         CULL_FACE = 0x0B44,
 162         BLEND = 0x0BE2,
 163         DITHER = 0x0BD0,
 164         STENCIL_TEST = 0x0B90,
 165         DEPTH_TEST = 0x0B71,
 166         SCISSOR_TEST = 0x0C11,
 167         POLYGON_OFFSET_FILL = 0x8037,
 168         SAMPLE_ALPHA_TO_COVERAGE = 0x809E,
 169         SAMPLE_COVERAGE = 0x80A0,
 170         NO_ERROR = 0,
 171         INVALID_ENUM = 0x0500,
 172         INVALID_VALUE = 0x0501,
 173         INVALID_OPERATION = 0x0502,
 174         OUT_OF_MEMORY = 0x0505,
 175         CW = 0x0900,
 176         CCW = 0x0901,
 177         LINE_WIDTH = 0x0B21,
 178         ALIASED_POINT_SIZE_RANGE = 0x846D,
 179         ALIASED_LINE_WIDTH_RANGE = 0x846E,
 180         CULL_FACE_MODE = 0x0B45,
 181         FRONT_FACE = 0x0B46,
 182         DEPTH_RANGE = 0x0B70,
 183         DEPTH_WRITEMASK = 0x0B72,
 184         DEPTH_CLEAR_VALUE = 0x0B73,
 185         DEPTH_FUNC = 0x0B74,
 186         STENCIL_CLEAR_VALUE = 0x0B91,
 187         STENCIL_FUNC = 0x0B92,
 188         STENCIL_FAIL = 0x0B94,
 189         STENCIL_PASS_DEPTH_FAIL = 0x0B95,
 190         STENCIL_PASS_DEPTH_PASS = 0x0B96,
 191         STENCIL_REF = 0x0B97,
 192         STENCIL_VALUE_MASK = 0x0B93,
 193         STENCIL_WRITEMASK = 0x0B98,
 194         STENCIL_BACK_FUNC = 0x8800,
 195         STENCIL_BACK_FAIL = 0x8801,
 196         STENCIL_BACK_PASS_DEPTH_FAIL = 0x8802,
 197         STENCIL_BACK_PASS_DEPTH_PASS = 0x8803,
 198         STENCIL_BACK_REF = 0x8CA3,
 199         STENCIL_BACK_VALUE_MASK = 0x8CA4,
 200         STENCIL_BACK_WRITEMASK = 0x8CA5,
 201         VIEWPORT = 0x0BA2,
 202         SCISSOR_BOX = 0x0C10,
 203         COLOR_CLEAR_VALUE = 0x0C22,
 204         COLOR_WRITEMASK = 0x0C23,
 205         UNPACK_ALIGNMENT = 0x0CF5,
 206         PACK_ALIGNMENT = 0x0D05,
 207         MAX_TEXTURE_SIZE = 0x0D33,
 208         MAX_VIEWPORT_DIMS = 0x0D3A,
 209         SUBPIXEL_BITS = 0x0D50,
 210         RED_BITS = 0x0D52,
 211         GREEN_BITS = 0x0D53,
 212         BLUE_BITS = 0x0D54,
 213         ALPHA_BITS = 0x0D55,
 214         DEPTH_BITS = 0x0D56,
 215         STENCIL_BITS = 0x0D57,
 216         POLYGON_OFFSET_UNITS = 0x2A00,
 217         POLYGON_OFFSET_FACTOR = 0x8038,
 218         TEXTURE_BINDING_2D = 0x8069,
 219         SAMPLE_BUFFERS = 0x80A8,
 220         SAMPLES = 0x80A9,
 221         SAMPLE_COVERAGE_VALUE = 0x80AA,
 222         SAMPLE_COVERAGE_INVERT = 0x80AB,
 223         NUM_COMPRESSED_TEXTURE_FORMATS = 0x86A2,
 224         COMPRESSED_TEXTURE_FORMATS = 0x86A3,
 225         DONT_CARE = 0x1100,
 226         FASTEST = 0x1101,
 227         NICEST = 0x1102,
 228         GENERATE_MIPMAP_HINT = 0x8192,
 229         BYTE = 0x1400,
 230         UNSIGNED_BYTE = 0x1401,
 231         SHORT = 0x1402,
 232         UNSIGNED_SHORT = 0x1403,
 233         INT = 0x1404,
 234         UNSIGNED_INT = 0x1405,
 235         FLOAT = 0x1406,
 236         HALF_FLOAT_OES = 0x8D61,
 237         FIXED = 0x140C,
 238         DEPTH_COMPONENT = 0x1902,
 239         ALPHA = 0x1906,
 240         RGB = 0x1907,
 241         RGBA = 0x1908,
 242         BGRA = 0x80E1,
 243         LUMINANCE = 0x1909,
 244         LUMINANCE_ALPHA = 0x190A,
 245         UNSIGNED_SHORT_4_4_4_4 = 0x8033,
 246         UNSIGNED_SHORT_5_5_5_1 = 0x8034,
 247         UNSIGNED_SHORT_5_6_5 = 0x8363,
 248         FRAGMENT_SHADER = 0x8B30,
 249         VERTEX_SHADER = 0x8B31,
 250         MAX_VERTEX_ATTRIBS = 0x8869,
 251         MAX_VERTEX_UNIFORM_VECTORS = 0x8DFB,
 252         MAX_VARYING_VECTORS = 0x8DFC,
 253         MAX_COMBINED_TEXTURE_IMAGE_UNITS = 0x8B4D,
 254         MAX_VERTEX_TEXTURE_IMAGE_UNITS = 0x8B4C,
 255         MAX_TEXTURE_IMAGE_UNITS = 0x8872,
 256         MAX_FRAGMENT_UNIFORM_VECTORS = 0x8DFD,
 257         SHADER_TYPE = 0x8B4F,
 258         DELETE_STATUS = 0x8B80,
 259         LINK_STATUS = 0x8B82,
 260         VALIDATE_STATUS = 0x8B83,
 261         ATTACHED_SHADERS = 0x8B85,
 262         ACTIVE_UNIFORMS = 0x8B86,
 263         ACTIVE_UNIFORM_MAX_LENGTH = 0x8B87,
 264         ACTIVE_ATTRIBUTES = 0x8B89,
 265         ACTIVE_ATTRIBUTE_MAX_LENGTH = 0x8B8A,
 266         SHADING_LANGUAGE_VERSION = 0x8B8C,
 267         CURRENT_PROGRAM = 0x8B8D,
 268         NEVER = 0x0200,
 269         LESS = 0x0201,
 270         EQUAL = 0x0202,
 271         LEQUAL = 0x0203,
 272         GREATER = 0x0204,
 273         NOTEQUAL = 0x0205,
 274         GEQUAL = 0x0206,
 275         ALWAYS = 0x0207,
 276         KEEP = 0x1E00,
 277         REPLACE = 0x1E01,
 278         INCR = 0x1E02,
 279         DECR = 0x1E03,
 280         INVERT = 0x150A,
 281         INCR_WRAP = 0x8507,
 282         DECR_WRAP = 0x8508,
 283         VENDOR = 0x1F00,
 284         RENDERER = 0x1F01,
 285         VERSION = 0x1F02,
 286         EXTENSIONS = 0x1F03,
 287         NEAREST = 0x2600,
 288         LINEAR = 0x2601,
 289         NEAREST_MIPMAP_NEAREST = 0x2700,
 290         LINEAR_MIPMAP_NEAREST = 0x2701,
 291         NEAREST_MIPMAP_LINEAR = 0x2702,
 292         LINEAR_MIPMAP_LINEAR = 0x2703,
 293         TEXTURE_MAG_FILTER = 0x2800,
 294         TEXTURE_MIN_FILTER = 0x2801,
 295         TEXTURE_WRAP_S = 0x2802,
 296         TEXTURE_WRAP_T = 0x2803,
 297         TEXTURE = 0x1702,
 298         TEXTURE_CUBE_MAP = 0x8513,
 299         TEXTURE_BINDING_CUBE_MAP = 0x8514,
 300         TEXTURE_CUBE_MAP_POSITIVE_X = 0x8515,
 301         TEXTURE_CUBE_MAP_NEGATIVE_X = 0x8516,
 302         TEXTURE_CUBE_MAP_POSITIVE_Y = 0x8517,
 303         TEXTURE_CUBE_MAP_NEGATIVE_Y = 0x8518,
 304         TEXTURE_CUBE_MAP_POSITIVE_Z = 0x8519,
 305         TEXTURE_CUBE_MAP_NEGATIVE_Z = 0x851A,
 306         MAX_CUBE_MAP_TEXTURE_SIZE = 0x851C,
 307         TEXTURE0 = 0x84C0,
 308         TEXTURE1 = 0x84C1,
 309         TEXTURE2 = 0x84C2,
 310         TEXTURE3 = 0x84C3,
 311         TEXTURE4 = 0x84C4,
 312         TEXTURE5 = 0x84C5,
 313         TEXTURE6 = 0x84C6,
 314         TEXTURE7 = 0x84C7,
 315         TEXTURE8 = 0x84C8,
 316         TEXTURE9 = 0x84C9,
 317         TEXTURE10 = 0x84CA,
 318         TEXTURE11 = 0x84CB,
 319         TEXTURE12 = 0x84CC,
 320         TEXTURE13 = 0x84CD,
 321         TEXTURE14 = 0x84CE,
 322         TEXTURE15 = 0x84CF,
 323         TEXTURE16 = 0x84D0,
 324         TEXTURE17 = 0x84D1,
 325         TEXTURE18 = 0x84D2,
 326         TEXTURE19 = 0x84D3,
 327         TEXTURE20 = 0x84D4,
 328         TEXTURE21 = 0x84D5,
 329         TEXTURE22 = 0x84D6,
 330         TEXTURE23 = 0x84D7,
 331         TEXTURE24 = 0x84D8,
 332         TEXTURE25 = 0x84D9,
 333         TEXTURE26 = 0x84DA,
 334         TEXTURE27 = 0x84DB,
 335         TEXTURE28 = 0x84DC,
 336         TEXTURE29 = 0x84DD,
 337         TEXTURE30 = 0x84DE,
 338         TEXTURE31 = 0x84DF,
 339         ACTIVE_TEXTURE = 0x84E0,
 340         REPEAT = 0x2901,
 341         CLAMP_TO_EDGE = 0x812F,
 342         MIRRORED_REPEAT = 0x8370,
 343         FLOAT_VEC2 = 0x8B50,
 344         FLOAT_VEC3 = 0x8B51,
 345         FLOAT_VEC4 = 0x8B52,
 346         INT_VEC2 = 0x8B53,
 347         INT_VEC3 = 0x8B54,
 348         INT_VEC4 = 0x8B55,
 349         BOOL = 0x8B56,
 350         BOOL_VEC2 = 0x8B57,
 351         BOOL_VEC3 = 0x8B58,
 352         BOOL_VEC4 = 0x8B59,
 353         FLOAT_MAT2 = 0x8B5A,
 354         FLOAT_MAT3 = 0x8B5B,
 355         FLOAT_MAT4 = 0x8B5C,
 356         SAMPLER_2D = 0x8B5E,
 357         SAMPLER_CUBE = 0x8B60,
 358         VERTEX_ATTRIB_ARRAY_ENABLED = 0x8622,
 359         VERTEX_ATTRIB_ARRAY_SIZE = 0x8623,
 360         VERTEX_ATTRIB_ARRAY_STRIDE = 0x8624,
 361         VERTEX_ATTRIB_ARRAY_TYPE = 0x8625,
 362         VERTEX_ATTRIB_ARRAY_NORMALIZED = 0x886A,
 363         VERTEX_ATTRIB_ARRAY_POINTER = 0x8645,
 364         VERTEX_ATTRIB_ARRAY_BUFFER_BINDING = 0x889F,
 365         COMPILE_STATUS = 0x8B81,
 366         INFO_LOG_LENGTH = 0x8B84,
 367         SHADER_SOURCE_LENGTH = 0x8B88,
 368         SHADER_COMPILER = 0x8DFA,
 369         SHADER_BINARY_FORMATS = 0x8DF8,
 370         NUM_SHADER_BINARY_FORMATS = 0x8DF9,
 371         LOW_FLOAT = 0x8DF0,
 372         MEDIUM_FLOAT = 0x8DF1,
 373         HIGH_FLOAT = 0x8DF2,
 374         LOW_INT = 0x8DF3,
 375         MEDIUM_INT = 0x8DF4,
 376         HIGH_INT = 0x8DF5,
 377         FRAMEBUFFER = 0x8D40,
 378         RENDERBUFFER = 0x8D41,
 379         RGBA4 = 0x8056,
 380         RGB5_A1 = 0x8057,
 381         RGB565 = 0x8D62,
 382         DEPTH_COMPONENT16 = 0x81A5,
 383         STENCIL_INDEX = 0x1901,
 384         STENCIL_INDEX8 = 0x8D48,
 385         DEPTH_STENCIL = 0x84F9,
 386         UNSIGNED_INT_24_8 = 0x84FA,
 387         DEPTH24_STENCIL8 = 0x88F0,
 388         RENDERBUFFER_WIDTH = 0x8D42,
 389         RENDERBUFFER_HEIGHT = 0x8D43,
 390         RENDERBUFFER_INTERNAL_FORMAT = 0x8D44,
 391         RENDERBUFFER_RED_SIZE = 0x8D50,
 392         RENDERBUFFER_GREEN_SIZE = 0x8D51,
 393         RENDERBUFFER_BLUE_SIZE = 0x8D52,
 394         RENDERBUFFER_ALPHA_SIZE = 0x8D53,
 395         RENDERBUFFER_DEPTH_SIZE = 0x8D54,
 396         RENDERBUFFER_STENCIL_SIZE = 0x8D55,
 397         FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE = 0x8CD0,
 398         FRAMEBUFFER_ATTACHMENT_OBJECT_NAME = 0x8CD1,
 399         FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL = 0x8CD2,
 400         FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE = 0x8CD3,
 401         COLOR_ATTACHMENT0 = 0x8CE0,
 402         DEPTH_ATTACHMENT = 0x8D00,
 403         STENCIL_ATTACHMENT = 0x8D20,
 404         DEPTH_STENCIL_ATTACHMENT = 0x821A,
 405         NONE = 0,
 406         FRAMEBUFFER_COMPLETE = 0x8CD5,
 407         FRAMEBUFFER_INCOMPLETE_ATTACHMENT = 0x8CD6,
 408         FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT = 0x8CD7,
 409         FRAMEBUFFER_INCOMPLETE_DIMENSIONS = 0x8CD9,
 410         FRAMEBUFFER_UNSUPPORTED = 0x8CDD,
 411         FRAMEBUFFER_BINDING = 0x8CA6,
 412         RENDERBUFFER_BINDING = 0x8CA7,
 413         MAX_RENDERBUFFER_SIZE = 0x84E8,
 414         INVALID_FRAMEBUFFER_OPERATION = 0x0506,
 415
 416         // WebGL-specific enums
 417         UNPACK_FLIP_Y_WEBGL = 0x9240,
 418         UNPACK_PREMULTIPLY_ALPHA_WEBGL = 0x9241,
 419         CONTEXT_LOST_WEBGL = 0x9242,
 420         UNPACK_COLORSPACE_CONVERSION_WEBGL = 0x9243,
 421         BROWSER_DEFAULT_WEBGL = 0x9244
 422     };
 423
 424     // Context creation attributes.
 425     struct Attributes {
 426         Attributes()
 427             : alpha(true)
 428             , depth(true)
 429             , stencil(false)
 430             , antialias(true)
 431             , premultipliedAlpha(true)
 432             , preserveDrawingBuffer(false)
 433             , noExtensions(false)
 434             , shareResources(true)
 435             , preferDiscreteGPU(false)
 436             , multithreaded(false)
 437             , forceSoftwareRenderer(false)
 438         {
 439         }
 440
 441         bool alpha;
 442         bool depth;
 443         bool stencil;
 444         bool antialias;
 445         bool premultipliedAlpha;
 446         bool preserveDrawingBuffer;
 447         bool noExtensions;
 448         bool shareResources;
 449         bool preferDiscreteGPU;
 450         bool multithreaded;
 451         bool forceSoftwareRenderer;
 452     };
 453
 454     enum RenderStyle {
 455         RenderOffscreen,
 456         RenderDirectlyToHostWindow,
 457         RenderToCurrentGLContext
 458     };
 459
 460     class ContextLostCallback {
 461     public:
 462         virtual void onContextLost() = 0;
 463         virtual ~ContextLostCallback() {}
 464     };
 465
 466     class ErrorMessageCallback {
 467     public:
 468         virtual void onErrorMessage(const String& message, GC3Dint id) = 0;
 469         virtual ~ErrorMessageCallback() { }
 470     };
 471
 472     void setContextLostCallback(PassOwnPtr<ContextLostCallback>);
 473     void setErrorMessageCallback(PassOwnPtr<ErrorMessageCallback>);
 474
 475     static PassRefPtr<GraphicsContext3D> create(Attributes, HostWindow*, RenderStyle = RenderOffscreen);
 476     static PassRefPtr<GraphicsContext3D> createForCurrentGLContext();
 477     ~GraphicsContext3D();
 478
 479 #if PLATFORM(MAC)
 480     PlatformGraphicsContext3D platformGraphicsContext3D() const { return m_contextObj; }
 481     Platform3DObject platformTexture() const { return m_compositorTexture; }
 482     CALayer* platformLayer() const { return reinterpret_cast<CALayer*>(m_webGLLayer.get()); }
 483 #else
 484     PlatformGraphicsContext3D platformGraphicsContext3D();
 485     Platform3DObject platformTexture() const;
 486 #if USE(ACCELERATED_COMPOSITING)
 487     PlatformLayer* platformLayer() const;
 488 #endif
 489 #endif
 490
 491     bool makeContextCurrent();
 492
 493 #if PLATFORM(MAC) || PLATFORM(GTK) || PLATFORM(EFL) || PLATFORM(BLACKBERRY) || PLATFORM(WIN) || PLATFORM(NIX)
 494     // With multisampling on, blit from multisampleFBO to regular FBO.
 495     void prepareTexture();
 496 #endif
 497
 498     // Equivalent to ::glTexImage2D(). Allows pixels==0 with no allocation.
 499     void texImage2DDirect(GC3Denum target, GC3Dint level, GC3Denum internalformat, GC3Dsizei width, GC3Dsizei height, GC3Dint border, GC3Denum format, GC3Denum type, const void* pixels);
 500
 501     // Helper to texImage2D with pixel==0 case: pixels are initialized to 0.
 502     // Return true if no GL error is synthesized.
 503     // By default, alignment is 4, the OpenGL default setting.
 504     bool texImage2DResourceSafe(GC3Denum target, GC3Dint level, GC3Denum internalformat, GC3Dsizei width, GC3Dsizei height, GC3Dint border, GC3Denum format, GC3Denum type, GC3Dint alignment = 4);
 505
 506     bool isGLES2Compliant() const;
 507
 508     //----------------------------------------------------------------------
 509     // Helpers for texture uploading and pixel readback.
 510     //
 511
 512     // Computes the components per pixel and bytes per component
 513     // for the given format and type combination. Returns false if
 514     // either was an invalid enum.
 515     static bool computeFormatAndTypeParameters(GC3Denum format,
 516                                                GC3Denum type,
 517                                                unsigned int* componentsPerPixel,
 518                                                unsigned int* bytesPerComponent);
 519
 520     // Computes the image size in bytes. If paddingInBytes is not null, padding
 521     // is also calculated in return. Returns NO_ERROR if succeed, otherwise
 522     // return the suggested GL error indicating the cause of the failure:
 523     //   INVALID_VALUE if width/height is negative or overflow happens.
 524     //   INVALID_ENUM if format/type is illegal.
 525     static GC3Denum computeImageSizeInBytes(GC3Denum format,
 526                                      GC3Denum type,
 527                                      GC3Dsizei width,
 528                                      GC3Dsizei height,
 529                                      GC3Dint alignment,
 530                                      unsigned int* imageSizeInBytes,
 531                                      unsigned int* paddingInBytes);
 532
 533     // Extracts the contents of the given ImageData into the passed Vector,
 534     // packing the pixel data according to the given format and type,
 535     // and obeying the flipY and premultiplyAlpha flags. Returns true
 536     // upon success.
 537     static bool extractImageData(ImageData*,
 538                           GC3Denum format,
 539                           GC3Denum type,
 540                           bool flipY,
 541                           bool premultiplyAlpha,
 542                           Vector<uint8_t>& data);
 543
 544     // Helper function which extracts the user-supplied texture
 545     // data, applying the flipY and premultiplyAlpha parameters.
 546     // If the data is not tightly packed according to the passed
 547     // unpackAlignment, the output data will be tightly packed.
 548     // Returns true if successful, false if any error occurred.
 549     static bool extractTextureData(unsigned int width, unsigned int height,
 550                             GC3Denum format, GC3Denum type,
 551                             unsigned int unpackAlignment,
 552                             bool flipY, bool premultiplyAlpha,
 553                             const void* pixels,
 554                             Vector<uint8_t>& data);
 555
 556
 557     // Attempt to enumerate all possible native image formats to
 558     // reduce the amount of temporary allocations during texture
 559     // uploading. This enum must be public because it is accessed
 560     // by non-member functions.
 561     enum DataFormat {
 562         DataFormatRGBA8 = 0,
 563         DataFormatRGBA16Little,
 564         DataFormatRGBA16Big,
 565         DataFormatRGBA16F,
 566         DataFormatRGBA32F,
 567         DataFormatRGB8,
 568         DataFormatRGB16Little,
 569         DataFormatRGB16Big,
 570         DataFormatRGB16F,
 571         DataFormatRGB32F,
 572         DataFormatBGR8,
 573         DataFormatBGRA8,
 574         DataFormatBGRA16Little,
 575         DataFormatBGRA16Big,
 576         DataFormatARGB8,
 577         DataFormatARGB16Little,
 578         DataFormatARGB16Big,
 579         DataFormatABGR8,
 580         DataFormatRGBA5551,
 581         DataFormatRGBA4444,
 582         DataFormatRGB565,
 583         DataFormatR8,
 584         DataFormatR16Little,
 585         DataFormatR16Big,
 586         DataFormatR16F,
 587         DataFormatR32F,
 588         DataFormatRA8,
 589         DataFormatRA16Little,
 590         DataFormatRA16Big,
 591         DataFormatRA16F,
 592         DataFormatRA32F,
 593         DataFormatAR8,
 594         DataFormatAR16Little,
 595         DataFormatAR16Big,
 596         DataFormatA8,
 597         DataFormatA16Little,
 598         DataFormatA16Big,
 599         DataFormatA16F,
 600         DataFormatA32F,
 601         DataFormatNumFormats
 602     };
 603
 604     // Check if the format is one of the formats from the ImageData or DOM elements.
 605     // The formats from ImageData is always RGBA8.
 606     // The formats from DOM elements vary with Graphics ports. It can only be RGBA8 or BGRA8 for non-CG port while a little more for CG port.
 607     static ALWAYS_INLINE bool srcFormatComesFromDOMElementOrImageData(DataFormat SrcFormat)
 608     {
 609 #if USE(CG)
 610 #if CPU(BIG_ENDIAN)
 611     return SrcFormat == DataFormatRGBA8 || SrcFormat == DataFormatARGB8 || SrcFormat == DataFormatRGB8
 612         || SrcFormat == DataFormatRA8 || SrcFormat == DataFormatAR8 || SrcFormat == DataFormatR8 || SrcFormat == DataFormatA8;
 613 #else
 614     // That LITTLE_ENDIAN case has more possible formats than BIG_ENDIAN case is because some decoded image data is actually big endian
 615     // even on little endian architectures.
 616     return SrcFormat == DataFormatBGRA8 || SrcFormat == DataFormatABGR8 || SrcFormat == DataFormatBGR8
 617         || SrcFormat == DataFormatRGBA8 || SrcFormat == DataFormatARGB8 || SrcFormat == DataFormatRGB8
 618         || SrcFormat == DataFormatR8 || SrcFormat == DataFormatA8
 619         || SrcFormat == DataFormatRA8 || SrcFormat == DataFormatAR8;
 620 #endif
 621 #else
 622     return SrcFormat == DataFormatBGRA8 || SrcFormat == DataFormatRGBA8;
 623 #endif
 624     }
 625
 626     //----------------------------------------------------------------------
 627     // Entry points for WebGL.
 628     //
 629
 630     void activeTexture(GC3Denum texture);
 631     void attachShader(Platform3DObject program, Platform3DObject shader);
 632     void bindAttribLocation(Platform3DObject, GC3Duint index, const String& name);
 633     void bindBuffer(GC3Denum target, Platform3DObject);
 634     void bindFramebuffer(GC3Denum target, Platform3DObject);
 635     void bindRenderbuffer(GC3Denum target, Platform3DObject);
 636     void bindTexture(GC3Denum target, Platform3DObject);
 637     void blendColor(GC3Dclampf red, GC3Dclampf green, GC3Dclampf blue, GC3Dclampf alpha);
 638     void blendEquation(GC3Denum mode);
 639     void blendEquationSeparate(GC3Denum modeRGB, GC3Denum modeAlpha);
 640     void blendFunc(GC3Denum sfactor, GC3Denum dfactor);
 641     void blendFuncSeparate(GC3Denum srcRGB, GC3Denum dstRGB, GC3Denum srcAlpha, GC3Denum dstAlpha);
 642
 643     void bufferData(GC3Denum target, GC3Dsizeiptr size, GC3Denum usage);
 644     void bufferData(GC3Denum target, GC3Dsizeiptr size, const void* data, GC3Denum usage);
 645     void bufferSubData(GC3Denum target, GC3Dintptr offset, GC3Dsizeiptr size, const void* data);
 646
 647     GC3Denum checkFramebufferStatus(GC3Denum target);
 648     void clear(GC3Dbitfield mask);
 649     void clearColor(GC3Dclampf red, GC3Dclampf green, GC3Dclampf blue, GC3Dclampf alpha);
 650     void clearDepth(GC3Dclampf depth);
 651     void clearStencil(GC3Dint s);
 652     void colorMask(GC3Dboolean red, GC3Dboolean green, GC3Dboolean blue, GC3Dboolean alpha);
 653     void compileShader(Platform3DObject);
 654
 655     void compressedTexImage2D(GC3Denum target, GC3Dint level, GC3Denum internalformat, GC3Dsizei width, GC3Dsizei height, GC3Dint border, GC3Dsizei imageSize, const void* data);
 656     void compressedTexSubImage2D(GC3Denum target, GC3Dint level, GC3Dint xoffset, GC3Dint yoffset, GC3Dsizei width, GC3Dsizei height, GC3Denum format, GC3Dsizei imageSize, const void* data);
 657     void copyTexImage2D(GC3Denum target, GC3Dint level, GC3Denum internalformat, GC3Dint x, GC3Dint y, GC3Dsizei width, GC3Dsizei height, GC3Dint border);
 658     void copyTexSubImage2D(GC3Denum target, GC3Dint level, GC3Dint xoffset, GC3Dint yoffset, GC3Dint x, GC3Dint y, GC3Dsizei width, GC3Dsizei height);
 659     void cullFace(GC3Denum mode);
 660     void depthFunc(GC3Denum func);
 661     void depthMask(GC3Dboolean flag);
 662     void depthRange(GC3Dclampf zNear, GC3Dclampf zFar);
 663     void detachShader(Platform3DObject, Platform3DObject);
 664     void disable(GC3Denum cap);
 665     void disableVertexAttribArray(GC3Duint index);
 666     void drawArrays(GC3Denum mode, GC3Dint first, GC3Dsizei count);
 667     void drawElements(GC3Denum mode, GC3Dsizei count, GC3Denum type, GC3Dintptr offset);
 668
 669     void enable(GC3Denum cap);
 670     void enableVertexAttribArray(GC3Duint index);
 671     void finish();
 672     void flush();
 673     void framebufferRenderbuffer(GC3Denum target, GC3Denum attachment, GC3Denum renderbuffertarget, Platform3DObject);
 674     void framebufferTexture2D(GC3Denum target, GC3Denum attachment, GC3Denum textarget, Platform3DObject, GC3Dint level);
 675     void frontFace(GC3Denum mode);
 676     void generateMipmap(GC3Denum target);
 677
 678     bool getActiveAttrib(Platform3DObject program, GC3Duint index, ActiveInfo&);
 679     bool getActiveUniform(Platform3DObject program, GC3Duint index, ActiveInfo&);
 680     void getAttachedShaders(Platform3DObject program, GC3Dsizei maxCount, GC3Dsizei* count, Platform3DObject* shaders);
 681     GC3Dint getAttribLocation(Platform3DObject, const String& name);
 682     void getBooleanv(GC3Denum pname, GC3Dboolean* value);
 683     void getBufferParameteriv(GC3Denum target, GC3Denum pname, GC3Dint* value);
 684     Attributes getContextAttributes();
 685     GC3Denum getError();
 686     void getFloatv(GC3Denum pname, GC3Dfloat* value);
 687     void getFramebufferAttachmentParameteriv(GC3Denum target, GC3Denum attachment, GC3Denum pname, GC3Dint* value);
 688     void getIntegerv(GC3Denum pname, GC3Dint* value);
 689     void getProgramiv(Platform3DObject program, GC3Denum pname, GC3Dint* value);
 690     String getProgramInfoLog(Platform3DObject);
 691     void getRenderbufferParameteriv(GC3Denum target, GC3Denum pname, GC3Dint* value);
 692     void getShaderiv(Platform3DObject, GC3Denum pname, GC3Dint* value);
 693     String getShaderInfoLog(Platform3DObject);
 694     void getShaderPrecisionFormat(GC3Denum shaderType, GC3Denum precisionType, GC3Dint* range, GC3Dint* precision);
 695     String getShaderSource(Platform3DObject);
 696     String getString(GC3Denum name);
 697     void getTexParameterfv(GC3Denum target, GC3Denum pname, GC3Dfloat* value);
 698     void getTexParameteriv(GC3Denum target, GC3Denum pname, GC3Dint* value);
 699     void getUniformfv(Platform3DObject program, GC3Dint location, GC3Dfloat* value);
 700     void getUniformiv(Platform3DObject program, GC3Dint location, GC3Dint* value);
 701     GC3Dint getUniformLocation(Platform3DObject, const String& name);
 702     void getVertexAttribfv(GC3Duint index, GC3Denum pname, GC3Dfloat* value);
 703     void getVertexAttribiv(GC3Duint index, GC3Denum pname, GC3Dint* value);
 704     GC3Dsizeiptr getVertexAttribOffset(GC3Duint index, GC3Denum pname);
 705
 706     void hint(GC3Denum target, GC3Denum mode);
 707     GC3Dboolean isBuffer(Platform3DObject);
 708     GC3Dboolean isEnabled(GC3Denum cap);
 709     GC3Dboolean isFramebuffer(Platform3DObject);
 710     GC3Dboolean isProgram(Platform3DObject);
 711     GC3Dboolean isRenderbuffer(Platform3DObject);
 712     GC3Dboolean isShader(Platform3DObject);
 713     GC3Dboolean isTexture(Platform3DObject);
 714     void lineWidth(GC3Dfloat);
 715     void linkProgram(Platform3DObject);
 716     void pixelStorei(GC3Denum pname, GC3Dint param);
 717     void polygonOffset(GC3Dfloat factor, GC3Dfloat units);
 718
 719     void readPixels(GC3Dint x, GC3Dint y, GC3Dsizei width, GC3Dsizei height, GC3Denum format, GC3Denum type, void* data);
 720
 721     void releaseShaderCompiler();
 722
 723     void renderbufferStorage(GC3Denum target, GC3Denum internalformat, GC3Dsizei width, GC3Dsizei height);
 724     void sampleCoverage(GC3Dclampf value, GC3Dboolean invert);
 725     void scissor(GC3Dint x, GC3Dint y, GC3Dsizei width, GC3Dsizei height);
 726     void shaderSource(Platform3DObject, const String& string);
 727     void stencilFunc(GC3Denum func, GC3Dint ref, GC3Duint mask);
 728     void stencilFuncSeparate(GC3Denum face, GC3Denum func, GC3Dint ref, GC3Duint mask);
 729     void stencilMask(GC3Duint mask);
 730     void stencilMaskSeparate(GC3Denum face, GC3Duint mask);
 731     void stencilOp(GC3Denum fail, GC3Denum zfail, GC3Denum zpass);
 732     void stencilOpSeparate(GC3Denum face, GC3Denum fail, GC3Denum zfail, GC3Denum zpass);
 733
 734     bool texImage2D(GC3Denum target, GC3Dint level, GC3Denum internalformat, GC3Dsizei width, GC3Dsizei height, GC3Dint border, GC3Denum format, GC3Denum type, const void* pixels);
 735     void texParameterf(GC3Denum target, GC3Denum pname, GC3Dfloat param);
 736     void texParameteri(GC3Denum target, GC3Denum pname, GC3Dint param);
 737     void texSubImage2D(GC3Denum target, GC3Dint level, GC3Dint xoffset, GC3Dint yoffset, GC3Dsizei width, GC3Dsizei height, GC3Denum format, GC3Denum type, const void* pixels);
 738
 739     void uniform1f(GC3Dint location, GC3Dfloat x);
 740     void uniform1fv(GC3Dint location, GC3Dsizei, GC3Dfloat* v);
 741     void uniform1i(GC3Dint location, GC3Dint x);
 742     void uniform1iv(GC3Dint location, GC3Dsizei, GC3Dint* v);
 743     void uniform2f(GC3Dint location, GC3Dfloat x, GC3Dfloat y);
 744     void uniform2fv(GC3Dint location, GC3Dsizei, GC3Dfloat* v);
 745     void uniform2i(GC3Dint location, GC3Dint x, GC3Dint y);
 746     void uniform2iv(GC3Dint location, GC3Dsizei, GC3Dint* v);
 747     void uniform3f(GC3Dint location, GC3Dfloat x, GC3Dfloat y, GC3Dfloat z);
 748     void uniform3fv(GC3Dint location, GC3Dsizei, GC3Dfloat* v);
 749     void uniform3i(GC3Dint location, GC3Dint x, GC3Dint y, GC3Dint z);
 750     void uniform3iv(GC3Dint location, GC3Dsizei, GC3Dint* v);
 751     void uniform4f(GC3Dint location, GC3Dfloat x, GC3Dfloat y, GC3Dfloat z, GC3Dfloat w);
 752     void uniform4fv(GC3Dint location, GC3Dsizei, GC3Dfloat* v);
 753     void uniform4i(GC3Dint location, GC3Dint x, GC3Dint y, GC3Dint z, GC3Dint w);
 754     void uniform4iv(GC3Dint location, GC3Dsizei, GC3Dint* v);
 755     void uniformMatrix2fv(GC3Dint location, GC3Dsizei, GC3Dboolean transpose, GC3Dfloat* value);
 756     void uniformMatrix3fv(GC3Dint location, GC3Dsizei, GC3Dboolean transpose, GC3Dfloat* value);
 757     void uniformMatrix4fv(GC3Dint location, GC3Dsizei, GC3Dboolean transpose, GC3Dfloat* value);
 758
 759     void useProgram(Platform3DObject);
 760     void validateProgram(Platform3DObject);
 761
 762     void vertexAttrib1f(GC3Duint index, GC3Dfloat x);
 763     void vertexAttrib1fv(GC3Duint index, GC3Dfloat* values);
 764     void vertexAttrib2f(GC3Duint index, GC3Dfloat x, GC3Dfloat y);
 765     void vertexAttrib2fv(GC3Duint index, GC3Dfloat* values);
 766     void vertexAttrib3f(GC3Duint index, GC3Dfloat x, GC3Dfloat y, GC3Dfloat z);
 767     void vertexAttrib3fv(GC3Duint index, GC3Dfloat* values);
 768     void vertexAttrib4f(GC3Duint index, GC3Dfloat x, GC3Dfloat y, GC3Dfloat z, GC3Dfloat w);
 769     void vertexAttrib4fv(GC3Duint index, GC3Dfloat* values);
 770     void vertexAttribPointer(GC3Duint index, GC3Dint size, GC3Denum type, GC3Dboolean normalized,
 771                              GC3Dsizei stride, GC3Dintptr offset);
 772
 773     void viewport(GC3Dint x, GC3Dint y, GC3Dsizei width, GC3Dsizei height);
 774
 775     void reshape(int width, int height);
 776
 777 #if PLATFORM(GTK) || PLATFORM(EFL) || USE(CAIRO)
 778     void paintToCanvas(const unsigned char* imagePixels, int imageWidth, int imageHeight,
 779                        int canvasWidth, int canvasHeight, PlatformContextCairo* context);
 780 #elif PLATFORM(BLACKBERRY) || USE(CG)
 781     void paintToCanvas(const unsigned char* imagePixels, int imageWidth, int imageHeight,
 782                        int canvasWidth, int canvasHeight, GraphicsContext*);
 783 #endif
 784
 785     void markContextChanged();
 786     void markLayerComposited();
 787     bool layerComposited() const;
 788
 789     void paintRenderingResultsToCanvas(ImageBuffer*, DrawingBuffer*);
 790     PassRefPtr<ImageData> paintRenderingResultsToImageData(DrawingBuffer*);
 791     bool paintCompositedResultsToCanvas(ImageBuffer*);
 792
 793 #if PLATFORM(BLACKBERRY)
 794     bool paintsIntoCanvasBuffer() const;
 795 #endif
 796
 797     // Support for buffer creation and deletion
 798     Platform3DObject createBuffer();
 799     Platform3DObject createFramebuffer();
 800     Platform3DObject createProgram();
 801     Platform3DObject createRenderbuffer();
 802     Platform3DObject createShader(GC3Denum);
 803     Platform3DObject createTexture();
 804
 805     void deleteBuffer(Platform3DObject);
 806     void deleteFramebuffer(Platform3DObject);
 807     void deleteProgram(Platform3DObject);
 808     void deleteRenderbuffer(Platform3DObject);
 809     void deleteShader(Platform3DObject);
 810     void deleteTexture(Platform3DObject);
 811
 812     // Synthesizes an OpenGL error which will be returned from a
 813     // later call to getError. This is used to emulate OpenGL ES
 814     // 2.0 behavior on the desktop and to enforce additional error
 815     // checking mandated by WebGL.
 816     //
 817     // Per the behavior of glGetError, this stores at most one
 818     // instance of any given error, and returns them from calls to
 819     // getError in the order they were added.
 820     void synthesizeGLError(GC3Denum error);
 821
 822     // Support for extensions. Returns a non-null object, though not
 823     // all methods it contains may necessarily be supported on the
 824     // current hardware. Must call Extensions3D::supports() to
 825     // determine this.
 826     Extensions3D* getExtensions();
 827
 828     IntSize getInternalFramebufferSize() const;
 829
 830     static unsigned getClearBitsByAttachmentType(GC3Denum);
 831     static unsigned getClearBitsByFormat(GC3Denum);
 832
 833     enum ChannelBits {
 834         ChannelRed = 1,
 835         ChannelGreen = 2,
 836         ChannelBlue = 4,
 837         ChannelAlpha = 8,
 838         ChannelDepth = 16,
 839         ChannelStencil = 32,
 840         ChannelRGB = ChannelRed | ChannelGreen | ChannelBlue,
 841         ChannelRGBA = ChannelRGB | ChannelAlpha,
 842     };
 843
 844     static unsigned getChannelBitsByFormat(GC3Denum);
 845
 846     // Possible alpha operations that may need to occur during
 847     // pixel packing. FIXME: kAlphaDoUnmultiply is lossy and must
 848     // be removed.
 849     enum AlphaOp {
 850         AlphaDoNothing = 0,
 851         AlphaDoPremultiply = 1,
 852         AlphaDoUnmultiply = 2
 853     };
 854
 855     enum ImageHtmlDomSource {
 856         HtmlDomImage = 0,
 857         HtmlDomCanvas = 1,
 858         HtmlDomVideo = 2,
 859         HtmlDomNone = 3
 860     };
 861
 862     // Packs the contents of the given Image which is passed in |pixels| into the passed Vector
 863     // according to the given format and type, and obeying the flipY and AlphaOp flags.
 864     // Returns true upon success.
 865     static bool packImageData(Image*, const void* pixels, GC3Denum format, GC3Denum type, bool flipY, AlphaOp, DataFormat sourceFormat, unsigned width, unsigned height, unsigned sourceUnpackAlignment, Vector<uint8_t>& data);
 866
 867     class ImageExtractor {
 868     public:
 869         ImageExtractor(Image*, ImageHtmlDomSource, bool premultiplyAlpha, bool ignoreGammaAndColorProfile);
 870
 871         // Each platform must provide an implementation of this method to deallocate or release resources
 872         // associated with the image if needed.
 873         ~ImageExtractor();
 874
 875         bool extractSucceeded() { return m_extractSucceeded; }
 876         const void* imagePixelData() { return m_imagePixelData; }
 877         unsigned imageWidth() { return m_imageWidth; }
 878         unsigned imageHeight() { return m_imageHeight; }
 879         DataFormat imageSourceFormat() { return m_imageSourceFormat; }
 880         AlphaOp imageAlphaOp() { return m_alphaOp; }
 881         unsigned imageSourceUnpackAlignment() { return m_imageSourceUnpackAlignment; }
 882         ImageHtmlDomSource imageHtmlDomSource() { return m_imageHtmlDomSource; }
 883     private:
 884         // Each platform must provide an implementation of this method.
 885         // Extracts the image and keeps track of its status, such as width, height, Source Alignment, format and AlphaOp etc,
 886         // needs to lock the resources or relevant data if needed and returns true upon success
 887         bool extractImage(bool premultiplyAlpha, bool ignoreGammaAndColorProfile);
 888
 889 #if USE(CAIRO)
 890         ImageSource* m_decoder;
 891         RefPtr<cairo_surface_t> m_imageSurface;
 892 #elif USE(CG)
 893         CGImageRef m_cgImage;
 894         RetainPtr<CGImageRef> m_decodedImage;
 895         RetainPtr<CFDataRef> m_pixelData;
 896         std::unique_ptr<uint8_t[]> m_formalizedRGBA8Data;
 897 #elif PLATFORM(BLACKBERRY)
 898         Vector<unsigned> m_imageData;
 899 #endif
 900         Image* m_image;
 901         ImageHtmlDomSource m_imageHtmlDomSource;
 902         bool m_extractSucceeded;
 903         const void* m_imagePixelData;
 904         unsigned m_imageWidth;
 905         unsigned m_imageHeight;
 906         DataFormat m_imageSourceFormat;
 907         AlphaOp m_alphaOp;
 908         unsigned m_imageSourceUnpackAlignment;
 909     };
 910
 911 private:
 912     GraphicsContext3D(Attributes, HostWindow*, RenderStyle = RenderOffscreen);
 913
 914     // Helper for packImageData/extractImageData/extractTextureData which implement packing of pixel
 915     // data into the specified OpenGL destination format and type.
 916     // A sourceUnpackAlignment of zero indicates that the source
 917     // data is tightly packed. Non-zero values may take a slow path.
 918     // Destination data will have no gaps between rows.
 919     static bool packPixels(const uint8_t* sourceData, DataFormat sourceDataFormat, unsigned width, unsigned height, unsigned sourceUnpackAlignment, unsigned destinationFormat, unsigned destinationType, AlphaOp, void* destinationData, bool flipY);
 920
 921 #if PLATFORM(MAC) || PLATFORM(GTK) || PLATFORM(EFL) || PLATFORM(BLACKBERRY) || PLATFORM(WIN) || PLATFORM(NIX)
 922     // Take into account the user's requested context creation attributes,
 923     // in particular stencil and antialias, and determine which could or
 924     // could not be honored based on the capabilities of the OpenGL
 925     // implementation.
 926     void validateDepthStencil(const char* packedDepthStencilExtension);
 927     void validateAttributes();
 928
 929     // Read rendering results into a pixel array with the same format as the
 930     // backbuffer.
 931     void readRenderingResults(unsigned char* pixels, int pixelsSize);
 932     void readPixelsAndConvertToBGRAIfNecessary(int x, int y, int width, int height, unsigned char* pixels);
 933 #endif
 934
 935 #if PLATFORM(BLACKBERRY)
 936     void logFrameBufferStatus(int line);
 937     void readPixelsIMG(GC3Dint x, GC3Dint y, GC3Dsizei width, GC3Dsizei height, GC3Denum format, GC3Denum type, void* data);
 938 #endif
 939
 940     bool reshapeFBOs(const IntSize&);
 941     void resolveMultisamplingIfNecessary(const IntRect& = IntRect());
 942 #if (PLATFORM(EFL) || PLATFORM(NIX)) && USE(GRAPHICS_SURFACE)
 943     void createGraphicsSurfaces(const IntSize&);
 944 #endif
 945
 946     int m_currentWidth, m_currentHeight;
 947     bool isResourceSafe();
 948
 949 #if PLATFORM(MAC)
 950     CGLContextObj m_contextObj;
 951     RetainPtr<WebGLLayer> m_webGLLayer;
 952 #elif PLATFORM(WIN) && USE(CA)
 953     RefPtr<PlatformCALayer> m_webGLLayer;
 954 #elif PLATFORM(BLACKBERRY)
 955 #if USE(ACCELERATED_COMPOSITING)
 956     RefPtr<PlatformLayer> m_compositingLayer;
 957 #endif
 958     void* m_context;
 959 #endif
 960
 961 #if PLATFORM(MAC) || PLATFORM(GTK) || PLATFORM(EFL) || PLATFORM(BLACKBERRY) || PLATFORM(WIN) || PLATFORM(NIX)
 962     struct SymbolInfo {
 963         SymbolInfo()
 964             : type(0)
 965             , size(0)
 966         {
 967         }
 968
 969         SymbolInfo(GC3Denum type, int size, const String& mappedName)
 970             : type(type)
 971             , size(size)
 972             , mappedName(mappedName)
 973         {
 974         }
 975
 976         bool operator==(SymbolInfo& other) const
 977         {
 978             return type == other.type && size == other.size && mappedName == other.mappedName;
 979         }
 980
 981         GC3Denum type;
 982         int size;
 983         String mappedName;
 984     };
 985
 986     typedef HashMap<String, SymbolInfo> ShaderSymbolMap;
 987
 988     struct ShaderSourceEntry {
 989         GC3Denum type;
 990         String source;
 991         String translatedSource;
 992         String log;
 993         bool isValid;
 994         ShaderSymbolMap attributeMap;
 995         ShaderSymbolMap uniformMap;
 996         ShaderSourceEntry()
 997             : type(VERTEX_SHADER)
 998             , isValid(false)
 999         {
1000         }
1001
1002         ShaderSymbolMap& symbolMap(enum ANGLEShaderSymbolType symbolType)
1003         {
1004             ASSERT(symbolType == SHADER_SYMBOL_TYPE_ATTRIBUTE || symbolType == SHADER_SYMBOL_TYPE_UNIFORM);
1005             if (symbolType == SHADER_SYMBOL_TYPE_ATTRIBUTE)
1006                 return attributeMap;
1007             return uniformMap;
1008         }
1009     };
1010
1011     typedef HashMap<Platform3DObject, ShaderSourceEntry> ShaderSourceMap;
1012     ShaderSourceMap m_shaderSourceMap;
1013
1014     String mappedSymbolName(Platform3DObject program, ANGLEShaderSymbolType, const String& name);
1015     String originalSymbolName(Platform3DObject program, ANGLEShaderSymbolType, const String& name);
1016
1017     ANGLEWebKitBridge m_compiler;
1018
1019     OwnPtr<ShaderNameHash> nameHashMapForShaders;
1020 #endif
1021
1022 #if PLATFORM(BLACKBERRY) || ((PLATFORM(GTK) || PLATFORM(EFL) || PLATFORM(WIN) || PLATFORM(NIX)) && USE(OPENGL_ES_2))
1023     friend class Extensions3DOpenGLES;
1024     OwnPtr<Extensions3DOpenGLES> m_extensions;
1025 #else
1026     friend class Extensions3DOpenGL;
1027     OwnPtr<Extensions3DOpenGL> m_extensions;
1028 #endif
1029     friend class Extensions3DOpenGLCommon;
1030
1031     Attributes m_attrs;
1032     RenderStyle m_renderStyle;
1033     Vector<Vector<float>> m_vertexArray;
1034
1035     GC3Duint m_texture;
1036 #if !PLATFORM(BLACKBERRY)
1037     GC3Duint m_compositorTexture;
1038 #endif
1039     GC3Duint m_fbo;
1040
1041 #if !PLATFORM(BLACKBERRY)
1042     GC3Duint m_depthBuffer;
1043     GC3Duint m_stencilBuffer;
1044 #endif
1045     GC3Duint m_depthStencilBuffer;
1046
1047     bool m_layerComposited;
1048     GC3Duint m_internalColorFormat;
1049
1050     struct GraphicsContext3DState {
1051         GraphicsContext3DState()
1052             : boundFBO(0)
1053             , activeTexture(GraphicsContext3D::TEXTURE0)
1054             , boundTexture0(0)
1055         { }
1056
1057         GC3Duint boundFBO;
1058         GC3Denum activeTexture;
1059         GC3Duint boundTexture0;
1060     };
1061
1062     GraphicsContext3DState m_state;
1063
1064     // For multisampling
1065     GC3Duint m_multisampleFBO;
1066     GC3Duint m_multisampleDepthStencilBuffer;
1067     GC3Duint m_multisampleColorBuffer;
1068
1069     // Errors raised by synthesizeGLError().
1070     ListHashSet<GC3Denum> m_syntheticErrors;
1071
1072 #if PLATFORM(BLACKBERRY)
1073     bool m_isImaginationHardware;
1074 #endif
1075
1076 #if !PLATFORM(BLACKBERRY)
1077     friend class GraphicsContext3DPrivate;
1078     OwnPtr<GraphicsContext3DPrivate> m_private;
1079 #endif
1080 };
1081
1082 } // namespace WebCore
1083
1084 #endif // GraphicsContext3D_h