סביבת תאורה

כיתה ציבורית סצנה

סצנת הסצנה כוללת את גרף הסצנה, ארגון היררכי של תוכן מסצנה. סצנת הצאצאים יכולה להכיל אפס צומתי צאצא או יותר, ולכל צומת יכול להיות אפס צומתי צאצא או יותר.

הסצינה כוללת גם בדיקת היט, שמאפשרת לזהות את הצומת שעליו לגעת ב-MotionEvent או ב-Ray.

מחלקות בתוך רכיב

משופר	Scene.OnPeekTouchListener		הגדרת ממשק להפעלה של קריאה חוזרת (callback) כשאירוע מגע נשלח לסצנה.
משופר	Scene.OnTouchListener		הגדרת ממשק להפעלה של קריאה חוזרת (callback) כשאירוע מגע נשלח לסצנה.
משופר	Scene.OnUpdateListener		הגדרת הממשק לקריאה חוזרת (callback) תופעל פעם אחת בכל פריים, מיד לפני עדכון הסצנה.

שדות

ציבורי סטטי סופי EnvironmentalHdrParameters

DEFAULT_HDR_PARAMETERS

בונים ציבוריים

Scene (תצוגת SceneView) יוצרים סצנה עם ההקשר הנתון.

שיטות ציבוריות

