Sahne Sahnesi, bir sahnenin içeriğinin hiyerarşik düzeni olan sahne grafiğini tutar. Bir sahnede sıfır veya daha fazla alt düğüm olabilir ve her düğüm sıfır ya da daha fazla alt düğüme sahip olabilir.
Sahne ayrıca bir MotionEvent veya Ray tarafından hangi düğümün dokunduğunu algılamanın bir yolu olan isabet testini de sağlar.
İç içe Dersler
arayüz | Sahne.OnPeekTouchListener | Bir sahneye bir dokunma etkinliği gönderildiğinde çağrılacak bir geri çağırmanın arayüz tanımı. | |
arayüz | Sahne.OnTouchListener | Bir sahneye bir dokunma etkinliği gönderildiğinde çağrılacak bir geri çağırmanın arayüz tanımı. | |
arayüz | Sahne.OnUpdateListener | Sahne güncellenmeden hemen önce, her karede bir kez çağrılacak bir geri çağırmanın arayüz tanımı. |
Alanlar
herkese açık statik nihai EnvironmentalHdrParameters | VARSAYILAN_HDR_PARAMETRELER |
İnşaat Ustaları
Herkese Açık Yöntemler
geçersiz |
addOnPeekTouchListener(Sahne.OnPeekTouchListener onPeekTouchListener)
Scene.OnTouchListener çağrılmadan önce çağrılacak bir dinleyici ekler. |
geçersiz |
addOnUpdateListener(Scene.OnUpdateListener onUpdateListener)
Sahne güncellenmeden hemen önce kare başına bir kez dinlenecek bir dinleyici ekler.
|
Kamera |
getKamera()
Sahneyi oluşturmak için kullanılan kamerayı alın.
|
Düğüm |
getSunlight()
Varsayılan güneş ışığı düğümünü alın.
|
SceneView |
getView()
Sahneyi oluşturmak için kullanılan SceneView'u döndürür.
|
HitTestSonu |
hitTest(MotionEvent motionEvent)
Bir hareket etkinliğinin, kaynağı hareket etkinliğinin ekran konumu olan ışın isabeti testine göre sahnedeki herhangi bir düğüme dokunup dokunmadığını görmek için test yapar ve ekrana en yakın düğümü içeren bir HitTestResult oluşturur.
|
HitTestSonu | |
ArrayList<HitTestResult> |
hitTestAll(Ray raylı)
Bir ışının sahnedeki herhangi bir düğüme vurup vurmadığını ve vurulan tüm düğümleri içeren ve uzaklığa göre sıralanmış bir TestTestSonuçları listesi döndürüp döndürmediğini test eder.
|
ArrayList<HitTestResult> |
hitTestAll(MotionEvent motionEvent)
Bir hareket etkinliğinin sahnedeki herhangi bir düğüme dokunup dokunmadığını ve isabet edilen tüm düğümleri içeren ve mesafeye göre sıralanmış bir HitTestResult listesi döndürdüğünü test eder.
|
geçersiz |
onAddChild(Düğüm alt öğesi)
|
geçersiz |
onRemoveChild(Düğüm alt öğesi)
|
Düğüm |
overlapTest(Düğüm düğümü)
Belirli bir düğümün çakışma şeklinin,
getCollisionShape() kullanarak sahnedeki diğer düğümlerin çakışma şekli ile çakışıp çakışmadığını kontrol eder. |
ArrayList<Düğüm> |
overlapTestAll (Düğüm düğümü)
Bir düğümün
getCollisionShape() kullanarak sahnedeki diğer düğümlerle çakışıp çakışmadığını kontrol eder. |
geçersiz |
removeOnPeekTouchListener(Sahne.OnPeekTouchListener onPeekTouchListener)
Scene.OnTouchListener çağrılmadan önce çağrılacak bir dinleyiciyi kaldırır. |
geçersiz |
removeOnUpdateListener(Scene.OnUpdateListener onUpdateListener)
Sahne güncellenmeden hemen önce kare başına bir kez dinlenecek bir dinleyiciyi kaldırır.
|
geçersiz |
setLightTahmin(Renk renk düzeltme, kayan pikselIntensity)
Sahne ışıklandırmasını ve yoğunluğunu değiştirmek için ışık tahminini ayarlar.
|
geçersiz |
setOnTouchListener(Scene.OnTouchListener onTouchListener)
Sahneye dokunulduğunda çağrılacak bir geri çağırma kaydedin.
|
Devralınan Yöntemler
Alanlar
herkese açık statik EnvironmentalHdrParameters DEFAULT_HDR_PARAMETERS
İnşaat Ustaları
herkese açık Sahne (SceneView görünümü)
Belirtilen bağlamla bir sahne oluşturun.
Parametreler
göster |
---|
Herkese Açık Yöntemler
genel geçersiz addOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)
Scene.OnTouchListener
çağrılmadan önce çağrılacak bir dinleyici ekler. Hareket tüketilse bile bu çağrılır, böylece sahneye gönderilen tüm hareket etkinlikleri gözlemlenebilir. Buna, düğüm bir düğümün üzerinde olmasa bile çağrılır. Bu durumda, getNode()
boş olacaktır. Dinleyiciler, eklendikleri sırayla aranır.
Parametreler
PeeekTouchListener | ekleyebileceğiniz temaslı dinleyici |
---|
genel geçersiz addOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Sahne güncellenmeden hemen önce kare başına bir kez dinlenecek bir dinleyici ekler. Dinleyiciler, eklendikleri sırayla aranır.
Parametreler
onUpdateListener'ı | eklemek için güncelleme dinleyicisi |
---|
herkese açık Kamera get Camera ()
Sahneyi oluşturmak için kullanılan kamerayı alın. Kamera bir düğüm türüdür.
İadeler
- sahneyi oluşturmak için kullanılan kamera
herkese açık Düğüm getSunlight ()
Varsayılan güneş ışığı düğümünü alın.
İadeler
- sahneyi aydınlatmak için kullanılan güneş ışığı düğümü
herkese açık HitTestResult hitTest (MotionEvent motionEvent)
Bir hareket etkinliğinin, kaynağı hareket etkinliğinin ekran konumu olan ışın isabeti testine göre sahnedeki herhangi bir düğüme dokunup dokunmadığını görmek için test yapar ve ekrana en yakın düğümü içeren bir HitTestResult oluşturur.
Parametreler
hareket etkinliği | test için kullanılacak hareket etkinliği |
---|
İadeler
- Sonuç, hareket etkinliğiyle sonuçlanan ilk düğümü (boş olabilir) ve hareket etkinliğinin düğüm içinde düğüme vurduğu yer hakkındaki bilgileri içerir
herkese açık HitTestResult hitTest (Ray ışını)
Test ederek bir ışının sahnedeki herhangi bir düğüme vurup vurmadığını kontrol eder ve ışın kaynağıyla en yakın düğümü içeren, ışınla kesişen bir HitTestResult elde eder.
Parametreler
Ray | test için kullanılacak ışın |
---|
İadeler
- Sonuç, ışın tarafından vurulan ilk düğümü (boş olabilir) ve dünya uzayında ışının düğümü
İlgili Konular
public ArrayList<HitTestResult> hitTestAll (Işın ışını)
Bir ışının sahnedeki herhangi bir düğüme vurup vurmadığını ve vurulan tüm düğümleri içeren ve uzaklığa göre sıralanmış bir TestTestSonuçları listesi döndürüp döndürmediğini test eder.
Parametreler
Ray | Test için kullanılacak ışın. |
---|
İadeler
- İsabete göre isabet alan her bir düğüm için mesafeye göre sıralanmış bir TestTestSonuçu ile doldurulur. Hiçbir düğüme ulaşılmadıysa boş olur.
İlgili Konular
public ArrayList<HitTestResult> hitTestAll (MotionEvent motionEvent)
Bir hareket etkinliğinin sahnedeki herhangi bir düğüme dokunup dokunmadığını ve isabet edilen tüm düğümleri içeren ve mesafeye göre sıralanmış bir HitTestResult listesi döndürdüğünü test eder.
Parametreler
hareket etkinliği | Test için kullanılacak hareket etkinliği. |
---|
İadeler
- İsabete göre isabet alan her bir düğüm için mesafeye göre sıralanmış bir TestTestSonuçu ile doldurulur. Hiçbir düğüme ulaşılmadıysa boş olur.
genel Düğüm örtüşme Testi (Düğüm düğümü)
Belirli bir düğümün çakışma şeklinin, getCollisionShape()
kullanarak sahnedeki diğer düğümlerin çakışma şekli ile çakışıp çakışmadığını kontrol eder. Test için kullanılan düğümün etkin olması gerekmez.
Parametreler
düğüm | Test için kullanılacak düğüm. |
---|
İadeler
- Test düğümüyle çakışan bir düğüm. Test düğümüyle çakışan düğüm yoksa bu boş olur. Test düğümü birden çok düğümle çakışıyorsa bunlardan herhangi biri olabilir.
İlgili Konular
public ArrayList<Node> overlapTestAll (Düğüm düğümü)
Bir düğümün getCollisionShape()
kullanarak sahnedeki diğer düğümlerle çakışıp çakışmadığını kontrol eder. Test için kullanılan düğümün etkin olması gerekmez.
Parametreler
düğüm | Test için kullanılacak düğüm. |
---|
İadeler
- Test düğümüyle çakışan tüm düğümlerin listesi. Test düğümüyle çakışan düğüm yoksa liste boş olur.
İlgili Konular
herkese açık geçersiz removeOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)
Scene.OnTouchListener
çağrılmadan önce çağrılacak bir dinleyiciyi kaldırır.
Bu işlem, hareket tüketilse bile çağrılır ve böylece sahneye gönderilen tüm hareket etkinliklerini gözlemlenebilir. Bu ad, düğüm bir düğümün üzerinde olmasa bile çağrılır. Bu durumda, getNode()
boş olacaktır.
Parametreler
PeeekTouchListener | kısa bakış dinleyicisini kaldırın |
---|
public invalid removeOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Sahne güncellenmeden hemen önce kare başına bir kez dinlenecek bir dinleyiciyi kaldırır.
Parametreler
onUpdateListener'ı | kaldırmak için güncelleme dinleyicisi |
---|
herkese açık geçersiz setLightTahmin (Renk renk düzeltme, kayan pikselIntensity)
Sahne ışıklandırmasını ve yoğunluğunu değiştirmek için ışık tahminini ayarlar. Oluşturulan ışıklar, bu değerlerin ve ışıkların rengi ile yoğunluğunun bir kombinasyonunu kullanır. Beyaz renk düzeltme ve piksel yoğunluğu 1 olduğunda ışık ayarlarında değişiklik yapılmaz.
Bu, AR Sceneform sahnelerinde dahili olarak ARCore'un değerlerine göre ışıklandırmayı ayarlamak için kullanılır. Artırılmış gerçeklik (AR) sahnesi bunu otomatik olarak çağırır ve muhtemelen diğer ayarlar geçersiz kılınır. Çoğu durumda bunu açıkça belirtmeniz gerekmez.
Parametreler
renk düzeltme | sahnenin ışıklandırma rengini değiştirir. |
---|---|
pixelYoğunluğu | sahnenin ışık yoğunluğunu değiştirir. |
herkese açık geçersiz setOnTouchListener (Sahne.OnTouchListener onTouchListener
Sahneye dokunulduğunda çağrılacak bir geri çağırma kaydedin. Etkinliği tüketen bir düğüm yoksa dokunma etkinliği sahnedeki düğümlere gönderildikten sonra geri çağırma çalıştırılır. Buna, düğüm bir düğümün üzerinde olmasa bile çağrılır. Bu durumda, getNode()
boş olacaktır.
Parametreler
onTouchListener | eklemek için dokunmatik dinleyici |
---|