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

ממשקי ה-API של Brush מספקים לכם את הכלים להגדיר את הסגנון החזותי של השרטוטים. אתם יכולים ליצור מברשות בצבעים, בגדלים ובסגנונות שונים כדי להשיג מגוון מראות.

יצירת מברשת

כדי ליצור מברשת, משתמשים ב-Compose Brush שיטות נלוות עם ארגומנטים בעלי שם כמו Brush.Companion.createWithComposeColor. המחלקה הזו מאפשרת להגדיר את המאפיינים הבאים:

  • ‫family: הסגנון של המברשת, בדומה למשפחת גופנים או גופן בטקסט. במאמר StockBrushes מפורטים הערכים הזמינים של BrushFamily.
  • ‫color: צבע המכחול. אפשר להגדיר את הצבע באמצעות ColorLong.
  • ‫size: העובי הכולל של משיחות המכחול שנוצרו באמצעות המברשת.
  • ‫epsilon: המרחק הקטן ביותר שבו שתי נקודות צריכות להיחשב כנפרדות מבחינה חזותית למטרות גיאומטריה של יצירת קווים. היחס בין אפסילון לנקודות הקו קובע עד כמה אפשר להגדיל את הקו בלי ארטיפקטים, על חשבון הזיכרון. נקודת התחלה טובה ליחידות קו היא 1 פיקסל, ונקודת התחלה טובה לאפסילון היא 0.1. ערכי אפסילון גבוהים יותר צורכים פחות זיכרון, אבל מאפשרים פחות זום לפני שמופיעים פגמים במשולשים. כדאי לערוך ניסויים כדי למצוא את הערך המתאים לתרחיש לדוגמה שלכם.

val brush = Brush.createWithComposeColor(
    family = StockBrushes.pressurePen(),
    color = Color.Black,
    size = 5F,
    epsilon = 0.1F
)

שינוי מאפייני המברשת

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

val redBrush = Brush.createWithComposeColor(
    family = StockBrushes.pressurePen(),
    color = Color.Red,
    size = 5F,
    epsilon = 0.1F
)

val blueBrush = redBrush.copyWithComposeColor(color = Color.Blue)

מברשות בהתאמה אישית

虽然 StockBrushes 提供了一组通用的画笔，但 Ink API 还提供了一种高级途径，可用于创建全新的画笔行为，以实现独特的艺术效果，或复制特定的现有画笔，以实现向后兼容性。

从序列化格式加载自定义 BrushFamily。所需格式为 BrushFamily 协议缓冲区的 gzip 压缩二进制编码。这样，您现在就可以加载和使用自定义画笔文件。反序列化后，自定义 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)
        }
        return loadedBrushes
    }
}

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

הקודם
בחירת המודול
הבא
ציור קו