Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

Surface3DSeries QML Type (Uncreatable)

3D 표면 그래프에서 데이터 시계를 나타냅니다. 더 보기...

Import Statement: import QtGraphs
In C++: QSurface3DSeries
Inherits:

Abstract3DSeries

참고: 이 유형은 생성할 수 없는 유형입니다. QML에서 인스턴스화할 수 없습니다.

속성

신호

방법

상세 설명

이 유형은 시리즈 데이터(데이터 프록시를 통해)뿐만 아니라 시리즈 고유의 시각적 요소도 관리합니다.

Surface3DSeries는 itemLabelFormat에 대해 다음 형식 태그를 지원합니다:

@xTitlex축의 제목
@yTitley축의 제목
@zTitlez축의 제목
@xLabelx축의 서식을 사용하여 형식이 지정된 항목 값입니다. 자세한 내용은 labelFormat 을 참조하십시오.
@yLabely축의 서식을 사용하여 서식화된 항목 값입니다. 자세한 내용은 labelFormat 을 참조하십시오.
@zLabelz축의 서식을 사용하여 서식화된 항목 값입니다. 자세한 내용은 labelFormat 를 참조하십시오.
@seriesName시리즈의 이름

더 자세한 설명은 QSurface3DSeries 을 참조하십시오.

Qt Graphs 의 3D 데이터 처리 항목도 참조하십시오 .

속성 설명서

baseColor : color

이 시리즈의 기본 색상입니다.

colorStyle 및 GraphsTheme.seriesColors도 참조하십시오 .

baseGradient : Gradient

이 수열의 기본 기울기.

colorStyle도 참조하십시오 .

colorStyle : GraphsTheme.ColorStyle

이 시리즈의 색상 스타일.

GraphsTheme.ColorStyle도 참조하십시오 .

dataArray : SurfaceDataArray

데이터 배열의 참조를 보관합니다.

dataArrayChanged newDataArray 가 이전 것과 동일하지 않은 경우, 데이터 배열이 설정되면 신호가 발신됩니다.

참고: dataArray와 관련된 작업을 수행하기전에 , 해당 프록시에 대한 시리얼을 생성해야 합니다.

dataProxy : SurfaceDataProxy

활성 데이터 프록시. 이 시계열은 자신에게 설정된 모든 프록시에 대한 소유권을 가지며, 새로운 프록시가 추가되면 이전에 설정된 프록시를 모두 삭제합니다. 프록시는 null이거나 다른 시계열로 설정되어서는 안 됩니다.

drawMode : DrawFlag

Surface3DSeries.DrawFlag{QSurface3DSeries.DrawFilledSurface} 중 하나로 그리기 모드를 설정합니다. DrawWireframe 또는 DrawSurface 중 하나는 반드시 설정되어야 합니다.

flatShadingSupported : bool [read-only]

현재 시스템에서 표면의 플랫 셰이딩을 지원하는지 여부를 나타냅니다. 이를 사용하려면 GL_EXT_gpu_shader4 확장 기능이 포함된 GLSL 버전 1.2 이상이 필요합니다.

참고: 이 읽기 전용 속성은 첫 번째 렌더링 패스가 끝난 후에야 올바른 값으로 설정됩니다. 그 전까지는 항상 ` true`으로 설정되어 있습니다.

invalidSelectionPosition : point [read-only]

잘못된 선택 위치를 반환하는 상수 속성입니다. 이 위치는 selectedPoint 속성에 할당되어 이 시리즈에서 선택 상태를 지웁니다.

GraphsItem3D::clearSelection()도 참조하십시오 .

itemLabel : string [read-only]

서식이 적용된 항목 레이블입니다. 선택된 항목이 없거나 선택된 항목이 표시되지 않는 경우, 빈 문자열을 반환합니다.

itemLabelFormat도 참조하십시오 .

itemLabelFormat : string

이 시리즈의 데이터 항목에 대한 레이블 형식입니다. 이 형식은 단일 항목 레이블에 사용되며, 예를 들어 항목이 선택되었을 때 적용됩니다. 이 형식이 어떻게 해석되는지는 시리즈 유형에 따라 다릅니다.

Bar3DSeries, Scatter3DSeries 및 Surface3DSeries도 참조하십시오 .

itemLabelVisible : bool

true 인 경우, 항목 레이블은 그래프에 플로팅 레이블로 표시됩니다. 그렇지 않은 경우, 항목 레이블은 표시되지 않습니다. 외부 컨트롤에 항목 레이블을 표시하려면 이 속성을 false 로 설정합니다. 기본값은 true 입니다.

itemLabelFormat 및 itemLabel도 참조하십시오 .

lightingMode : Abstract3DSeries.LightingMode [since 6.10]

시리즈 내 항목의 조명 모드입니다. 기본값은 QAbstract3DSeries::LightingMode::Shaded

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

QAbstract3DSeries::LightingMode도 참조하십시오 .

mesh : Abstract3DSeries.Mesh

시리즈에 포함된 항목의 메쉬, 또는 Surface3DSeries 의 경우 선택 포인터입니다. 메쉬가 Abstract3DSeries.Mesh.UserDefined 인 경우, 항목이 올바르게 렌더링되려면 userDefinedMesh 속성도 설정해야 합니다. 기본값은 그래프 유형에 따라 다릅니다.

QAbstract3DSeries::Mesh도 참조하십시오 .

meshRotation : quaternion

시리즈의 모든 항목에 적용되는 메쉬 회전입니다. 회전 값은 정규화된 쿼터니언이어야 합니다. 항목별 회전을 지원하는 시리즈 유형의 경우, 각 회전이 서로 곱해집니다. ` Bar3DSeries `은 y축을 중심으로 하지 않는 회전은 모두 무시합니다. ` Surface3DSeries `은 선택 포인터에만 회전을 적용합니다. 기본값은 회전 없음입니다.

