View3D QML Type

Diese Eigenschaft gibt an, welche Camera zum Rendern der Szene verwendet wird. Wenn diese Eigenschaft nicht gesetzt ist, wird die erste aktivierte Kamera in der Szene verwendet.

Siehe auch PerspectiveCamera, OrthographicCamera, FrustumCamera, und CustomCamera.

Diese Eigenschaft gibt die Größe der zugrunde liegenden Farb- (und Tiefen-/Schablonen-) Puffer in Pixeln an. Sie wird für die Verwendung im GUI-(Haupt-)Thread, in QML-Bindungen oder JavaScript bereitgestellt.

Diese Eigenschaft ist schreibgeschützt.

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch explicitTextureWidth, explicitTextureHeight, und DebugView.

Diese Eigenschaft gibt die SceneEnvironment an, die zum Rendern der Szene verwendet wird.

Siehe auch SceneEnvironment.

Die Höhe der dem Element zugeordneten Textur in Pixeln. Relevant, wenn eine feste Texturgröße gewünscht wird, die nicht von der Größe des Objekts abhängt. Diese Größe hat keine Auswirkung auf die Geometrie des Gegenstands (seine Größe und Platzierung in der Szene), was bedeutet, dass der Inhalt der Textur auf die Fläche des Gegenstands skaliert oder verkleinert (und möglicherweise gestreckt) erscheint.

