La scène Sceneform gère le graphique de la scène, une organisation hiérarchique du contenu d'une scène. Une scène peut comporter zéro ou plusieurs nœuds enfants, et chaque nœud peut avoir zéro ou plusieurs nœuds enfants.
La scène fournit également des tests de positionnement, un moyen de détecter quel nœud est touché par un MotionEvent ou un Ray.
Cours imbriqués
interface | Scene.OnPeekTouchListener | Définition de l'interface permettant d'appeler un rappel lorsqu'un événement tactile est envoyé à une scène. | |
interface | Scene.OnTouchListener | Définition de l'interface permettant d'appeler un rappel lorsqu'un événement tactile est envoyé à une scène. | |
interface | Scene.OnUpdateListener | Définition de l'interface permettant d'appeler un rappel par image juste avant la mise à jour de la scène. |
Champs
public static finalal EnvironmentalHdrParameters | DEFAULT_HDR_PARAMETERS |
Constructeurs publics
Méthodes publiques
void |
addOnPeekTouchListener(Scene.OnPeekTouchListener surPeekTouchListener)
Ajoute un écouteur qui sera appelé avant l'appel de
Scene.OnTouchListener . |
void |
addOnUpdateListener(Scene.OnUpdateListener onUpdateListener)
Ajoute un écouteur appelé une fois par image immédiatement avant la mise à jour de la scène.
|
Appareil photo |
getCamera
Obtenez la caméra utilisée pour afficher la scène.
|
Nœud |
getSunlight
Obtenez le nœud de soleil par défaut.
|
SceneView |
getView
Renvoie la vue SceneView utilisée pour créer la scène.
|
HitTestResult (HitTestResult). |
hitTest(Événement de mouvement MotionEvent)
Teste si un événement de mouvement touche des nœuds de la scène, en fonction d'un test d'appel de rayon dont l'origine correspond à la position d'écran de l'événement de mouvement et génère un HitTestResult contenant le nœud le plus proche de l'écran.
|
HitTestResult (HitTestResult). | |
ArrayList<HitTestResult> |
hitTestAll(Ray-ray)
Teste si un rayon atteint des nœuds de la scène et renvoie une liste de HitTestResults contenant tous les nœuds ayant été touchés, triés par distance.
|
ArrayList<HitTestResult> |
hitTestAll(Événement de mouvement MotionEvent)
Vérifie si un événement de mouvement touche des nœuds de la scène et renvoie une liste de HitTestResults contenant tous les nœuds ayant été touchés, triés par distance.
|
void |
onAddChild(enfant Node)
|
void |
onRemoveChild(enfant Node)
|
Nœud |
overlapTest(nœud Node)
Vérifie si la forme de collision du nœud donné chevauche celle de tous les autres nœuds de la scène utilisant
getCollisionShape() . |
ArrayList<Nœud> |
overlapTestAll(nœud Node)
Utilise
getCollisionShape() pour vérifier si un nœud chevauche d'autres nœuds de la scène. |
void |
removeOnPeekTouchListener(Scene.OnPeekTouchListener surPeekTouchListener)
Supprime un écouteur appelé avant l'appel de
Scene.OnTouchListener . |
void |
removeOnUpdateListener(Scene.OnUpdateListener ; onUpdateListener)
Supprime un écouteur appelé une fois par image immédiatement avant la mise à jour de la scène.
|
void |
setLightEstimate(Color CorrectionCorrection, float pixelIntensity)
Définit l'estimation de la luminosité pour moduler l'intensité et l'éclairage de la scène.
|
void |
setOnTouchListener(Scene.OnTouchListener onTouchListener)
Enregistrer un rappel à invoquer lorsque l'utilisateur touche la scène
|
Méthodes héritées
Champs
public static final EnvironmentalHdrParameters DEFAULT_HDR_PARAMETERS
Constructeurs publics
Méthodes publiques
public void addOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)
Ajoute un écouteur qui sera appelé avant l'appel de Scene.OnTouchListener
. Cela est invoqué même si le geste a été utilisé, ce qui permet d'observer tous les événements de mouvement envoyés à la scène. Cela est appelé même si l'action n'est pas effectuée sur un nœud, auquel cas getNode()
est nul. Les écouteurs seront appelés dans l'ordre dans lequel ils ont été ajoutés.
Paramètres
écouteur tactile | l'écouteur d'aperçu à ajouter |
---|
public void addOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Ajoute un écouteur appelé une fois par image immédiatement avant la mise à jour de la scène. Les écouteurs seront appelés dans l'ordre dans lequel ils ont été ajoutés.
Paramètres
écouteur d'actualisation | l'écouteur de mise à jour à ajouter |
---|
public Caméra getCamera ()
Obtenez la caméra utilisée pour afficher la scène. La caméra est un type de nœud.
Renvoie
- la caméra utilisée pour le rendu de la scène
public Nœud getSunlight ()
Obtenez le nœud de soleil par défaut.
Renvoie
- le nœud solaire utilisé pour éclairer la scène
public HitTestResult hitTest (MotionEvent mouvementEvent)
Teste si un événement de mouvement touche des nœuds de la scène, en fonction d'un test d'appel de rayon dont l'origine correspond à la position d'écran de l'événement de mouvement et génère un HitTestResult contenant le nœud le plus proche de l'écran.
Paramètres
mouvement | L'événement de mouvement à utiliser pour le test |
---|
Renvoie
- le résultat inclut le premier nœud qui a été touché par l'événement de mouvement (peut être nul) et des informations sur l'endroit où l'événement de mouvement a touché le nœud dans l'espace mondial
public HitTestResult hitTest (Ray Ray)
Teste si un rayon atteint des nœuds de la scène et génère un HitTestResult contenant le nœud le plus proche du point d'origine du rayon qui se recoupe avec le rayon.
Paramètres
Ray | le rayon à utiliser pour le test |
---|
Renvoie
- le résultat inclut le premier nœud ayant été atteint par le rayon (peut être nul) et des informations sur l'endroit où le rayon a touché le nœud dans l'espace mondial
Voir également
public ArrayList<HitTestResult> hitTestAll (Rayon)
Teste si un rayon atteint des nœuds de la scène et renvoie une liste de HitTestResults contenant tous les nœuds ayant été touchés, triés par distance.
Paramètres
Ray | Rayon à utiliser pour le test. |
---|
Renvoie
- Valeur renseignée par un HitTestResult pour chaque nœud ayant été atteint et trié par distance. Vide si aucun nœud n'a été appelé
Voir également
public ArrayList<HitTestResult> hitTestAll (Événement de mouvement mouvementEvent)
Vérifie si un événement de mouvement touche des nœuds de la scène et renvoie une liste de HitTestResults contenant tous les nœuds ayant été touchés, triés par distance.
Paramètres
mouvement | Événement de mouvement à utiliser pour le test. |
---|
Renvoie
- Valeur renseignée par un HitTestResult pour chaque nœud ayant été atteint et trié par distance. Vide si aucun nœud n'a été appelé
public Nœud overlapTest (nœud Node)
Vérifie si la forme de collision du nœud donné chevauche celle de tous les autres nœuds de la scène utilisant getCollisionShape()
. Le nœud utilisé pour les tests n'a pas besoin d'être actif.
Paramètres
GKE | Nœud à utiliser pour le test. |
---|
Renvoie
- Un nœud qui chevauche le nœud de test Si aucun nœud ne chevauche le nœud de test, la valeur est nulle. Si plusieurs nœuds se chevauchent, il peut s'agir de l'un d'eux.
Voir également
public ArrayList<Nœud> overlapTestAll (nœud Nœud)
Utilise getCollisionShape()
pour vérifier si un nœud chevauche d'autres nœuds de la scène. Le nœud utilisé pour les tests n'a pas besoin d'être actif.
Paramètres
GKE | Nœud à utiliser pour le test. |
---|
Renvoie
- Liste de tous les nœuds qui se chevauchent. Si aucun nœud ne chevauche le nœud de test, la liste est vide.
Voir également
public void removeOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)
Supprime un écouteur appelé avant l'appel de Scene.OnTouchListener
.
Cela est invoqué même si le geste a été utilisé, ce qui permet d'observer tous les événements de mouvement envoyés à la scène. Cela est appelé même si l'action n'est pas effectuée sur un nœud, auquel cas getNode()
est nul.
Paramètres
écouteur tactile | Aperçu de l'écouteur tactile à supprimer |
---|
public void removeOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Supprime un écouteur appelé une fois par image immédiatement avant la mise à jour de la scène.
Paramètres
écouteur d'actualisation | l'écouteur de mise à jour à supprimer |
---|
public void setLightEstimate (Color colorCorrection, float pixelIntensity)
Définit l'estimation de la luminosité pour moduler l'intensité et l'éclairage de la scène. Les ampoules rendues combinent ces valeurs et leur couleur et leur intensité. Les valeurs "colorCorrection" et "pixelIntensity" égales à 1 signifient qu'aucune modification n'est apportée aux paramètres de luminosité.
Elle est utilisée par les scènes AR Sceneform en interne pour ajuster la luminosité en fonction des valeurs d'ARCore. Une scène de RA l'appellera automatiquement, en remplaçant éventuellement d'autres paramètres. Dans la plupart des cas, il n'est pas nécessaire d'appeler cela explicitement.
Paramètres
Correction des couleurs | Modifie la couleur d'éclairage de la scène. |
---|---|
intensité des pixels | module l'intensité de la lumière de la scène. |
public void setOnTouchListener (Scene.OnTouchListener onTouchListener)
Enregistrer un rappel à invoquer lorsque l'utilisateur touche la scène Le rappel sera invoqué une fois l'événement tactile envoyé aux nœuds de la scène si aucun nœud n'a utilisé l'événement. Cela est appelé même si l'action n'est pas effectuée sur un nœud, auquel cas getNode()
est nul.
Paramètres
écouteur tactile | l'écouteur tactile à associer |
---|