צבעים בהתאמה אישית

ב-Compose, אובייקט Painter משמש לייצוג של משהו שאפשר לצייר (תחליף לממשקי ה-API של Drawable שמוגדרים ב-Android) ולהשפיע על המדידה והפריסה של הרכיב הקומפוזבילי התואם שמשתמש בו . BitmapPainter מקבל ImageBitmap שיכול לצייר Bitmap במסך.

ברוב המקרים, הפונקציה painterResource() מחזירה את ה-painter הנכון לנכס (כמו BitmapPainter או VectorPainter). למידע נוסף על ההבדלים בין השניים, קראו את הקטע ImageBitmap לעומת ImageVector.

Painter שונה מ-DrawModifier, שמצייר אך ורק בתוך הגבולות שניתנו לו, ואין לו השפעה על המדידה או על הפריסה של ה-composable.

כדי ליצור צייר בהתאמה אישית, מרחיבים את המחלקה Painter ומטמיעים את השיטה onDraw, שמאפשרת גישה ל-DrawScope כדי לצייר גרפיקה בהתאמה אישית. אפשר גם לקבוע ידנית את intrinsicSize, שישפיע על הפונקציה הקומפוזבילית שבה הוא נמצא:

class OverlayImagePainter constructor(
    private val image: ImageBitmap,
    private val imageOverlay: ImageBitmap,
    private val srcOffset: IntOffset = IntOffset.Zero,
    private val srcSize: IntSize = IntSize(image.width, image.height),
    private val overlaySize: IntSize = IntSize(imageOverlay.width, imageOverlay.height)
) : Painter() {

    private val size: IntSize = validateSize(srcOffset, srcSize)
    override fun DrawScope.onDraw() {
        // draw the first image without any blend mode
        drawImage(
            image,
            srcOffset,
            srcSize,
            dstSize = IntSize(
                [e-mail](),
                [e-mail]()
            )
        )
        // draw the second image with an Overlay blend mode to blend the two together
        drawImage(
            imageOverlay,
            srcOffset,
            overlaySize,
            dstSize = IntSize(
                [e-mail](),
                [e-mail]()
            ),
            blendMode = BlendMode.Overlay
        )
    }

    /**
     * Return the dimension of the underlying [ImageBitmap] as it's intrinsic width and height
     */
    override val intrinsicSize: Size get() = size.toSize()

    private fun validateSize(srcOffset: IntOffset, srcSize: IntSize): IntSize {
        require(
            srcOffset.x >= 0 &&
                srcOffset.y >= 0 &&
                srcSize.width >= 0 &&
                srcSize.height >= 0 &&
                srcSize.width <= image.width &&
                srcSize.height <= image.height
        )
        return srcSize
    }
}
CustomPainterSnippets.kt

עכשיו, כשיש לנו את Painter המותאם אישית, אנחנו יכולים להוסיף שכבת-על של כל תמונה מעל תמונת המקור, באופן הבא:

val rainbowImage = ImageBitmap.imageResource(id = R.drawable.rainbow)
val dogImage = ImageBitmap.imageResource(id = R.drawable.dog)
val customPainter = remember {
    OverlayImagePainter(dogImage, rainbowImage)
}
Image(
    painter = customPainter,
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Crop,
    modifier = Modifier.wrapContentSize()
)
CustomPainterSnippets.kt

בתמונה הבאה מוצג הפלט של שילוב שתי התמונות עם צייר מותאם אישית:

איור 1: Custom Painter שמוסיף שתי תמונות זו על גבי זו

אפשר גם להשתמש ב-custom painter עם Modifier.paint(customPainter) כדי לצייר את התוכן ב-composable, באופן הבא:

val rainbowImage = ImageBitmap.imageResource(id = R.drawable.rainbow)
val dogImage = ImageBitmap.imageResource(id = R.drawable.dog)
val customPainter = remember {
    OverlayImagePainter(dogImage, rainbowImage)
}
Box(
    modifier =
    Modifier.background(color = Color.Gray)
        .padding(30.dp)
        .background(color = Color.Yellow)
        .paint(customPainter)
) { /** intentionally empty **/ }
CustomPainterSnippets.kt

הערה: אפשר גם להטמיע את ה-Painter המותאם אישית הקודם באמצעות DrawModifier. אם אתם צריכים להשפיע על המדידה או על הפריסה, כדאי להשתמש ב-Painter. אם אתם מצפים לעיבוד רק בגבולות שניתנו לכם, כדאי להשתמש ב-DrawModifier במקום זאת.