<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- phonon-api.qdoc -->
<title>Qt 4.8: VideoWidget Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="phonon.html">Phonon</a></li>
<li>VideoWidget</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#public-slots">Public Slots</a></li>
<li class="level1"><a href="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">VideoWidget Class Reference</h1>
<span class="small-subtitle">(Phonon::VideoWidget)<br/></span>
<!-- $$$VideoWidget-brief -->
<p>The VideoWidget class provides a widget that is used to display video. <a href="#details">More...</a></p>
<!-- @@@VideoWidget -->
<pre class="cpp"> <span class="preprocessor">#include <Phonon/VideoWidget></span></pre><p><b>Inherits: </b><a href="qwidget.html">QWidget</a> and <a href="phonon-medianode.html">MediaNode</a>.</p>
<p>This class was introduced in Qt 4.4.</p>
<ul>
<li><a href="phonon-videowidget-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#AspectRatio-enum">AspectRatio</a></b> { AspectRatioAuto, AspectRatioWidget, AspectRatio4_3, AspectRatio16_9 }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#ScaleMode-enum">ScaleMode</a></b> { FitInView, ScaleAndCrop }</td></tr>
</table>
<a name="properties"></a>
<h2>Properties</h2>
<table class="propsummary">
<tr><td class="topAlign"><ul>
<li class="fn"><b><a href="phonon-videowidget.html#aspectRatio-prop">aspectRatio</a></b> : AspectRatio</li>
<li class="fn"><b><a href="phonon-videowidget.html#brightness-prop">brightness</a></b> : qreal</li>
<li class="fn"><b><a href="phonon-videowidget.html#contrast-prop">contrast</a></b> : qreal</li>
<li class="fn"><b><a href="phonon-videowidget.html#fullScreen-prop">fullScreen</a></b> : bool</li>
</ul></td><td class="topAlign"><ul>
<li class="fn"><b><a href="phonon-videowidget.html#hue-prop">hue</a></b> : qreal</li>
<li class="fn"><b><a href="phonon-videowidget.html#saturation-prop">saturation</a></b> : qreal</li>
<li class="fn"><b><a href="phonon-videowidget.html#scaleMode-prop">scaleMode</a></b> : ScaleMode</li>
</ul>
</td></tr>
</table>
<ul>
<li class="fn">58 properties inherited from <a href="qwidget.html#properties">QWidget</a></li>
<li class="fn">1 property inherited from <a href="qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#VideoWidget">VideoWidget</a></b> ( QWidget * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> AspectRatio </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#aspectRatio-prop">aspectRatio</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#brightness-prop">brightness</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#contrast-prop">contrast</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#hue-prop">hue</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#saturation-prop">saturation</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> ScaleMode </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#scaleMode-prop">scaleMode</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QImage </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#snapshot">snapshot</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">221 public functions inherited from <a href="qwidget.html#public-functions">QWidget</a></li>
<li class="fn">3 public functions inherited from <a href="phonon-medianode.html#public-functions">Phonon::MediaNode</a></li>
<li class="fn">29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
<li class="fn">13 public functions inherited from <a href="qpaintdevice.html#public-functions">QPaintDevice</a></li>
</ul>
<a name="public-slots"></a>
<h2>Public Slots</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#enterFullScreen">enterFullScreen</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#exitFullScreen">exitFullScreen</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#aspectRatio-prop">setAspectRatio</a></b> ( AspectRatio )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#brightness-prop">setBrightness</a></b> ( qreal <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#contrast-prop">setContrast</a></b> ( qreal <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#fullScreen-prop">setFullScreen</a></b> ( bool <i>fullscreen</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#hue-prop">setHue</a></b> ( qreal <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#saturation-prop">setSaturation</a></b> ( qreal <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#scaleMode-prop">setScaleMode</a></b> ( ScaleMode )</td></tr>
</table>
<ul>
<li class="fn">19 public slots inherited from <a href="qwidget.html#public-slots">QWidget</a></li>
<li class="fn">1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
</ul>
<a name="reimplemented-protected-functions"></a>
<h2>Reimplemented Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#event">event</a></b> ( QEvent * )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="phonon-videowidget.html#mouseMoveEvent">mouseMoveEvent</a></b> ( QMouseEvent * )</td></tr>
</table>
<ul>
<li class="fn">37 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 signal inherited from <a href="qwidget.html#signals">QWidget</a></li>
<li class="fn">1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
<li class="fn">4 static public members inherited from <a href="qwidget.html#static-public-members">QWidget</a></li>
<li class="fn">7 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
<li class="fn">37 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
<li class="fn">1 protected slot inherited from <a href="qwidget.html#protected-slots">QWidget</a></li>
</ul>
<a name="details"></a>
<!-- $$$VideoWidget-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The VideoWidget class provides a widget that is used to display video.</p>
<p>The VideoWidget class renders the video of a media stream on a <a href="qwidget.html">QWidget</a>. It is connected to the <a href="phonon-mediaobject.html">MediaObject</a>, of which video stream it should render. You connect the two objects using the <a href="phonon-path.html#createPath">Phonon::createPath</a>() function.</p>
<p>The widget has some possibilities to manipulate the video stream. You can change the <a href="phonon-videowidget.html#brightness-prop">brightness</a>(), <a href="phonon-videowidget.html#hue-prop">hue</a>(), <a href="phonon-videowidget.html#saturation-prop">saturation</a>(), and <a href="phonon-videowidget.html#contrast-prop">contrast</a>().</p>
<p>Resizing of the video is handled automatically, but you can affect the way the video is resized with the <a href="phonon-videowidget.html#aspectRatio-prop">aspectRatio</a> and <a href="phonon-videowidget.html#scaleMode-prop">scaleMode</a> properties. By default, the widget will use the aspect ratio of the video stream itself.</p>
<p>The video widget takes the size of the video when it receives a new video stream (i.e., when a new <a href="phonon-mediasource.html">MediaSource</a> is set on the <a href="phonon-mediaobject.html">MediaObject</a> to which it is connected). If you need to know the size of the video, you can call <a href="qwidget.html#sizeHint-prop">sizeHint()</a> after the video has been loaded (i.e., after the <a href="phonon-mediaobject.html">MediaObject</a> leaves the <a href="phonon.html#State-enum">LoadingState</a>).</p>
<p>It is also possible to go to <a href="phonon-videowidget.html#fullScreen-prop">full screen</a> mode.</p>
<p>A typical example of usage follows below:</p>
<pre class="cpp"> MediaObject <span class="operator">*</span>media <span class="operator">=</span> <span class="keyword">new</span> MediaObject(parent);
VideoWidget <span class="operator">*</span>vwidget <span class="operator">=</span> <span class="keyword">new</span> VideoWidget(parent);
Phonon<span class="operator">::</span>createPath(media<span class="operator">,</span> vwidget);</pre>
</div>
<p><b>See also </b><a href="phonon-module.html">Phonon Module</a>.</p>
<!-- @@@VideoWidget -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$AspectRatio$$$AspectRatioAuto$$$AspectRatioWidget$$$AspectRatio4_3$$$AspectRatio16_9 -->
<h3 class="fn"><a name="AspectRatio-enum"></a>enum VideoWidget::<span class="name">AspectRatio</span></h3>
<p>Defines the width:height to be used for the video.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>Phonon::VideoWidget::AspectRatioAuto</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">Let the decoder find the aspect ratio automatically from the media file (this is the default).</td></tr>
<tr><td class="topAlign"><tt>Phonon::VideoWidget::AspectRatioWidget</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Fits the video into the widget making the aspect ratio depend solely on the size of the widget. This way the aspect ratio is freely resizeable by the user.</td></tr>
<tr><td class="topAlign"><tt>Phonon::VideoWidget::AspectRatio4_3</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Make width/height == 4/3, which is the old TV size and monitor size (1024/768 == 4/3). (4:3)</td></tr>
<tr><td class="topAlign"><tt>Phonon::VideoWidget::AspectRatio16_9</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">Make width/height == 16/9, which is the size of most current media. (16:9)</td></tr>
</table>
<!-- @@@AspectRatio -->
<!-- $$$ScaleMode$$$FitInView$$$ScaleAndCrop -->
<h3 class="fn"><a name="ScaleMode-enum"></a>enum VideoWidget::<span class="name">ScaleMode</span></h3>
<p>The ScaleMode enum describes how to treat aspect ratio during resizing of video.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>Phonon::VideoWidget::FitInView</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The video will be fitted to fill the view keeping aspect ratio.</td></tr>
<tr><td class="topAlign"><tt>Phonon::VideoWidget::ScaleAndCrop</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The video is scaled</td></tr>
</table>
<!-- @@@ScaleMode -->
</div>
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$aspectRatio-prop$$$aspectRatio$$$setAspectRatioAspectRatio -->
<h3 class="fn"><a name="aspectRatio-prop"></a><span class="name">aspectRatio</span> : <span class="type"><a href="phonon-videowidget.html#AspectRatio-enum">AspectRatio</a></span></h3>
<p>Defaults to <a href="phonon-videowidget.html#AspectRatio-enum">AspectRatioAuto</a>.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> AspectRatio </td><td class="memItemRight bottomAlign"><span class="name"><b>aspectRatio</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setAspectRatio</b></span> ( AspectRatio )</td></tr>
</table>
<p><b>See also </b><a href="phonon-videowidget.html#AspectRatio-enum">AspectRatio</a>.</p>
<!-- @@@aspectRatio -->
<!-- $$$brightness-prop$$$brightness$$$setBrightnessqreal -->
<h3 class="fn"><a name="brightness-prop"></a><span class="name">brightness</span> : <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span></h3>
<p>This property holds brightness of the video.</p>
<p>Default is 0. Acceptable values are in range of -1, 1.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> qreal </td><td class="memItemRight bottomAlign"><span class="name"><b>brightness</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setBrightness</b></span> ( qreal <i>value</i> )</td></tr>
</table>
<!-- @@@brightness -->
<!-- $$$contrast-prop$$$contrast$$$setContrastqreal -->
<h3 class="fn"><a name="contrast-prop"></a><span class="name">contrast</span> : <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span></h3>
<p>This property holds the contrast of the video.</p>
<p>Default is 0. Acceptable values are in range of -1, 1.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> qreal </td><td class="memItemRight bottomAlign"><span class="name"><b>contrast</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setContrast</b></span> ( qreal <i>value</i> )</td></tr>
</table>
<!-- @@@contrast -->
<!-- $$$fullScreen-prop$$$isFullScreen$$$setFullScreenbool -->
<h3 class="fn"><a name="fullScreen-prop"></a><span class="name">fullScreen</span> : <span class="type">bool</span></h3>
<p>This property holds whether the video is shown using the complete screen.</p>
<p>The property differs from <a href="qwidget.html#fullScreen-prop">QWidget::fullScreen</a> in that it is writeable.</p>
<p>By default the widget is not shown in fullScreen.</p>
<p><b>Warning:</b> When switching to full screen mode using setFullScreen(), the widget onto which the video is rendered is shown as a top-level window. Key event forwarding is handled by <a href="phonon-videowidget.html">VideoWidget</a>, but if you need to handle other events, e.g., mouse events, you should handle fullscreen mode yourself.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#fullScreen-prop">isFullScreen</a></b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setFullScreen</b></span> ( bool <i>fullscreen</i> )</td></tr>
</table>
<!-- @@@fullScreen -->
<!-- $$$hue-prop$$$hue$$$setHueqreal -->
<h3 class="fn"><a name="hue-prop"></a><span class="name">hue</span> : <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span></h3>
<p>This property holds the hue of the video.</p>
<p>Default is 0. Acceptable values are in range of -1, 1.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> qreal </td><td class="memItemRight bottomAlign"><span class="name"><b>hue</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setHue</b></span> ( qreal <i>value</i> )</td></tr>
</table>
<!-- @@@hue -->
<!-- $$$saturation-prop$$$saturation$$$setSaturationqreal -->
<h3 class="fn"><a name="saturation-prop"></a><span class="name">saturation</span> : <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span></h3>
<p>This property holds saturation of the video.</p>
<p>Default is 0. Acceptable values are in range of -1, 1.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> qreal </td><td class="memItemRight bottomAlign"><span class="name"><b>saturation</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setSaturation</b></span> ( qreal <i>value</i> )</td></tr>
</table>
<!-- @@@saturation -->
<!-- $$$scaleMode-prop$$$scaleMode$$$setScaleModeScaleMode -->
<h3 class="fn"><a name="scaleMode-prop"></a><span class="name">scaleMode</span> : <span class="type"><a href="phonon-videowidget.html#ScaleMode-enum">ScaleMode</a></span></h3>
<p>If the size of the widget and the size of the video are not equal. The video will be zoomed to fit the widget. The smaller zoom (AddBarsScaleMode) adds black bars at the left/right or top/bottom to make all of the image visible (default). The bigger zoom (ExpandMode) fills the widget completely, keeping all information in one direction and leaving parts of the image outside of the widget in the other direction.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> ScaleMode </td><td class="memItemRight bottomAlign"><span class="name"><b>scaleMode</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setScaleMode</b></span> ( ScaleMode )</td></tr>
</table>
<!-- @@@scaleMode -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$VideoWidget[overload1]$$$VideoWidgetQWidget* -->
<h3 class="fn"><a name="VideoWidget"></a>VideoWidget::<span class="name">VideoWidget</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>parent</i> = 0 )</h3>
<p>Constructs a new video widget with the specified <i>parent</i>.</p>
<!-- @@@VideoWidget -->
<!-- $$$enterFullScreen[overload1]$$$enterFullScreen -->
<h3 class="fn"><a name="enterFullScreen"></a><span class="type">void</span> VideoWidget::<span class="name">enterFullScreen</span> ()<tt> [slot]</tt></h3>
<p>Convenience slot, calling setFullScreen(true)</p>
<!-- @@@enterFullScreen -->
<!-- $$$event[overload1]$$$eventQEvent* -->
<h3 class="fn"><a name="event"></a><span class="type">bool</span> VideoWidget::<span class="name">event</span> ( <span class="type"><a href="qevent.html">QEvent</a></span> * )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qobject.html#event">QObject::event</a>().</p>
<!-- @@@event -->
<!-- $$$exitFullScreen[overload1]$$$exitFullScreen -->
<h3 class="fn"><a name="exitFullScreen"></a><span class="type">void</span> VideoWidget::<span class="name">exitFullScreen</span> ()<tt> [slot]</tt></h3>
<p>Convenience slot, calling setFullScreen(false)</p>
<!-- @@@exitFullScreen -->
<!-- $$$mouseMoveEvent[overload1]$$$mouseMoveEventQMouseEvent* -->
<h3 class="fn"><a name="mouseMoveEvent"></a><span class="type">void</span> VideoWidget::<span class="name">mouseMoveEvent</span> ( <span class="type"><a href="qmouseevent.html">QMouseEvent</a></span> * )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#mouseMoveEvent">QWidget::mouseMoveEvent</a>().</p>
<!-- @@@mouseMoveEvent -->
<!-- $$$snapshot[overload1]$$$snapshot -->
<h3 class="fn"><a name="snapshot"></a><span class="type"><a href="qimage.html">QImage</a></span> VideoWidget::<span class="name">snapshot</span> () const</h3>
<p>Returns a snapshot of the current frame shown in the widget.</p>
<p>This function was introduced in Qt 4.7.</p>
<!-- @@@snapshot -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