meshSmooth : bool

true 인 경우, mesh 속성을 통해 설정된 사전 정의된 메쉬의 스무딩 버전이 사용됩니다. 이 속성은 메쉬가 Abstract3DSeries.Mesh.UserDefined 로 설정되었을 때 사용되는 사용자 정의 메쉬에는 영향을 미치지 않습니다. 기본값은 false 입니다.

multiHighlightColor : color

시리즈의 여러 항목을 강조 표시하는 색상입니다.

colorStyle 및 GraphsTheme.multiHighlightColor도 참조하십시오 .

multiHighlightGradient : Gradient

이 시리즈의 여러 항목을 강조 표시하는 그라데이션.

colorStyle 및 GraphsTheme.multiHighlightGradient도 참조하십시오 .

name : string

시리즈 이름. 이 이름은 @seriesName 태그와 함께 항목 레이블 형식으로 사용할 수 있습니다.

itemLabelFormat도 참조하십시오 .

selectedPoint : point

시리즈의 데이터 배열에서 행과 열로 지정된 위치에 있는 표면 격자점을 선택된 점으로 설정합니다. 한 번에 하나의 점만 선택할 수 있습니다.

이 시리즈에서 선택을 해제하려면 위치로 ` invalidSelectionPosition `을 할당하십시오. 이 시리즈가 그래프에 추가된 경우, 그래프는 사용자 상호작용에 따라 또는 선택이 무효화될 때 선택을 조정할 수 있습니다.

선택된 점의 행 앞뒤로 행을 제거하거나 삽입하면, 동일한 점이 계속 선택되도록 선택 상태가 조정됩니다.

GraphsItem3D::clearSelection()도 참조하십시오 .

shading : Shading

표면의 플랫 셰이딩을 ‘표시’로 설정합니다. 기본값은 ‘ Surface3DSeries.Shading.Flat ’로 설정되어 있습니다. 비활성화되면 표면의 법선 벡터가 보간되어 모서리가 둥글게 보입니다. ‘표시’로 설정되면 삼각형 내의 법선 벡터가 동일하게 유지되어 삼각형의 색상이 균일하게 나타납니다. 이를 통해 모델의 데이터를 더 명확하게 파악할 수 있습니다.

참고: 플랫 셰이딩 표면을 사용하려면 GL_EXT_gpu_shader4 확장이 포함된 GLSL 버전 1.2 이상이 필요합니다. flatShadingSupported 속성의 값은 런타임 시 플랫 셰이딩이 지원되는지 여부를 나타냅니다.

singleHighlightColor : color

이 시리즈의 개별 항목 강조 색상입니다.

colorStyle 및 GraphsTheme.singleHighlightColor도 참조하십시오 .

singleHighlightGradient : Gradient

이 시리즈의 단일 아이템 하이라이트 그라데이션.

colorStyle 및 GraphsTheme.singleHighlightGradient도 참조하십시오 .

textureFile : string

표면 텍스처의 텍스처 파일 이름입니다. 텍스처를 지우려면 빈 파일 이름을 설정합니다.

type : Abstract3DSeries.SeriesType [read-only]

시리즈의 유형. ` QAbstract3DSeries::SeriesType ` 값 중 하나.

userDefinedMesh : string

mesh 가 사용될 때 오브젝트에 대한 사용자 정의 메쉬의 파일 이름은 Abstract3DSeries.Mesh.UserDefined 입니다.

참고: 파일은 QtQuick3D 메쉬 형식이어야 합니다. 다른 3D 모델 형식의 메쉬를 생성하려면 balsam 변환 도구를 사용하십시오.

visible : bool

시리즈의 표시 여부. ` false`인 경우, 해당 시리즈는 표시되지 않습니다.

wireframeColor : color

표면 와이어프레임의 격자선을 그리는 데 사용되는 색상입니다.

신호 문서

baseColorChanged(color color)

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

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

baseGradientChanged(Gradient gradient)

이 신호는 baseGradient 이 gradient 으로 변경될 때 발생합니다.

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

colorStyleChanged(GraphsTheme.ColorStyle style)

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

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

dataArrayChanged(SurfaceDataArray array)

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

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

dataProxyChanged(SurfaceDataProxy proxy)

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

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

drawModeChanged(DrawFlag mode)

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

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

flatShadingSupportedChanged(bool enable)

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

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

itemLabelChanged(string label)

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

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

itemLabelFormatChanged(string format)

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

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

itemLabelVisibilityChanged(bool visible)

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

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

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

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

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

이 신호는 Qt 6.10에서 도입되었습니다.

meshChanged(Abstract3DSeries.Mesh mesh)

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

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

meshRotationChanged(quaternion rotation)

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

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

meshSmoothChanged(bool enabled)

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

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

multiHighlightColorChanged(color color)

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

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

multiHighlightGradientChanged(Gradient gradient)

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

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

nameChanged(string name)

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

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

rowsSanitizedChanged(bool enabled)

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

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

selectedPointChanged(point position)

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

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

shadingChanged(const Shading shading)

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

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

singleHighlightColorChanged(color color)

이 신호는 singleHighlightColor 이 color 으로 변경될 때 발생합니다.

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

singleHighlightGradientChanged(Gradient gradient)

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

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

textureFileChanged(string filename)

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

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

userDefinedMeshChanged(string fileName)

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

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

visibilityChanged(bool visible)

이 신호는 시리즈의 표시 상태가 ‘ visible ’로 변경될 때 발생합니다.

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

wireframeColorChanged(color color)

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

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

메서드 문서

void setMeshAxisAndAngle(vector3d axis, real angle)

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

meshRotation도 참조하십시오 .

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