feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Update info about camera components

Browse Source 
Task-number: QDS-4888
Change-Id: I7fe351d34953d3a5a59397818b92d93139aa81c6
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Mahmoud Badri <mahmoud.badri@qt.io>
This commit is contained in:
Johanna Vanhatapio
2021-09-27 18:05:34 +03:00
parent 624df6ec44
commit 34cdffa89b
2 changed files with 34 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/qtdesignstudio/images/studio-qtquick-camera-properties.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 50 KiB

49
doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-camera.qdoc
View File

@@ -40,10 +40,10 @@
\image studio-qtquick-3d-components.png "Qt Quick 3D components in Library" \image studio-qtquick-3d-components.png "Qt Quick 3D components in Library"
You can add a camera to your scene by dragging-and-dropping one from Add a camera by dragging-and-dropping one of the camera components from
\l Library > \uicontrol Components > \uicontrol {Qt Quick 3D} > \uicontrol \l Library > \uicontrol Components > \uicontrol {Qt Quick 3D} > \uicontrol
{Qt Quick 3D} to \l {3D Editor} or to a 3D view in \l Navigator. {Qt Quick 3D} to \l {3D Editor} or to a 3D view in \l Navigator.
If the cameras are not displayed in \uicontrol Library, you should add the If the cameras are not displayed in \uicontrol Library, add the
\uicontrol QtQuick3D module to your project, as described in \uicontrol QtQuick3D module to your project, as described in
\l {Adding and Removing Modules}. \l {Adding and Removing Modules}.
@@ -51,20 +51,21 @@
projection: projection:
\list \list
\li \l{PerspectiveCamera}{Camera Perspective} - is the standard camera \li \l{PerspectiveCamera}{Camera Perspective} is the standard camera
type, which uses field of view and near and far clip planes to type, which gives a realistic projection of the scene since distant
specify the projection. objects are perceived as smaller. It uses field of view and near and
\li \l{OrthographicCamera}{Camera Orthographic} - renders all contents far clip planes to specify the projection.
with no perspective. It is ideal for rendering 2D elements, because \li \l{OrthographicCamera}{Camera Orthographic} renders all contents
with no perspective. It is ideal for rendering 2D elements because
your images are guaranteed to be the right size on the screen, and your images are guaranteed to be the right size on the screen, and
you can use the z position of components to bring them closer to or you can use the z position of components to bring them closer to or
take them farther from the camera (\e z-sorting) with no take them farther from the camera (\e z-sorting) with no
foreshortening artifacts. foreshortening artifacts.
\li \l{FrustumCamera}{Camera Frustum} - enables finer grain control of \li \l{FrustumCamera}{Camera Frustum} enables finer grain control of
how the frustum is defined, by setting the number of degrees between how the frustum is defined, by setting the number of degrees between
the top and bottom or left and right edges of the camera frustum. the top and bottom or left and right edges of the camera frustum.
This is useful when creating asymmetrical frustums. This is useful when creating asymmetrical frustums.
\li \l{CustomCamera}{Camera Custom} - provides full control over how \li \l{CustomCamera}{Camera Custom} provides full control over how
the projection matrix is created. the projection matrix is created.
\endlist \endlist
@@ -84,6 +85,10 @@
\section1 Setting Camera Field of View \section1 Setting Camera Field of View
\note If you select \uicontrol {Qt 5} as the \uicontrol {Target Qt Version}
when \l {Creating Projects}{creating your project}, the camera properties
will be slightly different.
The camera frustum can be obtained by taking a frustum (that is, a The camera frustum can be obtained by taking a frustum (that is, a
truncation with parallel planes) of the cone of vision that a camera or eye truncation with parallel planes) of the cone of vision that a camera or eye
would have to the rectangular viewports typically used in computer graphics. would have to the rectangular viewports typically used in computer graphics.
@@ -108,12 +113,26 @@
This value is the number of degrees between the top and bottom edges This value is the number of degrees between the top and bottom edges
of the camera frustum. of the camera frustum.
The horizontal FOV determines the number of degrees between the left and The \uicontrol {FOV orientation} property specifies either a
right edges of the camera frustum. It is automatically calculated based on \uicontrol Vertical (the default setting) or a \uicontrol Horizontal
the aspect ratio of the scene when the FOV orientation is set to vertical. orientation for the field of view. The horizontal FOV determines the number
You can set the orientation to horizontal to translate FOV values from of degrees between the left and right edges of the camera frustum. It is
graphics tools such as Maya and Blender, which use horizontal FOV by automatically calculated based on the aspect ratio of the scene when the
default. FOV orientation is set to vertical. You can set the orientation to horizontal
to translate FOV values from graphics tools such as Maya and Blender, which
use horizontal FOV by default.
The \uicontrol {Horizontal magnification} and \uicontrol {Vertical magnification}
properties determine the horizontal and vertical magnification of the camera
frustum.
\note The \uicontrol {Horizontal magnification} and
\uicontrol {Vertical magnification} properties are not available in Qt 5.
The \uicontrol {Frustum culling enabled} property determines whether the
objects outside the camera frustum will be culled, which means they will not
be passed to the renderer.
\note The \uicontrol {Frustum culling enabled} property is not available in
Qt 5.
The default values are intended to cause anything within the view The default values are intended to cause anything within the view
of the camera to be rendered. Aside from special clipping effects, you of the camera to be rendered. Aside from special clipping effects, you