Q3DGraphsWidgetItem Class

속성 설명서

activeTheme : QGraphsTheme*

이 속성은 그래프의 활성 테마를 저장합니다.

activeTheme 를 그래프에 사용될 활성 테마로 설정합니다. addTheme()을 암시적으로 호출하여 테마의 소유권을 이 그래프로 이전합니다.

activeTheme 가 null인 경우, 임시 기본 테마가 생성됩니다. 이 임시 테마는 나중에 어떤 테마라도 명시적으로 설정되면 파기됩니다. 테마를 설정한 후에도 테마의 속성을 수정할 수 있으며, 수정 사항은 즉시 적용됩니다.

액세스 함수:

Notifier 신호:

ambientLightStrength : float

이 속성은 그래프 전체의 주변광 강도를 결정합니다.

이 값은 빛의 위치와 관계없이 그래프 전체에 걸쳐 색상이 얼마나 균일하고 밝게 표시될지를 결정합니다.

값은 0.0f 과 1.0f 사이여야 합니다.

액세스 함수:

알림 신호:

aspectRatio : qreal

이 속성은 수평면상의 가장 긴 축과 y축 사이의 그래프 확대/축소 비율을 나타냅니다.

기본값은 2.0 입니다.

액세스 함수:

알림 신호:

horizontalAspectRatio도 참조하십시오 .

cameraPreset : QtGraphs3D::CameraPreset

카메라가 현재 사용하고 있는 사전 설정된 카메라 위치입니다. 이 값은 CameraPreset 열거형의 값 중 하나로 설정할 수 있습니다. 이 속성을 사용하면 그래프를 볼 때 적용할 미리 정의된 카메라 각도를 설정할 수 있습니다.

기본적으로 카메라 프리셋은 CameraPreset::FrontLow 로 설정되어 있습니다.

액세스 함수:

Notifier 신호:

cameraTargetPosition : QVector3D

이 속성은 3D 공간에서 카메라의 목표 위치를 벡터 또는 정점 형태로 저장합니다.

기본값은 QVector3D(0.0, 0.0, 0.0) 입니다.

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

액세스 함수:

알림 신호:

cameraXRotation : float

이 속성은 타겟 지점을 중심으로 한 카메라의 X축 회전 각도를 도(°) 단위로 저장합니다.

액세스 함수:

알림 신호:

cameraYRotation : float

이 속성은 타겟 지점을 중심으로 한 카메라의 Y축 회전 각도를 도(°) 단위로 저장합니다.

액세스 함수:

알림 신호:

cameraZoomLevel : float

이 속성은 카메라 줌 수준을 백분율로 저장합니다.

100.0f 의 기본값은 카메라에 확대 또는 축소 설정이 되어 있지 않음을 의미합니다. 이 값은 minCameraZoomLevel 및 maxCameraZoomLevel 속성에 의해 제한됩니다.

액세스 함수:

알림 신호:

minCameraZoomLevel 및 maxCameraZoomLevel도 참조하십시오 .

[read-only] currentFps : int

이 속성은 지난 1초 동안의 렌더링 결과를 저장합니다.

FPS 측정이 활성화되면 결과가 이 읽기 전용 속성에 저장됩니다. 측정이 활성화된 후 이 값이 업데이트되기까지는 최소 1초가 소요됩니다.

액세스 함수:

알림 신호:

measureFps도 참조하십시오 .

[since 6.11] cutoffMargin : qreal

이 속성은 축 한계와 그래프 요소가 제거되는 위치 사이의 간격에 사용되는 값을 저장합니다.

이 열거형은 Qt 6.11에서 도입되었습니다.

액세스 함수:

Notifier 신호:

[since 6.12] dragMode : QtGraphs3D::DragMode

그래프에서 발생하는 드래그 이벤트가 어떻게 해석될지 결정하며, ` QtGraphs3D::DragMode ` 열거형의 값 중 하나를 가집니다.

기본값은 ` QtGraphs3D::DragMode::Rotate`입니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

액세스 함수:

알림 신호:

panEnabled도 참조하십시오 .

gridLineType : QtGraphs3D::GridLineType

이 속성은 격자선 유형이 ‘ QtGraphs3D::GridLineType::Shader ’이든 ‘ QtGraphs3D::GridLineType::Geometry ’이든 상관없이 적용됩니다.

이 값은 모든 격자선에 적용됩니다.

액세스 함수:

알림 신호:

QtGraphs3D::GridLineType도 참조하십시오 .

horizontalAspectRatio : qreal

