צומת

מחלקה ציבורית צומת

סיווגי משנה ישירים עוגןNode , AugmentedFaceNode, BaseTransformableNode, מצלמה, SkeletonNode, ראשון עוגת עוגן צומת שנמצא באופן אוטומטי במרחב העולמי על סמך ARCore עוגן.  AugmentedFaceNode הצומת משמש לרינדור של אפקטים חזותיים על הפנים באמצעות התכונה AugmentedFace של ARCore&. BaseTransformableNode מחלקה בסיסית של צמתים שאפשר לשנות באמצעות תנועות מ-TransformationSystem.  מצלמה מייצג מצלמה וירטואלית, שקובעת את נקודת המבט שבה צופים בסצנה.  SkeletonNode Node המספק מיפויים בין עצמות הModelRenderable של העור וקבוצה של Node.  יום ראשון מייצג את "sun" - ברירת המחדל של תאורת הכיוון בסצנה.

סיווגי משנה עקיפים ידועים TransformableNode TransformableNode צומת שאפשר לבחור, לתרגם, לסובב ולשנות את קנה המידה באמצעות תנועות מ-TransformationSystem.

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

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

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

משופר	Node.LifecycleListener		הגדרת ממשק להפעלה של קריאות חוזרות (callback) כאשר מתרחשים אירועים במחזור החיים של הצומת.
משופר	Node.OnTapListener		הגדרת ממשק להפעלה של קריאה חוזרת (callback) כשמקישים על צומת.
משופר	Node.OnTouchListener		הגדרת ממשק לקריאה חוזרת (callback) תופעל כשאירוע מגע יישלח לצומת הזה.
משופר	Node.TransformChangedListener		הגדרת הממשק לקריאה חוזרת (callback) תופעל כאשר הטרנספורמציה של הצומת משתנה.

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

צומת() יצירת צומת ללא הורה.

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

