Brush APIs

رابط‌های برنامه‌نویسی کاربردی قلم‌مو (API) مربوط به قلم‌موهای جوهری (Ink Brush راهی برای ایجاد و سفارشی‌سازی قلم‌موها برای طراحی روی بوم ارائه می‌دهند.

یک قلم مو ایجاد کنید

برای ایجاد یک قلم‌مو، از متدهای کارخانه Brush با آرگومان‌های نامگذاری شده مانند Brush.createWithColorLong() استفاده کنید. این کلاس به شما امکان می‌دهد ویژگی‌های زیر را تنظیم کنید:

  • family : سبک قلم‌مو، مشابه با یک فونت یا فونت در متن. برای مقادیر موجود BrushFamily به StockBrushes مراجعه کنید.
  • color : رنگ قلم‌مو. می‌توانید رنگ را با استفاده از ColorLong تنظیم کنید.
  • size : ضخامت پایه خطوط ایجاد شده با قلم‌مو.
  • epsilon : کمترین فاصله‌ای که در آن دو نقطه در خط باید متمایز در نظر گرفته شوند، که سطح جزئیات یا دقت هندسه خط را کنترل می‌کند.
    • مقادیر بالاتر، حاشیه را ساده‌تر می‌کنند که باعث می‌شود حافظه کمتری مصرف شود و سریع‌تر رندر شود، اما ممکن است هنگام بزرگنمایی، منجر به مصنوعات قابل مشاهده‌ای مانند لبه‌های ناهموار شود.
    • مقادیر پایین‌تر، جزئیات بیشتری را برای بزرگنمایی با کیفیت بالا حفظ می‌کنند، اما استفاده از حافظه را افزایش می‌دهند.
    • برای نمونه‌سازی اولیه با مقیاس واحد ۱ پیکسل، ۰.۱ نقطه شروع خوبی است. برای برنامه‌های تولیدی که از تراکم صفحه نمایش‌های مختلف پشتیبانی می‌کنند، از واحدهای مستقل از تراکم (مانند 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
)