skija

️ Repositori ini tidak lagi dipelihara secara aktif. ️

Proyek Skija aktif terletak di HumbleUI/Skija

Skija: Pengikatan Java untuk Skia

Skia adalah perpustakaan grafis 2D sumber terbuka yang menyediakan API umum yang bekerja di berbagai platform perangkat keras dan perangkat lunak.

Skija adalah binding Java berkualitas tinggi untuk Skia.

Motivasi: Mengapa Skija?

Karena Java tidak memiliki grafik 2D yang kuat dan modern — tetap saja!

Ada banyak kesempatan ketika Anda mungkin memerlukan grafis:

• perpustakaan widget UI khusus dan seluruh toolkit,
• grafik, diagram,
• visualisasi,
• pertandingan.

Penawaran yang ada adalah: Graphics2D dari AWT, GraphicsContext dari JavaFX. Mereka bagus, tapi mengecewakan.

Masuk Skia. Skia memiliki rekam jejak yang terbukti dalam proyek skala industri yang mengandalkannya untuk segala hal grafis: Google Chrome, Android, Flutter, Firefox Canvas, Xamarin, LibreOffice. Skia mengungguli semua toolkit Java2D yang ada di hampir semua benchmark, dan juga menyediakan:

• dukungan ruang warna yang luas,
• tipografi modern dengan fitur tipe terbuka, tipografi variabel, penanganan teks multi-skrip yang benar, emoji,
• rendering GPU yang sangat optimal,
• backend GPU modern, termasuk Vulkan dan Metal (sudah ada di Skia, segera hadir di Skija),
• fasilitas caching dan pengomposisian bawaan.

Skija menghadirkan semua kekuatan ini ke ujung jari Anda, semudah menambahkan toples ke classpath.

Mengapa penjilidan dibuat dengan tangan?

Ada pengikatan yang dibuat secara otomatis untuk Skia, tetapi tampaknya tidak memiliki tingkat adopsi yang tinggi:

• github.com/bytedeco/javacpp-presets/tree/master/skia
• github.com/eungju/skia-javacpp

Proyek Skija memiliki tujuan untuk menyediakan API asli Java yang bagus dan alami untuk digunakan. Secara khusus:

• manajemen memori otomatis penuh, tidak ada abstraksi penunjuk yang bocor,
• penggunaan alami kelas Java, antarmuka, warisan, lajang,
• penamaan yang konsisten mengikuti konvensi Java, termasuk getter/setter untuk properti,
• mengetik enum alih-alih konstanta integer,
• abstraksi platform Java asli alih-alih yang dibungkus Skia/C++ (string, array, stream, file, buffer byte, AutoCloseable),
• menyembunyikan detail implementasi, misalnya konversi pengkodean string transparan, konversi indeks byte/kode titik,
• API gaya pembuat yang lancar jika memungkinkan,
• kelas data ringan jika memungkinkan (Point, Rect, FontMetrics, dll tidak dicerminkan oleh instance asli).

Tujuan akhir Skija adalah merasa seperti perpustakaan Java dan tidak perlu memikirkan bagian asli sama sekali.

Dibangun dengan Skija

Compose untuk Desktop, toolkit UI deklaratif untuk Kotlin:

Skija Graphics2D, implementasi Java2D API:

Demo Robert Felker:

Video Harold:

Aplikasi demo Skija:

Status saat ini

Alfa publik. Segalanya mungkin berubah tanpa pemberitahuan.

Perlu diketahui bahwa Skia diketahui cukup sering mengubah API-nya (setiap bulan). Skija akan melakukan yang terbaik untuk melindungi dari perubahan ini, namun terkadang hal ini tidak mungkin dilakukan (misalnya metode telah dihapus). Biasanya itu hanya hal tambahan, jangan terlalu khawatir.

Platform:

• jendela
• Linux
• macOS

Bagian belakang:

• peta bit
• OpenGL
• Langsung3D
• Logam
• Vulkan

