<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- q3dscene.cpp -->
<title>Q3DScene Class | Qt Data Visualization 5.12.6</title>
<link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
<script type="text/javascript">
document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
// loading style sheet breaks anchors that were jumped to before
// so force jumping to anchor again
setTimeout(function() {
var anchor = location.hash;
// need to jump to different anchor first (e.g. none)
location.hash = "#";
setTimeout(function() {
location.hash = anchor;
}, 0);
}, 0);
</script>
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<table><tr>
<td >Qt 5.12</td><td ><a href="qtdatavisualization-index.html">Qt Data Visualization</a></td><td ><a href="qtdatavisualization-module.html">C++ Classes</a></td><td >Q3DScene</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right"><a href="qtdatavisualization-index.html">Qt Data Visualization | Commercial or GPLv3</a></td>
</tr></table>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<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="#signals">Signals</a></li>
<li class="level1"><a href="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Q3DScene Class</h1>
<!-- $$$Q3DScene-brief -->
<p><a href="q3dscene.html">Q3DScene</a> class provides description of the 3D scene being visualized. <a href="#details">More...</a></p>
<!-- @@@Q3DScene -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> <span class="preprocessor">#include <Q3DScene></span>
</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Since:</td><td class="memItemRight bottomAlign"> QtDataVisualization 1.0</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Instantiated By:</td><td class="memItemRight bottomAlign"> <a href="qml-qtdatavisualization-scene3d.html">Scene3D</a></td></tr></table></div><ul>
<li><a href="q3dscene-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2 id="properties">Properties</h2>
<div class="table"><table class="propsummary">
<tr><td class="topAlign"><ul>
<li class="fn"><b><a href="q3dscene.html#activeCamera-prop">activeCamera</a></b> : Q3DCamera*</li>
<li class="fn"><b><a href="q3dscene.html#activeLight-prop">activeLight</a></b> : Q3DLight*</li>
<li class="fn"><b><a href="q3dscene.html#devicePixelRatio-prop">devicePixelRatio</a></b> : float</li>
<li class="fn"><b><a href="q3dscene.html#graphPositionQuery-prop">graphPositionQuery</a></b> : QPoint</li>
<li class="fn"><b><a href="q3dscene.html#primarySubViewport-prop">primarySubViewport</a></b> : QRect</li>
</ul></td><td class="topAlign"><ul>
<li class="fn"><b><a href="q3dscene.html#secondarySubViewport-prop">secondarySubViewport</a></b> : QRect</li>
<li class="fn"><b><a href="q3dscene.html#secondarySubviewOnTop-prop">secondarySubviewOnTop</a></b> : bool</li>
<li class="fn"><b><a href="q3dscene.html#selectionQueryPosition-prop">selectionQueryPosition</a></b> : QPoint</li>
<li class="fn"><b><a href="q3dscene.html#slicingActive-prop">slicingActive</a></b> : bool</li>
<li class="fn"><b><a href="q3dscene.html#viewport-prop">viewport</a></b> : const QRect</li>
</ul>
</td></tr>
</table></div>
<a name="public-functions"></a>
<h2 id="public-functions">Public Functions</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#Q3DScene">Q3DScene</a></b>(QObject *<i>parent</i> = nullptr)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#dtor.Q3DScene">~Q3DScene</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Q3DCamera *</td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#activeCamera-prop">activeCamera</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Q3DLight *</td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#activeLight-prop">activeLight</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> float </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#devicePixelRatio-prop">devicePixelRatio</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#graphPositionQuery-prop">graphPositionQuery</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#isPointInPrimarySubView">isPointInPrimarySubView</a></b>(const QPoint &<i>point</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#isPointInSecondarySubView">isPointInSecondarySubView</a></b>(const QPoint &<i>point</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#secondarySubviewOnTop-prop">isSecondarySubviewOnTop</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#slicingActive-prop">isSlicingActive</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#primarySubViewport-prop">primarySubViewport</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#secondarySubViewport-prop">secondarySubViewport</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#selectionQueryPosition-prop">selectionQueryPosition</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#activeCamera-prop">setActiveCamera</a></b>(Q3DCamera *<i>camera</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#activeLight-prop">setActiveLight</a></b>(Q3DLight *<i>light</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#devicePixelRatio-prop">setDevicePixelRatio</a></b>(float <i>pixelRatio</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#graphPositionQuery-prop">setGraphPositionQuery</a></b>(const QPoint &<i>point</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#primarySubViewport-prop">setPrimarySubViewport</a></b>(const QRect &<i>primarySubViewport</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#secondarySubViewport-prop">setSecondarySubViewport</a></b>(const QRect &<i>secondarySubViewport</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#secondarySubviewOnTop-prop">setSecondarySubviewOnTop</a></b>(bool <i>isSecondaryOnTop</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#selectionQueryPosition-prop">setSelectionQueryPosition</a></b>(const QPoint &<i>point</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#slicingActive-prop">setSlicingActive</a></b>(bool <i>isSlicing</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#viewport-prop">viewport</a></b>() const</td></tr>
</table></div>
<a name="signals"></a>
<h2 id="signals">Signals</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#activeCamera-prop">activeCameraChanged</a></b>(Q3DCamera *<i>camera</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#activeLight-prop">activeLightChanged</a></b>(Q3DLight *<i>light</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#devicePixelRatio-prop">devicePixelRatioChanged</a></b>(float <i>pixelRatio</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#graphPositionQuery-prop">graphPositionQueryChanged</a></b>(const QPoint &<i>position</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#primarySubViewport-prop">primarySubViewportChanged</a></b>(const QRect &<i>subViewport</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#secondarySubViewport-prop">secondarySubViewportChanged</a></b>(const QRect &<i>subViewport</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#secondarySubviewOnTop-prop">secondarySubviewOnTopChanged</a></b>(bool <i>isSecondaryOnTop</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#selectionQueryPosition-prop">selectionQueryPositionChanged</a></b>(const QPoint &<i>position</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#slicingActive-prop">slicingActiveChanged</a></b>(bool <i>isSlicingActive</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#viewport-prop">viewportChanged</a></b>(const QRect &<i>viewport</i>)</td></tr>
</table></div>
<a name="static-public-members"></a>
<h2 id="static-public-members">Static Public Members</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#invalidSelectionPoint">invalidSelectionPoint</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QMetaObject </td><td class="memItemRight bottomAlign"><b><a href="q3dscene.html#staticMetaObject-var">staticMetaObject</a></b></td></tr>
</table></div>
<a name="details"></a>
<!-- $$$Q3DScene-description -->
<div class="descr">
<h2 id="details">Detailed Description</h2>
<p><a href="q3dscene.html">Q3DScene</a> class provides description of the 3D scene being visualized.</p>
<p>The 3D scene contains a single active camera and a single active light source. Visualized data is assumed to be at a fixed location.</p>
<p>The 3D scene also keeps track of the viewport in which visualization rendering is done, the primary subviewport inside the viewport where the main 3D data visualization view resides and the secondary subviewport where the 2D sliced view of the data resides. The subviewports are by default resized by the <i>Q3DScene</i>. To override the resize behavior you need to listen to both <a href="q3dscene.html#viewport-prop">viewportChanged</a>() and <a href="q3dscene.html#slicingActive-prop">slicingActiveChanged</a>() signals and recalculate the subviewports accordingly.</p>
<p>Also the scene has flag for tracking if the secondary 2D slicing view is currently active or not.</p>
<p><b>Note: </b>Not all visualizations support the secondary 2D slicing view.</p></div>
<!-- @@@Q3DScene -->
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$activeCamera-prop$$$activeCamera$$$setActiveCameraQ3DCamera*$$$activeCameraChangedQ3DCamera* -->
<h3 class="fn" id="activeCamera-prop"><a name="activeCamera-prop"></a><span class="name">activeCamera</span> : <span class="type"><a href="q3dcamera.html">Q3DCamera</a></span>*</h3>
<p>This property holds the currently active camera in the 3D scene.</p>
<p>When a new <a href="q3dcamera.html">Q3DCamera</a> object is set, it is automatically added as child of the scene.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> Q3DCamera *</td><td class="memItemRight bottomAlign"><span class="name"><b>activeCamera</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setActiveCamera</b></span>(Q3DCamera *<i>camera</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>activeCameraChanged</b></span>(Q3DCamera *<i>camera</i>)</td></tr>
</table></div>
<!-- @@@activeCamera -->
<!-- $$$activeLight-prop$$$activeLight$$$setActiveLightQ3DLight*$$$activeLightChangedQ3DLight* -->
<h3 class="fn" id="activeLight-prop"><a name="activeLight-prop"></a><span class="name">activeLight</span> : <span class="type"><a href="q3dlight.html">Q3DLight</a></span>*</h3>
<p>This property holds the currently active light in the 3D scene.</p>
<p>When a new <a href="q3dlight.html">Q3DLight</a> objects is set, it is automatically added as child of the scene.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> Q3DLight *</td><td class="memItemRight bottomAlign"><span class="name"><b>activeLight</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setActiveLight</b></span>(Q3DLight *<i>light</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>activeLightChanged</b></span>(Q3DLight *<i>light</i>)</td></tr>
</table></div>
<!-- @@@activeLight -->
<!-- $$$devicePixelRatio-prop$$$devicePixelRatio$$$setDevicePixelRatiofloat$$$devicePixelRatioChangedfloat -->
<h3 class="fn" id="devicePixelRatio-prop"><a name="devicePixelRatio-prop"></a><span class="name">devicePixelRatio</span> : <span class="type">float</span></h3>
<p>This property holds the device pixel ratio that is used when mapping input coordinates to pixel coordinates.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> float </td><td class="memItemRight bottomAlign"><span class="name"><b>devicePixelRatio</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setDevicePixelRatio</b></span>(float <i>pixelRatio</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>devicePixelRatioChanged</b></span>(float <i>pixelRatio</i>)</td></tr>
</table></div>
<!-- @@@devicePixelRatio -->
<!-- $$$graphPositionQuery-prop$$$graphPositionQuery$$$setGraphPositionQueryconstQPoint&$$$graphPositionQueryChangedconstQPoint& -->
<h3 class="fn" id="graphPositionQuery-prop"><a name="graphPositionQuery-prop"></a><span class="name">graphPositionQuery</span> : <span class="type">QPoint</span></h3>
<p>This property holds the coordinates for the user input that should be processed by the scene as a graph position query.</p>
<p>If this property is set to a value other than <a href="q3dscene.html#invalidSelectionPoint">invalidSelectionPoint</a>(), the graph tries to match a graph position to the specified coordinates within the primary viewport. After the rendering pass, this property is returned to its default state of <a href="q3dscene.html#invalidSelectionPoint">invalidSelectionPoint</a>(). The queried graph position can be read from the <a href="qabstract3dgraph.html#queriedGraphPosition-prop">QAbstract3DGraph::queriedGraphPosition</a> property after the next render pass.</p>
<p>There is no single correct 3D coordinate to match a particular screen position, so to be consistent, the queries are always done against the inner sides of an invisible box surrounding the graph.</p>
<p><b>Note: </b>Bar graphs allow graph position queries only at the graph floor level.</p><p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QPoint </td><td class="memItemRight bottomAlign"><span class="name"><b>graphPositionQuery</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setGraphPositionQuery</b></span>(const QPoint &<i>point</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>graphPositionQueryChanged</b></span>(const QPoint &<i>position</i>)</td></tr>
</table></div>
<p><b>See also </b><a href="qabstract3dgraph.html#queriedGraphPosition-prop">QAbstract3DGraph::queriedGraphPosition</a>.</p>
<!-- @@@graphPositionQuery -->
<!-- $$$primarySubViewport-prop$$$primarySubViewport$$$setPrimarySubViewportconstQRect&$$$primarySubViewportChangedconstQRect& -->
<h3 class="fn" id="primarySubViewport-prop"><a name="primarySubViewport-prop"></a><span class="name">primarySubViewport</span> : <span class="type">QRect</span></h3>
<p>This property holds the current subviewport rectangle inside the viewport where the primary view of the data visualization is targeted.</p>
<p>If <a href="q3dscene.html#slicingActive-prop">isSlicingActive</a>() is <code>false</code>, the primary sub viewport is equal to <a href="q3dscene.html#viewport-prop">viewport</a>(). If <a href="q3dscene.html#slicingActive-prop">isSlicingActive</a>() is <code>true</code> and the primary sub viewport has not been explicitly set, it will be one fifth of <a href="q3dscene.html#viewport-prop">viewport</a>().</p>
<p><b>Note: </b>Setting primarySubViewport larger than or outside of the viewport resizes the viewport accordingly.</p><p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QRect </td><td class="memItemRight bottomAlign"><span class="name"><b>primarySubViewport</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setPrimarySubViewport</b></span>(const QRect &<i>primarySubViewport</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>primarySubViewportChanged</b></span>(const QRect &<i>subViewport</i>)</td></tr>
</table></div>
<!-- @@@primarySubViewport -->
<!-- $$$secondarySubViewport-prop$$$secondarySubViewport$$$setSecondarySubViewportconstQRect&$$$secondarySubViewportChangedconstQRect& -->
<h3 class="fn" id="secondarySubViewport-prop"><a name="secondarySubViewport-prop"></a><span class="name">secondarySubViewport</span> : <span class="type">QRect</span></h3>
<p>This property holds the secondary viewport rectangle inside the viewport.</p>
<p>The secondary viewport is used for drawing the 2D slice view in some visualizations. If it has not been explicitly set, it will be equal to QRect. If <a href="q3dscene.html#slicingActive-prop">isSlicingActive</a>() is <code>true</code>, it will be equal to <a href="q3dscene.html#viewport-prop">viewport</a>.</p>
<p><b>Note: </b>If the secondary sub viewport is larger than or outside of the viewport, the viewport is resized accordingly.</p><p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QRect </td><td class="memItemRight bottomAlign"><span class="name"><b>secondarySubViewport</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setSecondarySubViewport</b></span>(const QRect &<i>secondarySubViewport</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>secondarySubViewportChanged</b></span>(const QRect &<i>subViewport</i>)</td></tr>
</table></div>
<!-- @@@secondarySubViewport -->
<!-- $$$secondarySubviewOnTop-prop$$$isSecondarySubviewOnTop$$$setSecondarySubviewOnTopbool$$$secondarySubviewOnTopChangedbool -->
<h3 class="fn" id="secondarySubviewOnTop-prop"><a name="secondarySubviewOnTop-prop"></a><span class="name">secondarySubviewOnTop</span> : <span class="type">bool</span></h3>
<p>This property holds whether the 2D slicing view or the 3D view is drawn on top.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isSecondarySubviewOnTop</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setSecondarySubviewOnTop</b></span>(bool <i>isSecondaryOnTop</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>secondarySubviewOnTopChanged</b></span>(bool <i>isSecondaryOnTop</i>)</td></tr>
</table></div>
<!-- @@@secondarySubviewOnTop -->
<!-- $$$selectionQueryPosition-prop$$$selectionQueryPosition$$$setSelectionQueryPositionconstQPoint&$$$selectionQueryPositionChangedconstQPoint& -->
<h3 class="fn" id="selectionQueryPosition-prop"><a name="selectionQueryPosition-prop"></a><span class="name">selectionQueryPosition</span> : <span class="type">QPoint</span></h3>
<p>This property holds the coordinates for the user input that should be processed by the scene as a selection.</p>
<p>If this property is set to a value other than <a href="q3dscene.html#invalidSelectionPoint">invalidSelectionPoint</a>(), the graph tries to select a data item, axis label, or a custom item at the specified coordinates within the primary viewport. After the rendering pass, the property is returned to its default state of <a href="q3dscene.html#invalidSelectionPoint">invalidSelectionPoint</a>().</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QPoint </td><td class="memItemRight bottomAlign"><span class="name"><b>selectionQueryPosition</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setSelectionQueryPosition</b></span>(const QPoint &<i>point</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>selectionQueryPositionChanged</b></span>(const QPoint &<i>position</i>)</td></tr>
</table></div>
<p><b>See also </b><a href="qabstract3dgraph.html#selectedElement-prop">QAbstract3DGraph::selectedElement</a>.</p>
<!-- @@@selectionQueryPosition -->
<!-- $$$slicingActive-prop$$$isSlicingActive$$$setSlicingActivebool$$$slicingActiveChangedbool -->
<h3 class="fn" id="slicingActive-prop"><a name="slicingActive-prop"></a><span class="name">slicingActive</span> : <span class="type">bool</span></h3>
<p>This property holds whether the 2D slicing view is currently active.</p>
<p>If <code>true</code>, <a href="qabstract3dgraph.html#selectionMode-prop">QAbstract3DGraph::selectionMode</a> must have either <a href="qabstract3dgraph.html#SelectionFlag-enum">QAbstract3DGraph::SelectionRow</a> or <a href="qabstract3dgraph.html#SelectionFlag-enum">QAbstract3DGraph::SelectionColumn</a> set to a valid selection.</p>
<p><b>Note: </b>Not all visualizations support the 2D slicing view.</p><p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isSlicingActive</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setSlicingActive</b></span>(bool <i>isSlicing</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>slicingActiveChanged</b></span>(bool <i>isSlicingActive</i>)</td></tr>
</table></div>
<!-- @@@slicingActive -->
<!-- $$$viewport-prop$$$viewport$$$viewportChangedconstQRect& -->
<h3 class="fn" id="viewport-prop"><a name="viewport-prop"></a><span class="name">viewport</span> : const <span class="type">QRect</span></h3>
<p>This property holds a read only property that contains the current viewport rectangle where all the 3D rendering is targeted.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QRect </td><td class="memItemRight bottomAlign"><span class="name"><b>viewport</b></span>() const</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>viewportChanged</b></span>(const QRect &<i>viewport</i>)</td></tr>
</table></div>
<!-- @@@viewport -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$Q3DScene[overload1]$$$Q3DSceneQObject* -->
<h3 class="fn" id="Q3DScene"><a name="Q3DScene"></a>Q3DScene::<span class="name">Q3DScene</span>(<span class="type">QObject</span> *<i>parent</i> = nullptr)</h3>
<p>Constructs a basic scene with one light and one camera in it. An optional <i>parent</i> parameter can be given and is then passed to QObject constructor.</p>
<!-- @@@Q3DScene -->
<!-- $$$~Q3DScene[overload1]$$$~Q3DScene -->
<h3 class="fn" id="dtor.Q3DScene"><a name="dtor.Q3DScene"></a><code>[virtual] </code>Q3DScene::<span class="name">~Q3DScene</span>()</h3>
<p>Destroys the 3D scene and all the objects contained within it.</p>
<!-- @@@~Q3DScene -->
<!-- $$$invalidSelectionPoint[overload1]$$$invalidSelectionPoint -->
<h3 class="fn" id="invalidSelectionPoint"><a name="invalidSelectionPoint"></a><code>[static] </code><span class="type">QPoint</span> Q3DScene::<span class="name">invalidSelectionPoint</span>()</h3>
<p>Returns a QPoint signifying an invalid selection position.</p>
<!-- @@@invalidSelectionPoint -->
<!-- $$$isPointInPrimarySubView[overload1]$$$isPointInPrimarySubViewconstQPoint& -->
<h3 class="fn" id="isPointInPrimarySubView"><a name="isPointInPrimarySubView"></a><span class="type">bool</span> Q3DScene::<span class="name">isPointInPrimarySubView</span>(const <span class="type">QPoint</span> &<i>point</i>)</h3>
<p>Returns whether the given <i>point</i> resides inside the primary subview or not. Returns <code>true</code> if the point is inside the primary subview.</p>
<p><b>Note: </b>If subviews are superimposed, and the given <i>point</i> resides inside both, result is <code>true</code> only when the primary subview is on top.</p><!-- @@@isPointInPrimarySubView -->
<!-- $$$isPointInSecondarySubView[overload1]$$$isPointInSecondarySubViewconstQPoint& -->
<h3 class="fn" id="isPointInSecondarySubView"><a name="isPointInSecondarySubView"></a><span class="type">bool</span> Q3DScene::<span class="name">isPointInSecondarySubView</span>(const <span class="type">QPoint</span> &<i>point</i>)</h3>
<p>Returns whether the given <i>point</i> resides inside the secondary subview or not. Returns <code>true</code> if the point is inside the secondary subview.</p>
<p><b>Note: </b>If subviews are superimposed, and the given <i>point</i> resides inside both, result is <code>true</code> only when the secondary subview is on top.</p><!-- @@@isPointInSecondarySubView -->
</div>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2019 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br/> 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.<br/> 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. </p>
</div>
</body>
</html>
