GraphsItem3D QML Type

Die Umgebungslichtstärke für das gesamte Diagramm. Dieser Wert bestimmt, wie gleichmäßig und hell die Farben im gesamten Diagramm unabhängig von der Lichtposition dargestellt werden. Der Wert muss zwischen 0.0 und 1.0 liegen.

Das Verhältnis der Skalierung des Diagramms zwischen der längsten Achse auf der horizontalen Ebene und der y-Achse. Der Standardwert ist 2.0.

Siehe auch horizontalAspectRatio.

Die derzeit aktive Kameravoreinstellung, die eine der folgenden ist: Graphs3D.CameraPreset. Wenn keine Voreinstellung aktiv ist, lautet der Wert Graphs3D.CameraPreset.NoPreset.

Das Kameraziel in Form eines vector3d. Der Standardwert ist vector3d(0.0, 0.0, 0.0).

Gültige Koordinatenwerte liegen zwischen -1.0...1.0, wobei die Randwerte die Ränder des entsprechenden Achsenbereichs angeben. Alle Werte außerhalb dieses Bereichs werden an den Rand geklemmt.

Der X-Drehwinkel der Kamera um den Zielpunkt in Grad, ausgehend von der aktuellen Basisposition.

Der Y-Drehwinkel der Kamera um den Zielpunkt in Grad, ausgehend von der aktuellen Basisposition.

Die Zoomstufe der Kamera in Prozent. Der Standardwert 100.0 bedeutet, dass die Kamera nicht vergrößert oder verkleinert werden kann. Der Wert wird durch die Eigenschaften minCameraZoomLevel und maxCameraZoomLevel begrenzt.

Siehe auch minCameraZoomLevel und maxCameraZoomLevel.

Wenn die FPS-Messung aktiviert ist, werden die Ergebnisse für die letzte Sekunde in dieser schreibgeschützten Eigenschaft gespeichert. Es dauert mindestens eine Sekunde, bis dieser Wert nach Aktivierung der Messung aktualisiert wird.

Siehe auch measureFps.

Die Liste der Custom3DItem Elemente, die dem Diagramm hinzugefügt wurden. Das Diagramm übernimmt das Eigentum an den hinzugefügten Elementen.

Legt fest, ob der Gitterlinientyp Graphs3D.GridLineType.Shader oder Graphs3D.GridLineType.Geometry ist.

Dieser Wert wirkt sich auf alle Gitterlinien aus.

Siehe auch Graphs3D.GridLineType.

Das Verhältnis der Skalierung des Diagramms zwischen der x-Achse und der z-Achse. Der Wert 0.0 bedeutet eine automatische Skalierung entsprechend den Achsenbereichen. Der Standardwert ist 0.0.

Siehe auch aspectRatio, polar, Bars3D::barThickness, und Bars3D::barSpacing.

Diese Eigenschaft legt den Rand für die Platzierung der Achsenbeschriftungen fest.

Negative Werte platzieren die Beschriftungen innerhalb des Plot-Bereichs, positive Werte außerhalb des Plot-Bereichs. Die automatische Drehung der Beschriftungen ist deaktiviert, wenn der Wert negativ ist. Standardwert ist 0.1

Siehe auch QAbstract3DAxis::labelAutoAngle.

Die Farbe des Umgebungs- und Glanzlichts, definiert in Scene3D.

Die Stärke des Glanzlichts für das gesamte Diagramm. Der Wert muss zwischen 0.0 und 10.0 liegen.

Dieser Wert wirkt sich auf das in Scene3D angegebene Licht aus.

Legt das Gebietsschema fest, das für die Formatierung verschiedener numerischer Beschriftungen verwendet wird. Standardmäßig wird das Gebietsschema "C" verwendet.

Siehe auch Value3DAxis::labelFormat.

Der absolute Wert, der für den Abstand zwischen dem Rand des plottbaren Diagrammbereichs und dem Rand des Diagrammhintergrunds verwendet wird.

Wenn der Wert für den Rand negativ ist, werden die Ränder automatisch bestimmt und können je nach Größe der Elemente in der Reihe und dem Typ des Diagramms variieren. Der Wert wird als Bruchteil des y-Achsenbereichs interpretiert, wenn die Seitenverhältnisse des Diagramms gegenüber den Standardwerten nicht geändert wurden. Der Standardwert ist -1.0.

