גרפיקה

  
שימוש ביכולות גרפיות בכמה גרסאות של פלטפורמת Android

בטבלה הזו מפורטים כל פריטי המידע בקבוצה androidx.graphics.

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
graphics-core 1.0.3 - - -
graphics-path 1.0.1 - - -
graphics-shapes 1.0.1 - 1.1.0-beta01 -
הספרייה הזו עודכנה לאחרונה ב-30 ביולי 2025

הצהרה על יחסי תלות

כדי להוסיף תלות ב-Graphics, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

dependencies {
    implementation "androidx.graphics:graphics-core:1.0.3"
    implementation "androidx.graphics:graphics-path:1.0.1"
    implementation "androidx.graphics:graphics-shapes:1.1.0-beta01"
}

Kotlin

dependencies {
    implementation("androidx.graphics:graphics-core:1.0.3")
    implementation("androidx.graphics:graphics-path:1.0.1")
    implementation("androidx.graphics:graphics-shapes:1.1.0-beta01")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-Build.

משוב

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

יצירת בעיה חדשה

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

אין הערות לגבי הגרסה של הארטיפקט הזה.

גרפיקה גרסה 1.1

גרסה 1.1.0-beta01

‫30 ביולי 2025

androidx.graphics:graphics-*:1.1.0-beta01 משוחרר. גרסה 1.1.0-beta01 מכילה את ההתחייבויות האלה.

שינויים ב-API

  • כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5)
  • הוספה של יעדי קומפילציה של mingwX64, ‏ js ו-wasm. (I2c46a)

גרסה 1.1.0-alpha01

‫11 בדצמבר 2024

androidx.graphics:graphics-*:1.1.0-alpha01 משוחרר. גרסה 1.1.0-alpha01 מכילה את הקומטים האלה.

תכונות חדשות

  • שינינו את ההדגמה הראשית והפכנו אותה לכלי כללי לעריכת צורות. כך אפשר לייבא צורות מנתיב SVG, לערוך ידנית את התכונות שזוהו במקרה של פספוסים בתהליך האוטומטי ולייצא את התוצאה לקוד שאפשר להשתמש בו בקוד ייצור. (I1ac13)
  • החלפנו את מדידות הזווית של התקדמות המתאר של הצורה במדידות של אורך העקומה, כדי לאפשר שימוש בצורות מורכבות יותר לצורך מורפינג. (I75478) , I390dd
  • שיפרנו את האלגוריתם של מיפוי התכונות, כך שיותר שינויים צריכים להיראות טבעיים יותר. (I83287)

שינויים ב-API

  • הוספת ייבוא של נתיב SVG וסריאליזציה של תכונות. התהליך הרגיל הוא:
    • אפשר להשתמש ב-SvgPathParser.parseFeatures() החדש כדי להמיר נתיב SVG (הערך של מאפיין d ברכיב path של SVG) ל-List<Feature>.
    • אפשר לשנות את הערך הזה, ואז לבצע סריאליזציה שלו למחרוזת באמצעות FeatureSerializer.serialize().
    • אפשר להשתמש במחרוזת שמתקבלת בקוד ייצור, על ידי ייבוא שלה באמצעות FeatureSerializer.parse()
    • הערה: השלבים 1 ו-2 מתבצעים פעם אחת, ואפשר לבצע אותם באמצעות האפליקציה החדשה. קוד הייצור צריך לבצע רק את שלב 3. (I9bd00, b/371196190), (Ic3842), (If68ed), (I10251)
  • הצגת ישויות של פוליגונים וסוגי ישויות. עכשיו אפשר ליצור עוד RoundedPolygons כלליים באמצעות בנאי הבסיס שמקבל List<Features>. התכונות הן בעיקר רשימה של עקומות בזייה מעוקבות, אבל הן מתויגות כדי לעזור לאלגוריתם המורפינג להתאים בין הצורות של ההתחלה והסוף (פינות קמורות ממופות לפינות קמורות ופינות קעורות ממופות לפינות קעורות). ‪(I61e76), (I1fc5c)
  • הוספנו תמיכה ב-watchosDeviceArm64 KMP target וב-target kotlin 1.9. ‫(Icf15d, ‏ b/364652024)

