HTMLCanvasElement.h [plain text]
#pragma once
#include "FloatRect.h"
#include "HTMLElement.h"
#include "IntSize.h"
#include <memory>
#include <wtf/Forward.h>
namespace WebCore {
class CanvasContextAttributes;
class CanvasRenderingContext;
class GraphicsContext;
class GraphicsContextStateSaver;
class HTMLCanvasElement;
class Image;
class ImageBuffer;
class ImageData;
namespace DisplayList {
typedef unsigned AsTextFlags;
}
class CanvasObserver {
public:
virtual ~CanvasObserver() { }
virtual void canvasChanged(HTMLCanvasElement&, const FloatRect& changedRect) = 0;
virtual void canvasResized(HTMLCanvasElement&) = 0;
virtual void canvasDestroyed(HTMLCanvasElement&) = 0;
};
class HTMLCanvasElement final : public HTMLElement {
public:
static Ref<HTMLCanvasElement> create(Document&);
static Ref<HTMLCanvasElement> create(const QualifiedName&, Document&);
virtual ~HTMLCanvasElement();
void addObserver(CanvasObserver&);
void removeObserver(CanvasObserver&);
unsigned width() const { return size().width(); }
unsigned height() const { return size().height(); }
const IntSize& size() const { return m_size; }
void setWidth(unsigned);
void setHeight(unsigned);
void setSize(const IntSize& newSize)
{
if (newSize == size())
return;
m_ignoreReset = true;
setWidth(newSize.width());
setHeight(newSize.height());
m_ignoreReset = false;
reset();
}
CanvasRenderingContext* getContext(const String&, CanvasContextAttributes* = nullptr);
bool probablySupportsContext(const String&, CanvasContextAttributes* = nullptr);
static bool is2dType(const String&);
#if ENABLE(WEBGL)
static bool is3dType(const String&);
#endif
static String toEncodingMimeType(const String& mimeType);
String toDataURL(const String& mimeType, const double* quality, ExceptionCode&);
String toDataURL(const String& mimeType, ExceptionCode& ec) { return toDataURL(mimeType, nullptr, ec); }
void didDraw(const FloatRect&);
void notifyObserversCanvasChanged(const FloatRect&);
void paint(GraphicsContext&, const LayoutRect&);
GraphicsContext* drawingContext() const;
GraphicsContext* existingDrawingContext() const;
CanvasRenderingContext* renderingContext() const { return m_context.get(); }
ImageBuffer* buffer() const;
Image* copiedImage() const;
void clearCopiedImage();
RefPtr<ImageData> getImageData();
void makePresentationCopy();
void clearPresentationCopy();
FloatRect convertLogicalToDevice(const FloatRect&) const;
FloatSize convertLogicalToDevice(const FloatSize&) const;
FloatSize convertDeviceToLogical(const FloatSize&) const;
SecurityOrigin* securityOrigin() const;
void setOriginTainted() { m_originClean = false; }
bool originClean() const { return m_originClean; }
AffineTransform baseTransform() const;
void makeRenderingResultsAvailable();
bool hasCreatedImageBuffer() const { return m_hasCreatedImageBuffer; }
bool shouldAccelerate(const IntSize&) const;
WEBCORE_EXPORT void setUsesDisplayListDrawing(bool);
WEBCORE_EXPORT void setTracksDisplayListReplay(bool);
WEBCORE_EXPORT String displayListAsText(DisplayList::AsTextFlags) const;
WEBCORE_EXPORT String replayDisplayListAsText(DisplayList::AsTextFlags) const;
size_t memoryCost() const;
size_t externalMemoryCost() const;
private:
HTMLCanvasElement(const QualifiedName&, Document&);
void parseAttribute(const QualifiedName&, const AtomicString&) final;
RenderPtr<RenderElement> createElementRenderer(RenderStyle&&, const RenderTreePosition&) final;
bool canContainRangeEndPoint() const final;
bool canStartSelection() const final;
void reset();
void createImageBuffer() const;
void clearImageBuffer() const;
void setSurfaceSize(const IntSize&);
void setImageBuffer(std::unique_ptr<ImageBuffer>) const;
void releaseImageBufferAndContext();
bool paintsIntoCanvasBuffer() const;
#if ENABLE(WEBGL)
bool is3D() const;
#endif
HashSet<CanvasObserver*> m_observers;
std::unique_ptr<CanvasRenderingContext> m_context;
FloatRect m_dirtyRect;
IntSize m_size;
bool m_originClean { true };
bool m_ignoreReset { false };
bool m_usesDisplayListDrawing { false };
bool m_tracksDisplayListReplay { false };
mutable bool m_hasCreatedImageBuffer { false };
mutable bool m_didClearImageBuffer { false };
mutable std::unique_ptr<ImageBuffer> m_imageBuffer;
mutable std::unique_ptr<GraphicsContextStateSaver> m_contextStateSaver;
mutable RefPtr<Image> m_presentedImage;
mutable RefPtr<Image> m_copiedImage; };
}