grafis

  
Memanfaatkan fasilitas grafis di beberapa rilis platform Android

Tabel ini mencantumkan semua artefak dalam grup androidx.graphics.

Artefak Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
inti grafis 1.0.0 - - -
grafis-jalur 1.0.1 - - -
bentuk-grafis - 1.0.0-rc01 - -
Library ini terakhir diperbarui pada: 24 Juli 2024

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada Print, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

Groovy

dependencies {
    implementation "androidx.graphics:graphics-core:1.0.0"
    implementation "androidx.graphics:graphics-path:1.0.1"
    implementation "androidx.graphics:graphics-shapes:1.0.0-rc01"
}

Kotlin

dependencies {
    implementation("androidx.graphics:graphics-core:1.0.0")
    implementation("androidx.graphics:graphics-path:1.0.1")
    implementation("androidx.graphics:graphics-shapes:1.0.0-rc01")
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Tidak ada catatan rilis untuk artefak ini.

Graphics Shapes Versi 1.0

Versi 1.0.0-rc01

24 Juli 2024

androidx.graphics:graphics-shapes:1.0.0-rc01, androidx.graphics:graphics-shapes-android:1.0.0-rc01, dan androidx.graphics:graphics-shapes-desktop:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit ini.

Versi 1.0.0-beta01

1 Mei 2024

androidx.graphics:graphics-shapes:1.0.0-beta01, androidx.graphics:graphics-shapes-android:1.0.0-beta01, dan androidx.graphics:graphics-shapes-desktop:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Perubahan API

  • Izinkan bentuk diputar sebelumnya untuk memulai dari titik yang berbeda. Perubahan ini memungkinkan bentuk pillStar memulai kurvanya dari titik non-default di perimeter. Ini bisa berguna saat menganimasikan gerakan jalur bentuk, untuk mulai menggambar dari lokasi tertentu pada garis luar bentuk. (Ifbb4d, b/324303807)
  • Fungsi calculateBounds() telah ditambahkan ke Morph, yang paralel dengan fungsi yang sama pada RoundedPolygon. (I8a3b6, b/325463575)

Versi 1.0.0-alpha05

7 Februari 2024

androidx.graphics:graphics-shapes:1.0.0-alpha05, androidx.graphics:graphics-shapes-android:1.0.0-alpha05, dan androidx.graphics:graphics-shapes-desktop:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Fitur Baru

  • Library sekarang menawarkan fungsi pill() dan pillStar() baru untuk memudahkan pembuatan bentuk bulat/berbintang ini. Ada juga API baru untuk menghitung batas yang tepat yang diperlukan untuk suatu bentuk (batas sebelumnya hanyalah perkiraan berdasarkan titik kontrol dan anchor kurva Bezier yang mendasarinya), serta batas maksimum yang memungkinkan, yang dapat berguna untuk menentukan ukuran container yang menampungnya jika akan diputar dalam container tersebut. (I71827)

Perubahan API

  • Sekarang opsi lainnya untuk mengambil batas tepat dan maksimum. (I6d49f, b/317286450)

Perbaikan Bug

  • Sesekali ada artefak rendering saat menggambar bentuk ini sebagai jalur yang digosok, karena masalah rendering tingkat rendah yang terkait dengan kurva panjang nol. Bug ini diperbaiki dengan menghilangkan semua kurva panjang nol (yang tidak diperlukan oleh bentuk, sehingga juga menghemat overhead jalur yang dihasilkan oleh bentuk).

Versi 1.0.0-alpha04

13 Desember 2023

androidx.graphics:graphics-shapes:1.0.0-alpha04, androidx.graphics:graphics-shapes-android:1.0.0-alpha04, dan androidx.graphics:graphics-shapes-desktop:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit berikut ini.

Fitur Baru

  • Rilis ini berisi beberapa perubahan API, serta perbaikan bug.
  • Banyak perubahan API membuat library Shapes cocok untuk KMP. Hal ini mempermudah panggilan dari kode non-Android (seperti kode Compose agnostik Android). Misalnya, tidak ada jenis Android di API, seperti jenis PointF, Matriks, dan Jalur sebelumnya.
  • Ada juga beberapa perubahan yang dibuat pada API dan implementasi untuk alasan performa, khususnya untuk meminimalkan alokasi (dan pengumpulan objek). Misalnya, perpindahan dari PointF ke parameter Float yang terpisah akan menghindari pengalokasian banyak struktur PointF sementara untuk menyimpan verteks tersebut.

Perubahan API

  • Mengganti Morph.asMutableCubics dengan fungsi untuk melakukan iterasi pada MutableCubics. Antarmuka fungsi PointTransformer yang telah diubah, kini menggunakan koordinat x dan y dari Point dan menampilkan TransformedResult (yang dibuat dengan koordinat x &y yang telah diubah) (I6719e)
  • Menghapus konstruktor Cubic publik dan menjadikannya fungsi factory. (I409ce)
  • Menambahkan API transformasi dan penggambaran khusus Android (I079f6, b/292289543)
  • Menghilangkan dependensi Android (Iadc1c, b/292289543)
  • Nama properti anchor dan kontrol lebih logis sekarang (If13bd, b/294562941)
  • Parameter PointF diubah menjadi pasangan Float (Id4705, b/276466399, b/290254314)
  • progress kini diteruskan ke perintah gambar Morph secara langsung (Icdca2)

Perbaikan Bug

Versi 1.0.0-alpha03

7 Juni 2023

androidx.graphics:graphics-shapes:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit ini.

Perubahan API

  • Menambahkan fungsi RoundedPolygon.rectangle() baru (I78e7e, b/280322189)
  • Fungsi Bintang dan Lingkaran kini didekapitalisasi dan dipanggil melalui objek pendamping RoundedPolygon: misalnya, RoundedPolygon.star(...)(I14735)

Perbaikan Bug

  • Memperbaiki bug terkait penghalusan (Ibf894)
  • Memperbaiki bug yang terjadi saat bentuk awal dan akhir sama. Distribusikan ruang yang tersedia di sisi dengan lebih baik untuk potongan, pertama-tama gunakan ruang yang tersedia untuk pembulatan, lalu untuk menghaluskan jika masih ada ruang yang tersisa. (Ibd320, b/277936300)

Versi 1.0.0-alpha02

19 April 2023

androidx.graphics:graphics-shapes:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Perubahan API

  • Superclass Polygon digabungkan dengan subclass-nya, RoundedPolygon; semua poligon sekarang [opsional] poligon bulat.
  • Fungsi Bintang (yang masih menampilkan RoundedPolygon, seperti sebelumnya) sekarang menggunakan nilai innerRadius, bukan parameter innerRadiusRatio sebelumnya. Parameter ini berada dalam unit yang sama dengan parameter radius yang ada, sehingga menjadikan semuanya lebih sederhana dan konsisten. Selain itu, parameter numOuterVertices diganti namanya menjadi numVerticesPerRadius untuk memperjelas bahwa angka yang sama diterapkan untuk radius dalam dan luar.
  • CornerRounding.radius sebelumnya didokumentasikan sebagai relatif terhadap ukuran poligon, tetapi nilai tersebut (dan seharusnya) merupakan nilai absolut, bukan relatif. Dokumen telah diperbarui dan anotasi yang membatasinya ke nilai maksimum 1,0 telah diperbaiki.

Versi 1.0.0-alpha01

5 April 2023

Graphics-Shapes adalah library baru yang memudahkan pembuatan dan rendering bentuk poligonal bulat, serta morphing (animasi) sederhana dan otomatis di antara berbagai bentuk.

androidx.graphics:graphics-shapes:1.0.0-alpha01 dirilis. Versi ini dirilis dari cabang internal.

Fitur Baru

  • Gunakan Polygon API untuk membuat poligon reguler dan bintang dengan jumlah verteks yang diinginkan.
  • Gunakan parameter CornerRounding opsional untuk menentukan radius pembulatan dan parameter yang menghaluskan sudut, sehingga menghasilkan bentuk poligon dengan sudut membulat.
  • Gunakan Morph(Polygon, Polygon) API baru untuk otomatis menghitung bentuk “mengubah” yang progresnya dapat disetel dari 0 hingga 1 untuk dianimasikan antara bentuk awal dan akhir. Animasikan progres tersebut dari waktu ke waktu, dengan menggambar hasilnya di setiap frame, untuk membuat animasi yang mulus di antara bentuk bulat baru ini.

Graphics Path Versi 1.0

Versi 1.0.1

1 Mei 2024

androidx.graphics:graphics-path:1.0.1 dirilis. Versi 1.0.1 berisi commit ini.

Perbaikan Bug

  • Peningkatan pada tanda compiler.

Versi 1.0.0

6 Maret 2024

androidx.graphics:graphics-path:1.0.0 dirilis.

Versi 1.0.0-rc01

21 Februari 2024

androidx.graphics:graphics-path:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit berikut ini.

Perbaikan Bug

  • Meningkatkan performa PathIterator di API < 34 (Id4629)

Versi 1.0.0-beta02

10 Januari 2024

Perubahan dalam rilis ini bertujuan untuk mengurangi ukuran library, yang lebih besar dari yang diperlukan karena asumsi yang dibuat oleh kode native.

androidx.graphics:graphics-path:1.0.0-beta02 dirilis. Versi 1.0.0-beta02 berisi commit ini.

Perbaikan Bug

  • Mengurangi ukuran libandroidx.graphics.path.so sebesar 96%. (I71397)
  • Kurangi ukuran libandroidx.graphics.path.so sebesar 5%. (I2da7c)
  • Menyingkat komponen native androidx.graphics:graphics-path sebesar 43%. (I8e40d)

Versi 1.0.0-beta01

29 November 2023

androidx.graphics:graphics-path:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Perubahan API

Perbaikan Bug

  • Berbagai perbaikan dan peningkatan performa, termasuk cara library menangani kerucut.

Versi 1.0.0-alpha02

7 Juni 2023

androidx.graphics:graphics-path:1.0.0-alpha02 dirilis. Versi ini dikembangkan di cabang internal.

Fitur Baru

  • Memperbaiki masalah pemeriksaan versi platform internal yang menyebabkan masalah saat menjalankan pratinjau Android 14 (pemeriksaan versi akan gagal, tetapi mekanisme untuk melakukan berbagai hal pada rilis sebelumnya tidak berfungsi dengan benar di Android 14 khususnya).

Versi 1.0.0-alpha01

22 Maret 2023

androidx.graphics:graphics-path:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

  • Library baru ini memungkinkan kueri data Jalur melalui PathIterator API yang baru. Dengan menggunakan API ini, pemanggil dapat melakukan iterasi melalui semua segmen objek Path untuk menentukan operasi dan data untuk segmen tersebut.
  • Library ini menggunakan API serupa yang diperkenalkan dalam pratinjau Android 14, tetapi versi AndroidX API ini juga berfungsi pada versi kembali ke API 21.

Graphics Core Versi 1.0

Versi 1.0.0

29 Mei 2024

androidx.graphics:graphics-core:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0

  • Rilis stabil resmi library inti grafis. Menyertakan perbaikan bug minor dan peningkatan performa dari 1.0.0-rc01

Versi 1.0.0-rc01

17 April 2024

androidx.graphics:graphics-core:1.0.0-rc01 dirilis. Versi ini dikembangkan di cabang internal.

Perbaikan Bug

  • Memperbaiki masalah yang menyebabkan potensi penutupan ganda deskriptor file dengan CanvasBufferedRendererAPI pada perangkat Android tertentu yang menjalankan Android 14.
  • Memperbaiki masalah saat FrameBuffer tidak menghapus instance framebuffer dengan benar.

Versi 1.0.0-beta01

13 Desember 2023

androidx.graphics:graphics-core:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Fitur Baru

  • Memperkenalkan LowLatencyCanvasView API baru untuk mendukung rendering latensi rendah dengan API grafis 2D Android (Canvas + Paint) dalam hierarki View.
  • Memperkenalkan CanvasBufferedRenderer API untuk mendukung rendering Canvas dengan akselerasi hardware ke HardwareBuffer. Ini dapat digunakan untuk menggambar bagian antarmuka pengguna menjadi buffer yang dapat dikonversi menjadi Bitmap menggunakan Bitmap.wrapHardwareBuffer API.

Perubahan API

  • Mengupdate CanvasBufferRenderer#releaseBuffer API untuk memiliki parameter fence opsional. Memperbarui dokumentasi untuk menjelaskan kapan RenderResult#fence ditampilkan. (If1ea7)
  • Menambahkan metode draw ke RenderRequest untuk mendukung pemanfaatan coroutine guna menjadwalkan permintaan gambar. Mengganti nama metode gambar sebelumnya yang menggunakan eksekutor menjadi drawAsync. Memfaktorkan ulang metode isClosed() ke properti. (I5bff6)
  • Mengekspos parameter format buffer ke CanvasFrontBufferRenderer untuk dipetakan langsung ke CanvasBufferedRenderer.Builder#setBufferFormat (I0f272)
  • Membuat CanvasBufferedRenderer API untuk menangani rendering kanvas dengan akselerasi hardware menjadi HardwareBuffer. Hal ini menyediakan implementasi yang di-backport ke Android Q bersama konfigurasi kedalaman swapchain HardwareBuffers. Konfigurasi ColorSpace masih terbatas untuk Android U+, tetapi penerapan compat memberikan perilaku tanpa pengoperasian pada aplikasi nama Anda. (I9b1d8)
  • Tambahkan setFrameRate/clearFrameRate API ke SurfaceControlCompat.Transaction untuk mengontrol kecepatan frame bersama strategi perubahan untuk transisi yang lancar atau default. (I6045c)
  • Menurunkan level API yang diperlukan untuk setDataSpace ke Android Q dari Android T. (I59c34)
  • Menambahkan callback onBufferReleased ke GLFrameBufferRenderer API untuk memberi konsumen kesempatan untuk membersihkan status saat buffer tidak lagi ditampilkan (I8a4e2)
  • Buat LowLatencyCanvasView untuk mendukung kasus penggunaan sederhana rendering konten dengan latensi rendah yang disinkronkan dengan rendering hierarki View. Hal ini mengurangi kerumitan yang terkait dengan pengelolaan SurfaceView dengan mengelola secara internal instance SurfaceView yang diterjemahkan di luar/di layar untuk rendering yang disinkronkan dan latensi rendah. (I9253b)
  • Menambahkan dukungan konfigurasi ruang warna ke CanvasFrontBufferedRenderer API. Mengupdate callback multibuffer agar juga menyertakan SurfaceControl yang di-buffer kembali (I24bd9)

Versi 1.0.0-alpha05

6 September 2023

androidx.graphics:graphics-core:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Fitur Baru

  • Memperkenalkan GLFrameBufferRenderer API. API ini menyediakan kombinasi dependensi OpenGL, konfigurasi rantai swap, format piksel, dan konfigurasi SurfaceControl. (Ic775b)

Perubahan API

  • Menambahkan parameter lebar + tinggi ke berbagai API callback ke dimensi pipa dari SurfaceHolder#Callbacks. (I7f9fc)
  • Menambahkan API yang jelas untuk menghapus lapisan depan dan multi-buffer. (Ic1f95)
  • Menambahkan dukungan untuk mengonfigurasi jenis buffer swapchain yang mendasarinya yang digunakan dalam GLFrontBufferedRenderer. (I07a13)
  • Menambahkan properti kotlin untuk pengambil pada GLFrameBufferRenderer, anotasi IntRange untuk entri buffer maksimum, serta anotasi HardwareBufferFormart dan HardwareBufferUsage untuk setFormat/setUsage. (Ief89e)
  • Mengupdate setBuffer API pada transaksi SurfaceControl untuk menyediakan fence rilis. (Ice1bb)
  • Menambahkan SurfaceControlCompat.Transaction API untuk mengonfigurasi ruang data serta menyetel rentang kecerahan yang diperluas. (Ic378d)

Versi 1.0.0-alpha04

7 Juni 2023

androidx.graphics:graphics-core:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit ini.

Fitur Baru

  • Memperkenalkan CanvasFrontBufferedRenderer untuk mendukung grafis latensi rendah yang memanfaatkan android.graphics.Canvas API bersama dengan implementasi OpenGL yang ada

Perubahan API

  • Mengupdate SurfaceControlCompat.Transaction#setBuffer API untuk memungkinkan instance HardwareBuffer nullable untuk mencerminkan API platform yang sesuai (I173d7)
  • Mengganti nama metode yang merujuk pada rendering Buffering Ganda menjadi Multi-Buffering karena swapchain pendukung dapat berisi lebih dari 2 buffer. (I830d7)
  • Buat CanvasFrontBufferedRenderer API untuk mengaktifkan 3ps guna memanfaatkan sistem rendering yang di-buffer depan menggunakan Canvas API. (Ibfc29)

Perbaikan Bug

  • Memperbaiki masalah saat GLFrontBufferedRenderer tidak merender konten setelah melanjutkan Aktivitas yang sesuai.
  • Memperbaiki masalah saat konten yang di-buffer telah dihapus sebelum waktunya.
  • Memperbaiki masalah SurfaceHolder.Callbacks yang tidak akan dihapus setelah API grafis latensi rendah dirilis.

Versi 1.0.0-alpha03

22 Maret 2023

androidx.graphics:graphics-core:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit ini.

Perubahan API

  • Memperbarui implementasi callback GLFrontBufferedRenderer untuk menyediakan objek BufferInfo yang berisi lebar/tinggi buffer beserta ID buffer frame yang dapat digunakan untuk menargetkan ulang tujuan asli setelah dirender ke buffer awal menengah. (I7fe20)
  • Menggabungkan pembuatan SyncFence ke metode factory statis di SyncFenceCompat.
  • Menghapus metode kompatibilitas publik untuk eglDupNativeFenceFDANDROID dan menggantinya dengan metode factory SyncFenceCompat untuk pembuatan SyncFence. Hal ini untuk memastikan semua platform API menerima implementasi SyncFence yang benar, terlepas dari level API. (I849bb)
  • Menambahkan dokumentasi untuk FrameBufferRenderer dan SyncStrategy.
    • Memindahkan FrameBufferRenderer + FrameBuffer + FrameBufferPool ke paket androidx.graphics.opengl
    • Memindahkan SyncStrategy ke paket androidx.graphics.opengl
    • RenderCallback#onDraw dokumen diperbarui
    • Memperbarui dokumentasi RenderCallback#obtainFrameBuffer yang mengimplementasikan API yang bertanggung jawab untuk memanggil FrameBuffer.close
    • Memperbarui onDrawComplete untuk menunjukkan bahwa konsumen bertanggung jawab mengirimkan konten untuk ditampilkan
    • Memindahkan antarmuka/class kompatibilitas SyncFence ke paket androidx.hardware untuk mencerminkan framework
    • Mengganti nama SyncFence API menjadi SyncFenceV19 dan menjadikannya pribadi untuk menggabungkan penggunaan menjadi SyncFenceCompat yang memanfaatkan SyncFence API framework jika memungkinkan. (I5149c)
  • Menambahkan metode GLFrontBufferedRenderer#cancel dan GLFrontBufferedRenderer#execute. Yang pertama berguna dalam skenario penolakan telapak tangan saat rendering ke buffer depan harus dibatalkan dan menyembunyikan buffer depan. Fungsi ini berguna dalam skenario untuk memanipulasi objek pada thread GL tanpa harus menjadwalkan render. (If0b7f)
  • Menambahkan API untuk merender secara langsung ke lapisan yang di-buffer ganda. Hal ini membantu merender ulang suasana setelah dilanjutkan serta memberikan kesempatan kepada konsumen untuk secara selektif menentukan kapan harus memanfaatkan rendering yang di-buffer depan secara dinamis berdasarkan suasana yang diinginkan untuk dirender. (Ied56c)
  • Menambahkan API baru ke SurfaceControlCompat.Builder untuk mendukung konfigurasi SurfaceControl induk dari instance SurfaceControl lain selain mekanisme yang sudah ada dari SurfaceView. (I1d1b6)
  • Lebih banyak nullability jenis nilai yang ditampilkan dari fungsi tersembunyi yang tidak digunakan lagi (Ibf7b0)
  • Menambahkan konstanta ekstensi EGL_ANDROID_get_native_client_buffer untuk mengkueri apakah perangkat Android mendukung pengimporan instance HardwareBuffer ke objek EGLClientBuffer yang dapat digunakan sebagai instance EGLImage. (Iad767)
  • Menambahkan anotasi @JvmDefaultWithCompatibility (I8f206)

Versi 1.0.0-alpha02

9 November 2022

androidx.graphics:graphics-core:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Perubahan API

  • Memperbaiki anotasi RequiresApi yang tidak ada untuk addTransactionCommitListener yang diperkenalkan di Android S (I0a035)
  • Memperbarui callback Buffering onDraw<Front/Double> untuk memberikan matriks transformasi yang dapat diteruskan konsumen ke shader vertex selain lebar/tinggi buffering saat ini. Konsumen bertanggung jawab menggunakan parameter ini untuk melakukan pra-rotasi kode rendering OpenGL dengan benar. (I82f9e)

Perbaikan Bug

  • Meningkatkan latensi grafis dengan melakukan pra-rotasi buffering sebelum mengeluarkan transaksi SurfaceControl.
  • Memperbaiki masalah saat log error akan menampilkan error 300d (EGL_BAD_SURFACE).
  • Memperbaiki masalah saat GLFrontBufferedRenderer menjadi tidak valid setelah Aktivitas terkait yang digunakannya dilanjutkan.
  • Meningkatkan dukungan untuk emulator dan perangkat Chrome OS.
  • Memperbaiki masalah saat lapisan buffering depan mungkin disembunyikan sebelum waktunya.

Versi 1.0.0-alpha01

24 Oktober 2022

androidx.graphics:graphics-core:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

  • Rilis awal library AndroidX inti grafis. Ini termasuk API untuk mendukung kasus penggunaan latensi rendah seperti input stilus. Ini juga memperkenalkan beberapa API helper untuk penggunaan OpenGL.

Perubahan API

  • Memperkenalkan GLFrontBufferedRenderer untuk membantu rendering di depan dan multi-buffer untuk mencapai output rendering berkualitas tinggi dan latensi rendah.
  • Memperkenalkan GLRenderer API guna membantu rendering OpenGL untuk berbagai penyedia Surface seperti SurfaceView, TextureView, dan lainnya.