이 속성은 x축과 z축 간의 그래프 확대/축소 비율을 지정합니다.

0.0 값은 축 범위에 따라 자동으로 크기가 조정됨을 나타냅니다. 기본값은 0.0 입니다.

이 속성은 Q3DBarsWidgetItem 에는 영향을 미치지 않으며, 는 barThickness 및 barSpacing 속성을 통해 수평면의 스케일링을 처리합니다. 극좌표 그래프도 이 속성을 무시합니다.

액세스 함수:

알림 신호:

aspectRatio, polar, Q3DBarsWidgetItem::barThickness 및 Q3DBarsWidgetItem::barSpacing도 참조하십시오 .

labelMargin : float

이 속성은 축 레이블의 배치 여백을 지정합니다.

음수 값을 지정하면 레이블이 플롯 영역 안쪽에 배치되고, 양수 값을 지정하면 플롯 영역 바깥쪽에 배치됩니다. 값이 음수일 경우 레이블의 자동 회전 기능이 비활성화됩니다. 기본값은 0.1

Access 함수:

알림 신호:

QAbstract3DAxis::labelAutoAngle도 참조하십시오 .

lightColor : QColor

이 속성은 주변광 및 반사광의 색상을 지정합니다.

이 값은 ` Q3DScene`에 지정된 조명에 영향을 미칩니다.

액세스 함수:

알림 신호:

lightStrength : float

이 속성은 그래프 전체에 대한 스페큘러 광도의 강도를 저장합니다.

값은 0.0f 와 10.0f 사이여야 합니다.

이 값은 Q3DScene 에 지정된 빛에 영향을 미칩니다.

액세스 함수:

알림 신호:

locale : QLocale

이 속성은 다양한 숫자 레이블의 서식을 지정하는 데 사용되는 로케일을 저장합니다.

기본값은 "C" 로케일입니다.

액세스 함수:

알림 신호:

QValue3DAxis::labelFormat도 참조하십시오 .

margin : qreal

이 속성은 그래프의 그리기 가능 영역 가장자리와 그래프 배경 가장자리 사이에 남겨질 간격에 사용되는 절대값을 저장합니다.

여백 값이 음수인 경우, 여백은 자동으로 결정되며 시리즈 내 항목의 크기와 그래프 유형에 따라 달라질 수 있습니다. 그래프 종횡비가 기본값에서 변경되지 않은 경우, 이 값은 y축 범위의 비율로 해석됩니다. 기본값은 -1.0 입니다.

액세스 함수:

알림 신호:

maxCameraXRotation : float

이 속성은 카메라가 대상 지점을 중심으로 회전할 때의 최대 X축 회전 각도(도)를 저장합니다. 기본값은 180.0

액세스 함수:

알림 신호:

maxCameraYRotation : float

이 속성은 카메라가 대상 지점을 중심으로 회전할 때의 최대 Y축 회전 각도(도 단위)를 나타냅니다. 기본값은 90.0

액세스 함수:

알림 신호:

maxCameraZoomLevel : float

이 속성은 허용되는 최대 카메라 줌 레벨을 지정합니다.

최대 레벨이 기존 최소 레벨보다 낮은 새로운 값으로 설정되면, 최소 레벨도 새로운 최대 레벨에 맞춰 조정됩니다. 현재 cameraZoomLevel 이 새로운 범위 밖인 경우에도 마찬가지로 조정됩니다. 기본값은 500.0f 입니다.

액세스 함수:

알림 신호:

관련 항목: cameraZoomLevel 및 minCameraZoomLevel.

measureFps : bool

이 속성은 렌더링이 요청 시마다 수행되는 것이 아니라 지속적으로 수행되는지 여부를 나타냅니다.

true 인 경우, 렌더링은 연속적으로 수행되며 currentFps 속성의 값이 업데이트됩니다. 기본값은 false 입니다.

액세스 함수:

Notifier 신호:

currentFps도 참조하십시오 .

minCameraXRotation : float

이 속성은 카메라가 대상 지점을 중심으로 회전할 때의 최소 X축 회전 각도(도 단위)를 나타냅니다. 기본값은 -180.0

액세스 함수:

알림 신호:

minCameraYRotation : float

이 속성은 카메라가 대상 지점을 중심으로 회전할 때의 최소 Y축 회전 각도(도)를 나타냅니다. 기본값은 0.0

액세스 함수:

알림 신호:

minCameraZoomLevel : float

이 속성은 허용되는 최소 카메라 줌 레벨을 저장합니다.

