שעון אנלוגי

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

הוצגה ב-Wear OS 4.

תחביר

<AnalogClock x="integer" y="integer" width="integer" height="integer"
             pivotX="float" pivotY="float" angle="float-degrees" alpha="integer"
             scaleX="float" scaleY="float"
             renderMode="[SOURCE | MASK | ALL]"
             tintColor="argb-color | rgb-color">
    <!-- This is the maximum number of hands that you can define. -->
    <HourHand ... />
    <HourHand ... />
    <MinuteHand ... />
    <MinuteHand ... />
    <SecondHand ... />
    <SecondHand ... />
</AnalogClock>

מאפיינים

לרכיב AnalogClock יש את המאפיינים הבאים:

מאפיינים נדרשים

המאפיינים הבאים הם מאפייני חובה:

x, y, width, height
אוסף של מספרים שלמים שמציינים את הגודל והמיקום של הרכיב.

מאפיינים אופציונליים

המאפיינים הבאים הם אופציונליים:

pivotX, pivotY
נקודת ציר דו-ממדית שסביבה הרכיב מסתובב. שני הערכים הם מספרי נקודה צפה (floating-point) שמתאימים לטווח $ [0, 1] $.
angle
מספר המעלות, בכיוון השעון, שבהן צריך לסובב את האלמנט סביב ציר הצירים שלו.
alpha
הגדרת רמת השקיפות של הרכיב הזה. הערך 0 מציין שהרכיב צריך להיות שקוף לחלוטין. הערך 255 מציין שהרכיב צריך להיות אטום לחלוטין.
scaleX
גורם לקביעת קנה מידה אופקי שחלה על הרכיב הזה.
scaleY
גורם לקביעת קנה מידה אנכי שיש להחיל על הרכיב הזה.
renderMode
סוג מצב הרינדור של הרכיב. הערכים האפשריים הם: SOURCE (ברירת המחדל), MASK או ALL.
tintColor
מחילים על הרכיב מסנן גוון צבע. צריך לציין את הצבע באמצעות פורמט ARGB‏ (#ff000000 = שחור אטום) או פורמט RGB‏ (#000000 = שחור).

רכיבים פנימיים

הרכיב AnalogClock יכול להכיל את הרכיבים הפנימיים הבאים:

HourHand
MinuteHand
SecondHand
רכיבים שמייצגים את מחוג השעות, מחוג הדקות ומחוג השניות, בהתאמה, שמסתובבים סביב תצוגת השעון. AnalogClock יכול להכיל עד 2 מחוגים לשעות, 2 מחוגים לדקות ו-2 מחוגים לשניות.
Localization
מספק רמז לגבי הלוקאל שבו יש להשתמש כשמייצרים את השעה. מידע נוסף זמין במסמך העזרה של Localization.

רכיב AnalogClock יכול להכיל רכיב Localization אחד לכל היותר.

Variant
מאפשר לשנות את המאפיינים של האלמנט הזה כשמכשיר Wear OS נמצא במצב אווירה. מידע נוסף זמין במסמך העזרה של Variant.