Sophie: qt-mobility-doc-1.2.0-13.mga5 noarch

qt-mobility-doc-1.2.0-13.mga5.noarch.rpm

<?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" />
  <title>Qt Mobility 1.2: lightmodel.cpp Example File (sensors/cubehouse/lightmodel.cpp)</title>
  <link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="content"> 
    <a href="index.html" class="qtref"><span>QtMobility Reference Documentation</span></a>
  </div>
  <div class="breadcrumb toolblock">
    <ul>
      <li class="first"><a href="index.html">Home</a></li>
      <!--  Breadcrumbs go here -->
    </ul>
  </div>
</div>
<div class="content mainContent">
<h1 class="title">lightmodel.cpp Example File</h1>
<span class="small-subtitle">sensors/cubehouse/lightmodel.cpp</span>
<!-- $$$sensors/cubehouse/lightmodel.cpp-description -->
<div class="descr"> <a name="details"></a>
<pre class="cpp"> <span class="comment">/****************************************************************************
 **
 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
 ** This file is part of the examples of the Qt Mobility Components.
 **
 ** $QT_BEGIN_LICENSE:BSD$
 ** You may use this file under the terms of the BSD license as follows:
 **
 ** &quot;Redistribution and use in source and binary forms, with or without
 ** modification, are permitted provided that the following conditions are
 ** met:
 **   * Redistributions of source code must retain the above copyright
 **     notice, this list of conditions and the following disclaimer.
 **   * Redistributions in binary form must reproduce the above copyright
 **     notice, this list of conditions and the following disclaimer in
 **     the documentation and/or other materials provided with the
 **     distribution.
 **   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
 **     the names of its contributors may be used to endorse or promote
 **     products derived from this software without specific prior written
 **     permission.
 **
 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 ** &quot;AS IS&quot; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.&quot;
 ** $QT_END_LICENSE$
 **
 ****************************************************************************/</span>

 <span class="preprocessor">#include &quot;lightmodel.h&quot;</span>

 <span class="comment">/*!
     \class LightModel
     \brief The LightModel class defines the lighting model to use for the scene.
     \since 4.7
     \ingroup qt3d
     \ingroup qt3d::painting
 */</span>

 <span class="comment">/*!
     \enum LightModel::Model
     This enum defines the type of lighting model to use: one-sided or two-sided.

     \value OneSided One-sided lighting, with the front face material used for both front and back faces.
     \value TwoSided Two-sided lighting, with separate front and back face materials.
 */</span>

 <span class="comment">/*!
     \enum LightModel::ColorControl
     This enum controls the number of colors to be generated by the lighting computation.

     \value SingleColor A single color is generated by the lighting computation.
     \value SeparateSpecularColor A separate specular color computation is
            performed and then summed into the pixel color after texture mapping.
 */</span>

 <span class="comment">/*!
     \enum LightModel::ViewerPosition
     This enum defines the position of the viewer for the purposes of lighting calculations.

     \value ViewerAtInfinity The viewer is at infinity along the -z axis.
     \value LocalViewer The viewer is at the local origin in eye coordinates.
 */</span>

 <span class="keyword">class</span> LightModelPrivate
 {
 <span class="keyword">public</span>:
     LightModelPrivate()
         : model(LightModel<span class="operator">::</span>OneSided)<span class="operator">,</span>
           colorControl(LightModel<span class="operator">::</span>SingleColor)<span class="operator">,</span>
           viewerPosition(LightModel<span class="operator">::</span>ViewerAtInfinity)
     {
         ambientSceneColor<span class="operator">.</span>setRgbF(<span class="number">0.2</span><span class="operator">,</span> <span class="number">0.2</span><span class="operator">,</span> <span class="number">0.2</span><span class="operator">,</span> <span class="number">1.0</span>);
     }

     LightModel<span class="operator">::</span>Model model;
     LightModel<span class="operator">::</span>ColorControl colorControl;
     LightModel<span class="operator">::</span>ViewerPosition viewerPosition;
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qcolor.html">QColor</a></span> ambientSceneColor;
 };

 <span class="comment">/*!
     Constructs a light model object with default values and attach
     it to \a parent.
 */</span>
 LightModel<span class="operator">::</span>LightModel(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> <span class="operator">*</span>parent)
     : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span>(parent)<span class="operator">,</span> d_ptr(<span class="keyword">new</span> LightModelPrivate)
 {
 }

 <span class="comment">/*!
     Destroys this light model.
 */</span>
 LightModel<span class="operator">::</span><span class="operator">~</span>LightModel()
 {
 }

 <span class="comment">/*!
     \property LightModel::model
     \brief the lighting model to use, either OneSided or TwoSided.
     The default is OneSided.

     \sa modelChanged()
 */</span>
 LightModel<span class="operator">::</span>Model LightModel<span class="operator">::</span>model() <span class="keyword">const</span>
 {
     Q_D(<span class="keyword">const</span> LightModel);
     <span class="keyword">return</span> d<span class="operator">-</span><span class="operator">&gt;</span>model;
 }

 <span class="type">void</span> LightModel<span class="operator">::</span>setModel(LightModel<span class="operator">::</span>Model value)
 {
     Q_D(LightModel);
     <span class="keyword">if</span> (d<span class="operator">-</span><span class="operator">&gt;</span>model <span class="operator">!</span><span class="operator">=</span> value) {
         d<span class="operator">-</span><span class="operator">&gt;</span>model <span class="operator">=</span> value;
         <span class="keyword">emit</span> modelChanged();
         <span class="keyword">emit</span> lightModelChanged();
     }
 }

 <span class="comment">/*!
     \property LightModel::colorControl
     \brief the color control mode, either SingleColor or
     SeparateSpecularColor.  The default value is SingleColor.

     If SingleColor is specified, then a single color is calculated
     by the lighting computation for a vertex.  If SeparateSpecularColor
     is specified, then a separate specular color computation is
     performed and then summed into the pixel color after texture mapping.

     \sa colorControlChanged()
 */</span>
 LightModel<span class="operator">::</span>ColorControl LightModel<span class="operator">::</span>colorControl() <span class="keyword">const</span>
 {
     Q_D(<span class="keyword">const</span> LightModel);
     <span class="keyword">return</span> d<span class="operator">-</span><span class="operator">&gt;</span>colorControl;
 }

 <span class="type">void</span> LightModel<span class="operator">::</span>setColorControl(LightModel<span class="operator">::</span>ColorControl value)
 {
     Q_D(LightModel);
     <span class="keyword">if</span> (d<span class="operator">-</span><span class="operator">&gt;</span>colorControl <span class="operator">!</span><span class="operator">=</span> value) {
         d<span class="operator">-</span><span class="operator">&gt;</span>colorControl <span class="operator">=</span> value;
         <span class="keyword">emit</span> colorControlChanged();
         <span class="keyword">emit</span> lightModelChanged();
     }
 }

 <span class="comment">/*!
     \property LightModel::viewerPosition
     \brief the viewer position, either ViewerAtInfinity or LocalViewer.
     The default value is ViewerAtInfinity.

     \sa viewerPositionChanged()
 */</span>
 LightModel<span class="operator">::</span>ViewerPosition LightModel<span class="operator">::</span>viewerPosition() <span class="keyword">const</span>
 {
     Q_D(<span class="keyword">const</span> LightModel);
     <span class="keyword">return</span> d<span class="operator">-</span><span class="operator">&gt;</span>viewerPosition;
 }

 <span class="type">void</span> LightModel<span class="operator">::</span>setViewerPosition(LightModel<span class="operator">::</span>ViewerPosition value)
 {
     Q_D(LightModel);
     <span class="keyword">if</span> (d<span class="operator">-</span><span class="operator">&gt;</span>viewerPosition <span class="operator">!</span><span class="operator">=</span> value) {
         d<span class="operator">-</span><span class="operator">&gt;</span>viewerPosition <span class="operator">=</span> value;
         <span class="keyword">emit</span> viewerPositionChanged();
         <span class="keyword">emit</span> lightModelChanged();
     }
 }

 <span class="comment">/*!
     \property LightModel::ambientSceneColor
     \brief the ambient color of the entire scene.  The default value
     is (0.2, 0.2, 0.2, 1.0).

     \sa ambientSceneColorChanged()
 */</span>
 <span class="type"><a href="http://qt.nokia.com/doc/4.7/qcolor.html">QColor</a></span> LightModel<span class="operator">::</span>ambientSceneColor() <span class="keyword">const</span>
 {
     Q_D(<span class="keyword">const</span> LightModel);
     <span class="keyword">return</span> d<span class="operator">-</span><span class="operator">&gt;</span>ambientSceneColor;
 }

 <span class="type">void</span> LightModel<span class="operator">::</span>setAmbientSceneColor(<span class="keyword">const</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qcolor.html">QColor</a></span><span class="operator">&amp;</span> value)
 {
     Q_D(LightModel);
     <span class="keyword">if</span> (d<span class="operator">-</span><span class="operator">&gt;</span>ambientSceneColor <span class="operator">!</span><span class="operator">=</span> value) {
         d<span class="operator">-</span><span class="operator">&gt;</span>ambientSceneColor <span class="operator">=</span> value;
         <span class="keyword">emit</span> ambientSceneColorChanged();
         <span class="keyword">emit</span> lightModelChanged();
     }
 }

 <span class="comment">/*!
     \fn void LightModel::modelChanged()

     This signal is emitted when model() changes.

     \sa model(), lightModelChanged()
 */</span>

 <span class="comment">/*!
     \fn void LightModel::colorControlChanged()

     This signal is emitted when colorControl() changes.

     \sa colorControl(), lightModelChanged()
 */</span>

 <span class="comment">/*!
     \fn void LightModel::viewerPositionChanged()

     This signal is emitted when viewerPosition() changes.

     \sa viewerPosition(), lightModelChanged()
 */</span>

 <span class="comment">/*!
     \fn void LightModel::ambientSceneColorChanged()

     This signal is emitted when ambientSceneColor() changes.

     \sa ambientSceneColor(), lightModelChanged()
 */</span>

 <span class="comment">/*!
     \fn void LightModel::lightModelChanged()

     This signal is emitted when one of model(), colorControl(),
     viewerPosition(), or ambientSceneColor() changes.
 */</span></pre>
</div>
<!-- @@@sensors/cubehouse/lightmodel.cpp -->
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
  <p>
     <acronym title="Copyright">&copy;</acronym> 2008-2011 Nokia Corporation and/or its
     subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation 
     in Finland and/or other countries worldwide.</p>
  <p>
     All other trademarks are property of their respective owners. <a title="Privacy Policy"
     href="http://qt.nokia.com/about/privacy-policy">Privacy Policy</a></p>
  <br />
  <p>
    Licensees holding valid Qt Commercial licenses may use this document in accordance with the    Qt Commercial License Agreement provided with the Software or, alternatively, in accordance    with the terms contained in a written agreement between you and Nokia.</p>
  <p>
    Alternatively, this document may be used 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>
</div>
</body>
</html>