Lebah:

 Bitmap               ▓▓▓▓▓▓▓▓▓▓    Paint                ▓▓▓▓▓▓▓▓▓▓
Canvas               ▓▓▓▓▓▓▓▓░░    Path                 ▓▓▓▓▓▓▓▓▓▓
Codec                ▓▓▓▓░░░░░░    PathEffects          ▓▓▓▓▓▓▓▓▓▓
Color                ▓░░░░░░░░░    PathMeasure          ▓▓▓▓▓▓▓▓▓▓
ColorFilter          ▓▓▓▓▓▓▓▓▓▓    PaintFilterCanvas    ▓▓▓▓▓▓▓▓▓▓
ColorInfo            ▓▓▓▓▓▓▓▓▓▓    Picture              ▓▓▓▓▓▓▓▓▓░
ColorSpace           ▓▓▓▓░░░░░░    PictureRecorder      ▓▓▓▓▓▓▓▓▓▓
Data                 ▓▓▓▓▓▓▓▓▓░    PixelRef             ▓▓▓▓▓▓▓▓▓▓
Drawable             ▓▓▓▓▓▓▓▓░░    Pixmap               ▓▓▓▓▓▓▓▓▓▓
Flattenable          ░░░░░░░░░░    Region               ▓▓▓▓▓▓▓▓▓▓
Font                 ▓▓▓▓▓▓▓▓▓▓    RuntimeEffect        ▓▓▓▓▓░░░░░
FontData             ░░░░░░░░░░    ScalerContext        ░░░░░░░░░░
FontManager          ▓▓▓▓▓▓▓▓▓░    Shader               ▓▓▓▓▓▓▓▓▓▓
FontStyle            ▓▓▓▓▓▓▓▓▓▓    ShadowUtils          ▓▓▓▓▓▓▓▓▓▓
FontStyleSet         ▓▓▓▓▓▓▓▓▓▓    Stream               ░░░░░░░░░░
Image                ▓▓░░░░░░░░    String               ▓░░░░░░░░░
ImageFilters         ▓▓▓▓▓▓▓▓▓▓    Surface              ▓░░░░░░░░░
ImageInfo            ▓▓▓▓▓▓▓▓▓▓    TextBlob             ▓▓▓▓▓▓▓▓▓▓
MaskFilter           ▓▓▓▓▓▓▓▓▓▓    TextBlobBuilder      ▓▓▓▓▓▓▓▓▓▓
Matrix33             ▓▓▓░░░░░░░    Typeface             ▓▓▓▓▓▓▓▓░░
Matrix44             ▓▓▓░░░░░░░    WStream              ▓▓░░░░░░░░

Shaper:                            Paragraph:

BiDiRunIterator      ▓▓▓▓▓▓▓▓▓▓    FontCollection       ▓▓▓▓▓▓▓▓▓▓
FontMgrRunIterator   ▓▓▓▓▓▓▓▓▓▓    LineMetrics          ▓▓▓▓▓▓▓▓▓░
FontRunIterator      ▓▓▓▓▓▓▓▓▓▓    Paragraph            ▓▓▓▓▓▓▓▓▓▓
HbIcuScriptRunIter   ▓▓▓▓▓▓▓▓▓▓    ParagraphCache       ▓▓▓▓▓▓▓▓▓▓
IcuBidiRunIterator   ▓▓▓▓▓▓▓▓▓▓    ParagraphStyle       ▓▓▓▓▓▓▓▓▓▓
LanguageRunIterator  ▓▓▓▓▓▓▓▓▓▓    ParagraphBuilder     ▓▓▓▓▓▓▓▓▓▓
RunHandler           ▓▓▓▓▓▓▓▓▓▓    TextStyle            ▓▓▓▓▓▓▓▓▓▓
RunInfo              ▓▓▓▓▓▓▓▓▓▓    TypefaceFontProvider ▓▓▓▓▓▓▓▓▓▓
ScriptRunIterator    ▓▓▓▓▓▓▓▓▓▓
Shaper               ▓▓▓▓▓▓▓▓▓▓
TextBlobBldRunHndlr  ▓▓▓▓▓▓▓▓▓▓