תיקוני באגים

  • תוקן מקרה קצה שבו התכונה האחרונה הייתה ריקה. (I390dd)
  • שיפור היצירה של RoundedPolygon. (Ib862c, ‏ b/360888486)
  • תוקן באג באתחול של RoundedPolygon. (I83ddb)
  • תיקון שגיאה באלגוריתם להערכת מרכז המצולע. (Ida147)

צורות גרפיות גרסה 1.0

גרסה 1.0.1

‫4 בספטמבר 2024

הגרסאות androidx.graphics:graphics-shapes:1.0.1, androidx.graphics:graphics-shapes-android:1.0.1 ו-androidx.graphics:graphics-shapes-desktop:1.0.1 יוצאות. גרסה 1.0.1 מכילה את הקומטים האלה.

גרסה 1.0.0

‫21 באוגוסט 2024

הגרסאות androidx.graphics:graphics-shapes:1.0.0, androidx.graphics:graphics-shapes-android:1.0.0 ו-androidx.graphics:graphics-shapes-desktop:1.0.0 יוצאות. גרסה 1.0.0 מכילה את הקומטים האלה.

גרסה 1.0.0-rc01

‫24 ביולי 2024

הגרסאות androidx.graphics:graphics-shapes:1.0.0-rc01, androidx.graphics:graphics-shapes-android:1.0.0-rc01 ו-androidx.graphics:graphics-shapes-desktop:1.0.0-rc01 יוצאות. גרסה 1.0.0-rc01 מכילה את הקומטים האלה.

גרסה 1.0.0-beta01

‫1 במאי 2024

הגרסאות androidx.graphics:graphics-shapes:1.0.0-beta01, androidx.graphics:graphics-shapes-android:1.0.0-beta01 ו-androidx.graphics:graphics-shapes-desktop:1.0.0-beta01 יוצאות. גרסה 1.0.0-beta01 מכילה את ההעברות האלה.

שינויים ב-API

  • מאפשרת לסובב מראש צורות כדי להתחיל בנקודה אחרת. השינוי הזה מאפשר לpillStarצורות להתחיל את העיקולים שלהן מנקודה לא מוגדרת מראש בהיקף. האפשרות הזו שימושית כשמנפישים את המשיכות של נתיב הצורה, כדי להתחיל לצייר ממיקום ספציפי בקו המתאר של הצורה. (Ifbb4d, ‏ b/324303807)
  • נוספו פונקציות calculateBounds() ל-Morph, שדומות לפונקציות המקבילות ב-RoundedPolygon. (I8a3b6, b/325463575)

גרסה 1.0.0-alpha05

‫7 בפברואר 2024

הגרסאות androidx.graphics:graphics-shapes:1.0.0-alpha05, androidx.graphics:graphics-shapes-android:1.0.0-alpha05 ו-androidx.graphics:graphics-shapes-desktop:1.0.0-alpha05 יוצאות. גרסה 1.0.0-alpha05 מכילה את הקומיטים האלה.

תכונות חדשות

  • בספרייה יש עכשיו פונקציות חדשות, pill() ו-pillStar(), שמאפשרות ליצור בקלות צורות מעוגלות או צורות עם כוכב. יש גם ממשקי API חדשים לחישוב הגבולות המדויקים שנדרשים לצורה (הגבולות הקודמים היו רק הערכה שמבוססת על נקודת העיגון ונקודות הבקרה של עקומת בזייה הבסיסית), וגם הגבולות המקסימליים האפשריים, שיכולים לעזור לקבוע את הגודל של מאגר שמכיל את הצורה אם היא תסתובב בתוך המאגר הזה. (I71827)

שינויים ב-API

  • עכשיו יש יותר אפשרויות לאחזור גבולות מדויקים ומקסימליים. (I6d49f, b/317286450)

