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

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

מיומנויות ב-Android

הצגת הקוד ב-GitHub

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

אפשר להשתמש ink-custom-brush-builder במיומנות Android כדי לעצב סגנונות BrushFamily בהתאמה אישית ב-Jetpack Compose עם טיפים בהתאמה אישית, התנהגויות דינמיות, טקסטורות ושכבות.

כדי להתקין את המיומנות מ-Android CLI, מריצים את הפקודה:

android skills add ink-custom-brush-builder

יצירת מברשת

כדי ליצור מברשת, משתמשים ב-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
)
InkApiBrushApis.kt

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

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

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

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

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

ב-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
)
InkApiBrushApis.kt