이 페이지에서

Custom3DItem QML Type

그래프에 사용자 정의 항목을 추가합니다. 더 보기...

Import Statement: import QtGraphs
In C++: QCustom3DItem
Inherited By:

Custom3DLabel and Custom3DVolume

속성

신호

방법

상세 설명

커스텀 아이템에는 커스텀 메시, 위치, 크기, 회전 및 선택적 텍스처가 포함됩니다.

속성 설명서

meshFile : string

아이템 메쉬 파일 이름입니다. 파일 내의 아이템은 메쉬 형식이어야 합니다. 메쉬 파일에는 정점, 법선, UV 좌표가 포함되어 있는 것이 좋습니다.

position : vector3d

항목 위치는 ` vector3d`로 지정됩니다. 기본값은 ` vector3d(0.0, 0.0, 0.0)`입니다.

항목의 위치는 positionAbsolute 속성의 값에 따라 데이터 좌표 또는 절대 좌표로 지정됩니다. 절대 좌표를 사용할 경우, -1.0...1.0 사이의 값은 축 범위 내에 포함됩니다.

참고: positionAbsolute 가 false 인 경우, 축 범위 외부에 배치된항목은 렌더링되지 않습니다. 단, 해당 항목이 부분적으로 표시될 수 있는 Custom3DVolume 이고, scalingAbsolute 또한 false 인 경우는 예외입니다. 이 경우, 볼륨의 표시되는 부분이 렌더링됩니다.

positionAbsolute 및 scalingAbsolute도 참조하십시오 .

positionAbsolute : bool

항목의 위치를 데이터 좌표로 처리할지, 아니면 절대 좌표로 처리할지 지정합니다. 기본값은 ‘ false ’입니다. 절대 좌표를 가진 항목은 항상 렌더링되는 반면, 데이터 좌표를 가진 항목은 축 범위 내에 있을 때만 렌더링됩니다.

position도 참조하십시오 .

rotation : quaternion

quaternion 의 항목 순환. 기본값은 quaternion(0.0, 0.0, 0.0, 0.0) 입니다.

rotationAbsolute : bool [since 6.11]

항목의 회전을 데이터 값으로 처리할지, 아니면 절대값으로 처리할지 정의합니다. 기본값은 ‘ true ’입니다. 절대 회전 값을 가진 항목은 축에 관계없이 기본 좌표에 따라 회전합니다. 데이터 회전 값을 가진 항목은 축 좌표에 따라 회전합니다.

이 속성은 Qt 6.11에서 도입되었습니다.

rotation도 참조하십시오 .

scaling : vector3d

항목 스케일링은 ‘ vector3d ’ 유형으로 지정됩니다. 기본값은 ‘ vector3d(0.1, 0.1, 0.1) ’입니다.

항목 스케일링은 scalingAbsolute 속성의 값에 따라 데이터 값 또는 절대값으로 지정됩니다. 절대값으로 해석되는 기본 벡터는 항목 메쉬가 정규화되어 있고 그래프의 종횡비가 기본값에서 변경되지 않은 경우, 항목을 그래프 높이의 10%로 설정합니다.

참고: ` Custom3DLabel ` 항목이나 ` polar ` 그래프에서 사용되는 사용자 정의 항목의 경우 절대 스케일링만 지원됩니다.

참고: Qt 6.8에서는 모델이 실제로는 크기 2(-1...1)로 스케일링되었음에도 불구하고, 기본적으로 크기 1(-0.5...0.5)로 스케일링된 것으로 잘못 가정되었습니다. 이 때문에 Qt 6.9부터 모든 사용자 정의 항목의 크기는 Qt 6.8에 비해 두 배가 됩니다.

scalingAbsolute도 참조하십시오 .

scalingAbsolute : bool

항목의 크기 조정을 데이터 값으로 처리할지, 아니면 절대 값으로 처리할지 지정합니다. 기본값은 ‘ true ’입니다. 절대 크기 조정이 적용된 항목은 축의 범위에 관계없이 동일한 크기로 표시됩니다. 데이터 스케일링이 적용된 항목은 축 범위에 따라 표시 크기가 달라집니다. positionAbsolute 가 true 인 경우, 이 속성은 무시되고 스케일링은 절대값으로 해석됩니다. 항목에 회전(rotation)이 적용된 경우, 데이터 스케일링은 회전되지 않은 항목을 기준으로 계산됩니다. 마찬가지로, Custom3DVolume 항목의 경우에도 범위 클리핑은 회전되지 않은 항목을 기준으로 계산됩니다.

참고: Custom3DLabel 항목이나 polar 그래프에서 사용되는 사용자 정의 항목의 경우 절대 스케일링만 지원됩니다.

참고: 사용자 정의 항목의메시는 [-1 ,1] 범위로 정규화되어야 하며, 그렇지 않으면 데이터 스케일링이 정확하지 않을 수 있습니다.

scaling 및 positionAbsolute도 참조하십시오 .

shadowCasting : bool

해당 아이템의 그림자 투영 기능이 활성화되어 있는지 여부를 지정합니다. 기본값은 ` true`입니다. ` false`인 경우, ` ShadowQuality` 설정과 관계없이 해당 아이템은 그림자를 투영하지 않습니다.

textureFile : string

아이템의 텍스처 파일 이름입니다. 설정하지 않으면 단색 회색 텍스처가 사용됩니다.

참고: 메모리를 절약하기위해 , 파일에서 불러온 ` QImage `는 텍스처가 생성된 후 지워집니다.

visible : bool

항목의 표시 여부입니다. 기본값은 ‘ true ’입니다.

Signal 문서

meshFileChanged(string meshFile)

이 신호는 meshFile 이 meshFile 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onMeshFileChanged 입니다.

positionAbsoluteChanged(bool positionAbsolute)

이 신호는 positionAbsolute 가 positionAbsolute 로 변경될 때 발생합니다.

참고: 이에 대응하는핸들러는 onPositionAbsoluteChanged 입니다.

positionChanged(vector3d position)

이 신호는 항목 position 이 position 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onPositionChanged 입니다.

rotationChanged(quaternion rotation)

이 신호는 ‘ rotation ’가 ‘ rotation ’로 변경될 때 발생합니다.

참고: 해당 핸들러는 onRotationChanged 입니다.

scalingAbsoluteChanged(bool scalingAbsolute)

이 신호는 scalingAbsolute 가 scalingAbsolute 로 변경될 때 발생합니다.

참고: 이에 대응하는핸들러는 onScalingAbsoluteChanged 입니다.

scalingChanged(vector3d scaling)

이 신호는 scaling 가 scaling 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onScalingChanged 입니다.

shadowCastingChanged(bool shadowCasting)

이 신호는 shadowCasting 이 shadowCasting 로 변경될 때 발생합니다.

참고: 이에 대응하는핸들러는 onShadowCastingChanged 입니다.

textureFileChanged(string textureFile)

이 신호는 textureFile 이 textureFile 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onTextureFileChanged 입니다.

visibleChanged(bool visible)

이 신호는 visible 이 visible 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onVisibleChanged 입니다.

메서드 문서

void setRotationAxisAndAngle(vector3d axis, real angle)

axis 와 angle 를 사용하여 회전 쿼터니언을 생성하는 편리한 함수입니다.

rotation도 참조하십시오 .

© 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.