โมดูล

Ink API เป็นแบบแยกส่วน คุณจึงใช้ได้เฉพาะสิ่งที่ต้องการ

สโตรก

笔画模块是 Ink API 的基础。此模块中的关键数据类型包括：

• StrokeInputBatch：表示一系列指针输入，包括其位置、时间戳，以及可选的压力、倾斜度和方向。
• InProgressStroke：表示正在绘制的笔画。InProgressStroke 用于以低延迟渲染部分笔画，并在输入完成后构建最终的 Stroke，之后该对象可以重复使用。 InProgressStroke 由 InProgressStrokes 可组合项使用。
• Stroke：已完成的笔画的不可变表示形式，具有固定的几何形状。每个 Stroke 都有一个 ImmutableStrokeInputBatch（输入点）、一个 Brush（样式）和一个 PartitionedMesh（几何形状）。您可以在应用中存储、处理和渲染笔画。

เรขาคณิต

โมดูลเรขาคณิตรองรับการดำเนินการทางเรขาคณิตกับรูปร่างพื้นฐาน (โดยใช้คลาสเฉพาะ เช่น Box และ Vec) รวมถึงรูปร่างที่กำหนดเอง (โดยใช้ PartitionedMesh) ซึ่งรวมถึงการตรวจหาการตัดกันและการแปลง PartitionedMesh ยังสามารถเก็บข้อมูลเพิ่มเติมเพื่อรองรับการแสดงผลได้ด้วย

แปรง

โมดูล brush จะกำหนดสไตล์ของเส้น โดยมีส่วนประกอบหลัก 2 ส่วน ได้แก่

• Brush: ระบุรูปแบบของเส้นขีด รวมถึง สีพื้นฐาน ขนาดพื้นฐาน และ BrushFamily BrushFamily มีลักษณะคล้ายกับชุดแบบอักษร โดยจะกำหนดสไตล์ของเส้นขีด เช่น BrushFamily สามารถแสดงถึงรูปแบบเฉพาะของเครื่องหมายหรือ ไฮไลต์ ซึ่งช่วยให้เส้นที่มีขนาดและสีต่างกันแชร์รูปแบบนั้นได้
• StockBrushes: มีฟังก์ชันจากโรงงานสำหรับ สร้างอินสแตนซ์ BrushFamily ที่พร้อมใช้งาน

การเขียน

借助 Compose 创作模块，您可以捕获用户触摸输入，并将其实时呈现为屏幕上的低延迟笔画。这是通过 InProgressStrokes 可组合项实现的，该可组合项可处理运动事件并在绘制笔画时显示笔画。

笔画完成后，可组合项会使用 InProgressStrokesFinishedListener 回调通知客户端应用。这允许应用检索完成的笔画以进行渲染或存储。

在 Compose 中，InProgressStrokes 通过 onStrokesFinished 参数接收此回调。将完成的笔画传递给另一个可组合项，以使用渲染模块将其提交到屏幕。

การแสดงภาพ

โมดูลการแสดงผลช่วยให้การวาดเส้นหมึกลงใน Android Canvas ง่ายขึ้น โดยมี CanvasStrokeRenderer สำหรับ Compose และ ViewStrokeRenderer สำหรับเลย์เอาต์ที่อิงตาม View โดย โปรแกรมแสดงผลเหล่านี้จะเพิ่มประสิทธิภาพการแสดงผลและช่วยแสดงภาพคุณภาพสูง รวมถึงการป้องกันรอยหยัก

หากต้องการแสดงผลลายเส้น ให้เรียกใช้เมธอด create() เพื่อรับอินสแตนซ์ CanvasStrokeRenderer จากนั้นเรียกใช้เมธอด draw() เพื่อ แสดงผลลายเส้นที่เสร็จแล้ว (Stroke) หรือลายเส้นที่กำลังดำเนินการ (InProgressStroke) บน Canvas

คุณสามารถเปลี่ยนรูปผืนผ้าใบได้เมื่อวาดเส้น ตัวอย่างเช่น การแพน การซูม และการหมุน หากต้องการแสดงผลเส้นขีดอย่างถูกต้อง คุณต้องส่งcanvas transform ไปยัง CanvasStrokeRenderer.draw ด้วย

หากต้องการหลีกเลี่ยงการติดตามการเปลี่ยนรูปแบบ canvas แยกกัน ให้ใช้ ViewStrokeRenderer แทน

พื้นที่เก็บข้อมูล

โมดูลพื้นที่เก็บข้อมูลมีเครื่องมือสำหรับ การแปลงข้อมูลลายมือเป็นอนุกรมและยกเลิกการแปลงเป็นอนุกรมอย่างมีประสิทธิภาพ โดยเน้นที่ StrokeInputBatch เป็นหลัก

โมดูลนี้ใช้บัฟเฟอร์โปรโตคอลและเทคนิคการบีบอัดเดลต้าที่เพิ่มประสิทธิภาพ ซึ่งช่วยประหยัดพื้นที่เก็บข้อมูลได้อย่างมากเมื่อเทียบกับวิธีการแบบเดิม

โมดูลพื้นที่เก็บข้อมูลช่วยให้การบันทึก โหลด และแชร์จังหวะง่ายขึ้น