Oświetlenie

klasa publiczna Scene

Scena sceny to wykres scenowy, który ma hierarchiczną organizację treści. Uwaga: scena może zawierać 0 lub więcej węzłów podrzędnych, ale nie może ich być więcej.

Scena udostępnia także testy działania, dzięki którym można wykryć węzeł, na który wpływa zdarzenie Motion lub Ray.

Zajęcia zagnieżdżone

interfejs	Scene.OnPeekTouchListener		Definicja interfejsu wywołania zwrotnego, które jest wywoływane, gdy zdarzenie dotyku jest wysyłane do sceny.
interfejs	Scene.OnTouchListener (Scene.OnTouchListener)		Definicja interfejsu wywołania zwrotnego, które jest wywoływane, gdy zdarzenie dotyku jest wysyłane do sceny.
interfejs	Scene.OnUpdateListener		Definicja interfejsu wywołania zwrotnego jest wywoływana raz na klatkę bezpośrednio przed aktualizacją sceny.

Pola

publiczne Static HdrParameters

DEFAULT_HDR_PARAMETERS

Budownictwo publiczne

Scene (Widok SceneView) Utwórz scenę z określonym kontekstem.

Metody publiczne

nieważne	addOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener) Dodaje detektor, który zostanie wywołany przed wywołaniem funkcji Scene.OnTouchListener.
nieważne	addOnUpdateListener (Scene.OnUpdateListener onUpdateListener) Dodaje detektor, który będzie wywoływany raz w każdej klatce bezpośrednio przed aktualizacją.
Kamera	getCamera() Pobierz aparat używany do renderowania sceny.
Węzeł	getSunlight() Pobierz domyślny węzeł słoneczny.
SceneView	getView() Zwraca widok SceneView użyty do utworzenia sceny.
Wynik testu	hitTest(MotionEvent MotionEvent) Testuje, czy zdarzenie ruchu dotyka dowolnego węzła w scenie na podstawie testu działania promienia, którego punkt początkowy jest zdarzeniem ruchu, i wywołuje wynik działania TestTest zawierający węzeł znajdujący się najbliżej ekranu.
Wynik testu	hitTest(ray) Testuje, czy promień dociera do dowolnego węzła w scenie, i zwraca wynik działania TestTestResult zawierający węzeł najbliższy promienia, który krzyżuje się z promieniem.
ArrayList<HitTestResult>	hitTestAll (ray) Testuje, czy promień nie dotyczy żadnych węzłów w scenie, i zwraca listę działań HitTestResults zawierających wszystkie trafienia, które zostały posortowane według odległości.
ArrayList<HitTestResult>	hitTestAll(MotionEvent MotionEvent) Testuje, czy zdarzenie ruchu dotyczy wszystkich węzłów w scenie, a następnie zwraca listę działań HitTestResults zawierających wszystkie trafienia, które zostały posortowane według odległości.
nieważne	onAddChild (element podrzędny węzła)
nieważne	onRemoveChild (element podrzędny)
Węzeł	overlapTest(węzeł węzła) Testuje, czy dany kształt kolizji danego węzła pokrywa się ze kształtem kolizji innych węzłów w scenie, używając interfejsu getCollisionShape().
ArrayList<Node>	overlapTestAll(węzeł węzła) Testuje, czy węzeł nie pokrywa się z innymi węzłami w scenie za pomocą polecenia getCollisionShape().
nieważne	removeOnPeekTouchListener(Scene.OnPeekTouchListener onPeekTouchListener) Usuwa detektor, który zostanie wywołany przed wywołaniem funkcji Scene.OnTouchListener.
nieważne	removeOnUpdateListener(Scene.OnUpdateListener onUpdateListener) Usuwa detektor, który jest wywoływany raz na klatkę bezpośrednio przed aktualizacją.
nieważne	setLightEstimate(Korekcja kolorów, intensywność kolorów pływającej) Ustawia szacowaną wartość światła, aby modyfikować oświetlenie i natężenie światła.
nieważne	setOnTouchListener (Scene.OnTouchListener onTouchListener) Zarejestruj wywołanie zwrotne, które ma być wywoływane po dotknięciu sceny.

Metody dziedziczone

Od klasy com.google.ar.sceneform.NodeParent

końcowy unieważnienie	addChild(element podrzędny) Dodaje węzeł podrzędny jako element podrzędny tego węzła NodeParent.
nieważne	callOnHierarchy(consumer<Node>consumer) Poruszaj się po hierarchii i wywołuj metodę w każdym węźle.
wartość logiczna	canAddChild (element podrzędny węzła, błąd StringBuilder)
Węzeł	findByName(ciąg znaków) Poruszaj się po hierarchii, aby znaleźć pierwszy węzeł o danej nazwie.
Węzeł	findInHierarchy(predykat<węzeł> warunek) Poruszaj się po hierarchii, aby znaleźć pierwszy węzeł spełniający warunek.
final List<Node>	getChildren() Zwraca stałą listę elementów podrzędnych tego elementu nadrzędnego.
nieważne	onAddChild (element podrzędny węzła)
nieważne	onRemoveChild (element podrzędny)
końcowy unieważnienie	removeChild (element podrzędny węzła) Usuwa węzeł z elementów podrzędnych tego węzła NodeParent.

Z klasy java.lang.Object

Obiekt	klon
wartość logiczna	równa się(obiekt argument;0)
nieważne	finalizacji
final Class<\">gt;	getClass()
int,	hashCode()
końcowy unieważnienie	notify()
końcowy unieważnienie	notifyAll()
Ciąg	toString()
końcowy unieważnienie	wait(długi arg0, int arg1)
końcowy unieważnienie	wait(długi arg0)
końcowy unieważnienie	wait()

Pola

public+static finalalHdrParameters DEFAULT_HDR_PARAMETERS

Budownictwo publiczne

publiczna Scena (SceneView)

Utwórz scenę z określonym kontekstem.

Parametry

widok

Metody publiczne

void voidaddOnPeekTouchListener(Scene.OnPeekTouchListener onPeekTouchListener)

Dodaje detektor, który zostanie wywołany przed wywołaniem funkcji Scene.OnTouchListener. Jest ona wywoływana nawet przy użyciu gestu, co pozwala obserwować wszystkie zdarzenia ruchu wysyłane do danej sceny. Jest to nazywane nawet wtedy, gdy punkt dotykowy nie znajduje się nad węzłem. W takim przypadku getNode() ma wartość NULL. Detektory będą wywoływane w kolejności, w której zostały dodane.

Parametry

OnPeekTouchListener	Szybki podgląd słuchacza

void void addOnUpdateListener (Scene.OnUpdateListener onUpdateListener)

Dodaje detektor, który będzie wywoływany raz w każdej klatce bezpośrednio przed aktualizacją. Detektory będą wywoływane w kolejności, w której zostały dodane.

Parametry

onUpdateListener	detektor aktualizacji do dodania

Aparat getCamera ()

Pobierz aparat używany do renderowania sceny. Aparat jest typem węzła.

Zwraca

• aparat użyty do renderowania sceny

Węzeł getSunlight ()

Pobierz domyślny węzeł słoneczny.

Zwraca

• węzeł słoneczny, który oświetla scenę

SceneView getView ()

Zwraca widok SceneView użyty do utworzenia sceny.

HitTestResult hitTest (MotionEvent MotionEvent)

Testuje, czy zdarzenie ruchu dotyka dowolnego węzła w scenie na podstawie testu działania promienia, którego punkt początkowy jest zdarzeniem ruchu, i wywołuje wynik działania TestTest zawierający węzeł znajdujący się najbliżej ekranu.

Parametry

Motionmotion	zdarzenie ruchu, które ma zostać wykorzystane do testu

Zwraca

• w wyniku znajdzie się pierwszy węzeł, który został wywołany przez zdarzenie ruchu (może mieć wartość null) oraz informacje o tym, w którym miejscu w ruchu wystąpił węzeł w przestrzeni świata.

publiczne HitTestResult hitTest (Ray ray)

Testuje, czy promień dociera do dowolnego węzła w scenie, i zwraca wynik działania TestTestResult zawierający węzeł najbliższy promienia, który krzyżuje się z promieniem.

Parametry

Ray	tablica do wykorzystania w teście

Zwraca

• w wyniku znajdzie się pierwszy węzeł trafiony przez promień (może mieć wartość null) oraz informacje o tym, w którym miejscu promień dotarł do węzła w przestrzeni świata.

Zobacz również

• screenPointToRay(float, float)

public ArrayList<HitTestResult> hitTestAll (Ray ray)

Testuje, czy promień nie dotyczy żadnych węzłów w scenie, i zwraca listę działań HitTestResults zawierających wszystkie trafienia, które zostały posortowane według odległości.

Parametry

Ray	Promień używany do testu.

Zwraca

• Wartość wypełniana przez wynik testu testowego dla każdego węzła, który został posortowany według odległości. Brak wartości, jeśli nie wystąpiły żadne węzły.

Zobacz również

• screenPointToRay(float, float)

public ArrayList<HitTestResult> hitTestAll (MotionEvent MotionEvent)

Testuje, czy zdarzenie ruchu dotyczy wszystkich węzłów w scenie, a następnie zwraca listę działań HitTestResults zawierających wszystkie trafienia, które zostały posortowane według odległości.

Parametry

Motionmotion	Zdarzenie ruchu używane w teście.

Zwraca

• Wartość wypełniana przez wynik testu testowego dla każdego węzła, który został posortowany według odległości. Brak wartości, jeśli nie wystąpiły żadne węzły.

void void onAddChild (węzeł elementu podrzędnego)

Parametry

dziecko

void void onRemoveChild (Node children)

Parametry

dziecko

Węzeł overlapTest (węzeł)

Testuje, czy dany kształt kolizji danego węzła pokrywa się ze kształtem kolizji innych węzłów w scenie, używając interfejsu getCollisionShape(). Węzeł używany do testowania nie musi być aktywny.

Parametry

węzeł	Węzeł używany w teście.

Zwraca

• Węzeł pokrywający się z węzła testowego. Jeśli żaden węzeł testowy nie nakłada się na węzeł testowy, wartość jest pusta. Jeśli wiele węzłów pokrywa się z wieloma węzłami, może to być dowolny z nich.

Zobacz również

• overlapTestAll(Node)

public ArrayList<Node> overlapTestAll (węzeł)

Testuje, czy węzeł nie pokrywa się z innymi węzłami w scenie za pomocą polecenia getCollisionShape(). Węzeł używany do testowania nie musi być aktywny.

Parametry

węzeł	Węzeł używany w teście.

Zwraca

• Lista wszystkich węzłów, które nakładają się na węzeł testowy. Jeśli żaden węzeł testowy nie nakłada się na węzeł testowy, lista jest pusta.

Zobacz również

• overlapTest(Node)

void void removeOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)

Usuwa detektor, który zostanie wywołany przed wywołaniem funkcji Scene.OnTouchListener. Jest ona wywoływana nawet przy użyciu gestu, co pozwala obserwować wszystkie zdarzenia ruchu wysyłane do danej sceny. Nazywa się to nawet wtedy, gdy kontakt nie znajduje się w węźle, w którym przypadku wartość getNode() jest pusta.

Parametry

OnPeekTouchListener	Szybki podgląd detektora do usunięcia

void void removeOnUpdateListener (Scene.OnUpdateListener onUpdateListener)

Usuwa detektor, który jest wywoływany raz na klatkę bezpośrednio przed aktualizacją.

Parametry

onUpdateListener	detektor aktualizacji do usunięcia

void void setLightEstimated (Kolor, korekcja kolorów pływającego piksela)

Ustawia szacowaną wartość światła, aby modyfikować oświetlenie i natężenie światła. Wyrenderowane oświetlenie będzie korzystać z połączenia tych wartości, a także kolorów i intensywności żarówki. Wartość białej korekcji kolorów i intensywności piksela 1 oznacza, że w ustawieniach światła nie są wprowadzane żadne zmiany.

Ta scena jest wykorzystywana przez sceny AR AR do dostosowywania oświetlenia na podstawie wartości ARCore. Scena AR wyświetli się automatycznie i może zastąpić inne ustawienia. W większości przypadków nie trzeba tego wywoływać.

Parametry

korekcja kolorów	modyfikuje kolor oświetlenia sceny.
Intensywność piksela	modyfikuje intensywność oświetlenia sceny.

void void setOnTouchListener (Scene.OnTouchListener onTouchListener)

Zarejestruj wywołanie zwrotne, które ma być wywoływane po dotknięciu sceny. Wywołanie zwrotne zostanie wysłane po wysłaniu zdarzenia dotknięcia do węzłów w scenie, jeśli żaden węzeł nie wykorzysta tego zdarzenia. Jest to wywoływane nawet wtedy, gdy punkt dotykowy nie znajduje się nad węzłem. W takim przypadku getNode() ma wartość NULL.

Parametry

onTouchListener	detektor dotykowy do podłączenia