Surface3DSeries QML Type

데이터 계열을 3D 표면 그래프로 표시합니다. 자세히...

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

상속된 멤버를 포함한 모든 멤버 목록
Surface3DSeries는 Qt Graphs 3D용 QML 유형의 일부입니다.

속성

baseColor : color
baseGradient : Gradient
colorStyle : GraphsTheme.ColorStyle
dataArray : SurfaceDataArray
dataProxy : SurfaceDataProxy
drawMode : DrawFlag
flatShadingSupported : bool
invalidSelectionPosition : point
itemLabel : string
itemLabelFormat : string
itemLabelVisible : bool
mesh : Abstract3DSeries.Mesh
meshRotation : quaternion
meshSmooth : bool
multiHighlightColor : color
multiHighlightGradient : Gradient
name : string
selectedPoint : point
shading : Shading
singleHighlightColor : color
singleHighlightGradient : Gradient
textureFile : string
type : Abstract3DSeries.SeriesType
userDefinedMesh : string
visible : bool
wireframeColor : color

신호

baseColorChanged(color color)
baseGradientChanged(Gradient gradient)
colorStyleChanged(GraphsTheme.ColorStyle style)
dataArrayChanged(SurfaceDataArray array)
dataProxyChanged(SurfaceDataProxy proxy)
drawModeChanged(DrawFlag mode)
flatShadingSupportedChanged(bool enable)
itemLabelChanged(string label)
itemLabelFormatChanged(string format)
itemLabelVisibilityChanged(bool visible)
meshChanged(Abstract3DSeries.Mesh mesh)
meshRotationChanged(quaternion rotation)
meshSmoothChanged(bool enabled)
multiHighlightColorChanged(color color)
multiHighlightGradientChanged(Gradient gradient)
nameChanged(string name)
selectedPointChanged(point position)
shadingChanged(const Shading shading)
singleHighlightColorChanged(color color)
singleHighlightGradientChanged(Gradient gradient)
textureFileChanged(string filename)
userDefinedMeshChanged(string fileName)
visibilityChanged(bool visible)
wireframeColorChanged(color color)

방법

void setMeshAxisAndAngle(vector3d axis, real angle)

상세 설명

이 유형은 시리즈별 시각적 요소와 시리즈 데이터(데이터 프록시를 통해)를 관리합니다.

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

xTitle	x축의 제목
@yTitle	y축의 제목
@zTitle	z축의 제목
@xLabel	x축의 형식을 사용하여 서식이 지정된 항목 값입니다. 자세한 내용은 labelFormat 을 참조하세요.
@yLabel	y축의 형식을 사용하여 서식이 지정된 항목 값입니다. 자세한 내용은 labelFormat 을 참조하세요.
@zLabel	z축의 형식을 사용하여 서식이 지정된 항목 값입니다. 자세한 내용은 labelFormat 을 참조하세요.
시리즈 이름	시리즈의 이름

자세한 설명은 QSurface3DSeries 을 참조하세요.

또한 Qt Graphs 3D로 데이터 처리하기를참조하세요 .

속성 문서

baseColor : color

시리즈의 기본 색상을 설정합니다.

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

baseGradient : Gradient

계열의 기본 그라데이션을 설정합니다.

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

colorStyle : GraphsTheme.ColorStyle

시리즈의 색상 스타일을 설정합니다.

GraphsTheme.ColorStyle참조 .

dataArray : SurfaceDataArray

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

dataArrayChanged newDataArray 이 이전과 동일하지 않는 한 데이터 배열이 설정되면 신호가 전송됩니다.

참고: 데이터 배열과 관련된 작업을 수행하기 전에 관련 프록시에 대한 시리즈를 만들어야 합니다.

dataProxy : SurfaceDataProxy

활성 데이터 프록시입니다. 시리즈는 여기에 설정된 모든 프록시의 소유권을 가지며 새 프록시가 추가되면 이전에 설정된 모든 프록시를 삭제합니다. 프록시는 null이거나 다른 시리즈로 설정할 수 없습니다.

drawMode : DrawFlag

그리기 모드를 Surface3DSeries.DrawFlag 중 하나로 설정합니다. 모든 플래그를 지우는 것은 허용되지 않습니다.

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 을참조하십시오 .

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 입니다.

meshChanged(Abstract3DSeries.Mesh mesh)

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

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

meshRotationChanged(quaternion rotation)

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

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

meshSmoothChanged(bool enabled)

meshSmooth 이 enabled 으로 변경될 때 이 신호가 전송됩니다.

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

멀티 하이라이트 컬러 변경(color color)

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

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

multiHighlightGradientChanged(Gradient gradient)

multiHighlightGradient 이 gradient 으로 변경될 때 이 신호가 전송됩니다.

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

nameChanged(string name)

name 이 name 으로 변경될 때 이 신호가 전송됩니다.

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

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도 참조하십시오 .

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