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 است. این به شما امکان می‌دهد فایل‌های براش سفارشی را همین امروز بارگذاری و استفاده کنید. پس از deserialize شدن، می‌توان از BrushFamily سفارشی برای ایجاد یک Brush جدید با رنگ و اندازه خاص، درست مانند هر یک از خانواده‌های StockBrushes ، استفاده کرد.

class CustomBrushes(val context: Context) {

  private const val TAG = "CustomBrushes"

  val brushes by lazy { loadCustomBrushes(context) }

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