2876be3fa27262dc4a9286829a098778d958db5f
[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 FloatPoint;
49 class FloatRect;
50 class FloatSize;
51 class GraphicsContext;
52 class ImageBuffer;
53 class IntPoint;
54 class InttRect;
55 class IntSize;
56
57 class HTMLCanvasElement : public HTMLElement {
58 public:
59     HTMLCanvasElement(Document*);
60     virtual ~HTMLCanvasElement();
61
62     virtual HTMLTagStatus endTagRequirement() const;
63     virtual int tagPriority() const;
64
65     int width() const { return m_size.width(); }
66     int height() const { return m_size.height(); }
67     void setWidth(int);
68     void setHeight(int);
69
70     CanvasRenderingContext* getContext(const String&);
71     // FIXME: Web Applications 1.0 describes a toDataURL function.
72
73     virtual void parseMappedAttribute(MappedAttribute*);
74     virtual RenderObject* createRenderer(RenderArena*, RenderStyle*);
75
76     IntSize size() const { return m_size; }
77     void willDraw(const FloatRect&);
78
79     void paint(GraphicsContext*, const IntRect&);
80
81     GraphicsContext* drawingContext() const;
82
83     ImageBuffer* buffer() const; 
84 #if PLATFORM(CG)
85     CGImageRef createPlatformImage() const;
86 #elif PLATFORM(QT)
87     QPixmap createPlatformImage() const;
88 #elif PLATFORM(CAIRO)
89     cairo_surface_t* createPlatformImage() const;
90 #endif
91     
92     IntRect convertLogicalToDevice(const FloatRect&) const;
93     IntSize convertLogicalToDevice(const FloatSize&) const;
94     IntPoint convertLogicalToDevice(const FloatPoint&) const;
95     static const float MaxCanvasArea;
96 private:
97     void createImageBuffer() const;
98     void reset();
99
100     bool m_rendererIsCanvas;
101
102     RefPtr<CanvasRenderingContext2D> m_2DContext;
103     IntSize m_size;
104
105     // FIXME: Web Applications 1.0 describes a security feature where we track
106     // if we ever drew any images outside the domain, so we can disable toDataURL.
107
108     // m_createdImageBuffer means we tried to malloc the buffer.  We didn't necessarily get it.
109     mutable bool m_createdImageBuffer;
110     mutable OwnPtr<ImageBuffer> m_imageBuffer;
111 };
112
113 } //namespace
114
115 #endif