ממשקי 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) {

    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
)