Q3DGraphsWidgetItem Class

프로퍼티 문서

activeTheme : QGraphsTheme*

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

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

activeTheme 이 null이면 임시 기본 테마가 만들어집니다. 이 임시 테마는 나중에 테마를 명시적으로 설정하면 삭제됩니다. 테마를 설정한 후에도 테마의 속성을 수정할 수 있으며 수정 사항은 즉시 적용됩니다.

기능 액세스:

알림 신호:

ambientLightStrength : float

이 속성은 전체 그래프에 대한 주변광 강도를 유지합니다.

이 값은 조명 위치에 관계없이 그래프 전체에 색상이 얼마나 균일하고 밝게 표시되는지를 결정합니다.

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

기능에 액세스합니다:

알림 신호:

aspectRatio : qreal

이 속성은 가로 평면에서 가장 긴 축과 y축 사이의 그래프 배율 비율을 유지합니다.

기본값은 2.0 입니다.

기능에 액세스합니다:

알림 신호:

horizontalAspectRatio 를참조하세요 .

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 : const int

이 프로퍼티에는 지난 1초 동안의 렌더링 결과가 저장됩니다.

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

기능 액세스:

알림 신호:

measureFps 를참조하세요 .

gridLineType : QtGraphs3D::GridLineType

이 속성은 격자선 유형이 QtGraphs3D::GridLineType::Shader 또는 QtGraphs3D::GridLineType::Geometry 인지 여부를 보유합니다.

이 값은 모든 격자선에 영향을 줍니다.

액세스 함수:

알림 신호:

QtGraphs3D::GridLineType 를참조하세요 .

horizontalAspectRatio : qreal

이 속성은 X축과 Z축 사이의 그래프 배율 비율을 보유합니다.

0.0 값은 축 범위에 따른 자동 배율을 나타냅니다. 기본값은 0.0 입니다.

barThickness 및 barSpacing 속성을 통해 가로 평면에서 배율을 처리하는 Q3DBarsWidgetItem 에는 영향을 미치지 않습니다. 극좌표 그래프도 이 속성을 무시합니다.

기능에 접근합니다:

알림 신호:

aspectRatio, polar, Q3DBarsWidgetItem::barThickness, Q3DBarsWidgetItem::barSpacing 을참조하세요 .

labelMargin : float

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

음수 값은 레이블을 플롯 영역 안쪽에 배치하고 양수 값은 플롯 영역 바깥쪽에 배치합니다. 값이 음수이면 레이블 자동 회전이 비활성화됩니다. 기본값은 다음과 같습니다. 0.1

기능에 액세스합니다:

알림 신호:

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 회전 각도(도)를 보유합니다.

기능에 액세스합니다:

알림 신호:

maxCameraYRotation : float

이 프로퍼티는 대상 지점을 중심으로 카메라의 최대 Y 회전 각도를 도 단위로 저장합니다.

함수에 액세스합니다:

알림 신호:

maxCameraZoomLevel : float

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

최대 레벨이 기존 최소 레벨보다 낮은 새 값으로 설정되면 최소 레벨도 새 최대 레벨로 조정됩니다. 현재 cameraZoomLevel 이 새 범위를 벗어나면 이 값도 조정됩니다. 기본값은 500.0f 입니다.

기능에 액세스합니다:

알림 신호:

cameraZoomLevel 및 minCameraZoomLevel 을참조하세요 .

measureFps : bool

이 속성은 렌더링이 온디맨드가 아닌 연속적으로 수행되는지 여부를 보유합니다.

true 인 경우 렌더링이 계속되고 currentFps 속성 값이 업데이트됩니다. 기본값은 false 입니다.

함수 액세스:

알림 신호:

currentFps 를참조하세요 .

minCameraXRotation : float

이 속성은 대상 지점을 중심으로 카메라의 최소 X 회전 각도(도)를 유지합니다.

기능에 액세스합니다:

알림 신호:

minCameraYRotation : float

이 프로퍼티는 대상 지점을 중심으로 카메라의 최소 Y 회전 각도(도)를 유지합니다.

함수에 액세스합니다:

알림 신호:

minCameraZoomLevel : float

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

최소 레벨이 기존 최대 레벨보다 높은 새 값으로 설정되면 최대 레벨도 새 최소 레벨로 조정됩니다. 현재 줌 레벨이 새 범위를 벗어나면 이 값도 조정됩니다. 최소 카메라 줌 레벨은 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 를참조하세요 .

polar : bool

이 속성은 가로축이 극축으로 변경되는지 여부를 유지합니다.

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

기본값은 false 입니다.

기능에 접근합니다:

통지 신호:

orthoProjection 및 radialLabelOffset 을참조하세요 .

[read-only] queriedGraphPosition : const 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 : const QtGraphs3D::ElementType

이 속성은 그래프에서 선택한 요소를 보유합니다.

이 속성은 선택한 요소 유형을 쿼리하는 데 사용할 수 있습니다. 이 유형은 그래프에서 새 선택이 이루어지고 selectedElementChanged 신호가 전송될 때까지 유효합니다.

이 신호는 예를 들어 그래프 갤러리의 Scatter Graph 탭 아래 예시된 것처럼 사용자 지정 입력 핸들러를 구현하는 데 사용할 수 있습니다.

기능에 액세스합니다:

알림 신호:

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 에 지정된 조명에 영향을 줍니다.

기능에 액세스합니다:

알림 신호:

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);