דף זה תורגם על ידי Cloud Translation API.

ממשקי API של מברשות

ממשקי ה-API של Ink Brush מאפשרים ליצור ולהתאים אישית מברשות לציור על קנבס.

יצירת מברשת

כדי ליצור מברשת, משתמשים בשיטות ליצירת אובייקטים Brush עם ארגומנטים בעלי שם כמו Brush.createWithColorLong(). המחלקות האלה מאפשרות להגדיר את המאפיינים הבאים:

‫family: הסגנון של המברשת, בדומה לטיפוגרפיה או לגופן בטקסט. בקטע StockBrushes מפורטים הערכים הזמינים של BrushFamily.
‫color: צבע המברשת. אפשר להגדיר את הצבע באמצעות ColorLong.
size: עובי הבסיס של הקווים שנוצרו באמצעות המברשת.
‫epsilon: המרחק הקטן ביותר שבו שתי נקודות בקו צריכות להיחשב כנפרדות. המרחק הזה קובע את רמת הפירוט או את רמת הדיוק של הגיאומטריה של הקו.
- ערכים גבוהים יותר מפשטים את הקו יותר, מה שמאפשר שימוש בפחות זיכרון ועיבוד מהיר יותר, אבל עלול לגרום לאפקטים חזותיים לא רצויים כמו קצוות משוננים כשמגדילים את התצוגה.
- ערכים נמוכים יותר שומרים על יותר פרטים להגדלה באיכות גבוהה, אבל מגדילים את השימוש בזיכרון.
- אם יוצרים אב טיפוס עם סולם של יחידה אחת של פיקסל, כדאי להתחיל עם 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 从其序列化格式加载。所需格式为 BrushFamily 协议缓冲区的 gzip 压缩二进制编码。这样一来，您就可以立即加载和使用自定义笔刷文件。反序列化后，自定义 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
)

ממשקי API של מברשות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

יצירת מברשת

שינוי המאפיינים של המכחול

מכחולים בהתאמה אישית

ממשקי API של מברשות