תיקוני באגים

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

גרסה 1.0.0-alpha04

‫13 בדצמבר 2023

הגרסאות androidx.graphics:graphics-shapes:1.0.0-alpha04, androidx.graphics:graphics-shapes-android:1.0.0-alpha04 ו-androidx.graphics:graphics-shapes-desktop:1.0.0-alpha04 יוצאות. גרסה 1.0.0-alpha04 מכילה את הקומיטים האלה.

תכונות חדשות

  • הגרסה הזו כוללת כמה שינויים ב-API, וגם תיקוני באגים.
  • הרבה מהשינויים ב-API הופכים את ספריית הצורות לידידותית ל-KMP. כך קל יותר להתקשר מקוד שאינו קוד Android (למשל קוד Compose שאינו ספציפי ל-Android). לדוגמה, אין סוגי Android ב-API, כמו הסוגים הקודמים PointF,‏ Matrix ו-Path.
  • בנוסף, בוצעו כמה שינויים בממשקי API וביישום מסיבות שקשורות לביצועים, במיוחד כדי לצמצם את הקצאת האובייקטים (ואת האיסוף שלהם). לדוגמה, המעבר מ-PointF לפרמטרים נפרדים של Float מונע הקצאה של הרבה מבני PointF זמניים כדי להכיל את הקודקודים האלה.

שינויים ב-API

  • הוחלף Morph.asMutableCubics בפונקציה שחוזרת על עצמה ב-MutableCubics. ממשק פונקציונלי PointTransformer השתנה, עכשיו הוא מקבל קואורדינטות x ו-y של Point ומחזיר TransformedResult (שנוצר עם קואורדינטות x ו-y שעברו טרנספורמציה) (I6719e)
  • הסרנו את ה-constructor הציבורי Cubic והפכנו אותו לפונקציית factory. (I409ce)
  • הוספת ממשקי API לציור ולשינוי של Android (‏I079f6, ‏b/292289543)
  • הסרת יחסי תלות ב-Android‏ (Iadc1c, ‏ b/292289543)
  • שמות המאפיינים של העוגן והבקרה הגיוניים יותר עכשיו (If13bd, ‏ b/294562941)
  • הפרמטרים של PointF השתנו לזוגות של Float (‏Id4705, ‏ b/276466399, ‏ b/290254314)
  • ‫progress מועבר עכשיו ישירות לפקודות השרטוט של Morph (Icdca2)

תיקוני באגים

  • תוקן באג שקרה כשיוצרים צורות גדולות. (I4fd66, b/313497325)

גרסה 1.0.0-alpha03

‫7 ביוני 2023

androidx.graphics:graphics-shapes:1.0.0-alpha03 משוחרר. גרסה 1.0.0-alpha03 מכילה את הקומיטים האלה.

שינויים ב-API

  • נוספה פונקציה חדשה RoundedPolygon.rectangle() (I78e7e, ‏ b/280322189)
  • הפונקציות Star ו-Circle לא מתחילות יותר באות גדולה, והן נקראות באמצעות אובייקט נלווה של RoundedPolygon: למשל, RoundedPolygon.star(...)(I14735)

תיקוני באגים

  • תיקון באג בהחלקה (Ibf894)
  • תוקן באג שהתרחש כשהצורה של ההתחלה והסיום היו זהות. לשפר את חלוקת המקום הפנוי בצדדים לחיתוך, קודם להשתמש במקום הפנוי לעיגול ואז להחלקה אם נשאר מקום. (Ibd320, ‏ b/277936300)

גרסה 1.0.0-alpha02

‫19 באפריל 2023

androidx.graphics:graphics-shapes:1.0.0-alpha02 משוחרר. גרסה 1.0.0-alpha02 מכילה את הקומיטים האלה.

