This file is indexed.

/usr/include/Wt/WHTML5Video is in libwt-dev 3.1.10-1ubuntu2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
// This may look like C code, but it's really -*- C++ -*-
/*
 * Copyright (C) 2010 Emweb bvba, Leuven, Belgium.
 *
 * See the LICENSE file for terms of use.
 */
#ifndef WHTML5VIDEO_H_
#define WHTML5VIDEO_H_

#include <Wt/WHTML5Media>

namespace Wt {

/*! \class WHTML5Video Wt/WHTML5Video Wt/WHTML5Video
 *  \brief A widget that renders video using the HTML5 video element.
 *
 * This class renders HTML5 video. In a typical usage scenario,
 * you instantiate the class, set options, add one or multiple
 * video sources. Since not every browser supports HTML5 video,
 * the class provides a mechanism to display alternative content
 * in browsers that cannot play the video.
 *
 * \if cpp
 * Usage example:
 * \code
 * WHTML5Video *v = new WHTML5Video(parent);
 * v->setOptions(WHTML5Video::Autoplay | WHTML5Video::Controls);
 * // Addsources may be called multiple times for different formats:
 * // Firefox only plays ogg
 * v->addSource("wt.ogv");
 * // many others play mp4
 * v->addSource("wt.mp4", "video/mp4");
 * // Image to be displayed before playback starts
 * v->setPoster("wt.jpg");
 * // You may display a simple text to explain that you need html5 support...
 * // v->setAlternativeContent(new WText("You have no HTML5 Video!"));
 * // ... or provide an alternative player, e.g. Flash-based
 * WFlashObject *f = new WFlashObject("player.swf", root());
 * f->setFlashVariable("startimage", "wt.jpg");
 * f->setFlashVariable("flv", "wt.mp4");
 * f->resize(640, 384);
 * v->setAlternativeContent(f);
 * \endcode
 * \endif
 *
 * There are two reasons why the a browser may use the alternative
 * content: either because the browser does not support the HTML5
 * video tag (alternative content is displayed even when JavaScript
 * is not available), or because none of the specified sources contain
 * a video format that is understood by the browser (requires
 * JavaScript to display the alternative content).
 *
 * addSource() and setAlternativeContent() must not be called after
 * the WHTML5Video was rendered. This can easily be avoided by calling
 * these functions right after construction.
 *
 * This is a technology-specific class. To let %Wt choose a technology
 * (and fallback technologies) to display your videos, use the WVideo class.
 */
class WT_API WHTML5Video : public WHTML5Media
{
public:
  /*! \brief Creates a HTML5 video widget.
   *
   * The constructor sets the 'controls' option, which causes the browser
   * to display a bar with play/pauze/volume/... controls.
   *
   * A freshly constructed HTML5Video widget has no poster image, no
   * media sources, has preload mode set to PreloadAuto, and only the
   * Controls flag is set.
   */
  WHTML5Video(WContainerWidget *parent = 0);
  
  /*! \brief Set the poster image
   *
   * On browsers that support it, the poster image is displayed before
   * the video is playing. Some browsers display the first frame of the
   * video stream once the video stream is loaded; it is therefore a
   * good idea to include the poster image as first frame in the video
   * feed too.
   */
  void setPoster(const std::string &url);
  
  /*! \brief Returns the JavaScript reference to the video object, or null.
   *
   * It is possible, for compatibility reasons, that jsRef() is not the
   * HTML5 video element. jsVideoRef() is guaranteed to be an expression
   * that evaluates to the video object. This expression may yield null, if
   * the video object is not rendered at all (e.g. on older versions of
   * Internet Explorer).
   */
  std::string jsVideoRef() const;

  virtual void resize(const WLength &width, const WLength &height);

protected:
  virtual DomElement *createMediaDomElement();
  DomElementType domElementType() const;
  void updateMediaDom(DomElement& element, bool all);

private:
  std::string posterUrl_;
  PreloadMode preloadMode_;
  bool sizeChanged_, posterChanged_;
};

}

#endif // WHTML5VIDEO_H_