Scène

classe publique Scene

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

Scène(SceneView) Créez une scène avec le contexte donné.

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).	hitTest(Rayon 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.
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

De la classe com.google.ar.sceneform.NodeParent

dernière valeur	addChild(enfant Node) Ajoute un nœud en tant qu'enfant de ce NodeParent.
void	callOnHiérarchie(Consumer<Node> consumer) Parcourir la hiérarchie et appeler une méthode sur chaque nœud
booléen	canAddChild(enfant du nœud, StringBuilder failureReason)
Nœud	findByName(nom de la chaîne (String)) Parcourez la hiérarchie pour trouver le premier nœud portant un nom donné.
Nœud	findInHiérarchie(Condition de prédicat<Nœud>) Parcourez la hiérarchie pour trouver le premier nœud qui remplit une condition.
final List<Nœud>	getChildren Renvoie une liste immuable des enfants de ce parent.
void	onAddChild(enfant Node)
void	onRemoveChild(enfant Node)
dernière valeur	removeChild(enfant Node) Supprime un nœud des enfants de ce NodeParent.

De la classe java.lang.Object

Objet	clone()
booléen	est égal(e) à(Objet arg0)
void	finalize
Classe finale <	getClass()
int	hashCode()
dernière valeur	notify()
dernière valeur	notifyAll()
String	toString()
dernière valeur	wait(long arg0, int arg1)
dernière valeur	wait(long arg0)
dernière valeur	wait()

Champs

public static final EnvironmentalHdrParameters DEFAULT_HDR_PARAMETERS

Constructeurs publics

public Scène (vue SceneView)

Créez une scène avec le contexte donné.

Paramètres

vue

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 SceneView getView ()

Renvoie la vue SceneView utilisée pour créer 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

• screenPointToRay(float, float)

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

• screenPointToRay(float, float)

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 void onAddChild (enfant Node)

Paramètres

enfant

public void onRemoveChild (enfant Node)

Paramètres

enfant

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

• overlapTestAll(Node)

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

• overlapTest(Node)

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