שינויים ב-API

  • מחלקת העל Polygon מוזגה עם מחלקת המשנה שלה, RoundedPolygon. כל המצולעים הם עכשיו מצולעים מעוגלים [אופציונלית].
  • הפונקציה Star (שעדיין מחזירה RoundedPolygon, כמו קודם) מקבלת עכשיו ערך innerRadius, במקום הפרמטר innerRadiusRatio הקודם. היחידות זהות ליחידות של פרמטר הרדיוס הקיים, כך שהשימוש פשוט ועקבי יותר. בנוסף, הפרמטר numOuterVertices שונה ל-numVerticesPerRadius כדי להבהיר שאותו מספר מוחל על הרדיוסים הפנימי והחיצוני.
  • בעבר, הפרמטר CornerRounding.radius תועד כערך יחסי לגודל המצולע, אבל הוא היה (וצריך להיות) ערך מוחלט, ולא יחסי. המסמכים עודכנו וההערה שהגבילה את הערך המקסימלי ל-1.0 תוקנה.

גרסה 1.0.0-alpha01

‫5 באפריל 2023

‫Graphics-Shapes היא ספרייה חדשה שמאפשרת ליצור ולעבד בקלות צורות רב-צלעיות מעוגלות, וגם לבצע מורפינג (אנימציה) פשוט ואוטומטי בין צורות שונות.

androidx.graphics:graphics-shapes:1.0.0-alpha01 משוחרר. הגרסה הזו הופצה מענף פנימי.

תכונות חדשות

  • אפשר להשתמש ב-Polygon API כדי ליצור מצולעים משוכללים ומצולעים בצורת כוכב עם מספר הקודקודים הרצוי.
  • אפשר להשתמש בפרמטרים אופציונליים של CornerRounding כדי לציין את רדיוס העיגול ואת פרמטרים ההחלקה של הפינות, וכך ליצור צורות מצולעות עם פינות מעוגלות.
  • משתמשים ב-API החדש Morph(Polygon, Polygon) כדי לחשב באופן אוטומטי צורה של 'שינוי צורה' שאפשר להגדיר את ההתקדמות שלה מ-0 עד 1 כדי ליצור אנימציה בין צורת ההתחלה לצורת הסיום. מנפישים את ההתקדמות הזו לאורך זמן, מציירים את התוצאה בכל פריים, כדי ליצור אנימציה חלקה בין הצורות המעוגלות החדשות האלה.

נתיב גרפיקה גרסה 1.0

גרסה 1.0.1

‫1 במאי 2024

androidx.graphics:graphics-path:1.0.1 משוחרר. גרסה 1.0.1 מכילה את הקומטים האלה.

תיקוני באגים

  • שיפורים בדגלי קומפילציה.

גרסה 1.0.0

‫6 במרץ 2024

androidx.graphics:graphics-path:1.0.0 משוחרר.

גרסה 1.0.0-rc01

‫21 בפברואר 2024

androidx.graphics:graphics-path:1.0.0-rc01 משוחרר. גרסה 1.0.0-rc01 כוללת את הקומיטים האלה.

תיקוני באגים

  • שיפור הביצועים של PathIterator ב-API < 34 (Id4629)

גרסה 1.0.0-beta02

‫10 בינואר 2024

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

androidx.graphics:graphics-path:1.0.0-beta02 משוחרר. גרסה 1.0.0-beta02 מכילה את הקומיטים האלה.

תיקוני באגים

  • הגודל של libandroidx.graphics.path.so הוקטן ב-96%. (I71397)
  • הקטנת הגודל של libandroidx.graphics.path.so ב-5%. (I2da7c)
  • הקטנו את הרכיבים המקוריים של androidx.graphics:graphics-path ב-43%. (I8e40d)

גרסה 1.0.0-beta01

‫29 בנובמבר 2023

androidx.graphics:graphics-path:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 מכילה את הקומיטים האלה.

שינויים ב-API

  • הוסרו שימושים ב-API הניסיוני isAtLeastU() (Ie9117, ‏ b/289269026)

תיקוני באגים

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

גרסה 1.0.0-alpha02

‫7 ביוני 2023

androidx.graphics:graphics-path:1.0.0-alpha02 משוחרר. הגרסה הזו פותחה בענף פנימי.