Legt die maximal zulässige Zoomstufe der Kamera fest. Wenn die neue maximale Stufe niedriger ist als die vorhandene minimale Stufe, wird die minimale Stufe ebenfalls an die neue maximale Stufe angepasst. Wenn die aktuelle cameraZoomLevel außerhalb der neuen Grenzen liegt, wird sie ebenfalls angepasst. Die Standardeinstellung ist 500.0f.

Siehe auch cameraZoomLevel und minCameraZoomLevel.

Falls true, wird das Rendering kontinuierlich und nicht nur bei Bedarf durchgeführt und der Wert der Eigenschaft currentFps aktualisiert. Der Standardwert ist false.

Siehe auch currentFps.

Legt die minimal zulässige Zoomstufe der Kamera fest. Wenn die neue Mindeststufe höher ist als die vorhandene Höchststufe, wird die Höchststufe ebenfalls an die neue Mindeststufe angepasst. Wenn die aktuelle cameraZoomLevel außerhalb der neuen Grenzen liegt, wird sie ebenfalls angepasst. Der minCameraZoomLevel kann nicht unter 1.0 gesetzt werden. Der Standardwert ist 10.0.

Siehe auch cameraZoomLevel und maxCameraZoomLevel.

Die Anzahl der Samples, die beim Multisample-Antialiasing verwendet werden, wenn renderingMode für Indirect steht. Wenn renderingMode gleich DirectToBackground ist, ist dieser Eigenschaftswert schreibgeschützt und gibt die Anzahl der Samples zurück, die durch das Fensteroberflächenformat festgelegt ist. Der Standardwert ist 4.

Siehe auch renderingMode.

Gibt an, ob der Standard- oder Legacy-Modus für die Rendering-Optimierung verwendet wird.

Der Standardmodus verwendet instanziertes Rendering und bietet den vollen Funktionsumfang bei bester Leistung auf den meisten Systemen. Der statische Modus optimiert das Rendering von Graphen und ist ideal für große, unveränderliche Datensätze. Bei dynamischen Datenänderungen und Elementdrehungen ist er langsamer. Die Auswahl wird nicht optimiert, daher ist die Verwendung des statischen Modus bei großen Datensätzen nicht ratsam. Der Legacy-Modus rendert alle Elemente im Diagramm einzeln, ohne Instanzierung. Er sollte nur verwendet werden, wenn der Standardmodus nicht funktioniert, d. h. wenn das Zielsystem keine Instanzierung unterstützt. Die Voreinstellung ist Default.

Siehe auch Abstract3DSeries::mesh und Graphs3D.OptimizationHint.

Wenn true gewählt wird, wird die orthografische Projektion für die Darstellung des Diagramms verwendet. Die Standardeinstellung ist false.

Wenn true eingestellt ist, werden die horizontalen Achsen in polare Achsen umgewandelt. Die x-Achse wird zur Winkelachse und die z-Achse wird zur Radialachse. Der Polarmodus ist für Balkendiagramme nicht verfügbar.

Die Standardeinstellung ist false.

Siehe auch orthoProjection und radialLabelOffset.

Diese schreibgeschützte Eigenschaft enthält die letzten Positionswerte des Diagramms entlang jeder Achse, die mit Scene3D::graphPositionQuery abgefragt wurden. Die Werte sind auf den Bereich [-1, 1] normalisiert. Wenn die abgefragte Position außerhalb der Diagrammgrenzen liegt, spiegeln die Werte nicht die tatsächliche Position wider, sondern eine undefinierte Position außerhalb des Bereichs [-1, 1]. Der Wert ist so lange undefiniert, bis eine Abfrage durchgeführt wird.

Es gibt keine einzige korrekte 3D-Koordinate, die einer bestimmten Bildschirmposition entspricht. Um konsistent zu sein, werden die Abfragen daher immer an den Innenseiten eines unsichtbaren Rahmens durchgeführt, der das Diagramm umgibt.

Siehe auch Scene3D::graphPositionQuery.

