این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

ماژول ها

Ink API ماژولار است، بنابراین می‌توانید فقط از آنچه نیاز دارید استفاده کنید.

سکته مغزی

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

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

هندسه

ماژول Geometry از عملیات هندسی روی اشکال اولیه (با استفاده از کلاس‌های اختصاصی مانند Box و Vec ) و همچنین اشکال دلخواه (با استفاده از PartitionedMesh ) از جمله تشخیص تقاطع و تبدیل پشتیبانی می‌کند. PartitionedMesh همچنین می‌تواند داده‌های اضافی را برای پشتیبانی از رندرینگ در خود نگه دارد.

برس

ماژول brush سبک خطوط را تعریف می‌کند و از دو بخش اصلی تشکیل شده است:

Brush : سبک یک خط شامل رنگ پایه، اندازه پایه و BrushFamily را مشخص می‌کند. BrushFamily مشابه خانواده فونت است و سبک یک خط را تعریف می‌کند. برای مثال، یک BrushFamily می‌تواند یک سبک خاص از ماژیک یا هایلایتر را نشان دهد و به خطوط با اندازه‌ها و رنگ‌های مختلف اجازه می‌دهد تا آن سبک را به اشتراک بگذارند.
StockBrushes : توابع کارخانه‌ای برای ایجاد نمونه‌های آماده برای استفاده BrushFamily را فراهم می‌کند.

تألیف

ماژول Compose Authoring به شما امکان می‌دهد ورودی لمسی کاربر را ضبط کرده و آن را به صورت حرکات لمسی با تأخیر کم روی صفحه نمایش به صورت بلادرنگ رندر کنید. این امر از طریق Composable InProgressStrokes محقق می‌شود که رویدادهای حرکتی را پردازش کرده و حرکات لمسی را هنگام ترسیم نمایش می‌دهد.

پس از تکمیل یک stroke، composable با استفاده از فراخوانی InProgressStrokesFinishedListener به برنامه کلاینت اطلاع می‌دهد. این به برنامه اجازه می‌دهد تا stroke های تکمیل شده را برای رندر یا ذخیره سازی بازیابی کند.

در Compose، InProgressStrokes این فراخوانی را در پارامتر onStrokesFinished دریافت می‌کند. stroke های تکمیل شده را به یک composable دیگر منتقل کنید تا با استفاده از ماژول رندر ، آنها را به صفحه نمایش اعمال کند.

رندرینگ

ماژول Rendering، ترسیم خطوط جوهر روی Canvas اندروید را ساده می‌کند. این CanvasStrokeRenderer را برای Compose و ViewStrokeRenderer را برای طرح‌بندی‌های مبتنی بر نما فراهم می‌کند. این رندرکننده‌ها عملکرد رندر را بهینه کرده و به ارائه تصاویر با کیفیت بالا، از جمله ضد لبه‌سازی، کمک می‌کنند.

برای رندر کردن strokeها، متد create() را برای دریافت یک نمونه CanvasStrokeRenderer فراخوانی کنید، و سپس متد draw() را برای رندر strokeهای تکمیل‌شده ( Stroke ) یا در حال انجام ( InProgressStroke ) روی یک Canvas فراخوانی کنید.

شما می‌توانید هنگام رسم یک stroke، بوم را تغییر شکل دهید. مثال‌ها شامل panning، zooming و rotation می‌شود. برای رندر صحیح stroke، باید transform canvas را به CanvasStrokeRenderer.draw نیز ارسال کنید.

برای جلوگیری از ردیابی جداگانه‌ی تبدیل canvas ، به جای آن ViewStrokeRenderer استفاده کنید.