תמונה חלקית

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

הוצגה ב-Wear OS 4.

תחביר

<PartImage x="integer" y="integer" width="integer" height="integer"
           pivotX="float" pivotY="float" angle="float-degrees" alpha="integer"
           name="string" scaleX="float" scaleY="float"
           renderMode="[SOURCE | MASK | ALL]"
           tintColor="argb-color | rgb-color">
    <!-- Image-specific child elements. A "PartImage" element can have any
         number of these elements. -->
    <ImageFilters ... />
    <Images>
        <Image ... />
    </Images>
    <Image ... />

    <!-- Child elements that are shared across all "Part" elements. -->
    <Localization .../>
    <Transform .../>
    <Variant .../>
    <Gyro .../>
    <Launch .../>
    <ScreenReader .../>
</PartImage>

מאפיינים

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

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

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

x, y, width, height

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

אפשר לשנות את המאפיינים האלה.

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

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

pivotX, pivotY

נקודת ציר דו-ממדית שסביבה הרכיב מסתובב. שני הערכים הם מספרים בספרות עשרוניות שמתאימים לטווח $ [0, 1] $.

אפשר לשנות את המאפיינים האלה.

angle

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

המאפיין הזה ניתן לשינוי.

alpha

מגדירים את רמת השקיפות של הרכיב הזה. הערך 0 מציין שהרכיב צריך להיות שקוף לחלוטין. ערך של 255 מציין שהרכיב צריך להיות אטום לחלוטין.

המאפיין הזה ניתן לשינוי.

name

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

scaleX

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

המאפיין הזה ניתן לשינוי.

scaleY

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

המאפיין הזה ניתן לשינוי.

renderMode

סוג מצב העיבוד של הרכיב. הערכים האפשריים הם: SOURCE (ברירת המחדל), MASK או ALL.

tintColor

מחילים על הרכיב מסנן גוון צבע. צריך לציין את הצבע באמצעות פורמט ARGB‏ (#ff000000 = שחור אטום) או פורמט RGB‏ (#000000 = שחור).

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

הרכיב PartImage יכול להכיל את הרכיבים הפנימיים הבאים. כל הרכיבים הם אופציונליים, ורכיב PartImage יכול להכיל מספר בלתי מוגבל של כל רכיב פנימי – מלבד Localization,‏ Gyro,‏ Launch ו-ScreenReader, שיכולים להופיע בכל פעם רק פעם אחת.

• ImageFilters
• Images
• Image
• Localization
• Transform
• Variant
• Gyro
• Launch
• ScreenReader