Represents a data series in a 3D surface graph. 更多...
| import 语句： |
import QtGraphs
|
| 在 C++： | QSurface3DSeries |
| 继承： |
This type manages the series specific visual elements, as well as the series data (via a data proxy).
Surface3DSeries supports the following format tags for itemLabelFormat:
| @xTitle | Title from x-axis |
| @yTitle | Title from y-axis |
| @zTitle | Title from z-axis |
| @xLabel | Item value formatted using the format of the x-axis. For more information, see labelFormat . |
| @yLabel | Item value formatted using the format of the y-axis. For more information, see labelFormat . |
| @zLabel | Item value formatted using the format of the z-axis. For more information, see labelFormat . |
| @seriesName | Name of the series |
For a more complete description, see QSurface3DSeries .
另请参阅 Qt Graphs Data Handling with 3D .
|
baseColor : color |
Sets the base color of the series.
另请参阅 colorStyle and GraphsTheme.seriesColors .
|
baseGradient : Gradient |
Sets the base gradient of the series.
另请参阅 colorStyle and GraphsTheme.seriesGradients.
|
colorStyle : GraphsTheme . ColorStyle |
Sets the color style for the series.
另请参阅 GraphsTheme.ColorStyle .
|
dataArray : SurfaceDataArray |
Holds the reference of the data array.
dataArrayChanged signal is emitted when data array is set, unless newDataArray is identical to the previous one.
注意： Before doing anything regarding the dataArray, a series must be created for the relevant proxy.
|
dataProxy : SurfaceDataProxy |
The active data proxy. The series assumes ownership of any proxy set to it and deletes any previously set proxy when a new one is added. The proxy cannot be null or set to another series.
|
drawMode : DrawFlag |
Sets the drawing mode to one of Surface3DSeries.DrawFlag . Clearing all flags is not allowed.
|
flatShadingSupported
:
bool
|
Indicates whether flat shading for surfaces is supported by the current system. It requires at least GLSL version 1.2 with GL_EXT_gpu_shader4 extension.
注意：
This read-only property is set to its correct value after the first render pass. Until then it is always
true
.
|
invalidSelectionPosition
:
point
|
A constant property providing an invalid selection position. This position is assigned to the selectedPoint property to clear the selection from this series.
另请参阅 GraphsItem3D::clearSelection ().
|
itemLabel
:
string
|
The formatted item label. If there is no selected item or the selected item is not visible, returns an empty string.
另请参阅 itemLabelFormat .
|
itemLabelFormat : string |
The label format for data items in this series. This format is used for single item labels, for example, when an item is selected. How the format is interpreted depends on series type.
另请参阅 Bar3DSeries , Scatter3DSeries ，和 Surface3DSeries .
|
itemLabelVisible : bool |
若
true
, item labels are drawn as floating labels in the graph. Otherwise, item labels are not drawn. To show the item label in an external control, this property is set to
false
。默认为
true
.
另请参阅 itemLabelFormat and itemLabel .
|
mesh : Abstract3DSeries . Mesh |
Sets the mesh of the items in the series, or the selection pointer in case of Surface3DSeries . If the mesh is Abstract3DSeries.Mesh.UserDefined , then the userDefinedMesh property must also be set for items to render properly. The default value depends on the graph type.
另请参阅 QAbstract3DSeries::Mesh .
|
meshRotation : quaternion |
Sets the mesh rotation that is applied to all items of the series. The rotation should be a normalized quaternion. For those series types that support item specific rotation, the rotations are multiplied together. Bar3DSeries ignores any rotation that is not around the y-axis. Surface3DSeries applies the rotation only to the selection pointer. Defaults to no rotation.
|
meshSmooth : bool |
若
true
, smooth versions of predefined meshes set via the
mesh
property are used. This property does not affect custom meshes used when the mesh is set to
Abstract3DSeries.Mesh.UserDefined
。默认为
false
.
|
multiHighlightColor : color |
Sets the multiple item highlight color of the series.
另请参阅 colorStyle and GraphsTheme.multiHighlightColor .
|
multiHighlightGradient : Gradient |
Sets the multiple item highlight gradient of the series.
另请参阅 colorStyle and GraphsTheme.multiHighlightGradient .
|
name : string |
The series name. It can be used in item label format with the tag
@seriesName
.
另请参阅 itemLabelFormat .
|
selectedPoint : point |
Sets the surface grid point in the position specified by a row and a column in the data array of the series as selected. Only one point can be selected at a time.
To clear the selection from this series, assign invalidSelectionPosition as the position. If this series is added to a graph, the graph can adjust the selection according to user interaction or if it becomes invalid.
Removing rows from or inserting rows into the series before the row of the selected point will adjust the selection so that the same point will stay selected.
另请参阅 GraphsItem3D::clearSelection ().
|
shading : Shading |
Sets surface flat shading to visible. It is preset to
Surface3DSeries.Shading.Flat
by default. When disabled, the normals on the surface are interpolated making the edges look round. When visible, the normals are kept the same on a triangle making the color of the triangle solid. This makes the data more readable from the model.
注意： Flat shaded surfaces require at least GLSL version 1.2 with GL_EXT_gpu_shader4 extension. The value of the flatShadingSupported property indicates whether flat shading is supported at runtime.
|
singleHighlightColor : color |
Sets the single item highlight color of the series.
另请参阅 colorStyle and GraphsTheme.singleHighlightColor .
|
singleHighlightGradient : Gradient |
Sets the single item highlight gradient of the series.
另请参阅 colorStyle and GraphsTheme.singleHighlightGradient .
|
textureFile : string |
The texture file name for the surface texture. To clear the texture, an empty file name is set.
|
type
:
Abstract3DSeries
.
SeriesType
|
The type of the series. One of the QAbstract3DSeries::SeriesType 值。
|
userDefinedMesh : string |
Sets the filename for a user defined custom mesh for objects that is used when mesh is Abstract3DSeries.Mesh.UserDefined .
注意：
The file needs to be in the
QtQuick3D
mesh format. Use the
balsam
conversion tool to create a mesh from other 3D model formats.
|
visible : bool |
Sets the visibility of the series. If
false
, the series is not rendered.
|
wireframeColor : color |
The color used to draw the gridlines of the surface wireframe.
|
baseColorChanged ( color color ) |
此信号发射，当 baseColor changes to color .
注意：
相应处理程序是
onBaseColorChanged
.
|
baseGradientChanged ( Gradient gradient ) |
此信号发射，当 baseGradient changes to gradient .
注意：
相应处理程序是
onBaseGradientChanged
.
|
colorStyleChanged ( GraphsTheme . ColorStyle style ) |
此信号发射，当 colorStyle changes to style .
注意：
相应处理程序是
onColorStyleChanged
.
|
dataArrayChanged ( SurfaceDataArray array ) |
此信号发射，当 dataArray changes to array .
注意：
相应处理程序是
onDataArrayChanged
.
|
dataProxyChanged ( SurfaceDataProxy proxy ) |
此信号发射，当 dataProxy changes to proxy .
注意：
相应处理程序是
onDataProxyChanged
.
|
drawModeChanged ( DrawFlag mode ) |
此信号发射，当 drawMode changes to mode .
注意：
相应处理程序是
onDrawModeChanged
.
|
flatShadingSupportedChanged ( bool enable ) |
此信号发射，当 flatShadingSupported changes to enable .
注意：
相应处理程序是
onFlatShadingSupportedChanged
.
|
itemLabelChanged ( string label ) |
此信号发射，当 itemLabel changes to label .
注意：
相应处理程序是
onItemLabelChanged
.
|
itemLabelFormatChanged ( string format ) |
此信号发射，当 itemLabelFormat changes to format .
注意：
相应处理程序是
onItemLabelFormatChanged
.
|
itemLabelVisibilityChanged ( bool visible ) |
This signal is emitted when itemLabelVisibility changes to visible .
注意：
相应处理程序是
onItemLabelVisibilityChanged
.
|
meshChanged ( Abstract3DSeries . Mesh mesh ) |
此信号发射，当 mesh changes to mesh .
注意：
相应处理程序是
onMeshChanged
.
|
meshRotationChanged ( quaternion rotation ) |
此信号发射，当 meshRotation changes to rotation .
注意：
相应处理程序是
onMeshRotationChanged
.
|
meshSmoothChanged ( bool enabled ) |
此信号发射，当 meshSmooth changes to enabled .
注意：
相应处理程序是
onMeshSmoothChanged
.
|
multiHighlightColorChanged ( color color ) |
此信号发射，当 multiHighlightColor changes to color .
注意：
相应处理程序是
onMultiHighlightColorChanged
.
|
multiHighlightGradientChanged ( Gradient gradient ) |
此信号发射，当 multiHighlightGradient changes to gradient .
注意：
相应处理程序是
onMultiHighlightGradientChanged
.
|
nameChanged ( string name ) |
此信号发射，当 name changes to name .
注意：
相应处理程序是
onNameChanged
.
|
selectedPointChanged ( point position ) |
此信号发射，当 selectedPoint changes to position .
注意：
相应处理程序是
onSelectedPointChanged
.
|
shadingChanged (const Shading shading ) |
此信号发射，当 shading changes to shading .
注意：
相应处理程序是
onShadingChanged
.
|
singleHighlightColorChanged ( color color ) |
此信号发射，当 singleHighlightColor changes to color .
注意：
相应处理程序是
onSingleHighlightColorChanged
.
|
singleHighlightGradientChanged ( Gradient gradient ) |
此信号发射，当 singleHighlightGradient changes to gradient .
注意：
相应处理程序是
onSingleHighlightGradientChanged
.
|
textureFileChanged ( string filename ) |
此信号发射，当 textureFile changes to filename .
注意：
相应处理程序是
onTextureFileChanged
.
|
userDefinedMeshChanged ( string fileName ) |
此信号发射，当 userDefinedMesh changes to fileName .
注意：
相应处理程序是
onUserDefinedMeshChanged
.
|
visibilityChanged ( bool visible ) |
This signal is emitted when the series visibility changes to visible .
注意：
相应处理程序是
onVisibilityChanged
.
|
wireframeColorChanged ( color color ) |
此信号发射，当 wireframeColor changes to color .
注意：
相应处理程序是
onWireframeColorChanged
.
A convenience function to construct a mesh rotation quaternion from axis and angle .
另请参阅 meshRotation .
