348b860253d8fbeb967538928ed9cd9354d67f90
[WebKit-https.git] / WebCore / html / HTMLCanvasElement.h
1 /*
2  * Copyright (C) 2004, 2006 Apple Computer, Inc.  All rights reserved.
3  * Copyright (C) 2007 Alp Toker <alp@atoker.com>
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
25  */
26
27 #ifndef HTMLCanvasElement_h
28 #define HTMLCanvasElement_h
29
30 #include "HTMLElement.h"
31 #include "IntSize.h"
32
33 #if PLATFORM(CG)
34 // FIXME: CG-specific parts need to move to the platform directory.
35 typedef struct CGContext* CGContextRef;
36 typedef struct CGImage* CGImageRef;
37 #elif PLATFORM(QT)
38 class QPixmap;
39 class QPainter;
40 #elif PLATFORM(CAIRO)
41 typedef struct _cairo_surface cairo_surface_t;
42 #endif
43
44 namespace WebCore {
45
46 class CanvasRenderingContext2D;
47 typedef CanvasRenderingContext2D CanvasRenderingContext;
48 class FloatRect;
49 class GraphicsContext;
50 class ImageBuffer;
51
52 class HTMLCanvasElement : public HTMLElement {
53 public:
54     HTMLCanvasElement(Document*);
55     virtual ~HTMLCanvasElement();
56
57     virtual HTMLTagStatus endTagRequirement() const;
58     virtual int tagPriority() const;
59
60     int width() const { return m_size.width(); }
61     int height() const { return m_size.height(); }
62     void setWidth(int);
63     void setHeight(int);
64
65     CanvasRenderingContext* getContext(const String&);
66     // FIXME: Web Applications 1.0 describes a toDataURL function.
67
68     virtual void parseMappedAttribute(MappedAttribute*);
69     virtual RenderObject* createRenderer(RenderArena*, RenderStyle*);
70
71     IntSize size() const { return m_size; }
72     void willDraw(const FloatRect&);
73
74     void paint(GraphicsContext*, const IntRect&);
75
76     GraphicsContext* drawingContext() const;
77
78     ImageBuffer* buffer() const; 
79 #if PLATFORM(CG)
80     CGImageRef createPlatformImage() const;
81 #elif PLATFORM(QT)
82     QPixmap createPlatformImage() const;
83 #elif PLATFORM(CAIRO)
84     cairo_surface_t* createPlatformImage() const;
85 #endif
86
87 private:
88     void createDrawingContext() const;
89     void reset();
90
91     bool m_rendererIsCanvas;
92
93     RefPtr<CanvasRenderingContext2D> m_2DContext;
94     IntSize m_size;
95
96     // FIXME: Web Applications 1.0 describes a security feature where we track
97     // if we ever drew any images outside the domain, so we can disable toDataURL.
98
99     mutable bool m_createdDrawingContext;
100     mutable OwnPtr<ImageBuffer> m_data;
101     mutable GraphicsContext* m_drawingContext;
102 };
103
104 } //namespace
105
106 #endif