Scene3D QML Type

Le type `Scene3D` fournit une description de la scène 3D en cours de visualisation. En savoir plus...

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• activeCamera : Camera3D
• activeLight : Light3D
• devicePixelRatio : real
• graphPositionQuery : point
• invalidSelectionPoint : point
• primarySubViewport : rect
• secondarySubViewport : rect
• secondarySubviewOnTop : bool
• selectionQueryPosition : point
• slicingActive : bool
• viewport : rect

Description détaillée

La scène 3D contient une seule caméra active et une seule source de lumière active. Les données visualisées sont supposées se trouver à un emplacement fixe.

La scène 3D garde également en mémoire la fenêtre d'affichage dans laquelle s'effectue le rendu de la visualisation, la sous-fenêtre principale à l'intérieur de la fenêtre d'affichage où se trouve la vue principale de visualisation des données 3D, ainsi que la sous-fenêtre secondaire où se trouve la vue en coupe 2D des données.

De plus, la scène dispose d’un indicateur permettant de savoir si la vue de découpage 2D secondaire est actuellement active ou non.

Documentation des propriétés

activeCamera : Camera3D

La caméra actuellement active dans la scène 3D. Lorsqu'un objet `Camera3D` est défini dans cette propriété, il est automatiquement ajouté en tant qu'enfant de la scène.

activeLight : Light3D

La lumière actuellement active dans la scène 3D. Lorsqu'un objet « Light3D » est défini dans cette propriété, il est automatiquement ajouté en tant qu'enfant de la scène.

devicePixelRatio : real

Le rapport de pixels actuel de l'appareil, utilisé pour convertir les coordonnées d'entrée en coordonnées de pixels.

graphPositionQuery : point

Coordonnées de la saisie utilisateur qui doivent être traitées par la scène comme une requête de position dans le graphe. Si cette propriété est définie sur une valeur autre que « invalidSelectionPoint », le graphe tente de faire correspondre une position du graphe au point donné dans la fenêtre d'affichage principale. Après le passage de rendu, cette propriété revient à son état par défaut : invalidSelectionPoint. La position du graphique interrogée peut être lue à partir de la propriété AbstractGraph3D::queriedGraphPosition après le passage de rendu suivant.

Il n’existe pas de coordonnées 3D uniques permettant de correspondre à une position particulière à l’écran ; par souci de cohérence, les requêtes sont donc toujours effectuées par rapport aux côtés intérieurs d’un rectangle invisible entourant le graphique.

Voir également AbstractGraph3D::queriedGraphPosition.

invalidSelectionPoint : point

Une propriété constante fournissant un point non valide pour la sélection.

primarySubViewport : rect

Rectangle du sous-fenêtre d’affichage actuel à l’intérieur de la fenêtre d’affichage, où est ciblée la vue principale de la visualisation des données.

Si slicingActive vaut false, la sous-fenêtre principale sera identique à la fenêtre d’affichage. Si slicingActive vaut true et que la sous-fenêtre principale n’a pas été explicitement définie, elle correspondra à un cinquième de la fenêtre d’affichage.

secondarySubViewport : rect

* * * Le rectangle de la fenêtre d'affichage secondaire à l'intérieur de la fenêtre d'affichage. La fenêtre d'affichage secondaire * est utilisée pour dessiner la vue en coupe 2D dans certaines visualisations. Si elle n'a pas * été explicitement définie, elle sera nulle. Si slicingActive est true, elle * sera identique à la fenêtre d'affichage. *

secondarySubviewOnTop : bool

Détermine si la vue de coupe 2D ou la vue 3D s'affiche au premier plan.

selectionQueryPosition : point

Coordonnées de la saisie utilisateur qui doit être traitée par la scène comme une sélection. Si cette propriété est définie sur une valeur autre que « invalidSelectionPoint », le graphe tente de sélectionner un élément de données situé au point indiqué dans la fenêtre d'affichage principale. Une fois le rendu effectué, la propriété revient à son état par défaut, à savoir « invalidSelectionPoint ».

slicingActive : bool

Détermine si la vue de découpage 2D est actuellement active. Si l'option « true » est activée, l'option « AbstractGraph3D::selectionMode » doit comporter soit « AbstractGraph3D.SelectionRow », soit « AbstractGraph3D.SelectionColumn », avec une sélection valide.

viewport : rect [read-only]

Le rectangle de la fenêtre d'affichage actuelle vers lequel sont dirigés tous les rendus 3D.