תכונות חדשות

  • תוקנה בעיה בבדיקת גרסת הפלטפורמה הפנימית שגרמה לבעיות בהרצה בתצוגות מקדימות של Android 14 (בדיקת הגרסה נכשלה, אבל המנגנון לביצוע פעולות בגרסאות קודמות לא פועל בצורה תקינה ב-Android 14).

גרסה 1.0.0-alpha01

‫22 במרץ 2023

androidx.graphics:graphics-path:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • הספרייה החדשה הזו מאפשרת להריץ שאילתות על נתוני נתיב באמצעות PathIterator API החדש. באמצעות ה-API הזה, המתקשרים יכולים לחזור על כל הפלחים של אובייקט Path כדי לקבוע את הפעולה והנתונים של הפלחים האלה.
  • הספרייה משתמשת בממשקי API דומים שהוצגו בתצוגה המקדימה של Android 14, אבל גרסת AndroidX של ה-API פועלת גם בגרסאות עד API 21.

גרסה 1.0 של Graphics Core

גרסה 1.0.3

‫26 במרץ 2025

androidx.graphics:graphics-core:1.0.3 משוחרר. גרסה 1.0.3 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • תוקנה בעיה של הבהובים במסך מלא בזמן ציור במכשירים מסוימים עם API<33.

גרסה 1.0.2

‫16 באוקטובר 2024

androidx.graphics:graphics-core:1.0.2 משוחרר. גרסה 1.0.2 מכילה את הקומטים האלה.

תיקוני באגים

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

גרסה 1.0.1

‫4 בספטמבר 2024

androidx.graphics:graphics-core:1.0.1 משוחרר. גרסה 1.0.1 מכילה את הקומטים האלה.

תיקוני באגים

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

גרסה 1.0.0

‫29 במאי 2024

androidx.graphics:graphics-core:1.0.0 משוחרר. גרסה 1.0.0 מכילה את הקומטים האלה.

התכונות העיקריות בגרסה 1.0.0

  • גרסה יציבה רשמית של ספריית graphics-core. כולל תיקוני באגים קלים ושיפורי ביצועים מגרסה 1.0.0-rc01

גרסה 1.0.0-rc01

‫17 באפריל 2024

androidx.graphics:graphics-core:1.0.0-rc01 משוחרר. הגרסה הזו פותחה בענף פנימי.

תיקוני באגים

  • תוקנה בעיה שעלולה לגרום לסגירה כפולה של מתארים של קבצים באמצעות CanvasBufferedRendererAPI במכשירי Android מסוימים שפועלת בהם מערכת Android 14.
  • תוקנה בעיה שבה FrameBuffer לא מחק כראוי מופעים של framebuffer.

גרסה 1.0.0-beta01

‫13 בדצמבר 2023

androidx.graphics:graphics-core:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 מכילה את הקומיטים האלה.

תכונות חדשות

  • השקנו LowLatencyCanvasViewAPI חדש לתמיכה ברינדור עם זמן אחזור נמוך באמצעות ממשקי API של גרפיקה דו-ממדית ב-Android (Canvas + Paint) בהיררכיית התצוגה.
  • הוספנו את API‏ CanvasBufferedRenderer כדי לתמוך בעיבוד של Canvas באמצעות חומרה ל-HardwareBuffer. אפשר להשתמש בזה כדי לצייר חלק מממשק משתמש לתוך מאגר שאפשר להמיר ל-Bitmap באמצעות ה-API‏ Bitmap.wrapHardwareBuffer.