Diese Eigenschaft gibt den normierten horizontalen Versatz für die Achsenbeschriftungen der radialen Polarachse an. Der Wert 0.0 gibt an, dass die Beschriftungen neben der 0-Winkel-Winkelachsen-Gitterlinie gezeichnet werden sollen. Der Wert 1.0 gibt an, dass die Beschriftungen an ihrem üblichen Platz am Rand des Diagrammhintergrunds gezeichnet werden. Diese Eigenschaft wird ignoriert, wenn der Wert der Polareigenschaft false lautet. Der Standardwert ist 1.0.

Siehe auch polar.

Wie das Diagramm gerendert werden soll. Der Standardwert ist Indirect.

Siehe auch msaaSamples und Graphs3D.RenderingMode.

Ob dieser Input-Handler die Drehung des Graphen erlaubt.

Der Standardwert ist true.

Der Scene3D Zeiger, der verwendet werden kann, um die Szene zu manipulieren und auf die Szenenelemente zuzugreifen.

Diese Eigenschaft ist schreibgeschützt.

Das im Diagramm ausgewählte Element.

Diese Eigenschaft kann verwendet werden, um den Typ des ausgewählten Elements abzufragen. Der Typ ist so lange gültig, bis eine neue Auswahl im Graphen getroffen und das Signal selectedElementChanged ausgegeben wird.

Das Signal kann z. B. zur Implementierung einer benutzerdefinierten Eingabebehandlung verwendet werden, wie im Beispiel Achsenbehandlung gezeigt.

Siehe auch selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Bars3D::selectedSeries, Scatter3D::selectedSeries, Scene3D::selectionQueryPosition, und Graphs3D.ElementType.

Ob dieser Input-Handler eine Auswahl aus dem Diagramm erlaubt.

Der Standardwert ist true.

Der aktive Auswahlmodus im Diagramm. Einer der Graphs3D.SelectionFlag enum Werte.

Die Qualität des Schattens. Einer der Graphs3D.ShadowQuality enum-Werte.

Die Schattenstärke für das gesamte Diagramm. Je höher der Wert ist, desto dunkler sind die Schatten. Der Wert muss zwischen 0.0 und 100.0 liegen.

Dieser Wert wirkt sich auf das in Scene3D angegebene Licht aus.

Das aktive Thema des Diagramms.

Siehe auch GraphsTheme.

Das Verhalten der minimalen und maximalen Grenzen in der X-Drehung. Standardmäßig verläuft die X-Drehung vom Minimalwert zum Maximum und vom Maximum zum Minimum.

Bei der Einstellung true wird die X-Drehung der Kamera vom Minimum zum Maximum und vom Maximum zum Minimum umgeschlagen. Bei der Einstellung false ist die X-Drehung der Kamera auf den durch den Minimal- und Maximalwert bestimmten Sektor begrenzt.

Das Verhalten der Minimal- und Maximalwerte bei der Y-Drehung. Standardmäßig wird die Y-Drehung zwischen dem Minimal- und dem Maximalwert begrenzt, ohne dass ein Umbruch stattfindet.

Wenn true angegeben ist, wird die Y-Drehung der Kamera vom Minimum zum Maximum und vom Maximum zum Minimum umbrochen. Bei false wird die Y-Drehung der Kamera auf den durch den Minimal- und Maximalwert bestimmten Sektor begrenzt.

Ob beim Zoomen das Kameraziel geändert werden soll, damit der gezoomte Punkt des Diagramms nach dem Zoomen an der gleichen Stelle bleibt.

Der Standardwert ist true.

Ob dieser Input-Handler das Zoomen des Diagramms erlaubt.

Der Standardwert ist true.

Dieses Signal wird ausgegeben, wenn das Diagrammelement innerhalb einer kurzen Zeitspanne zweimal angetippt wird. Der Signalparameter eventPoint enthält Informationen aus dem Release-Ereignis über den Punkt, der angetippt wurde, und button ist der mouse button, der angeklickt wurde, oder NoButton auf einem Touchscreen.

Siehe auch QEventPoint, Qt::MouseButtons, und TapHandler::doubleTapped.

Dieses Signal wird ausgegeben, wenn sich die Verschiebung des Punktclusters auf dem Graphen während der Ausführung der Pinch-Geste ändert. Der delta Vektor gibt die Änderung der Verschiebung an.

