Custom3DItem QML Type
그래프에 사용자 지정 항목을 추가합니다. 더 보기...
Import Statement: | import QtGraphs |
In C++: | QCustom3DItem |
Inherited By: |
- 상속된 멤버를 포함한 모든 멤버 목록
- Custom3DItem은 Qt Graphs 3D용 QML 유형에 포함되어 있습니다.
속성
- meshFile : string
- position : vector3d
- positionAbsolute : bool
- rotation : quaternion
- scaling : vector3d
- scalingAbsolute : bool
- shadowCasting : bool
- textureFile : string
- visible : bool
신호
- meshFileChanged(string meshFile)
- positionAbsoluteChanged(bool positionAbsolute)
- positionChanged(vector3d position)
- rotationChanged(quaternion rotation)
- scalingAbsoluteChanged(bool scalingAbsolute)
- scalingChanged(vector3d scaling)
- shadowCastingChanged(bool shadowCasting)
- textureFileChanged(string textureFile)
- visibleChanged(bool visible)
방법
- void setRotationAxisAndAngle(vector3d axis, real angle)
상세 설명
커스텀 아이템에는 커스텀 메시, 위치, 스케일, 회전, 텍스처 옵션이 있습니다.
속성 문서
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)
입니다.
scaling : vector3d |
vector3d 유형으로 항목 크기 조정. 기본값은 vector3d(0.1, 0.1, 0.1)
입니다.
항목 배율은 scalingAbsolute 속성의 값에 따라 데이터 값 또는 절대값으로 지정됩니다. 절대값으로 해석되는 기본 벡터는 항목 메쉬가 정규화되어 있고 그래프 가로 세로 비율이 기본값에서 변경되지 않은 경우 항목을 그래프 높이의 10%로 설정합니다.
scalingAbsolute 를참조하세요 .
scalingAbsolute : bool |
항목 배율을 데이터 값으로 처리할지 절대 값으로 처리할지 정의합니다. 기본값은 true
입니다. 절대 배율을 사용하는 항목은 축 범위에 관계없이 동일한 크기로 렌더링됩니다. 데이터 배율이 있는 항목은 축 범위에 따라 겉보기 크기가 변경됩니다. positionAbsolute 가 true
인 경우 이 속성은 무시되고 배율은 절대값으로 해석됩니다. 항목에 회전이 있는 경우 데이터 배율은 회전되지 않은 항목에 대해 계산됩니다. 마찬가지로 Custom3DVolume 항목의 경우 회전되지 않은 항목에 대해 범위 클리핑이 계산됩니다.
참고: Custom3DLabel 항목 또는 polar 그래프에 사용되는 사용자 지정 항목에는 절대 배율만 지원됩니다.
참고: 사용자 지정 항목의 메쉬는 [-1 ,1]
범위로 정규화해야 하며, 그렇지 않으면 데이터 배율이 정확하지 않습니다.
scaling 및 positionAbsolute 을참조하세요 .
shadowCasting : bool |
항목의 그림자 드리우기 활성화 여부를 정의합니다. 기본값은 true
입니다. false
인 경우 ShadowQuality 에 관계없이 항목이 그림자를 드리우지 않습니다.
textureFile : string |
항목의 텍스처 파일 이름입니다. 설정하지 않으면 단색 회색 텍스처가 사용됩니다.
참고: 메모리를 절약하기 위해 텍스처가 생성된 후 파일에서 로드된 QImage 은 지워집니다.
visible : bool |
항목의 가시성입니다. 기본값은 true
입니다.
신호 문서
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
입니다.
메서드 문서
axis 와 angle 에서 회전 쿼터니언을 구성하는 편의 함수입니다.
rotation도 참조하십시오 .
© 2025 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.