이 페이지에서

Camera3D QML Type

3D 공간에서 카메라의 표현. 더 보기...

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

이 유형은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.

속성

상세 설명

Camera3D는 데이터 시각화를 렌더링할 때 사용되는, 중심점을 기준으로 회전하는 기본적인 3D 카메라를 나타냅니다. 이 타입은 카메라를 원점을 중심으로 회전시키고 줌 레벨을 설정하는 간단한 메서드를 제공합니다.

Camera3D 열거형에 대해서는 Q3DCamera::CameraPreset 을 참조하십시오.

속성 설명

cameraPreset : Camera3D.CameraPreset

현재 활성화된 카메라 프리셋으로, Camera3D.CameraPreset 중 하나입니다. 활성화된 프리셋이 없는 경우, 값은 Camera3D.CameraPresetNone 입니다.

maxZoomLevel : real

허용되는 최대 카메라 줌 레벨을 설정합니다. 새로운 최대 레벨이 기존 최소 레벨보다 낮을 경우, 최소 레벨도 새로운 최대 레벨에 맞춰 조정됩니다. 현재 zoomLevel 가 새로운 범위 밖일 경우에도 마찬가지로 조정됩니다. 기본값은 500.0f 입니다.

zoomLevel 및 minZoomLevel항목도 참조하십시오 .

minZoomLevel : real

허용되는 카메라 줌 레벨의 최소값을 설정합니다. 새로운 최소 레벨이 기존 최대 레벨보다 높을 경우, 최대 레벨도 새로운 최소 레벨로 조정됩니다. 현재 zoomLevel 이 새로운 범위 밖일 경우에도 마찬가지로 조정됩니다. minZoomLevel은 1.0 보다 낮게 설정할 수 없습니다. 기본값은 10.0 입니다.

zoomLevel 및 maxZoomLevel항목도 참조하십시오 .

target : vector3d [since QtDataVisualization 1.2]

카메라 타깃은 Vector3D 형식입니다. 기본값은 vector3d(0.0, 0.0, 0.0) 입니다.

유효한 좌표 값은 -1.0...1.0 사이여야 하며, 여기서 경계 값은 해당 축 범위의 끝점을 나타냅니다. 이 범위 밖의 값은 경계값으로 클램핑됩니다.

참고: 막대 그래프의경우 Y 좌표는 무시되며, 카메라는 항상 수평 배경상의 한 지점을 목표로 합니다.

이 속성은 QtDataVisualization 1.2에서 도입되었습니다.

wrapXRotation : bool

X 회전 시 최소 및 최대 한계값의 동작 방식입니다. 기본적으로 X 회전은 최소값에서 최대값으로, 그리고 최대값에서 최소값으로 순환합니다.

true 로 설정하면 카메라의 X 회전 각도는 최소값에서 최대값으로, 그리고 최대값에서 최소값으로 순환합니다. false 로 설정하면 카메라의 X 회전 각도는 최소값과 최대값으로 결정된 구역 내에서만 제한됩니다.

wrapYRotation : bool

Y축 회전 시 최소값과 최대값의 동작 방식. 기본적으로 Y축 회전은 최소값과 최대값 사이에서 제한되며, 값이 넘어서면 다시 최소값으로 돌아가지 않습니다.

true 인 경우, 카메라의 Y축 회전은 최소값에서 최대값으로, 그리고 최대값에서 최소값으로 순환합니다. false 인 경우, 카메라의 Y축 회전은 최소값과 최대값으로 정의된 구역 내에서만 제한됩니다.

xRotation : real

현재 기준 위치에서 시작하여 타겟 지점을 중심으로 한 카메라의 X축 회전 각도(도 단위).

yRotation : real

현재 기준 위치에서 시작하여 타겟 지점을 중심으로 한 카메라의 Y축 회전 각도(도 단위).

zoomLevel : real

카메라 줌 수준을 백분율로 나타낸 값입니다. 기본값인 100.0 은 카메라에 확대 또는 축소 설정이 되어 있지 않음을 의미합니다. 이 값은 minZoomLevel 및 maxZoomLevel 속성에 의해 제한됩니다.

minZoomLevel 및 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.