e8a9bc9540b04fae956b9d887778c94128f7caa7
[WebKit-https.git] / Source / WebCore / html / HTMLVideoElement.h
1 /*
2  * Copyright (C) 2007, 2008, 2009, 2010 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 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 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 HTMLVideoElement_h
27 #define HTMLVideoElement_h
28
29 #if ENABLE(VIDEO)
30
31 #include "HTMLMediaElement.h"
32 #include <memory>
33
34 namespace WebCore {
35
36 class HTMLImageLoader;
37
38 class HTMLVideoElement final : public HTMLMediaElement {
39 public:
40     static Ref<HTMLVideoElement> create(const QualifiedName&, Document&, bool);
41
42     WEBCORE_EXPORT unsigned videoWidth() const;
43     WEBCORE_EXPORT unsigned videoHeight() const;
44
45     // Fullscreen
46     void webkitEnterFullscreen(ExceptionCode&);
47     void webkitExitFullscreen();
48     bool webkitSupportsFullscreen();
49     bool webkitDisplayingFullscreen();
50
51     void ancestorWillEnterFullscreen() override;
52     
53     // FIXME: Maintain "FullScreen" capitalization scheme for backwards compatibility.
54     // https://bugs.webkit.org/show_bug.cgi?id=36081
55     void webkitEnterFullScreen(ExceptionCode& ec) { webkitEnterFullscreen(ec); }
56     void webkitExitFullScreen() { webkitExitFullscreen(); }
57
58 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
59     bool webkitWirelessVideoPlaybackDisabled() const;
60     void setWebkitWirelessVideoPlaybackDisabled(bool);
61 #endif
62
63 #if ENABLE(MEDIA_STATISTICS)
64     // Statistics
65     unsigned webkitDecodedFrameCount() const;
66     unsigned webkitDroppedFrameCount() const;
67 #endif
68
69     // Used by canvas to gain raw pixel access
70     void paintCurrentFrameInContext(GraphicsContext&, const FloatRect&);
71
72     NativeImagePtr nativeImageForCurrentTime();
73
74     // Used by WebGL to do GPU-GPU textures copy if possible.
75     // See more details at MediaPlayer::copyVideoTextureToPlatformTexture() defined in Source/WebCore/platform/graphics/MediaPlayer.h.
76     bool copyVideoTextureToPlatformTexture(GraphicsContext3D*, Platform3DObject texture, GC3Denum target, GC3Dint level, GC3Denum internalFormat, GC3Denum format, GC3Denum type, bool premultiplyAlpha, bool flipY);
77
78     bool shouldDisplayPosterImage() const { return displayMode() == Poster || displayMode() == PosterWaitingForVideo; }
79
80     URL posterImageURL() const;
81     RenderPtr<RenderElement> createElementRenderer(RenderStyle&&, const RenderTreePosition&) override;
82
83 #if ENABLE(VIDEO_PRESENTATION_MODE)
84     bool webkitSupportsPresentationMode(const String&) const;
85     void webkitSetPresentationMode(const String&);
86     String webkitPresentationMode() const;
87     void setFullscreenMode(VideoFullscreenMode);
88     void fullscreenModeChanged(VideoFullscreenMode) override;
89 #endif
90
91 #if PLATFORM(MAC) && ENABLE(VIDEO_PRESENTATION_MODE)
92     void exitToFullscreenModeWithoutAnimationIfPossible(HTMLMediaElementEnums::VideoFullscreenMode fromMode, HTMLMediaElementEnums::VideoFullscreenMode toMode);
93 #endif
94
95 private:
96     HTMLVideoElement(const QualifiedName&, Document&, bool);
97
98     void scheduleResizeEvent() override;
99     void scheduleResizeEventIfSizeChanged() override;
100     bool rendererIsNeeded(const RenderStyle&) override;
101     void didAttachRenderers() override;
102     void parseAttribute(const QualifiedName&, const AtomicString&) override;
103     bool isPresentationAttribute(const QualifiedName&) const override;
104     void collectStyleForPresentationAttribute(const QualifiedName&, const AtomicString&, MutableStyleProperties&) override;
105     bool isVideo() const override { return true; }
106     bool hasVideo() const override { return player() && player()->hasVideo(); }
107     bool supportsFullscreen(HTMLMediaElementEnums::VideoFullscreenMode) const override;
108     bool isURLAttribute(const Attribute&) const override;
109     const AtomicString& imageSourceURL() const override;
110
111     bool hasAvailableVideoFrame() const;
112     void updateDisplayState() override;
113     void didMoveToNewDocument(Document* oldDocument) override;
114     void setDisplayMode(DisplayMode) override;
115
116     PlatformMediaSession::MediaType presentationType() const override { return PlatformMediaSession::Video; }
117
118     std::unique_ptr<HTMLImageLoader> m_imageLoader;
119
120     AtomicString m_defaultPosterURL;
121
122     unsigned m_lastReportedVideoWidth { 0 };
123     unsigned m_lastReportedVideoHeight { 0 };
124 };
125
126 } // namespace WebCore
127
128 SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::HTMLVideoElement)
129     static bool isType(const WebCore::HTMLMediaElement& element) { return element.hasTagName(WebCore::HTMLNames::videoTag); }
130     static bool isType(const WebCore::Element& element) { return is<WebCore::HTMLMediaElement>(element) && isType(downcast<WebCore::HTMLMediaElement>(element)); }
131     static bool isType(const WebCore::Node& node) { return is<WebCore::HTMLMediaElement>(node) && isType(downcast<WebCore::HTMLMediaElement>(node)); }
132 SPECIALIZE_TYPE_TRAITS_END()
133
134 #endif // ENABLE(VIDEO)
135 #endif // HTMLVideoElement_h