שינויים ב-API

  • ה-API‏ CanvasBufferRenderer#releaseBuffer עודכן כך שיכלול פרמטר אופציונלי של גדר וירטואלית. עדכנו את התיעוד כדי לתאר מתי מוחזרת התוצאה RenderResult#fence. (If1ea7)
  • הוספת שיטה draw ל-RenderRequest כדי לתמוך בשימוש בקורוטינות לתזמון בקשות לציור. שינינו את השם של שיטת הציור הקודמת שצרכה רכיב Executor ל-drawAsync. השיטה isClosed() שונתה למאפיין. (I5bff6)
  • הוספנו פרמטר של פורמט מאגר ל-CanvasFrontBufferRenderer כדי למפות ישירות ל-CanvasBufferedRenderer.Builder#setBufferFormat (I0f272)
  • נוצר API‏ CanvasBufferedRenderer לטיפול בעיבוד מואץ של קנבס באמצעות חומרה לתוך HardwareBuffer. ההגדרה הזו מספקת הטמעה של backport ל-Android Q לצד הגדרה של עומק swapchain של HardwareBuffers. ההגדרה של ColorSpace עדיין מוגבלת ל-Android U ומעלה, אבל הטמעת התאימות לא מספקת התנהגות no-op בשם המפתחים. (I9b1d8)
  • מוסיפים ממשקי API של setFrameRate/clearFrameRate ל-SurfaceControlCompat.Transaction כדי לשלוט בקצב הפריימים לצד אסטרטגיית השינוי למעברים חלקים או למעברים שמוגדרים כברירת מחדל. (I6045c)
  • הורדנו את רמת ה-API הנדרשת ל-setDataSpace מ-Android T ל-Android Q. (I59c34)
  • נוספה קריאה חוזרת (callback) onBufferReleased ל-API‏ GLFrameBufferRenderer כדי לתת למשתמשים הזדמנות לנקות את הסטטוס כשמאגר לא מוצג יותר (I8a4e2)
  • יוצרים LowLatencyCanvasView כדי לתמוך בתרחיש שימוש פשוט של עיבוד תוכן עם זמן אחזור נמוך, שמסונכרן עם עיבוד היררכיית התצוגה. כך אפשר לצמצם את המורכבות שקשורה לניהול SurfaceView, כי המערכת מנהלת באופן פנימי את מופע SurfaceView שמתורגם במסך או מחוצה לו, כדי להציג את התוכן בצורה מסונכרנת עם זמן אחזור נמוך. (I9253b)
  • הוספנו תמיכה בהגדרת מרחב צבעים ל-CanvasFrontBufferedRenderer API. עודכנו קריאות חוזרות (Callback) עם מאגרים מרובים כך שיכללו גם את מאגר הנתונים הזמני של הגיבוי SurfaceControl (I24bd9)

גרסה 1.0.0-alpha05

‫6 בספטמבר 2023

androidx.graphics:graphics-core:1.0.0-alpha05 משוחרר. גרסה 1.0.0-alpha05 מכילה את הקומיטים האלה.

תכונות חדשות

  • השקנו את GLFrameBufferRenderer API. ההגדרה הזו מספקת שילוב של יחסי תלות ב-OpenGL, הגדרת שרשרת החלפה, פורמטים של פיקסלים והגדרת SurfaceControl. (Ic775b)

שינויים ב-API

  • הוספנו פרמטרים של רוחב וגובה לממשקי API שונים של קריאה חוזרת (callback) כדי להעביר מידות מ-SurfaceHolder#Callbacks. (I7f9fc)
  • הוספנו API ברור למחיקה של שכבות עם מאגרים מרובים ושל שכבות קדמיות. (Ic1f95)
  • הוספנו תמיכה בהגדרת סוג המאגר הבסיסי של שרשראות החלפה שמשמשות ב-GLFrontBufferedRenderer. (I07a13)
  • נוספו מאפייני Kotlin לשיטות get בהערה GLFrameBufferRenderer, בהערה IntRange למקסימום ערכים במאגר, ובהערות HardwareBufferFormart ו-HardwareBufferUsage ל-setFormat/setUsage בהתאמה. (Ief89e)
  • בוצע עדכון של setBuffer API בעסקאות מ-SurfaceControl כדי לספק גדר שחרור. (Ice1bb)
  • הוספנו ממשקי API של SurfaceControlCompat.Transaction להגדרת מרחב הנתונים ולקביעת טווח הבהירות המורחב. (Ic378d)

