En esta página

Camera3D QML Type

Representación de una cámara en el espacio 3D. Más...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: Q3DCamera
Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Descripción detallada

Camera3D representa una cámara 3D con una órbita básica alrededor del punto central que se utiliza al renderizar la visualización de datos. Este tipo ofrece métodos sencillos para girar la cámara alrededor del origen y ajustar el nivel de zoom.

Para consultar las enumeraciones de Camera3D, véase Q3DCamera::CameraPreset.

Documentación de propiedades

cameraPreset : Camera3D.CameraPreset

El preajuste de cámara actualmente activo, que es uno de los que se encuentran en Camera3D.CameraPreset. Si no hay ningún preajuste activo, el valor es Camera3D.CameraPresetNone.

maxZoomLevel : real

Establece el nivel máximo permitido de zoom de la cámara. Si el nuevo nivel máximo es inferior al nivel mínimo actual, el nivel mínimo se ajusta también al nuevo máximo. Si el valor actual de « zoomLevel » se encuentra fuera de los nuevos límites, también se ajusta. El valor por defecto es « 500.0f ».

Véase también zoomLevel y minZoomLevel.

minZoomLevel : real

Establece el nivel mínimo permitido de zoom de la cámara. Si el nuevo nivel mínimo es superior al nivel máximo actual, el nivel máximo se ajusta también al nuevo mínimo. Si el valor actual de « zoomLevel » se encuentra fuera de los nuevos límites, también se ajusta. El valor de «minZoomLevel» no puede fijarse por debajo de « 1.0 ». El valor por defecto es « 10.0 ».

Véase también zoomLevel y maxZoomLevel.

target : vector3d [since QtDataVisualization 1.2]

El objetivo de la cámara como un vector3d. El valor por defecto es vector3d(0.0, 0.0, 0.0).

Los valores de coordenadas válidos se encuentran entre -1.0...1.0, donde los valores límite indican los extremos del rango del eje correspondiente. Cualquier valor fuera de este rango se limita al valor límite.

Nota: En el caso de los gráficos de barras, se ignora la coordenada Y y la cámara siempre se orienta hacia un punto del fondo horizontal.

Esta propiedad se introdujo en QtDataVisualization 1.2.

wrapXRotation : bool

El comportamiento de los límites mínimo y máximo en la rotación X. Por defecto, la rotación X se repite desde el valor mínimo hasta el máximo y desde el máximo hasta el mínimo.

Si se establece en « true », la rotación X de la cámara se repite desde el valor mínimo hasta el máximo y desde el máximo hasta el mínimo. Si se establece en « false », la rotación X de la cámara queda limitada al sector determinado por los valores mínimo y máximo.

wrapYRotation : bool

Comportamiento de los límites mínimo y máximo en la rotación Y. Por defecto, la rotación Y está limitada entre los valores mínimo y máximo sin que se produzca ningún rebote.

Si se establece « true », la rotación Y de la cámara se repite de mínimo a máximo y de máximo a mínimo. Si se establece « false », la rotación Y de la cámara se limita al sector determinado por los valores mínimo y máximo.

xRotation : real

El ángulo de rotación X de la cámara alrededor del punto objetivo, expresado en grados, partiendo de la posición base actual.

yRotation : real

El ángulo de rotación en Y de la cámara alrededor del punto objetivo, expresado en grados, partiendo de la posición base actual.

zoomLevel : real

El nivel de zoom de la cámara expresado en porcentaje. El valor predeterminado de « 100.0 » significa que no hay ningún ajuste de zoom (ni de acercamiento ni de alejamiento) configurado en la cámara. El valor está limitado por las propiedades « minZoomLevel » y « maxZoomLevel ».

Véase también minZoomLevel y maxZoomLevel.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. 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.