SVG:

SVGDOM               ▓▓▓▓▓▓▓▓░░
SVGCanvas            ▓▓▓▓▓▓▓▓▓▓
SVGSVG               ▓▓▓▓▓▓▓▓░░

Menggunakan Skija

Menggunakan Skija semudah menambahkan file jar.

Pakar:

< repositories >
  < repository >
    < id >space-maven</ id >
    < url >https://packages.jetbrains.team/maven/p/skija/maven</ url >
  </ repository >
</ repositories >

< dependencies >
  < dependency >
    < groupId >org.jetbrains.skija</ groupId >
    < artifactId >skija-${platform}</ artifactId >
    < version >${version}</ version >
  </ dependency >
</ dependencies >

Gradasi:

 repositories {
  maven {
    url " https://packages.jetbrains.team/maven/p/skija/maven "
  }
}

dependencies {
  api " org.jetbrains.skija: ${ artifact } : ${ version } "
}

Ganti ${artifact} dan ${version} dengan:

Platform	${artifact}	${version}
macOS Intel	skija-macos-x64
macOS M1	skija-macos-arm64
Linux	skija-linux
jendela	skija-windows

Dokumentasi

Mulailah dengan membaca Memulai.

Dokumen API sedang dalam pengembangan — lihat kode sumber dan komentar JavaDoc.

Saya menemukan dokumentasi SkiaSharp sebagai sumber yang bagus tentang apa yang dapat dilakukan di Skia. Mereka juga memiliki contoh bagus dan penjelasan visual.

Jika Skija tidak memiliki dokumentasi untuk metode atau kelas tertentu, periksa kelas yang sama di Dokumentasi Skia. Mungkin saja kami belum memindahkannya ke Jawa. PR dipersilakan!

Terakhir, aplikasi demo LWJGL memiliki contoh sebagian besar API yang saat ini diterapkan.

Sumber daya

• Ikhtisar youtube.com/watch?v=t1X-Oln1u24
• Permainan coding di Skija dan Clojure youtube.com/watch?v=KES-lKTq-3M
• SWT dan Skija di Raspberry Pi spket.com/blog/native-gui-app-with-swt-and-skija-on-raspberry-pi

Membangun Skija dari awal

Prasyarat: Git, CMake, Ninja, JDK 9+, $JAVA_HOME, Python 3.

Check-out:

git clone https://github.com/JetBrains/skija.git
cd skija
./script/build.py

Untuk mendesain kode:

security find-identity
export APPLE_CODESIGN_IDENTITY= " <...> "
./script/build.py

Untuk membuat Skia sendiri, lihat https://github.com/JetBrains/skia-build/

Contoh yang sedang berjalan

Contohnya memerlukan pembangunan Skija lokal (lihat Gedung Skija).

Lihat contoh/.

Berkontribusi

Kontribusi dipersilahkan!

Pastikan untuk membaca Konvensi Kode.

Ingat: tujuan Skija adalah memetakan Skia API sedekat mungkin.

Hal-hal ini mempunyai tempat di Skija:

• Segala sesuatu yang ada di Skia dan masuk akal di dunia Java.
• Metode kenyamanan (misalnya metode yang menggunakan nilai default untuk suatu parameter).
• Dokumentasi tentang metode Skija sangat diterima!

Ini tidak:

• Hal-hal yang tidak secara langsung dipetakan ke apa pun di Java (pointer, dll).
• Kelas baru, metode baru yang tidak ada di Skia.
• Kode yang menggabungkan API Skia untuk kasus penggunaan khusus.

Hal-hal berguna yang dibangun di atas Skia/Skija selalu diterima — sebagai perpustakaan.