גרסה 1.0.0-alpha04

‫7 ביוני 2023

androidx.graphics:graphics-core:1.0.0-alpha04 משוחרר. גרסה 1.0.0-alpha04 מכילה את הקומיטים האלה.

תכונות חדשות

  • הוספנו את CanvasFrontBufferedRenderer כדי לתמוך בגרפיקה עם זמן אחזור נמוך באמצעות android.graphics.Canvas API לצד הטמעה קיימת של OpenGL

שינויים ב-API

  • ‫SurfaceControlCompat.Transaction#setBuffer API עודכן כדי לאפשר מקרים של HardwareBuffer שניתן להגדיר כ-nullable, כדי לשקף את ה-API המתאים של הפלטפורמה (I173d7)
  • כדאי לשנות את השם של שיטות שמתייחסות לרינדור עם מאגר נתונים זמני כפול לרינדור עם מאגר נתונים זמני מרובה, כי יכול להיות ששרשרת ההחלפה של הרקע תכיל יותר מ-2 מאגרי נתונים זמניים. (I830d7)
  • ‫Create CanvasFrontBufferedRenderer API כדי לאפשר לצדדים שלישיים להשתמש במערכת עיבוד עם מאגר קדמי באמצעות Canvas API. (Ibfc29)

תיקוני באגים

  • תוקנה הבעיה שבה התוכן לא הוצג ב-GLFrontBufferedRenderer אחרי חידוש הפעילות המתאימה.
  • תוקנה בעיה שבה תוכן שמאוחסן בבאפר הקדמי נמחק לפני הזמן.
  • תוקנה בעיה שבה SurfaceHolder.Callbacks לא הוסר אחרי שפורסמו ממשקי API של גרפיקה עם השהיה נמוכה.

גרסה 1.0.0-alpha03

‫22 במרץ 2023

androidx.graphics:graphics-core:1.0.0-alpha03 משוחרר. גרסה 1.0.0-alpha03 מכילה את הקומיטים האלה.

שינויים ב-API

  • עדכנו את ההטמעה של הקריאה החוזרת GLFrontBufferedRenderer כדי לספק אובייקט BufferInfo שמכיל את הרוחב והגובה של המאגר, יחד עם מזהה של מאגר מסגרות שאפשר להשתמש בו כדי להגדיר מחדש את יעד המקור אחרי העיבוד למאגר זמני. (I7fe20)
  • איחדנו את יצירת SyncFence לשיטת יצירה סטטית ב-SyncFenceCompat.
  • הוסרה שיטת תאימות ציבורית ל-eglDupNativeFenceFDANDROID לטובת שיטת יצירה של SyncFenceCompat במפעל לצורך יצירת SyncFence. הסיבה לכך היא כדי לוודא שכל פלטפורמות ה-API יקבלו את ההטמעה הנכונה של SyncFence, ללא קשר לרמת ה-API. (I849bb)
  • נוספה תיעוד ל-FrameBufferRenderer ול-SyncStrategy.
    • הועברו FrameBufferRenderer + FrameBuffer + FrameBufferPool לחבילה androidx.graphics.opengl
    • הועבר אל חבילת androidx.graphics.openglSyncStrategy
    • RenderCallback#onDraw מסמכים עודכנו
    • עדכון התיעוד של RenderCallback#obtainFrameBuffer שהמטמיע של ה-API אחראי להפעיל FrameBuffer.close
    • עדכון של onDrawComplete כדי לציין שהצרכנים אחראים לשליחת התוכן להצגה
    • הועברו SyncFence ממשקי תאימות/מחלקות לחבילה androidx.hardware כדי לשקף את המסגרת
    • שינינו את השם של SyncFence API ל-SyncFenceV19 והגדרנו אותו כפרטי כדי לאחד את השימושים ב-SyncFenceCompat, שמסתמך על SyncFence API של המסגרת בכל מקום שאפשר. (I5149c)
  • הוספנו את השיטות GLFrontBufferedRenderer#cancel וGLFrontBufferedRenderer#execute. האפשרות הראשונה שימושית בתרחישים של דחיית מגע בכף היד, שבהם צריך לבטל את הרינדור למאגר הקדמי ולהסתיר אותו. האפשרות השנייה שימושית בתרחישים שבהם רוצים לבצע מניפולציה באובייקטים בשרשור GL בלי לתזמן עיבוד. (If0b7f)
  • הוספת API לעיבוד ישירות לשכבה עם מאגר כפול. התכונה הזו עוזרת לעבד מחדש סצנה אחרי הפסקה, וגם מאפשרת לצרכנים לקבוע באופן סלקטיבי מתי להשתמש בעיבוד דינמי של מאגר קדמי, על סמך הסצנה הרצויה לעיבוד. (Ied56c)
  • הוספנו ל-SurfaceControlCompat.Builder API חדש לתמיכה בהגדרת SurfaceControl האב ממופע אחר של SurfaceControl, בנוסף למנגנון הקיים מ-SurfaceView. (I1d1b6)
  • הוספת אפשרות להחזרת ערך null לסוגים נוספים של פונקציות שהוצאו משימוש ומוסתרות (Ibf7b0)
  • נוסף קבוע התוסף EGL_ANDROID_get_native_client_buffer לשאילתה כדי לבדוק אם מכשיר Android תומך בייבוא של מופעי HardwareBuffer לאובייקטים של EGLClientBuffer שאפשר להשתמש בהם כמופע EGLImage. (Iad767)
  • הוספת הערה @JvmDefaultWithCompatibility (I8f206)

