<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- q3dcamera.cpp --> <title>Q3DCamera Class | Qt Data Visualization 5.12.2</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 >Q3DCamera</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="#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="#reimplemented-public-functions">Reimplemented 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">Q3DCamera Class</h1> <!-- $$$Q3DCamera-brief --> <p>Representation of a camera in 3D space. <a href="#details">More...</a></p> <!-- @@@Q3DCamera --> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> <span class="preprocessor">#include <Q3DCamera></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-camera3d.html">Camera3D</a></td></tr><tr><td class="memItemLeft rightAlign topAlign"> Inherits:</td><td class="memItemRight bottomAlign"> <a href="q3dobject.html">Q3DObject</a></td></tr></table></div><ul> <li><a href="q3dcamera-members.html">List of all members, including inherited members</a></li> </ul> <a name="public-types"></a> <h2 id="public-types">Public Types</h2> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#CameraPreset-enum">CameraPreset</a></b> { CameraPresetNone, CameraPresetFrontLow, CameraPresetFront, CameraPresetFrontHigh, ..., CameraPresetDirectlyBelow }</td></tr> </table></div> <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="q3dcamera.html#cameraPreset-prop">cameraPreset</a></b> : CameraPreset</li> <li class="fn"><b><a href="q3dcamera.html#maxZoomLevel-prop">maxZoomLevel</a></b> : float</li> <li class="fn"><b><a href="q3dcamera.html#minZoomLevel-prop">minZoomLevel</a></b> : float</li> <li class="fn"><b><a href="q3dcamera.html#target-prop">target</a></b> : QVector3D</li> <li class="fn"><b><a href="q3dcamera.html#wrapXRotation-prop">wrapXRotation</a></b> : bool</li> </ul></td><td class="topAlign"><ul> <li class="fn"><b><a href="q3dcamera.html#wrapYRotation-prop">wrapYRotation</a></b> : bool</li> <li class="fn"><b><a href="q3dcamera.html#xRotation-prop">xRotation</a></b> : float</li> <li class="fn"><b><a href="q3dcamera.html#yRotation-prop">yRotation</a></b> : float</li> <li class="fn"><b><a href="q3dcamera.html#zoomLevel-prop">zoomLevel</a></b> : float</li> </ul> </td></tr> </table></div> <ul> <li class="fn">2 properties inherited from <a href="q3dobject.html#properties">Q3DObject</a></li> </ul> <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="q3dcamera.html#Q3DCamera">Q3DCamera</a></b>(QObject *<i>parent</i> = nullptr)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> virtual </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#dtor.Q3DCamera">~Q3DCamera</a></b>()</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> Q3DCamera::CameraPreset </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#cameraPreset-prop">cameraPreset</a></b>() const</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> float </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#maxZoomLevel-prop">maxZoomLevel</a></b>() const</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> float </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#minZoomLevel-prop">minZoomLevel</a></b>() const</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#setCameraPosition">setCameraPosition</a></b>(float <i>horizontal</i>, float <i>vertical</i>, float <i>zoom</i> = 100.0f)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#cameraPreset-prop">setCameraPreset</a></b>(Q3DCamera::CameraPreset <i>preset</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#maxZoomLevel-prop">setMaxZoomLevel</a></b>(float <i>zoomLevel</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#minZoomLevel-prop">setMinZoomLevel</a></b>(float <i>zoomLevel</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#target-prop">setTarget</a></b>(const QVector3D &<i>target</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#wrapXRotation-prop">setWrapXRotation</a></b>(bool <i>isEnabled</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#wrapYRotation-prop">setWrapYRotation</a></b>(bool <i>isEnabled</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#xRotation-prop">setXRotation</a></b>(float <i>rotation</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#yRotation-prop">setYRotation</a></b>(float <i>rotation</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#zoomLevel-prop">setZoomLevel</a></b>(float <i>zoomLevel</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> QVector3D </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#target-prop">target</a></b>() const</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#wrapXRotation-prop">wrapXRotation</a></b>() const</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#wrapYRotation-prop">wrapYRotation</a></b>() const</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> float </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#xRotation-prop">xRotation</a></b>() const</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> float </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#yRotation-prop">yRotation</a></b>() const</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> float </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#zoomLevel-prop">zoomLevel</a></b>() const</td></tr> </table></div> <a name="reimplemented-public-functions"></a> <h2 id="reimplemented-public-functions">Reimplemented Public Functions</h2> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#copyValuesFrom">copyValuesFrom</a></b>(const Q3DObject &<i>source</i>)</td></tr> </table></div> <ul> <li class="fn">4 public functions inherited from <a href="q3dobject.html#public-functions">Q3DObject</a></li> </ul> <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="q3dcamera.html#cameraPreset-prop">cameraPresetChanged</a></b>(Q3DCamera::CameraPreset <i>preset</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#maxZoomLevel-prop">maxZoomLevelChanged</a></b>(float <i>zoomLevel</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#minZoomLevel-prop">minZoomLevelChanged</a></b>(float <i>zoomLevel</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#target-prop">targetChanged</a></b>(const QVector3D &<i>target</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#wrapXRotation-prop">wrapXRotationChanged</a></b>(bool <i>isEnabled</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#wrapYRotation-prop">wrapYRotationChanged</a></b>(bool <i>isEnabled</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#xRotation-prop">xRotationChanged</a></b>(float <i>rotation</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#yRotation-prop">yRotationChanged</a></b>(float <i>rotation</i>)</td></tr> <tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#zoomLevel-prop">zoomLevelChanged</a></b>(float <i>zoomLevel</i>)</td></tr> </table></div> <ul> <li class="fn">1 signal inherited from <a href="q3dobject.html#signals">Q3DObject</a></li> </ul> <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"> const QMetaObject </td><td class="memItemRight bottomAlign"><b><a href="q3dcamera.html#staticMetaObject-var">staticMetaObject</a></b></td></tr> </table></div> <h3>Additional Inherited Members</h3> <ul> <li class="fn">2 protected functions inherited from <a href="q3dobject.html#protected-functions">Q3DObject</a></li> </ul> <a name="details"></a> <!-- $$$Q3DCamera-description --> <div class="descr"> <h2 id="details">Detailed Description</h2> <p>Representation of a camera in 3D space.</p> <p><a href="q3dcamera.html">Q3DCamera</a> represents a basic orbit around centerpoint 3D camera that is used when rendering the data visualization. The class offers simple methods for rotating the camera around the origin and setting zoom level.</p> </div> <!-- @@@Q3DCamera --> <div class="types"> <h2>Member Type Documentation</h2> <!-- $$$CameraPreset$$$CameraPresetNone$$$CameraPresetFrontLow$$$CameraPresetFront$$$CameraPresetFrontHigh$$$CameraPresetLeftLow$$$CameraPresetLeft$$$CameraPresetLeftHigh$$$CameraPresetRightLow$$$CameraPresetRight$$$CameraPresetRightHigh$$$CameraPresetBehindLow$$$CameraPresetBehind$$$CameraPresetBehindHigh$$$CameraPresetIsometricLeft$$$CameraPresetIsometricLeftHigh$$$CameraPresetIsometricRight$$$CameraPresetIsometricRightHigh$$$CameraPresetDirectlyAbove$$$CameraPresetDirectlyAboveCW45$$$CameraPresetDirectlyAboveCCW45$$$CameraPresetFrontBelow$$$CameraPresetLeftBelow$$$CameraPresetRightBelow$$$CameraPresetBehindBelow$$$CameraPresetDirectlyBelow --> <h3 class="fn" id="CameraPreset-enum"><a name="CameraPreset-enum"></a>enum Q3DCamera::<span class="name">CameraPreset</span></h3> <p>Predefined positions for camera.</p> <div class="table"><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"><code>Q3DCamera::CameraPresetNone</code></td><td class="topAlign tblval"><code>-1</code></td><td class="topAlign">Used to indicate a preset has not been set, or the scene has been rotated freely.</td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetFrontLow</code></td><td class="topAlign tblval"><code>0</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetFront</code></td><td class="topAlign tblval"><code>1</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetFrontHigh</code></td><td class="topAlign tblval"><code>2</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetLeftLow</code></td><td class="topAlign tblval"><code>3</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetLeft</code></td><td class="topAlign tblval"><code>4</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetLeftHigh</code></td><td class="topAlign tblval"><code>5</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetRightLow</code></td><td class="topAlign tblval"><code>6</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetRight</code></td><td class="topAlign tblval"><code>7</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetRightHigh</code></td><td class="topAlign tblval"><code>8</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetBehindLow</code></td><td class="topAlign tblval"><code>9</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetBehind</code></td><td class="topAlign tblval"><code>10</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetBehindHigh</code></td><td class="topAlign tblval"><code>11</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetIsometricLeft</code></td><td class="topAlign tblval"><code>12</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetIsometricLeftHigh</code></td><td class="topAlign tblval"><code>13</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetIsometricRight</code></td><td class="topAlign tblval"><code>14</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetIsometricRightHigh</code></td><td class="topAlign tblval"><code>15</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetDirectlyAbove</code></td><td class="topAlign tblval"><code>16</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetDirectlyAboveCW45</code></td><td class="topAlign tblval"><code>17</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetDirectlyAboveCCW45</code></td><td class="topAlign tblval"><code>18</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetFrontBelow</code></td><td class="topAlign tblval"><code>19</code></td><td class="topAlign">In <a href="q3dbars.html">Q3DBars</a> from CameraPresetFrontBelow onward these only work for graphs including negative values. They act as Preset...Low for positive-only values.</td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetLeftBelow</code></td><td class="topAlign tblval"><code>20</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetRightBelow</code></td><td class="topAlign tblval"><code>21</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetBehindBelow</code></td><td class="topAlign tblval"><code>22</code></td><td class="topAlign"> </td></tr> <tr><td class="topAlign"><code>Q3DCamera::CameraPresetDirectlyBelow</code></td><td class="topAlign tblval"><code>23</code></td><td class="topAlign">Acts as CameraPresetFrontLow for positive-only bars.</td></tr> </table></div> <!-- @@@CameraPreset --> </div> <div class="prop"> <h2>Property Documentation</h2> <!-- $$$cameraPreset-prop$$$cameraPreset$$$setCameraPresetQ3DCamera::CameraPreset$$$cameraPresetChangedQ3DCamera::CameraPreset --> <h3 class="fn" id="cameraPreset-prop"><a name="cameraPreset-prop"></a><span class="name">cameraPreset</span> : <span class="type"><a href="q3dcamera.html#CameraPreset-enum">CameraPreset</a></span></h3> <p>This property holds the currently active camera preset.</p> <p>If no <a href="q3dcamera.html#CameraPreset-enum">CameraPreset</a> value is set, <a href="q3dcamera.html#CameraPreset-enum">CameraPresetNone</a> is used by default.</p> <p><b>Access functions:</b></p> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft topAlign rightAlign"> Q3DCamera::CameraPreset </td><td class="memItemRight bottomAlign"><span class="name"><b>cameraPreset</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setCameraPreset</b></span>(Q3DCamera::CameraPreset <i>preset</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>cameraPresetChanged</b></span>(Q3DCamera::CameraPreset <i>preset</i>)</td></tr> </table></div> <!-- @@@cameraPreset --> <!-- $$$maxZoomLevel-prop$$$maxZoomLevel$$$setMaxZoomLevelfloat$$$maxZoomLevelChangedfloat --> <h3 class="fn" id="maxZoomLevel-prop"><a name="maxZoomLevel-prop"></a><span class="name">maxZoomLevel</span> : <span class="type">float</span></h3> <p>This property holds the maximum allowed camera zoom level.</p> <p>If the maximum level is set to a new value that is lower than the existing minimum level, the minimum level is adjusted to the new maximum as well. If the current <a href="q3dcamera.html#zoomLevel-prop">zoomLevel</a> is outside the new bounds, it is adjusted as well. Defaults to <code>500.0f</code>.</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>maxZoomLevel</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMaxZoomLevel</b></span>(float <i>zoomLevel</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>maxZoomLevelChanged</b></span>(float <i>zoomLevel</i>)</td></tr> </table></div> <p><b>See also </b><a href="q3dcamera.html#zoomLevel-prop">zoomLevel</a> and <a href="q3dcamera.html#minZoomLevel-prop">minZoomLevel</a>.</p> <!-- @@@maxZoomLevel --> <!-- $$$minZoomLevel-prop$$$minZoomLevel$$$setMinZoomLevelfloat$$$minZoomLevelChangedfloat --> <h3 class="fn" id="minZoomLevel-prop"><a name="minZoomLevel-prop"></a><span class="name">minZoomLevel</span> : <span class="type">float</span></h3> <p>This property holds the minimum allowed camera zoom level.</p> <p>If the minimum level is set to a new value that is higher than the existing maximum level, the maximum level is adjusted to the new minimum as well. If the current <a href="q3dcamera.html#zoomLevel-prop">zoomLevel</a> is outside the new bounds, it is adjusted as well. The minZoomLevel cannot be set below <code>1.0f</code>. Defaults to <code>10.0f</code>.</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>minZoomLevel</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMinZoomLevel</b></span>(float <i>zoomLevel</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>minZoomLevelChanged</b></span>(float <i>zoomLevel</i>)</td></tr> </table></div> <p><b>See also </b><a href="q3dcamera.html#zoomLevel-prop">zoomLevel</a> and <a href="q3dcamera.html#maxZoomLevel-prop">maxZoomLevel</a>.</p> <!-- @@@minZoomLevel --> <!-- $$$target-prop$$$target$$$setTargetconstQVector3D&$$$targetChangedconstQVector3D& --> <h3 class="fn" id="target-prop"><a name="target-prop"></a><span class="name">target</span> : <span class="type">QVector3D</span></h3> <p>This property holds the camera target as a a vector or vertex in the 3D space.</p> <p>Defaults to <code>QVector3D(0.0, 0.0, 0.0)</code>.</p> <p>Valid coordinate values are between <code>-1.0...1.0</code>, where the edge values indicate the edges of the corresponding axis range. Any values outside this range are clamped to the edge.</p> <p><b>Note: </b>For bar graphs, the Y-coordinate is ignored and camera always targets a point on the horizontal background.</p><p>This property was introduced in QtDataVisualization 1.2.</p> <p><b>Access functions:</b></p> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft topAlign rightAlign"> QVector3D </td><td class="memItemRight bottomAlign"><span class="name"><b>target</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setTarget</b></span>(const QVector3D &<i>target</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>targetChanged</b></span>(const QVector3D &<i>target</i>)</td></tr> </table></div> <!-- @@@target --> <!-- $$$wrapXRotation-prop$$$wrapXRotation$$$setWrapXRotationbool$$$wrapXRotationChangedbool --> <h3 class="fn" id="wrapXRotation-prop"><a name="wrapXRotation-prop"></a><span class="name">wrapXRotation</span> : <span class="type">bool</span></h3> <p>This property holds the behavior of the minimum and maximum limits in the X-rotation.</p> <p>If set to <code>true</code>, the X-rotation of the camera is wrapped from minimum to maximum and from maximum to minimum. If set to <code>false</code>, the X-rotation of the camera is limited to the sector determined by the minimum and maximum values. Set to <code>true</code> by default.</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>wrapXRotation</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWrapXRotation</b></span>(bool <i>isEnabled</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>wrapXRotationChanged</b></span>(bool <i>isEnabled</i>)</td></tr> </table></div> <!-- @@@wrapXRotation --> <!-- $$$wrapYRotation-prop$$$wrapYRotation$$$setWrapYRotationbool$$$wrapYRotationChangedbool --> <h3 class="fn" id="wrapYRotation-prop"><a name="wrapYRotation-prop"></a><span class="name">wrapYRotation</span> : <span class="type">bool</span></h3> <p>This property holds the behavior of the minimum and maximum limits in the Y-rotation.</p> <p>If <code>true</code>, the Y-rotation of the camera is wrapped from minimum to maximum and from maximum to minimum. If <code>false</code>, the Y-rotation of the camera is limited to the sector determined by the minimum and maximum values. Set to <code>true</code> by default.</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>wrapYRotation</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWrapYRotation</b></span>(bool <i>isEnabled</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>wrapYRotationChanged</b></span>(bool <i>isEnabled</i>)</td></tr> </table></div> <!-- @@@wrapYRotation --> <!-- $$$xRotation-prop$$$xRotation$$$setXRotationfloat$$$xRotationChangedfloat --> <h3 class="fn" id="xRotation-prop"><a name="xRotation-prop"></a><span class="name">xRotation</span> : <span class="type">float</span></h3> <p>This property holds the X-rotation angle of the camera around the target point in degrees.</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>xRotation</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setXRotation</b></span>(float <i>rotation</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>xRotationChanged</b></span>(float <i>rotation</i>)</td></tr> </table></div> <!-- @@@xRotation --> <!-- $$$yRotation-prop$$$yRotation$$$setYRotationfloat$$$yRotationChangedfloat --> <h3 class="fn" id="yRotation-prop"><a name="yRotation-prop"></a><span class="name">yRotation</span> : <span class="type">float</span></h3> <p>This property holds the Y-rotation angle of the camera around the target point in degrees.</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>yRotation</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setYRotation</b></span>(float <i>rotation</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>yRotationChanged</b></span>(float <i>rotation</i>)</td></tr> </table></div> <!-- @@@yRotation --> <!-- $$$zoomLevel-prop$$$zoomLevel$$$setZoomLevelfloat$$$zoomLevelChangedfloat --> <h3 class="fn" id="zoomLevel-prop"><a name="zoomLevel-prop"></a><span class="name">zoomLevel</span> : <span class="type">float</span></h3> <p>This property holds the camera zoom level in percentage.</p> <p>The default value of <code>100.0f</code> means there is no zoom in or out set in the camera. The value is limited by the <a href="q3dcamera.html#minZoomLevel-prop">minZoomLevel</a> and <a href="q3dcamera.html#maxZoomLevel-prop">maxZoomLevel</a> properties.</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>zoomLevel</b></span>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setZoomLevel</b></span>(float <i>zoomLevel</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>zoomLevelChanged</b></span>(float <i>zoomLevel</i>)</td></tr> </table></div> <p><b>See also </b><a href="q3dcamera.html#minZoomLevel-prop">minZoomLevel</a> and <a href="q3dcamera.html#maxZoomLevel-prop">maxZoomLevel</a>.</p> <!-- @@@zoomLevel --> </div> <div class="func"> <h2>Member Function Documentation</h2> <!-- $$$Q3DCamera[overload1]$$$Q3DCameraQObject* --> <h3 class="fn" id="Q3DCamera"><a name="Q3DCamera"></a>Q3DCamera::<span class="name">Q3DCamera</span>(<span class="type">QObject</span> *<i>parent</i> = nullptr)</h3> <p>Constructs a new 3D camera with position set to origin, up direction facing towards the Y-axis and looking at origin by default. An optional <i>parent</i> parameter can be given and is then passed to QObject constructor.</p> <!-- @@@Q3DCamera --> <!-- $$$~Q3DCamera[overload1]$$$~Q3DCamera --> <h3 class="fn" id="dtor.Q3DCamera"><a name="dtor.Q3DCamera"></a><code>[virtual] </code>Q3DCamera::<span class="name">~Q3DCamera</span>()</h3> <p>Destroys the camera object.</p> <!-- @@@~Q3DCamera --> <!-- $$$copyValuesFrom[overload1]$$$copyValuesFromconstQ3DObject& --> <h3 class="fn" id="copyValuesFrom"><a name="copyValuesFrom"></a><code>[virtual] </code><span class="type">void</span> Q3DCamera::<span class="name">copyValuesFrom</span>(const <span class="type"><a href="q3dobject.html#Q3DObject">Q3DObject</a></span> &<i>source</i>)</h3> <p>Reimplemented from <a href="q3dobject.html#copyValuesFrom">Q3DObject::copyValuesFrom</a>().</p> <p>Copies the 3D camera's properties from the given source camera. Values are copied from the <i>source</i> to this object.</p> <!-- @@@copyValuesFrom --> <!-- $$$setCameraPosition[overload1]$$$setCameraPositionfloatfloatfloat --> <h3 class="fn" id="setCameraPosition"><a name="setCameraPosition"></a><span class="type">void</span> Q3DCamera::<span class="name">setCameraPosition</span>(<span class="type">float</span> <i>horizontal</i>, <span class="type">float</span> <i>vertical</i>, <span class="type">float</span> <i>zoom</i> = 100.0f)</h3> <p>Utility function that sets the camera rotations and distance.<i>horizontal</i> and <i>vertical</i> define the camera rotations to be used. Optional <i>zoom</i> parameter can be given to set the zoom percentage of the camera within the bounds defined by <a href="q3dcamera.html#minZoomLevel-prop">minZoomLevel</a> and <a href="q3dcamera.html#maxZoomLevel-prop">maxZoomLevel</a> properties.</p> <!-- @@@setCameraPosition --> </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>