Siehe auch PinchHandler::translationChanged.

Dieses Signal wird ausgegeben, wenn das Element parent gedrückt und länger als TapHandler::longPressThreshold gehalten wird.

Siehe auch TapHandler::longPressed.

Dieses Signal wird ausgegeben, wenn der Graph ein MouseMove-Ereignis empfängt. mousePos Wert gibt die Position der Maus an, während sie sich bewegt.

Siehe auch QQuickItem::mouseMoveEvent.

Dieses Signal wird ausgegeben, wenn sich der Skalierungsfaktor des Graphen ändert, während die Pinch-Geste ausgeführt wird. Der Wert delta gibt die multiplikative Änderung des Maßstabs an.

Siehe auch PinchHandler::scaleChanged.

Dieses Signal wird ausgegeben, wenn das Diagrammelement einmal angetippt wird. Der Signalparameter eventPoint enthält Informationen aus dem Release-Ereignis über den Punkt, der angetippt wurde, und button ist der mouse button, der angeklickt wurde, oder NoButton auf einem Touchscreen.

Siehe auch QEventPoint, Qt::MouseButtons, und TapHandler::singleTapped.

Dieses Signal wird jedes Mal ausgegeben, wenn der Graph ein event vom Typ QWheelEvent empfängt, d. h. jedes Mal, wenn das Rad bewegt oder die Bildlaufgeste aktualisiert wird.

Siehe auch WheelEvent und WheelHandler::wheel.

Fügt ein Custom3DItem item zum Graph hinzu. Graph übernimmt das Eigentum an dem hinzugefügten Element.

Gibt den Index des hinzugefügten Elements zurück, wenn add erfolgreich war, -1, wenn versucht wurde, ein Nullelement hinzuzufügen, und den Index des Elements, wenn versucht wurde, ein bereits hinzugefügtes Element hinzuzufügen.

Siehe auch removeCustomItems(), removeCustomItem(), und removeCustomItemAt().

Löscht die Auswahl aus allen angehängten Serien.

Gibt zurück, ob das Element series bereits zum Diagramm hinzugefügt wurde.

Holt den Besitz von item zurück und entfernt item aus dem Diagramm.

Siehe auch Custom3DItem::textureFile.

Entfernt das benutzerdefinierte item. Löscht die ihm zugewiesenen Ressourcen.

Entfernt alle benutzerdefinierten Elemente unter position. Löscht die ihnen zugewiesenen Ressourcen.

Entfernt alle benutzerdefinierten Elemente. Löscht die ihnen zugewiesenen Ressourcen.

Kann verwendet werden, um die ausgewählte Achse nach Erhalt des Signals selectedElementChanged mit einem beliebigen Etikettentyp zu erhalten. Die Auswahl ist bis zum nächsten selectedElementChanged Signal gültig.

Gibt die ausgewählte Achse oder Null zurück.

Siehe auch selectedElement.

Kann verwendet werden, um das ausgewählte benutzerdefinierte Element nach dem Empfang des Signals selectedElementChanged mit dem Typ ElementType.CustomItem zu erhalten. Der Besitz des Elements bleibt beim Diagramm. Die Auswahl ist bis zum nächsten selectedElementChanged Signal gültig.

Gibt das ausgewählte benutzerdefinierte Element oder null zurück.

Siehe auch selectedElement.

Kann verwendet werden, um den Index des ausgewählten benutzerdefinierten Elements abzufragen, nachdem das Signal selectedElementChanged mit dem Typ ElementType.CustomItem empfangen wurde. Die Auswahl ist bis zum nächsten selectedElementChanged -Signal gültig.

Gibt den Index des ausgewählten benutzerdefinierten Eintrags oder -1 zurück.

Siehe auch selectedElement.

Kann verwendet werden, um den Index des ausgewählten Etiketts nach dem Empfang des Signals selectedElementChanged mit einem beliebigen Etikettentyp abzufragen. Die Auswahl ist bis zum nächsten selectedElementChanged -Signal gültig.

Gibt den Index des ausgewählten Etiketts oder -1 zurück.

Siehe auch selectedElement.