واجهات برمجة تطبيقات الفرشاة

توفّر واجهات برمجة التطبيقات BrushInk طريقة لإنشاء وتخصيص فُرش للرسم على لوحة.

إنشاء فرشاة

لإنشاء فرشاة، استخدِم طرق المصنع Brush مع وسيطات مُسمّاة مثل Brush.createWithColorLong(). يتيح لك هذا الصف ضبط الخصائص التالية:

• family: نمط الفرشاة، وهو مشابه لنمط الخط أو الخط في النص. راجِع StockBrushes للاطّلاع على قيم BrushFamily المتاحة.
• ‫color: تمثّل هذه السمة لون الفرشاة. يمكنك ضبط اللون باستخدام ColorLong.
• size: السُمك الأساسي للخطوط التي تم إنشاؤها باستخدام الفرشاة
• epsilon: هي أصغر مسافة يجب أن تكون بين نقطتَين في الخط ليتم اعتبارهما مختلفتَين، ما يتحكّم في مستوى التفاصيل أو دقة شكل الخط.
  • تؤدي القيم الأعلى إلى تبسيط الخط بشكل أكبر، ما يؤدي إلى استخدام مساحة أقل من الذاكرة وعرض أسرع، ولكن قد يؤدي ذلك إلى ظهور تشوّهات مرئية، مثل الحواف المسنّنة عند التكبير.
  • تحتفظ القيم المنخفضة بتفاصيل أكثر عند التكبير بجودة عالية، ولكنها تزيد من استخدام الذاكرة.
  • لإنشاء نماذج أوّلية باستخدام مقياس وحدة 1 بكسل، يمكنك البدء بالقيمة 0.1. بالنسبة إلى تطبيقات الإنتاج التي تتوافق مع كثافات شاشة مختلفة، استخدِم وحدات مستقلة عن الكثافة (مثل dp) وعدِّل قيمة إبسيلون وفقًا لذلك.

val redBrush = Brush.createWithColorLong(
  family = StockBrushes.pressurePen(),
  colorLong = Color.RED.pack(),
  size = 5F,
  epsilon = 0.1F
)

تعديل خصائص الفرشاة

يمكنك إنشاء نسخة من فرشاة حالية باستخدام طريقة copy(). تتيح لك هذه الطريقة تغيير أي من خصائص الفرشاة.

val blueBrush = redBrush.copy(colorLong = Color.BLUE.pack())

الفرش المخصّصة

على الرغم من أنّ StockBrushes يوفّر مجموعة متنوّعة من الفُرش الشائعة، فإنّ واجهة برمجة التطبيقات Ink API توفّر أيضًا مسارًا متقدّمًا لإنشاء سلوكيات جديدة تمامًا للفُرش من أجل الحصول على تأثيرات فنية فريدة أو تكرار فُرش معيّنة حالية للتوافق مع الأنظمة القديمة.

يتم تحميل BrushFamily مخصّص من تنسيقه المتسلسل. التنسيق المطلوب هو الترميز الثنائي المضغوط بتنسيق gzip لمخزن بروتوكولات BrushFamily المؤقت. يتيح لك ذلك تحميل ملفات الفرشاة المخصصة واستخدامها اليوم. بعد إلغاء تسلسل البيانات، يمكن استخدام BrushFamily المخصّص لإنشاء Brush جديد بلون وحجم محدّدَين، تمامًا مثل أي من مجموعات StockBrushes.

class CustomBrushes(val context: Context) {

    companion object {
        private const val TAG = "CustomBrushes"
    }

    val brushes by lazy { loadCustomBrushes() }

    @OptIn(ExperimentalInkCustomBrushApi::class)
    private fun loadCustomBrushes(): List<CustomBrush> {
        val brushFiles = mapOf(
            "Calligraphy" to (R.raw.calligraphy to R.drawable.draw_24px),
            "Flag Banner" to (R.raw.flag_banner to R.drawable.flag_24px),
            "Graffiti" to (R.raw.graffiti to R.drawable.format_paint_24px),
            // ...
        )

        val loadedBrushes = brushFiles.mapNotNull { (name, pair) ->
            val (resourceId, icon) = pair
            val brushFamily = context.resources.openRawResource(resourceId).use { inputStream ->
                BrushFamily.decode(inputStream)
            }
            CustomBrush(name, icon, brushFamily.copy(clientBrushFamilyId = name))
        }
        return loadedBrushes
    }
}

data class CustomBrush(
    val name: String,
    val icon: Int,
    val brushFamily: BrushFamily
)
InkApiBrushApis.kt