גרסה 1.0.0-alpha02

9 בנובמבר 2022

androidx.graphics:graphics-core:1.0.0-alpha02 משוחרר. גרסה 1.0.0-alpha02 מכילה את הקומיטים האלה.

שינויים ב-API

  • תוקנה הערה חסרה RequiresApi עבור addTransactionCommitListener שהוצגה ב-Android S‏ (I0a035)
  • עדכנו את onDraw<Front/Double> Buffer callbacks כדי לספק מטריצת טרנספורמציה שצרכנים יכולים להעביר ל-vertex shaders שלהם בנוסף לרוחב ולגובה הנוכחיים של המאגר. הצרכנים אחראים לשימוש בפרמטרים האלה כדי לבצע סיבוב מראש של קוד הרינדור שלהם ב-OpenGL. (I82f9e)

תיקוני באגים

  • שיפור חביון הגרפיקה על ידי סיבוב מראש של מאגרי נתונים זמניים לפני הנפקת עסקאות SurfaceControl.
  • תוקנה בעיה שבה ביומני השגיאות הוצגה שגיאה 300d ‏ (EGL_BAD_SURFACE).
  • תוקנה הבעיה שבה GLFrontBufferedRenderer היה לא תקין אחרי שהופעלה מחדש הפעילות התואמת שבה נעשה בו שימוש.
  • שיפור התמיכה באמולטורים ובמכשירי ChromeOS.
  • נפתרה בעיה שגרמה לכך שהשכבה הקדמית של המאגר נעלמה מוקדם מדי.

גרסה 1.0.0-alpha01

24 באוקטובר 2022

androidx.graphics:graphics-core:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • גרסה ראשונית של ספריית AndroidX של ליבת הגרפיקה. הם כוללים ממשקי API לתמיכה בתרחישי שימוש עם זמן אחזור קצר, כמו קלט של עט סטיילוס. בנוסף, יש גם כמה ממשקי API מסייעים לשימוש ב-OpenGL.

שינויים ב-API

  • הוספנו את GLFrontBufferedRenderer כדי לעזור בעיבוד של חזיתות ושל מאגרי נתונים זמניים מרובים, וכך להשיג גם זמן אחזור קצר וגם פלט עיבוד באיכות גבוהה.
  • הוספנו את GLRenderer API כדי לסייע בעיבוד OpenGL עבור ספקי Surface שונים, כמו SurfaceView, TextureView ועוד.