ביטול	addOnPeekTouchListener(Scene.OnPeekTouchListener ב-PeekTouchListener) מוסיף מאזינים שייקראו לפני הפעלת Scene.OnTouchListener.
ביטול	addOnUpdateListener(Scene.OnUpdateListener onUpdateListener) מוסיף מאזינים שייקראו פעם אחת לכל מסגרת מיד לפני עדכון הסצנה.
מצלמה	getCamera() מורידים את המצלמה המשמשת לעיבוד הסצנה.
צומת	getSunlight() קבלת ברירת המחדל של צומת אור השמש.
תרחיש	getView() מחזירה את תצוגת הסצנה המשמשת ליצירת הסצנה.
היט בדיקה	hitTest(MotionEvent תנועה Event) בודקת אם אירוע תנועה נוגע בצמתים כלשהם בסצנה, על סמך בדיקת היט ריי שהמקור שלה הוא מיקום המסך של אירוע התנועה. היא יוצרת פלט של בהטת מבחן המכיל את הצומת הקרוב ביותר למסך.
היט בדיקה	hitTest(Ray ray) בודקת אם רנטגן מגיע לצמתים כלשהם בסצנה ופלטת תוצאות של TestTest.
ArrayList<HitTestResult>	hitTestAll(קרן ריי מתבצעת בדיקה אם רנטגן מגיע לצמתים כלשהם בסצנה ומחזיר רשימה של תוצאות מבחן הבדיקה המכילות את כל הצמתים שהתקבלו, ממוינים לפי מרחק.
ArrayList<HitTestResult>	hitTestAll(MotionEvent trafficEvent) הבדיקה בודקת אם אירוע תנועה נוגע בצמתים כלשהם בסצנה ומחזירה רשימה של התאמות של בודקים.
ביטול	onAddChild(צומת ילד)
ביטול	onRemoveChild(צומת ילד)
צומת	overlapTest(צומת צומת) מאפשר לבדוק אם צורת ההתנגשות של צומת מסוים חופפת לצומת התנגשות אחר באמצעות getCollisionShape().
ArrayList<Node>	overlapTestAll(צומת צומת) בדיקה אם צומת חופף לצמתים אחרים בסצנה באמצעות getCollisionShape().
ביטול	removeOnPeekTouchListener(Scene.OnPeekTouchListener ב-PeekTouchListener) הסרה של מאזינים שייקראו לפני ההפעלה של Scene.OnTouchListener.
ביטול	removeOnUpdateListener(Scene.OnUpdateListener onUpdateListener) הסרה של מאזינים שייקראו פעם אחת לכל פריים לפני עדכון הסצנה.
ביטול	setLightestimated(צבעתיקון, float pixelIntensity) מגדיר את התאורה המשוערת כדי לשנות את התאורה ואת העוצמה של הסצנה.
ביטול	setOnTouchListener(Scene.OnTouchListener ב-TouchListener) רישום של קריאה חוזרת (callback) שיופעל כשנוגעים בסצנה.

שיטות שעברו בירושה

מתוך הכיתה com.google.ar.sceneform.Nodeהורה

ביטול סופי	addChild(צומת ילד) מוסיף צומת כצאצא של Nodeהורה זה.
ביטול	callOnHiirrchy(Consumer<Node> Consumer) חוצה את ההיררכיה וקוראים לשיטה בכל צומת.
boolean	canAddChild(צאצא של צומת, סיבת הכשל של StringBuilder)
צומת	findByName(שם מחרוזת) חוצה את ההיררכיה כדי למצוא את הצומת הראשון עם שם נתון.
צומת	findInHiirrchy(Predicate<Node>condition) חוצה את ההיררכיה כדי למצוא את הצומת הראשון שעומד בתנאי.
הסופי List<Node>	getkids() מחזירה רשימה קבועה של הילדים של ההורה הזה.
ביטול	onAddChild(צומת ילד)
ביטול	onRemoveChild(צומת ילד)
ביטול סופי	removeChild(צומת ילד) מסיר צומת מהילדים של הצומת הזה.

class Java.lang.Object

אובייקט	clone()
boolean	equals(Object arg0)
ביטול	finalize()
סופי class<?>	getClass()
int	HashCode()
ביטול סופי	know()
ביטול סופי	knowAll()
מחרוזת	toString()
ביטול סופי	Pending(long arg0, int arg1)
ביטול סופי	Pending(long arg0)
ביטול סופי	Pending()

שדות

גלוי לכול סטטי EnvironmentalHdrParameters DEFAULT_HDR_PARAMETERS

בונים ציבוריים

גלוי לכול סצנה (צפייה ב-SceneView)

יוצרים סצנה עם ההקשר הנתון.

פרמטרים

תצוגה

שיטות ציבוריות

Public null addOnPeekTouchListener (Scene.OnPeekTouchListener ב-PeekTouchListener)

מוסיף מאזינים שייקראו לפני הפעלת Scene.OnTouchListener. פעולה זו מופעלת גם אם התנועה נאספה, כך שניתן לצפות בכל אירועי התנועה שנשלחו לסצנה. הנתון הזה נקרא גם אם המגע לא מעל לצומת, ובמקרה כזה getNode() יהיה ריק. המאזינים ייקראו לפי הסדר שבו הם נוספו.

פרמטרים

onPeekTouchListener	הצצה למסך

Public null addOnUpdateListener (Scene.OnUpdateListener onUpdateListener)

מוסיף מאזינים שייקראו פעם אחת לכל מסגרת מיד לפני עדכון הסצנה. שם המאזינים ייקרא בסדר שבו הם נוספו.

פרמטרים

onUpdateListener	כלי ההאזנה לעדכון

גלוי לכול מצלמה getCamera ()

מורידים את המצלמה המשמשת לעיבוד הסצנה. המצלמה היא סוג של צומת.

החזרות

• המצלמה ששימשה לעיבוד הסצנה

גלוי לכול צומת getSunlight ()

קבלת ברירת המחדל של צומת אור השמש.

החזרות

• צומת השמש המשמש לתאורת הסצנה

גלוי לכול SceneView getView ()

מחזירה את תצוגת הסצנה המשמשת ליצירת הסצנה.

Public HitTestResult hitTest (MotionEvent trafficEvent)

בודקת אם אירוע תנועה נוגע בצמתים כלשהם בסצנה, על סמך בדיקת היט ריי שהמקור שלה הוא מיקום המסך של אירוע התנועה. היא יוצרת פלט של בהטת מבחן המכיל את הצומת הקרוב ביותר למסך.

פרמטרים

אירועי תנועה	אירוע התנועה שבו יש להשתמש לבדיקה

החזרות

• התוצאה כוללת את הצומת הראשון שהוצג על ידי אירוע התנועה (ייתכן שהוא null), ומידע על המקום שבו אירוע התנועה הגיע לצומת במרחב המשותף

Public HitTestResult hitTest (Ray ray)

בודקת אם רנטגן מגיע לצמתים כלשהם בסצנה ופלטת תוצאות של TestTest.

פרמטרים

Ray	החיסון שישמש לבדיקה

החזרות

• התוצאה כוללת את הצומת הראשון שהושג על ידי ה-ray (יכול להיות ריק), ומידע על האופן שבו הקרן הגיעה לצומת במרחב המשותף

ראו בנוסף

• screenPointToRay(float, float)

Public ArrayList<HitTestResult> hitTestAll (Ray ray)

מתבצעת בדיקה אם רנטגן מגיע לצמתים כלשהם בסצנה ומחזיר רשימה של תוצאות מבחן הבדיקה המכילות את כל הצמתים שהתקבלו, ממוינים לפי מרחק.

פרמטרים

Ray	הקרן שבה רוצים להשתמש בבדיקה.

החזרות

• שדה זה מאוכלס בהיט של תוצאות בדיקה עבור כל צומת שזוהה לפי מרחק. ריק אם לא בוצעה צמתים.

ראו בנוסף

• screenPointToRay(float, float)

Public ArrayList<HitTestResult> hitTestAll (MotionEvent trafficEvent)

הבדיקה בודקת אם אירוע תנועה נוגע בצמתים כלשהם בסצנה ומחזירה רשימה של התאמות של בודקים.

פרמטרים

אירועי תנועה	אירוע התנועה שבו יש להשתמש לבדיקה.

החזרות

• שדה זה מאוכלס בהיט של תוצאות בדיקה עבור כל צומת שזוהה לפי מרחק. ריק אם לא בוצעה צמתים.

Public null onAddChild (צומת הילד)

פרמטרים

צאצא

Public null onRemoveChild (צומת)

פרמטרים

צאצא

גלוי לכול צומת overlapTest (צומת)

מאפשר לבדוק אם צורת ההתנגשות של צומת מסוים חופפת לצומת התנגשות אחר באמצעות getCollisionShape(). הצומת המשמש לבדיקה לא צריך להיות פעיל.

פרמטרים

צומת (Node)	הצומת שבו יש להשתמש לבדיקה.

החזרות

• צומת שחופף לצומת הבדיקה. אם אין צומת שחופף לצומת הבדיקה, הערך יהיה null. אם מספר צמתים חופפים זה לזה, הצומת יכול להיות אחד מהם.

ראו בנוסף

• overlapTestAll(Node)

Public ArrayList<Node> overlapTestAll (צומת צומת)

בדיקה אם צומת חופף לצמתים אחרים בסצנה באמצעות getCollisionShape(). הצומת המשמש לבדיקה אינו צריך להיות פעיל.

פרמטרים

צומת (Node)	הצומת שבו יש להשתמש לבדיקה.

החזרות

• רשימה של כל הצמתים שחופפים לצומת הבדיקה. אם אין צומת שחופף לצומת הבדיקה, הרשימה תהיה ריקה.

ראו בנוסף

• overlapTest(Node)

Public null removeOnPeekTouchListener (Scene.OnPeekTouchListener ב-PeekTouchListener)

הסרה של מאזינים שייקראו לפני ההפעלה של Scene.OnTouchListener. פעולה זו מתבצעת גם אם התנועה שימוש, מה שמאפשר לראות את כל אירועי התנועה שנשלחו לסצנה. הנתון הזה נקרא גם אם המגע לא מעל לצומת, ובמקרה כזה getNode() יהיה ריק.

פרמטרים

onPeekTouchListener	הצצה למסך

Public null removeOnUpdateListener (Scene.OnUpdateListener onUpdateListener)

הסרה של מאזינים שייקראו פעם אחת לכל פריים לפני עדכון הסצנה.

פרמטרים

onUpdateListener	כלי ההאזנה לעדכון

Public null setLightVALUE (צבעFix, float pixelIntensity)

מגדיר את התאורה המשוערת כדי לשנות את התאורה ואת העוצמה של הסצנה. התאורה המעובדת תשתמש בשילוב של הערכים האלה, בצבע ובעוצמה של האורות. אם הערך 1 תיקון לבן לבן ועוצמת הפיקסלים 1, לא יתבצעו שינויים בהגדרות התאורה.

משמש בסצנות AR של הדמיה פנימית כדי להתאים את התאורה על סמך ערכים מ-ARCore. סצנה ב-AR תזהה זאת באופן אוטומטי, וייתכן שהיא תדלג על הגדרות אחרות. ברוב המקרים, אין צורך לציין זאת במפורש.

פרמטרים

תיקון צבע	מודולש את צבע התאורה של הסצנה.
עוצמת פיקסלים	מודולק את עוצמת התאורה בסצנה.

Public null setOnTouchListener (Scene.OnTouchListener onTouchListener)

רישום של קריאה חוזרת (callback) שיופעל כשנוגעים בסצנה. הקריאה החוזרת תופעל לאחר שאירוע המגע יישלח לצמתים בסצנה, אם הצומת לא צרך את האירוע. פעולה זו נקראת גם אם המגע לא מעל לצומת, ובמקרה כזה הgetNode() יהיה ריק.

פרמטרים

onTouchListener	האזנה במגע לצירוף