Standardmäßig ist der Wert 0. Ein Wert von 0 bedeutet, dass die Größe der Textur der Größe des Objekts folgt. (texture size in pixels = item's logical size * device pixel ratio).

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch explicitTextureWidth, effectiveTextureSize, und DebugView.

Die Breite der dem Element zugeordneten Textur in Pixeln. Relevant, wenn eine feste Texturgröße gewünscht wird, die nicht von der Größe des Objekts abhängt. Diese Größe hat keine Auswirkung auf die Geometrie des Gegenstands (seine Größe und Platzierung in der Szene), was bedeutet, dass der Inhalt der Textur auf der Fläche des Gegenstands nach oben oder unten skaliert (und möglicherweise gestreckt) erscheint.

Standardmäßig ist der Wert 0. Ein Wert von 0 bedeutet, dass die Größe der Textur der Größe des Objekts folgt. (texture size in pixels = item's logical size * device pixel ratio).

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch explicitTextureHeight, effectiveTextureSize, und DebugView.

Diese Eigenschaft enthält eine Liste von Benutzererweiterungen, die mit dieser View3D verwendet werden sollten.

Siehe auch RenderExtension.

Diese Eigenschaft definiert den Referenzknoten der zu rendernden Szene im Ansichtsfenster. Der Knoten muss kein Kindknoten des View3D sein. Dieser referenzierte Knoten wird zu einem Geschwisterknoten mit Kindknoten von View3D, falls es welche gibt.

Sie können auch eine Hierarchie von Node-based Elementen als Kinder von View3D direkt definieren, dann wird dies die implizite Szene von View3D.

Um die aktuelle Szene des View3D zurückzugeben, verwenden Sie die Eigenschaft scene.

Siehe auch Node.

Diese Eigenschaft bestimmt das Format der Backing-Textur. Sie ist nur anwendbar, wenn View3D auf eine Textur gerendert wird, zum Beispiel weil renderMode View3D.Offscreen ist.

Die Vorgabe ist ShaderEffectSource.RGBA8.

Wenn das Format vom zugrunde liegenden Grafiktreiber zur Laufzeit nicht unterstützt wird, wird RGBA8 verwendet.

• ShaderEffectSource.RGBA8
• ShaderEffectSource.RGBA16F
• ShaderEffectSource.RGBA32F

Diese Eigenschaft wurde in Qt 6.4 eingeführt.

Siehe auch QtQuick::ShaderEffectSource::format und QtQuick::Item::layer.format.

Diese Eigenschaft bestimmt, wie die View3D mit den anderen Teilen der Qt Quick Szene kombiniert wird.

Standardmäßig wird die Szene als Zwischenschritt in einen Off-Screen-Puffer gerendert. Dieser Off-Screen-Puffer wird dann wie jedes andere Qt Quick Item in das Fenster (oder Rendering-Ziel) gerendert.

Für die meisten Benutzer wird es nicht nötig sein, den Rendermodus zu ändern, und diese Eigenschaft kann getrost ignoriert werden. Auf mancher Grafikhardware kann die Verwendung eines Offscreen-Puffers jedoch einen Leistungsengpass darstellen. Wenn dies der Fall ist, lohnt es sich, mit anderen Modi zu experimentieren.

Die Voreinstellung ist View3D.Offscreen.

Diese Eigenschaft liefert Statistiken über das Rendering eines Frames, wie fps, frameTime, renderTime, syncTime und maxFrameTime.

Gibt die Wurzel Node der Szene von View3D zurück.

So definieren Sie die 3D-Szene, die in der View3D visualisiert wird:

• Definieren Sie eine Hierarchie von Node-based Elementen als Kinder der View3D direkt, dann wird dies die implizite Szene der View3D.
• Verweisen Sie auf eine bestehende Szene, indem Sie die Eigenschaft importScene verwenden und sie auf die Wurzel Node der Szene setzen, die Sie visualisieren möchten. Diese Node muss kein Vorfahre der View3D sein, und Sie können mehrere View3Ds haben, die die gleiche Szene importieren.

Siehe auch importScene.

Transformiert scenePos vom Szenenraum (3D) in den Ansichtsraum (2D).

Die zurückgegebenen x- und y-Werte werden in Ansichtskoordinaten angegeben, wobei die linke obere Ecke bei [0, 0] und die rechte untere Ecke bei [Breite, Höhe] liegt. Der zurückgegebene z-Wert enthält den Abstand von der nahen Clipebene des Kegelstumpfes (clipNear) zu scenePos in Szenekoordinaten. Wenn der Abstand negativ ist, bedeutet das, dass scenePos hinter der aktiven Kamera liegt. Wenn scenePos nicht auf eine Position in der Szene abgebildet werden kann, wird eine Position von [0, 0, 0] zurückgegeben.

Diese Funktion setzt voraus, dass camera der Ansicht zugewiesen ist.

Siehe auch mapTo3DScene() und Camera.mapToViewport().

Transformiert viewPos vom Ansichtsraum (2D) in den Szenenraum (3D).

Die x- und y-Werte von viewPos sollten in Ansichtskoordinaten angegeben werden, wobei die obere linke Ecke bei [0, 0] und die untere rechte Ecke bei [Breite, Höhe] liegt. Der z-Wert wird als Abstand von der nahen Clipebene des Kegelstumpfes (clipNear) in Szenekoordinaten interpretiert.

Wenn viewPos nicht erfolgreich auf eine Position in der Szene abgebildet werden kann, wird eine Position von [0, 0, 0] zurückgegeben.

Diese Funktion setzt voraus, dass der Ansicht eine camera zugewiesen ist.

Siehe auch mapFrom3DScene() und Camera.mapFromViewport().

Diese Methode "schießt" einen Strahl von den Ansichtskoordinaten x und y in die Szene und gibt Informationen über den nächstgelegenen Schnittpunkt mit einem Objekt in der Szene zurück.

Sie kann z.B. mit Mauskoordinaten aufgerufen werden, um das Objekt unter dem Mauszeiger zu finden.

Diese Methode "schießt" einen Strahl von den Ansichtskoordinaten x und y in die Szene und gibt Informationen über den Schnittpunkt zwischen dem Strahl und dem angegebenen model zurück.

Dies kann z.B. mit Mauskoordinaten aufgerufen werden, um das Objekt unter dem Mauszeiger zu finden.

Diese Methode wurde in Qt 6.8 eingeführt.

Diese Methode "schießt" einen Strahl in die Szene von den Ansichtskoordinaten x und y und gibt eine Liste von Informationen über Schnittpunkte mit Objekten in der Szene zurück. Die zurückgegebene Liste ist nach der Entfernung von der Kamera sortiert, wobei die nächstgelegenen Schnittpunkte zuerst und die am weitesten entfernten zuletzt angezeigt werden.

Dies kann z.B. mit Mauskoordinaten aufgerufen werden, um das Objekt unter dem Mauszeiger zu finden.

Diese Methode wurde in Qt 6.2 eingeführt.

Diese Methode "schießt" einen Strahl von den Ansichtskoordinaten x und y in die Szene und gibt Informationen über die Schnittpunkte mit der übergebenen Liste von models zurück. Dabei wird nur die Liste der übergebenen Modelle überprüft. Die zurückgegebene Liste ist nach der Entfernung von der Kamera sortiert, wobei die nächstgelegenen Schnittpunkte zuerst und die am weitesten entfernten zuletzt angezeigt werden.

Diese Funktion kann z.B. mit Mauskoordinaten aufgerufen werden, um das Objekt unter dem Mauszeiger zu finden.

Funktioniert sowohl mit Property List<Model> als auch mit dynamischen JavaScript Arrays von Models.

Diese Methode wurde in Qt 6.8 eingeführt.

Diese Methode "schießt" einen Strahl in die Szene, beginnend bei origin und direction und gibt Informationen über den nächstgelegenen Schnittpunkt mit einem Objekt in der Szene zurück.

Sie kann zum Beispiel mit der Position und dem Vorwärtsvektor eines beliebigen Objekts in der Szene aufgerufen werden, um zu sehen, welches Objekt sich vor einem Objekt befindet. Damit ist es möglich, von jedem Punkt der Szene aus zu picken.

Diese Methode wurde in Qt 6.2 eingeführt.

Diese Methode "schießt" einen Strahl in die Szene, beginnend bei origin und direction, und gibt eine Liste mit Informationen über die nächstgelegenen Schnittpunkte mit Objekten in der Szene zurück. Die Liste ist nach der Entfernung vom Ursprung entlang des Richtungsvektors vorsortiert, wobei die nächstgelegenen Schnittpunkte zuerst und die am weitesten entfernten zuletzt angezeigt werden.

Dies kann zum Beispiel mit der Position und dem Vorwärtsvektor eines beliebigen Objekts in einer Szene aufgerufen werden, um zu sehen, welche Objekte sich vor einem Objekt befinden. Damit ist es möglich, von jedem Punkt der Szene aus zu picken.

Diese Methode wurde in Qt 6.2 eingeführt.

Sendet ein synthetisches Berührungsereignis an target und verschiebt den Berührungspunkt mit der ID pointId nach position, wobei pressed bestimmt, ob der Punkt gedrückt wird. Sendet auch das entsprechende Berührungsfreigabeereignis, wenn pointId zuvor auf einem anderen Element aktiv war.

Diese Methode wurde in Qt 6.8 eingeführt.