skija

พื้นที่เก็บข้อมูลนี้ไม่ได้รับการดูแลอย่างแข็งขันอีกต่อไป

โครงการ Active Skija ตั้งอยู่ที่ HumbleUI/Skija

Skija: การผูก Java สำหรับ Skia

Skia เป็นไลบรารีกราฟิก 2D แบบโอเพ่นซอร์สซึ่งมี API ทั่วไปที่ทำงานบนแพลตฟอร์มฮาร์ดแวร์และซอฟต์แวร์ที่หลากหลาย

Skija เป็นการผูก Java คุณภาพสูงสำหรับ Skia

แรงจูงใจ: ทำไมต้อง Skija?

เพราะ Java ไม่มีกราฟิก 2D ที่ทรงพลังและทันสมัย ​​— ถึงกระนั้น!

มีหลายครั้งที่คุณอาจต้องการกราฟิก:

• ไลบรารีวิดเจ็ต UI แบบกำหนดเองและชุดเครื่องมือทั้งหมด
• กราฟ, ไดอะแกรม,
• การสร้างภาพข้อมูล
• เกม

ข้อเสนอที่มีอยู่ ได้แก่: Graphics2D จาก AWT, GraphicsContext จาก JavaFX พวกเขาดีแต่ก็น้อยใจ

เข้าสเกีย.. Skia มีประวัติที่พิสูจน์แล้วในโครงการระดับอุตสาหกรรมโดยอาศัยโครงการนี้สำหรับกราฟิกทุกประเภท: Google Chrome, Android, Flutter, Firefox Canvas, Xamarin, LibreOffice Skia มีประสิทธิภาพเหนือกว่าชุดเครื่องมือ Java2D ที่มีอยู่ทั้งหมดในเกือบทุกการวัดประสิทธิภาพ และยังให้:

• รองรับพื้นที่สีที่กว้างขวาง
• แบบอักษรสมัยใหม่พร้อมคุณสมบัติแบบเปิด แบบอักษรที่ปรับเปลี่ยนได้ การจัดการข้อความแบบหลายสคริปต์ที่ถูกต้อง อิโมจิ
• การเรนเดอร์ GPU ที่ได้รับการปรับปรุงให้เหมาะสมที่สุด
• แบ็กเอนด์ GPU ที่ทันสมัย ​​รวมถึง Vulkan และ Metal (มีอยู่แล้วใน Skia และจะมาที่ Skija เร็ว ๆ นี้)
• สิ่งอำนวยความสะดวกแคชและคอมโพสิตในตัว

Skija นำพลังทั้งหมดนี้มาสู่ปลายนิ้วของคุณ ง่ายๆ เพียงเติมขวดโหลลงใน classpath

ทำไมต้องเย็บเล่มด้วยมือ?

มีการผูกข้อมูลที่สร้างขึ้นโดยอัตโนมัติสำหรับ Skia แต่ดูเหมือนว่าจะไม่มีการนำไปใช้งานสูง:

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

โปรเจ็กต์ Skija มีเป้าหมายในการจัดหา Java-native API ที่ยอดเยี่ยมซึ่งใช้งานได้ตามธรรมชาติ โดยเฉพาะ:

• การจัดการหน่วยความจำอัตโนมัติเต็มรูปแบบ ไม่มีตัวชี้ที่เป็นนามธรรมรั่วไหล
• การใช้คลาส Java, อินเทอร์เฟซ, การสืบทอด, ซิงเกิลตันตามธรรมชาติ
• การตั้งชื่อที่สอดคล้องกันตามแบบแผน Java รวมถึง getters/setters สำหรับคุณสมบัติ
• พิมพ์ enums แทนค่าคงที่จำนวนเต็ม
• นามธรรมแพลตฟอร์ม Java ดั้งเดิมแทนการห่อ Skia/C++ (สตริง อาร์เรย์ สตรีม ไฟล์ บัฟเฟอร์ไบต์ AutoCloseable)
• การซ่อนรายละเอียดการใช้งาน เช่น การแปลงการเข้ารหัสสตริงแบบโปร่งใส การแปลงดัชนีจุดไบต์/โค้ด
• API แบบตัวสร้างที่คล่องแคล่วหากเป็นไปได้
• คลาสข้อมูลที่มีน้ำหนักเบาเมื่อเป็นไปได้ (Point, Rect, FontMetrics ฯลฯ จะไม่ถูกมิเรอร์โดยอินสแตนซ์ดั้งเดิม)

เป้าหมายสูงสุดสำหรับ Skija คือการรู้สึกเหมือนเป็นไลบรารี Java และไม่ต้องคิดถึงส่วนดั้งเดิมเลย

สร้างร่วมกับสกีจา

เขียนสำหรับเดสก์ท็อป ชุดเครื่องมือ UI ที่ประกาศสำหรับ Kotlin:

Skija Graphics2D การใช้งาน Java2D API:

การสาธิตของ Robert Felker:

วิดีโอของแฮโรลด์:

แอปสาธิต Skija:

สถานะปัจจุบัน

อัลฟ่าสาธารณะ สิ่งต่าง ๆ อาจเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบล่วงหน้า

โปรดทราบว่า Skia เป็นที่รู้กันว่าเปลี่ยน API ค่อนข้างบ่อย (ทุกเดือน) Skija จะพยายามอย่างเต็มที่เพื่อปกป้องจากการเปลี่ยนแปลงเหล่านี้ แต่บางครั้งก็อาจเป็นไปไม่ได้ (เช่น ลบวิธีการออก) ปกติมันเป็นของเสริมครับ อย่ากังวลมาก

แพลตฟอร์ม:

• หน้าต่าง
• ลินุกซ์
• ระบบปฏิบัติการ macOS

แบ็กเอนด์:

• บิตแมป
• OpenGL
• ไดเร็ค3ดี
• โลหะ
• วัลแคน

API:

 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               ▓▓▓▓▓▓▓▓░░

การใช้สกีจา

การใช้ Skija นั้นง่ายดายเพียงแค่เพิ่มไฟล์ jar

มาเวน:

< 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 >

เกรด:

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

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

แทนที่ ${artifact} และ ${version} ด้วย:

แพลตฟอร์ม	${artifact}	${version}
macOS อินเทล	skija-macos-x64
แมคโอเอส M1	skija-macos-arm64
ลินุกซ์	skija-linux
หน้าต่าง	skija-windows

เอกสารประกอบ

เริ่มต้นด้วยการอ่านการเริ่มต้นใช้งาน

เอกสาร API อยู่ระหว่างการพัฒนา — ศึกษาซอร์สโค้ดและความคิดเห็น JavaDoc

ฉันพบว่าเอกสารของ SkiaSharp เป็นแหล่งข้อมูลที่ดีเยี่ยมเกี่ยวกับสิ่งที่สามารถทำได้ใน Skia พวกเขามีตัวอย่างที่ดีและคำอธิบายด้วยภาพด้วย

หาก Skija ไม่มีเอกสารประกอบสำหรับวิธีการหรือคลาสเฉพาะ ให้ตรวจสอบคลาสเดียวกันใน Skia Documentation แทน อาจเป็นไปได้ว่าเรายังไม่ได้ย้ายไปยัง Java PR ยินดีต้อนรับ!

สุดท้าย แอปสาธิต LWJGL มีตัวอย่างของ API ส่วนใหญ่ที่ใช้งานอยู่ในปัจจุบัน

ทรัพยากร

• ภาพรวม youtube.com/watch?v=t1X-Oln1u24
• เกมเขียนโค้ดใน Skija และ Clojure youtube.com/watch?v=KES-lKTq-3M
• SWT และ Skija บน Raspberry Pi spket.com/blog/native-gui-app-with-swt-and-skija-on-raspberry-pi

สร้าง Skija ตั้งแต่เริ่มต้น

สิ่งที่ต้องมีก่อน: Git, CMake, Ninja, JDK 9+, $JAVA_HOME, Python 3

ชำระเงิน:

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

ในการออกแบบโค้ด:

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

หากต้องการสร้าง Skia โปรดดู https://github.com/JetBrains/skia-build/

ตัวอย่างการทำงาน

ตัวอย่างต้องมีการสร้าง Skija ในพื้นที่ (ดูการสร้าง Skija)

ดูตัวอย่าง/.

มีส่วนร่วม

ยินดีบริจาค!

อย่าลืมอ่าน Code Conventions

ข้อควรจำ: เป้าหมายของ Skija คือการทำแผนที่ Skia API ให้ใกล้เคียงที่สุด

สิ่งเหล่านี้มีสถานที่ใน Skija:

• ทุกสิ่งที่อยู่ใน Skia และสมเหตุสมผลในโลก Java
• วิธีการอำนวยความสะดวก (เช่น วิธีการที่ใช้ค่าเริ่มต้นสำหรับพารามิเตอร์)
• ยินดีเป็นอย่างยิ่งที่ยินดีรับฟังเอกสารเกี่ยวกับวิธีการของ Skija!

สิ่งเหล่านี้ไม่:

• สิ่งที่ไม่ได้แมปกับสิ่งใดๆ ใน Java โดยตรง (พอยน์เตอร์ ฯลฯ)
• คลาสใหม่ วิธีการใหม่ที่ไม่มีอยู่ใน Skia
• โค้ดที่รวม Skia API เข้าด้วยกันเพื่อกรณีการใช้งานพิเศษ

เรายินดีต้อนรับสิ่งที่เป็นประโยชน์ที่สร้างขึ้นจาก Skia/Skija เสมอ — ในฐานะห้องสมุด