ביטול	addLifecycleListener(Node.LifecycleListener LifecycleListener) מוסיף מאזינים שייקראו כאשר יתקיימו אירועים במחזור החיים של הצומת.
ביטול	addTransformChangedListener(Node.TransformChangedListener transformChangedListener) מוסיף מאזינים שייקראו בעת שינוי הטרנספורמציה של הצומת #39.
ביטול	callOnHiirrchy(Consumer<Node> Consumer) חוצה את ההיררכיה וקוראים לשיטה בכל צומת (כולל הצומת הזה).
צומת	findInHiirrchy(Predicate<Node>condition) חוצה את ההיררכיה כדי למצוא את הצומת הראשון (כולל הצומת הזה) שעומד בתנאי.
סופי Vector3	getBack() מקבל את הוקטור האחורי של המרחב המשותף (+z) עבור הצומת הזה.
צורת התנגשות	getCollisionצורת() קבלת הצורה לשימוש עבור התנגשויות עם הצומת הזה.
סופי Vector3	getdown() מקבל את הווקטור כלפי מטה של המרחב המשותף (-y) של הצומת הזה.
סופי Vector3	getforward() מקבלת את הווקטור הקדמי של המרחב המשותף (-z) עבור הצומת הזה.
סופי Vector3	getleft() מקבל את הוקטור השמאלי של המרחב המשותף (-x) עבור הצומת הזה.
בהיר	getLight() מקבל את האור הנוכחי, שניתן לשנות אותו.
סופי Vector3	getLocalLocation() קבלת עותק של מיקום הצמתים ביחס להורה שלו (מרחב מקומי).
סופי רבעון	getLocalRotation() קבלת עותק של סבב הצמתים ביחס להורה שלו (מרחב מקומי).
סופי Vector3	getLocalScale() יוצג עותק של קנה המידה של הצמתים ביחס להורה שלו (מרחב מקומי).
סופי מחרוזת	getName() מחזירה את שם הצומת.
סופי צומת	getהורה() מחזירה את ההורה של הצומת הזה.
ניתן לעיבוד	getRenderable() מקבל אפשרות להצגה של הצומת הזה.
סופי Vector3	getright() מקבל את הוקטור הימני של המרחב המשותף (+x) עבור הצומת הזה.
סופי סצנה	getScene() מחזירה את הצומת שהצומת הוא חלק ממנו, null אם הוא לא חלק מסצנה כלשהי.
סופי Vector3	getUp() מקבלת את הווקטור של המרחב המשותף למעלה (+y) של הצומת הזה.
סופי Vector3	getWorldLocation() עותק של מיקום הצמתים בעולם.
סופי רבעון	getWorldRotation() קבלת עותק של סבב המרחבים המשותפים.
סופי Vector3	getWorldScale() קבלת עותק של קנה המידה של המרחב המשותף בצמתים.
ערך בוליאני סופי	isActive() פונקציה זו מחזירה את הערך True אם הצומת פעיל.
ערך בוליאני סופי	isDescendantOf(Nodeהורה אב) מתבצעת בדיקה אם הצומת האב הוא אב של הצומת בצורה חוזרת.
ערך בוליאני סופי	isEnabled() קבלת המצב הפעיל של הצומת הזה.
boolean	isTopLevel() פונקציה זו מחזירה את הערך True אם הצומת הזה הוא ברמה העליונה.
סופי Vector3	localToWorldDirection(כיוון Vector3) ממירה כיוון מהמרחב המקומי של הצומת הזה למרחב משותף.
סופי Vector3	localToWorldPoint(נקודה אחת (Vector3) ממירה נקודה במרחב המקומי של הצומת הזה למרחב משותף.
ביטול	onActivate() מטפל כשהצומת הזה הופך לפעיל.
ביטול	onהשבתה( מטפל כשהצומת הזה מושבת.
boolean	onTouchEvent(HitTestResult היטTestResult, MotionEvent trafficEvent) מטפל כשנוגעים בצומת הזה.
ביטול	onTransformChange(צומת שמקורו בצומת) מטפל כשטרנספורמציה של הצומת הזה משתנה.
ביטול	onUpdate(FrameTime frameworkTime) ניהול הטיפול כשהצומת הזה מעודכן.
ביטול	removelifecycleListener(Node.LifecycleListener LifecycleListener) הסרת מאזינים שייקראו במועד שבו מתרחשים אירועים במחזור החיים של הצומת.
ביטול	removeTransformChangedListener(Node.TransformChangedListener transformChangedListener) מסיר את המאזינים שייקראו כשהטרנספורמציה של הצומת תשתנה.
ביטול	setCollisionצורת(Collision הצורה התנגשות) מגדיר את הצורה המשמשת לזיהוי התנגשויות עבור Node.
ביטול סופי	setEnabled(הפעלה בוליאנית) הגדרת המצב הפעיל של הצומת הזה.
ביטול	setLight(בהיר) הגדרה של Light להצגה.
ביטול	setLocalLocation(מיקום Vector3) מגדיר את המיקום של הצומת הזה ביחס להורה שלו (מרחב מקומי).
ביטול	setLocalRotation(סבב Quaternion) מגדירה את הסיבוב של הצומת הזה ביחס להורה שלו (מרחב מקומי).
ביטול	setLocalScale(קנה מידה של Vector3) מגדיר את קנה המידה של הצומת הזה ביחס להורה שלו (מרחב מקומי).
ביטול סופי	setLookDirection(Vector3 LookDirection) הגדרת הכיוון שבו הצומת רואה במרחב המשותף.
ביטול סופי	setLookDirection(Vector3 LookDirection, Vector3 upDirection) הגדרת הכיוון שבו הצומת רואה במרחב המשותף.
ביטול סופי	setName(שם מחרוזת) מגדיר את השם של הצומת הזה.
ביטול	setOnTapListener(Node.OnTapListener onTapListener) רישום קריאה חוזרת (callback) להפעלת הצומת.
ביטול	setOnTouchListener(Node.OnTouchListener ב-TouchToucher) רושם קריאה חוזרת (callback) שיופעל כשאירוע מגע יישלח לצומת הזה.
ביטול	set הורה(הורה ראשי) שינוי הצומת של הצומת של הצומת הזה.
ביטול	setRenderable(ניתן לעיבוד (ניתן לעיבוד) מגדיר את Renderable להצגה עבור הצומת הזה.
ביטול	setWorldLocation(מיקום Vector3) הגדרת המיקום של המרחב המשותף של הצומת הזה בעולם.
ביטול	setWorldRotation(Quaternion סבב) מגדיר את סיבוב המרחב המשותף של הצומת הזה.
ביטול	setWorldScale(קנה מידה של Vector3) מגדיר את קנה המידה של המרחב המשותף בצומת הזה.
מחרוזת	toString()
סופי Vector3	worldToLocalDirection(מסלול וקטור3) ממירה כיוון ממרחב משותף למרחב המקומי של הצומת הזה.
סופי Vector3	worldToLocalPoint(נקודה אחת (Vector3) ממירה נקודה במרחב המשותף למרחב המקומי של הצומת הזה.

שיטות מוגנות

ערך בוליאני סופי	canAddChild(צאצא של צומת, סיבת הכשל של StringBuilder)
ביטול סופי	onAddChild(צומת ילד)
ביטול סופי	onRemoveChild(צומת ילד)

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

מתוך הכיתה 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()

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

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

יצירת צומת ללא הורה.

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

Public null addLifecycleListener (Node.LifecycleListener LifecycleListener)

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

פרמטרים

מחזור החיים של המאזינים

Public null addTransformChangedListener (Node.TransformChangedListener transformChangedListener)

מוסיף מאזינים שייקראו בעת שינוי הטרנספורמציה של הצומת #39.

פרמטרים

TransformChangedListener

Public null callOnHiirrchy (Consumer<Node> Consumer)

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

פרמטרים

צרכן	השיטה שיש לקרוא בכל צומת

ציבורי צומת findInHiirrchy (Predicate<Node>condition)

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

פרמטרים

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

החזרות

• הצומת הראשון שתואם לתנאי החיזוי, אחרת יוחזר null

גלוי לכולם Vector3 getBack ()

מקבל את הוקטור האחורי של המרחב המשותף (+z) עבור הצומת הזה.

החזרות

• וקטור חדש שמייצג את כיוון החזרה של הצומת במרחב המשותף

גלוי לכול Collision הצורה getCollision הצורה ()

קבלת הצורה לשימוש עבור התנגשויות עם הצומת הזה. אם הצורה ריקה וsetRenderable(Renderable) מוגדר, getCollisionShape() משמש לזיהוי התנגשויות בNode.

החזרות

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

ראו בנוסף

• hitTest(Ray)
• hitTestAll(Ray)
• overlapTest(Node)
• overlapTestAll(Node)

גלוי לכול סופי Vector3 getdown ()

מקבל את הווקטור כלפי מטה של המרחב המשותף (-y) של הצומת הזה.

החזרות

• וקטור חדש שמייצג את כיוון השעון בצומת

Public final Vector3 getforward ()

מקבלת את הווקטור הקדמי של המרחב המשותף (-z) עבור הצומת הזה.

החזרות

• וקטור חדש שמייצג את כיוון ההתקדמות של הצומת במרחב המשותף

גלוי לכולם Vector3 getleft ()

מקבל את הוקטור השמאלי של המרחב המשותף (-x) עבור הצומת הזה.

החזרות

• וקטור חדש שמייצג את הכיוון השמאלי של הצומת במרחב המשותף

גלוי לכול בהיר getLight ()

מקבל את האור הנוכחי, שניתן לשנות אותו.

גלוי לכולם Vector3 getLocalLocation ()

קבלת עותק של מיקום הצמתים ביחס להורה שלו (מרחב מקומי). אם הערך של isTopLevel() הוא TRUE, הערך זהה ל-getWorldPosition().

החזרות

• וקטור חדש שמייצג את מיקום המרחב המשותף של הצומת

ראו בנוסף

• setLocalPosition(Vector3)

גלוי לכולם Quaternion getLocalRotation ()

קבלת עותק של סבב הצמתים ביחס להורה שלו (מרחב מקומי). אם הערך של isTopLevel() הוא TRUE, הערך זהה ל-getWorldRotation().

החזרות

• מיחזור חדש המייצג את סבב המרחב המשותף של הצומת

ראו בנוסף

• setLocalRotation(Quaternion)

Public final Vector3 getLocalScale ()

יוצג עותק של קנה המידה של הצמתים ביחס להורה שלו (מרחב מקומי). אם הערך של isTopLevel() נכון, הערך זהה ל-getWorldScale().

החזרות

• וקטור חדש שמייצג את קנה המידה של המרחב המקומי של הצומת

ראו בנוסף

• setLocalScale(Vector3)

גלוי לכולם מחרוזת getName ()

מחזירה את שם הצומת. ערך ברירת המחדל הוא "Node".

גלוי לכול סופי צומת getהורה ()

מחזירה את ההורה של הצומת הזה. אם לNode הזה יש הורה, והורה הוא מחלקת משנה של Node או Node, פונקציה זו מחזירה את ההורה בתור Node. מחזירה null אם ההורה הוא Scene, יש להשתמש במקום זאת getScene() כדי לאחזר את ההורה.

החזרות

• הורה בתור Node, אם ההורה הוא Node.

Public Renderable getRenderable ()

מקבל אפשרות להצגה של הצומת הזה.

החזרות

• ניתן לעיבוד להצגה לצומת הזה

Public final Vector3 getright ()

מקבל את הוקטור הימני של המרחב המשותף (+x) עבור הצומת הזה.

החזרות

• וקטור חדש שמייצג את הכיוון הנכון של הצומת במרחב המשותף

Public final Scene getScene ()

מחזירה את הצומת שהצומת הוא חלק ממנו, null אם הוא לא חלק מסצנה כלשהי. צומת הוא חלק מסצינה אם ההורה הראשי שלו הוא Scene

גלוי לכולם Vector3 getUp ()

מקבלת את הווקטור של המרחב המשותף למעלה (+y) של הצומת הזה.

החזרות

• וקטור חדש שמייצג את כיוון הצומת במרחב המשותף

גלוי לכולם Vector3 getWorldLocation ()

עותק של מיקום הצמתים בעולם.

החזרות

• וקטור חדש שמייצג את מיקום המרחב המשותף של הצומת

ראו בנוסף

• setWorldPosition(Vector3)

גלוי לכולם Quaternion getWorldRotation ()

קבלת עותק של סבב המרחבים המשותפים.

החזרות

• מיחזור חדש המייצג את סיבוב המרחב המשותף של הצומת

ראו בנוסף

• setWorldRotation(Quaternion)

Public final Vector3 getWorldScale ()

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

החזרות

• וקטור חדש שמייצג את קנה המידה של המרחב המשותף בצומת

ראו בנוסף

• setWorldScale(Vector3)

גלוי לכול סופי בוליאני isActive ()

פונקציה זו מחזירה את הערך True אם הצומת פעיל. צומת נחשב כפעיל אם הוא עומד בכל התנאים הבאים:

• הצומת הוא חלק מסצנה.
• ההורה של הצומת פעיל.
• הצומת מופעל.

בצומת פעיל יש את ההתנהגות הבאה:

• תיקרא הפונקציה onUpdate(FrameTime) של הצומת בכל מסגרת.
• מתבצע עיבוד של getRenderable() של הצומת.
• הצומת של getCollisionShape() יהיה נבדק בקריאות ל-set.hitTest.
• תיקרא הפונקציה onTouchEvent(HitTestResult, MotionEvent) של הצומת כאשר נוגעים בו.

החזרות

• הסטטוס הפעיל של הצומת

ראו בנוסף

• onActivate()
• onDeactivate()

Public final בוליאני isDescendantOf (Nodeהורה אב)

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

פרמטרים

אב	צומת האב כדי לבדוק

החזרות

• True אם הצומת הוא אב של הצומת הזה

גלוי לכול סופי בוליאני isEnabled ()

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

החזרות

• הסטטוס המופעל של הצומת.

ראו בנוסף

• isActive()

Public בוליאני isTopLevel ()

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

החזרות

• True אם הצומת ברמה העליונה

גלוי לכול סופי Vector3 localToWorldDirection (מסלול וקטור3)

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

פרמטרים

direction	המסלול במרחב המקומי להמרה

החזרות

• וקטור חדש שמייצג את הכיוון במרחב המשותף

Public final Vector3 localToWorldPoint (Vector3 נקודה)

ממירה נקודה במרחב המקומי של הצומת הזה למרחב משותף.

פרמטרים

נקודה	הנקודה במרחב המקומי כדי להמיר

החזרות

• וקטור חדש שמייצג את הנקודה במרחב המשותף

Public null onActivate ()

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

שינוי מברירת המחדל לביצוע כל הגדרה שצריכה להתרחש כאשר הצומת מופעל.

ראו בנוסף

• isActive()
• isEnabled()

Public null onactivate ()

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

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

ראו בנוסף

• isActive()
• isEnabled()

new boolean onTouchEvent (HitTestResult ולהיט TestResult, MotionEvent trafficEvent)

מטפל כשנוגעים בצומת הזה.

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

כשמתרחש אירוע ACTION_DOWN, המשמעות היא שהתנועה מתחילה. ACTION_UP או ACTION_Cancel מייצגות מתי תנועה מסתיימת. כשהתנועה מתחילה, יתבצעו הפעולות הבאות:

• שליחת אירועי מגע לצומת שבו זוהה הקטע hitTest(MotionEvent).
• אם הצומת לא צורך את האירוע, הוא יחזור כלפי מעלה דרך ההורים בצומת ושולח את אירוע המגע עד שאחד מהצומת יצרוך את האירוע.
• אם צמתים לא צורכים את האירוע, המערכת מתעלמת מהתנועה והאירועים הבאים שהם חלק מהתנועה לא מועברים לצמתים.
• אם אחד מהצומת מכיל את האירוע, הצומת הזה יצרו את כל אירועי המגע העתידיים בתנועה.

כשאירוע מגע נשלח לצומת, האירוע מועבר תחילה ל-Node.OnTouchListener של הצומת. אם האירוע Node.OnTouchListener לא מתבצע במהלך האירוע, הוא יועבר אל onTouchEvent(HitTestResult, MotionEvent).

פרמטרים

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

החזרות

• הערך True אם האירוע טופל, False אם לא.

Public null onTransformChange (צומת שמקורו בצומת)

מטפל כשטרנספורמציה של הצומת הזה משתנה.

הצומת המקורי הוא הצומת ברמה העליונה בהיררכיה שהפעילה את הצומת הזה. הצומת תמיד יהיה אותו צומת או אחד מההורים שלו. כלומר, אם המיקום של הצומת A&#39 ישתנה, בעקבות זאת המערכת תפעיל את onTransformChange(Node) עבור כל הצאצאים שהצומת המקורי הוא צומת A.

פרמטרים

נקודת המוצא	הצומת שהפעיל את הטרנספורמציה של הצומת הזה

Public null onUpdate (FrameTime frameworkTime)

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

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

פרמטרים

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

Public null removeLifecycleListener (Node.LifecycleListener LifecycleListener)

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

פרמטרים

מחזור החיים של המאזינים

Public null removeTransformChangedListener (Node.TransformChangedListener transformChangedListener)

מסיר את המאזינים שייקראו כשהטרנספורמציה של הצומת תשתנה.

פרמטרים

TransformChangedListener

Public null setCollisionצורת (Collision הצורה התנגשות

מגדיר את הצורה המשמשת לזיהוי התנגשויות עבור Node. אם הצורה לא מוגדרת והמדיניות setRenderable(Renderable) מוגדרת, getCollisionShape() משמש לזיהוי התנגשויות בNode.

פרמטרים

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

ראו בנוסף

• hitTest(Ray)
• hitTestAll(Ray)
• overlapTest(Node)
• overlapTestAll(Node)

Public final null setEnabled (בוליאני מופעל)

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

פרמטרים

פעיל	הסטטוס המופעל החדש של הצומת

ראו בנוסף

• isActive()

Public null setLight (בהיר)

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

פרמטרים

בהיר	תכונות של Light לעיבוד, יש להסיר ערך null כדי להסיר את האור.

Public null setLocalLocation (מיקום Vector3)

מגדיר את המיקום של הצומת הזה ביחס להורה שלו (מרחב מקומי). אם הערך של isTopLevel() נכון, הערך זהה ל-setWorldPosition(Vector3).

פרמטרים

position	המיקום להגשת הבקשה.

ראו בנוסף

• getLocalPosition()

Public null setLocalRotation (סבב רבעון)

מגדירה את הסיבוב של הצומת הזה ביחס להורה שלו (מרחב מקומי). אם הערך של isTopLevel() נכון, הערך זהה ל-setWorldRotation(Quaternion).

פרמטרים

סיבוב	הסיבוב ליישום.

ראו בנוסף

• getLocalRotation()

Public null setLocalScale (Vector3scale)

מגדיר את קנה המידה של הצומת הזה ביחס להורה שלו (מרחב מקומי). אם הערך של isTopLevel() הוא TRUE, הערך זהה ל-setWorldScale(Vector3).

פרמטרים

קנה מידה	קנה המידה ליישום.

ראו בנוסף

• getLocalScale()

Public final null setLookDirection (Vector3 LookDirection)

הגדרת הכיוון שבו הצומת רואה במרחב המשותף. לאחר השיחה למספר הזה, getForward() יתאים לכיוון המראה שהועבר. מקש הרווח מרחבי העולם (0, 1, 0) ישמש לקביעת הכיוון של הצומת מסביב לכיוון.

פרמטרים

LookDirection	וקטור שמייצג את כיוון המראה הרצוי במרחב המשותף

Public final null setLookDirection (Vector3 LookDirection, Vector3 upDirection)

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

פרמטרים

LookDirection	וקטור שמייצג את כיוון המראה הרצוי במרחב המשותף
כיוון גבוה	וקטור שמייצג וקטור חוקי המשמש לשימוש, כגון Vector3.up()

Public final null setName (שם מחרוזת)

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

פרמטרים

name	שם הצומת.

Public null setOnTapListener (Node.OnTapListener onTapListener)

רישום קריאה חוזרת (callback) להפעלת הצומת. אם נרשמת שיחה חוזרת, אירועי מגע לא בועות בבועות להורה של הצומת הזה. אם Node.onTouchEvent בוטל ו-Super.onTouchEvent לא נקרא, ההקשה לא תתרחש.

פרמטרים

onTapListener

ראו בנוסף

• Node.OnTapListener

Public null setOnTouchListener (Node.OnTouchListener onTouchListener)

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

כשמתרחש אירוע ACTION_DOWN, המשמעות היא שהתנועה מתחילה. ACTION_UP או ACTION_Cancel מייצגות מתי תנועה מסתיימת. כשהתנועה מתחילה, יתבצעו הפעולות הבאות:

• שליחת אירועי מגע לצומת שבו זוהה הקטע hitTest(MotionEvent).
• אם הצומת לא צורך את האירוע, הוא יחזור כלפי מעלה דרך ההורים בצומת ושולח את אירוע המגע עד שאחד מהצומת יצרוך את האירוע.
• אם צמתים לא צורכים את האירוע, המערכת מתעלמת מהתנועה והאירועים הבאים שהם חלק מהתנועה לא מועברים לצמתים.
• אם אחד מהצומת מכיל את האירוע, הצומת הזה יצרו את כל אירועי המגע העתידיים בתנועה.

כשאירוע מגע נשלח לצומת, האירוע מועבר תחילה ל-Node.OnTouchListener של הצומת. אם האירוע Node.OnTouchListener לא מתבצע במהלך האירוע, הוא יועבר אל onTouchEvent(HitTestResult, MotionEvent).

פרמטרים

onTouchListener

ראו בנוסף

• Node.OnTouchListener

Public null setparent (הורה הורה)

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

יכול להיות שההורה הוא Node או Scene. אם זו סצינה, Node נחשבת כרמה עליונה. getParent() יחזיר null, וgetScene() יחזיר את הסצנה.

פרמטרים

הורה	ההורה החדש שאליו הצומת הזה יהיה צאצא. אם הוא ריק, הצומת הזה ינותק מההורה שלו.

ראו בנוסף

• getParent()
• getScene()

Public null setRenderable (ניתן לעיבוד)

מגדיר את Renderable להצגה עבור הצומת הזה. אם המדיניות setCollisionShape(CollisionShape) לא מוגדרת, אזgetCollisionShape() משמש לזיהוי התנגשויות בין Node.

פרמטרים

ניתן לעיבוד	בדרך כלל מודל תלת-ממדי. אם הערך הוא null, יוסר הרינדור הנוכחי של הצומת הזה.

ראו בנוסף

• ModelRenderable
• ViewRenderable

Public null setWorldposition (מיקום Vcor3)

הגדרת המיקום של המרחב המשותף של הצומת הזה בעולם.

פרמטרים

position	המיקום להגשת הבקשה.

ראו בנוסף

• getWorldPosition()

Public null setWorldRotation (סבב רבעון)

מגדיר את סיבוב המרחב המשותף של הצומת הזה.

פרמטרים

סיבוב	הסיבוב ליישום.

ראו בנוסף

• getWorldRotation()

Public null setWorldScale (Vector3 קנה מידה)

מגדיר את קנה המידה של המרחב המשותף בצומת הזה.

פרמטרים

קנה מידה	קנה המידה ליישום.

ראו בנוסף

• getWorldScale()

גלוי לכול מחרוזת toString ()

Public final Vector3 worldToLocalDirection (Vector3 כיוון)

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

פרמטרים

direction	המסלול במרחב המשותף

החזרות

• וקטור חדש שמייצג את הכיוון במרחב המקומי

גלוי לכול סופי Vector3 worldToLocalPoint (Vector3 point)

ממירה נקודה במרחב המשותף למרחב המקומי של הצומת הזה.

פרמטרים

נקודה	הנקודה במרחב המשותף

החזרות

• וקטור חדש שמייצג את הנקודה במרחב המקומי

שיטות מוגנות

החשבון מוגן בוליאני canAddChild (צומת, StringBuilder סיבת הכשל)

פרמטרים

צאצא
סיבה לכישלון

מוגן סופי ביטול onAddChild (צומת)

פרמטרים

צאצא

מוגן סופי ביטול onRemoveChild (צומת הילד)

פרמטרים

צאצא