최소 레벨이 기존 최대 레벨보다 높은 새로운 값으로 설정되면, 최대 레벨도 새로운 최소 레벨로 조정됩니다. 현재 줌 레벨(zoomLevel)이 새로운 범위 밖인 경우에도 마찬가지로 조정됩니다. minCameraZoomLevel은 1.0f 보다 낮게 설정할 수 없습니다. 기본값은 10.0f 입니다.

액세스 함수:

알림 신호:

cameraZoomLevel 및 maxCameraZoomLevel도 참조하십시오 .

msaaSamples : int

이 속성은 MSAA에서 사용되는 샘플 수를 저장합니다.

사용되는 MSAA 샘플 수를 samples 로 설정합니다. 샘플 수는 0, 2, 4 또는 8 중 하나여야 합니다.

액세스 함수:

알림 신호:

optimizationHint : QtGraphs3D::OptimizationHint

렌더링 최적화를 위해 기본 모드 또는 레거시 모드 중 어느 것을 사용할지 지정합니다.

기본 모드는 인스턴스 렌더링을 사용하며, 대부분의 시스템에서 최상의 성능으로 전체 기능 세트를 제공합니다. 정적 모드는 그래프 렌더링을 최적화하며, 변경되지 않는 대규모 데이터 세트에 이상적입니다. 동적 데이터 변경이나 항목 회전 시에는 속도가 느려집니다. 선택 기능은 최적화되지 않으므로, 방대한 데이터 세트에 정적 모드를 사용하는 것은 권장되지 않습니다. 정적 최적화는 산점도 그래프에서만 작동합니다. 레거시 모드는 인스턴싱 없이 그래프의 모든 항목을 개별적으로 렌더링합니다. 이 모드는 기본 모드가 작동하지 않는 경우, 즉 대상 시스템이 인스턴싱을 지원하지 않는 경우에만 사용해야 합니다. 기본값은 ` QtGraphs3D::OptimizationHint::Default`입니다.

액세스 함수:

알림 신호:

참조: QAbstract3DSeries::mesh.

orthoProjection : bool

이 속성은 그래프를 표시할 때 정투영을 사용할지 여부를 지정합니다.

기본값은 ' false'입니다.

액세스 함수:

알림 신호:

QAbstract3DAxis::labelAutoAngle도 참조하십시오 .

[since 6.12] panEnabled : bool

이 속성은 해당 입력 핸들러가 그래프 패닝을 허용하는지 여부를 나타냅니다.

기본값은 ` true`입니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

액세스 함수:

알림 신호:

dragMode 및 setPanButton()도 참조하십시오 .

polar : bool

이 속성은 가로축이 극좌표축으로 변경되더라도 유지됩니다.

true 인 경우, x축은 각도축이 되고 z축은 반경축이 됩니다. 막대 그래프에서는 극좌표 모드를 사용할 수 없습니다.

기본값은 false 입니다.

액세스 함수:

알림 신호:

orthoProjection 및 radialLabelOffset도 참조하십시오 .

[read-only] queriedGraphPosition : QVector3D

이 속성은 각 축에 따라 쿼리된 최신 그래프 위치 값을 포함합니다.

이 읽기 전용 속성은 ` Q3DScene::graphPositionQuery`에서 반환된 결과를 포함합니다. 값은 ` [-1, 1]` 범위로 정규화됩니다. 쿼리된 위치가 그래프 경계 외부에 있는 경우, 값은 실제 위치를 반영하지 않고 대신 ` [-1, 1]` 범위 외부의 정의되지 않은 위치를 나타냅니다. 쿼리가 수행될 때까지 값은 정의되지 않은 상태로 유지됩니다.

특정 화면 위치에 대응하는 단일한 올바른 3D 좌표는 없으므로, 일관성을 유지하기 위해 쿼리는 항상 그래프를 둘러싼 보이지 않는 상자의 안쪽 면을 기준으로 수행됩니다.

액세스 함수:

알림 신호:

Q3DScene::graphPositionQuery도 참조하십시오 .

radialLabelOffset : float

이 속성은 방사형 극좌표축의 축 레이블에 대한 정규화된 수평 오프셋을 저장합니다.

0.0 값은 레이블이 0각도 각도축 격자선 옆에 그려져야 함을 나타냅니다. 1.0 값은 레이블이 그래프 배경의 가장자리라는 일반적인 위치에 그려져야 함을 나타냅니다. 기본값은 1.0 입니다.

polar 속성 값이 false 인 경우 이 속성은 무시됩니다.

액세스 함수:

알림 신호:

polar도 참조하십시오 .

rotationEnabled : bool

이 속성은 해당 입력 핸들러가 그래프 회전을 허용하는지 여부를 나타냅니다.

기본값은 ` true`입니다.

액세스 함수:

알림 신호:

[read-only] scene : Q3DScene* const

이 속성은 씬을 조작하고 씬 요소에 접근하는 데 사용할 수 있는 씬 객체( Q3DScene ) 포인터를 포함합니다.

이 속성은 읽기 전용입니다.

액세스 함수:

[read-only] selectedElement : QtGraphs3D::ElementType

이 속성은 그래프에서 선택된 요소를 저장합니다.

이 속성은 선택된 요소의 유형을 조회하는 데 사용할 수 있습니다. 이 유형은 그래프에서 새로운 선택이 이루어지고 ‘ selectedElementChanged ’ 신호가 발생하기 전까지 유효합니다.

이 신호는 예를 들어, ‘ Scatter Graph ’ 탭의 Graph Gallery 예제에서 시연된 바와 같이 사용자 정의 입력 핸들러를 구현하는 데 사용할 수 있습니다.

액세스 함수:

알림 신호:

관련 항목: ` selectedLabelIndex()`, ` selectedAxis()`, ` selectedCustomItemIndex()`, ` selectedCustomItem()`, ` Q3DBarsWidgetItem::selectedSeries()`, ` Q3DScatterWidgetItem::selectedSeries()`, ` Q3DSurfaceWidgetItem::selectedSeries()` 및 ` Q3DScene::setSelectionQueryPosition()`.

selectionEnabled : bool

이 속성은 해당 입력 핸들러가 그래프에서 항목을 선택할 수 있도록 허용하는지 여부를 나타냅니다.

기본값은 ` true`입니다.

액세스 함수:

알림 신호:

selectionMode : QtGraphs3D::SelectionFlags

항목 선택 모드.

SelectionFlags의 조합입니다. 기본값은 Item 입니다. 그래프 유형에 따라 지원하는 선택 모드가 다릅니다.

액세스 함수:

알림 신호:

QtGraphs3D::SelectionFlags도 참조하십시오 .

shadowQuality : QtGraphs3D::ShadowQuality

이 속성은 그림자의 품질을 지정합니다.

ShadowQuality 열거형 값 중 하나입니다. 기본값은 Medium 입니다.

액세스 함수:

알림 신호:

QtGraphs3D::ShadowQuality도 참조하십시오 .

shadowStrength : float

이 속성은 그래프 전체의 그림자 농도를 결정합니다.

숫자가 클수록 그림자가 더 어두워집니다. 값은 0.0 과 100.0 사이여야 합니다.

이 값은 Q3DScene 에 지정된 조명에 영향을 미칩니다.

액세스 함수:

알림 신호:

[since 6.9] transparencyTechnique : QtGraphs3D::TransparencyTechnique

사용할 투명도 기법을 지정합니다. 기본값은 ` Default`입니다. 투명한 표면 그래프를 렌더링할 때는 ` Approximate ` 또는 ` Accurate`을 사용하십시오. 다른 그래프 유형의 경우 ` Default `을 사용해야 합니다.

이 열거형은 Qt 6.9에서 도입되었습니다.

액세스 함수:

알림 신호:

QtGraphs3D::TransparencyTechnique도 참조하십시오 .

wrapCameraXRotation : bool

이 속성은 X축 회전의 최소 및 최대 한계값에 대한 동작을 지정합니다.

true 로 설정하면 카메라의 X축 회전이 최소값에서 최대값으로, 최대값에서 최소값으로 반복됩니다. false 로 설정하면 카메라의 X축 회전이 최소값과 최대값으로 정의된 구간으로 제한됩니다. 기본값은 true 입니다.

액세스 함수:

알림 신호:

wrapCameraYRotation : bool

이 속성은 Y축 회전의 최소 및 최대 한계값에 대한 동작을 지정합니다.

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

액세스 함수:

알림 신호:

zoomAtTargetEnabled : bool

이 속성은 확대/축소 후 그래프의 확대된 지점이 동일한 위치에 유지되도록 카메라 대상을 변경해야 하는지 여부를 지정합니다.

기본값은 ` true`입니다.

액세스 함수:

알림 신호:

zoomEnabled : bool

이 속성은 해당 입력 핸들러가 그래프 확대/축소를 허용하는지 여부를 나타냅니다.

기본값은 true 입니다.

액세스 함수:

알림 신호:

QQuickWidget quickwidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickwidget);