Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

इमेज को पसंद के मुताबिक बनाना

किसी Image कंपोज़ेबल पर मौजूद प्रॉपर्टी (जैसे, contentScale, colorFilter) इस्तेमाल करके, इमेज पसंद के मुताबिक बनाई जा सकती हैं. Image पर अलग-अलग इफ़ेक्ट लागू करने के लिए, मौजूदा मॉडिफ़ायर भी इस्तेमाल किए जा सकते हैं. मॉडिफ़ायर, Image कंपोज़ेबल पर ही नहीं, बल्कि हर कंपोज़ेबल पर इस्तेमाल किए जा सकते हैं. वहीं, contentScale और colorFilter खास तौर पर Image कंपोज़ेबल के लिए ही बनाए गए पैरामीटर हैं.

कॉन्टेंट का स्केल

किसी इमेज को काटने या उसका साइज़ बदलने का तरीका तय करने के लिए, contentScale विकल्प का इस्तेमाल करें. डिफ़ॉल्ट रूप से, अगर आपने कोई contentScale विकल्प नहीं चुना है, तो ContentScale.Fit का इस्तेमाल किया जाएगा.

यहां दिए गए उदाहरण में, Image कंपोज़ेबल को 150 डीपी साइज़ तक सीमित किया गया है और इसमें बॉर्डर भी जोड़ा गया है. इसके अलावा, Image कंपोज़ेबल का बैकग्राउंड पीले रंग पर सेट किया गया है, ताकि नीचे दी गई टेबल में अलग-अलग ContentScale विकल्प दिखाए जा सकें.

val imageModifier = Modifier
    .size(150.dp)
    .border(BorderStroke(1.dp, Color.Black))
    .background(Color.Yellow)
Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Fit,
    modifier = imageModifier
)CustomizeImageSnippets.kt

ContentScale के अलग-अलग विकल्प सेट करने पर, अलग-अलग आउटपुट मिलते हैं. यहां दी गई टेबल से, आपको सही ContentScale मोड चुनने में मदद मिलेगी:

सोर्स इमेज
`ContentScale`	नतीजा - पोर्ट्रेट इमेज:	नतीजा - लैंडस्केप इमेज:
`ContentScale.Fit`: इमेज को समान रूप से स्केल करता है और आसपेक्ट रेशियो (डिफ़ॉल्ट) बनाए रखता है. अगर इमेज का साइज़ छोटा है, तो उसे बॉक्स में फ़िट करने के लिए बड़ा कर दिया जाता है.
`ContentScale.Crop`: इमेज को बॉक्स में पूरी तरह फ़िट करने के लिए, उसके किनारे काट दिए जाते हैं और बीच का हिस्सा दिखाया जाता है.
`ContentScale.FillHeight`: इमेज की आसपेक्ट रेशियो को बदले बिना, उसे ऐसे स्केल करता है कि उसकी ऊंचाई बिलकुल बॉक्स की ऊंचाई के बराबर हो जाए.
`ContentScale.FillWidth`: इमेज की आसपेक्ट रेशियो को बदले बिना, उसे ऐसे स्केल करता है कि उसकी चौड़ाई बिलकुल बॉक्स की चौड़ाई के बराबर हो जाए.
`ContentScale.FillBounds`: इमेज को वर्टिकल और हॉरिज़ॉन्टल तौर पर असमान रूप से खींचकर, उसे बॉक्स के बराबर साइज़ का कर दिया जाता है. (ध्यान दें: अगर इमेज ऐसे बॉक्स में रखी जाती हैं जो उनके आसपेक्ट रेशियो से मेल नहीं खाते हैं, तो इमेज खराब हो जाएंगी).
`ContentScale.Inside`: इमेज को इस हिसाब से स्केल किया जाता है कि उसकी आसपेक्ट रेशियो न बदले और वह बॉक्स के अंदर भी रहे. अगर इमेज, लंबाई और चौड़ाई दोनों में बॉक्स से छोटी या उसके बराबर है, तो यह `None` की तरह काम करता है. कॉन्टेंट हमेशा तय सीमा के अंदर रहेगा. अगर इमेज बॉक्स से छोटी है, तो उसे बड़ा नहीं किया जाएगा.	सोर्स इमेज का साइज़, बॉक्स से बड़ा है: सोर्स इमेज का साइज़, बॉक्स से छोटा है:	सोर्स इमेज का साइज़, बॉक्स से बड़ा है: सोर्स इमेज का साइज़, बॉक्स से छोटा है:
`ContentScale.None`: इमेज को छोटा-बड़ा नहीं किया जाता है. अगर इमेज, बॉक्स के साइज़ से छोटी है, तो उसे बॉक्स में फ़िट करने के लिए बड़ा नहीं किया जाएगा.	सोर्स इमेज का साइज़, बॉक्स से बड़ा है: सोर्स इमेज का साइज़, बॉक्स से छोटा है:	सोर्स इमेज का साइज़, बॉक्स से बड़ा है: सोर्स इमेज का साइज़, बॉक्स से छोटा है:

किसी `Image` कंपोज़ेबल को किसी आकार में क्लिप करना

किसी इमेज को किसी शेप में फ़िट करने के लिए, पहले से मौजूद clip मॉडिफ़ायर का इस्तेमाल करें. किसी इमेज को सर्कल के आकार में काटने के लिए, Modifier.clip(CircleShape) का इस्तेमाल करें:

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Crop,
    modifier = Modifier
        .size(200.dp)
        .clip(CircleShape)
)CustomizeImageSnippets.kt

एक कुत्ते की इमेज, जिसे एक सर्कल में क्लिप किया गया है. — **पहली इमेज**. `CircleShape` की मदद से इमेज को क्लिप करना.

गोल किनारों वाली शेप के लिए, Modifier.clip(RoundedCornerShape(16.dp) का इस्तेमाल करें और किनारों को कितना गोल करना है, इसका साइज़ तय करें:

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Crop,
    modifier = Modifier
        .size(200.dp)
        .clip(RoundedCornerShape(16.dp))
)CustomizeImageSnippets.kt

एक कुत्ते की स्क्वेयर इमेज, जिसके कोने गोल हैं. — **दूसरी इमेज**. `RoundedCornerShape` की मदद से इमेज को क्लिप करना.

Shape को एक्सटेंड करके, अपनी खुद की क्लिपिंग शेप भी बनाई जा सकती है. इसके लिए, आपको क्लिप करने के लिए शेप के चारों ओर Path देना होगा:

class SquashedOval : Shape {
    override fun createOutline(
        size: Size,
        layoutDirection: LayoutDirection,
        density: Density
    ): Outline {
        val path = Path().apply {
            // We create an Oval that starts at ¼ of the width, and ends at ¾ of the width of the container.
            addOval(
                Rect(
                    left = size.width / 4f,
                    top = 0f,
                    right = size.width * 3 / 4f,
                    bottom = size.height
                )
            )
        }
        return Outline.Generic(path = path)
    }
}

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Crop,
    modifier = Modifier
        .size(200.dp)
        .clip(SquashedOval())
)CustomizeImageSnippets.kt

एक कुत्ते की स्क्वेयर इमेज, जिसे कस्टम ओवल शेप में क्लिप किया गया है. — **तीसरी इमेज**. कस्टम पाथ शेप का इस्तेमाल करके, इमेज को क्लिप करना.

किसी `Image` कंपोज़ेबल में बॉर्डर जोड़ना

इमेज के चारों ओर बॉर्डर बनाने के लिए, Modifier.border() को Modifier.clip() के साथ जोड़ना एक सामान्य कार्रवाई है:

val borderWidth = 4.dp
Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Crop,
    modifier = Modifier
        .size(150.dp)
        .border(
            BorderStroke(borderWidth, Color.Yellow),
            CircleShape
        )
        .padding(borderWidth)
        .clip(CircleShape)
)CustomizeImageSnippets.kt

एक कुत्ते की स्क्वेयर इमेज, जिसे सर्कल में काटा गया है. सर्कल के चारों ओर पीले रंग का बॉर्डर है. — **चौथी इमेज**. क्लिप की गई इमेज, जिसके चारों ओर बॉर्डर है.

ग्रेडिएंट बॉर्डर बनाने के लिए, Brush एपीआई का इस्तेमाल करके, इमेज के चारों ओर रेनबो ग्रेडिएंट बॉर्डर बनाया जा सकता है:

val rainbowColorsBrush = remember {
    Brush.sweepGradient(
        listOf(
            Color(0xFF9575CD),
            Color(0xFFBA68C8),
            Color(0xFFE57373),
            Color(0xFFFFB74D),
            Color(0xFFFFF176),
            Color(0xFFAED581),
            Color(0xFF4DD0E1),
            Color(0xFF9575CD)
        )
    )
}
val borderWidth = 4.dp
Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Crop,
    modifier = Modifier
        .size(150.dp)
        .border(
            BorderStroke(borderWidth, rainbowColorsBrush),
            CircleShape
        )
        .padding(borderWidth)
        .clip(CircleShape)
)CustomizeImageSnippets.kt

एक कुत्ते की गोल इमेज, जिसके चारों ओर रेनबो ग्रेडिएंट बॉर्डर है. — **पांचवीं इमेज**. रेनबो ग्रेडिएंट सर्कल बॉर्डर.

कस्टम आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) सेट करना

किसी इमेज का आसपेक्ट रेशियो अपनी पसंद के मुताबिक सेट करने के लिए, Modifier.aspectRatio(16f/9f) का इस्तेमाल करें. इससे किसी इमेज (या किसी भी कंपोज़ेबल) के लिए, पसंद के मुताबिक रेशियो सेट किया जा सकता है.

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    modifier = Modifier.aspectRatio(16f / 9f)
)CustomizeImageSnippets.kt

एक कुत्ते की स्क्वेयर इमेज, जिसे 16:9 आसपेक्ट रेशियो में बदला गया है. इससे इमेज की चौड़ाई बढ़ गई है और लंबाई कम हो गई है. — **छठी इमेज**. `Modifier.aspectRatio(16f/9f)` का इस्तेमाल `Image` पर किया जा रहा है.

कलर फ़िल्टर: इमेज के पिक्सल के रंग बदलना

Image कंपोज़ेबल में एक colorFilter पैरामीटर होता है. इससे आपकी इमेज के अलग-अलग पिक्सल के आउटपुट को बदला जा सकता है.

इमेज की रंगत बदलना

ColorFilter.tint(color, blendMode) का इस्तेमाल करने पर, आपके Image कंपोज़ेबल पर दिए गए रंग के साथ ब्लेंड मोड लागू होता है. ColorFilter.tint(color, blendMode), कॉन्टेंट को टिंट करने के लिए BlendMode.SrcIn का इस्तेमाल करता है. इसका मतलब है कि स्क्रीन पर इमेज दिखने वाली जगह पर, दिया गया रंग दिखाया जाता है. यह उन आइकॉन और वेक्टर के लिए मददगार है जिन्हें अलग-अलग थीम में दिखाना ज़रूरी है.

Image(
    painter = painterResource(id = R.drawable.baseline_directions_bus_24),
    contentDescription = stringResource(id = R.string.bus_content_description),
    colorFilter = ColorFilter.tint(Color.Yellow)
)CustomizeImageSnippets.kt

बस की इमेज, जिस पर पीले रंग का टिंट लागू किया गया है. — **सातवीं इमेज**. `ColorFilter.tint` को `BlendMode.SrcIn` के साथ लागू किया गया.

अन्य BlendModes से अलग-अलग इफ़ेक्ट मिलते हैं. उदाहरण के लिए, किसी इमेज पर Color.Green के साथ BlendMode.Darken सेट करने पर, यह नतीजा मिलता है:

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    colorFilter = ColorFilter.tint(Color.Green, blendMode = BlendMode.Darken)
)CustomizeImageSnippets.kt

BlendMode.Darken का इस्तेमाल करके, कुत्ते की इमेज पर हरे रंग का टिंट लगाया गया है. इससे इमेज में गहरे हरे रंग के शेड दिख रहे हैं. — **आठवीं इमेज**. `Color.Green tint` में `BlendMode.Darken` के साथ बिताए गए यादगार लम्हे.

उपलब्ध अलग-अलग ब्लेंड मोड के बारे में ज़्यादा जानने के लिए, BlendMode रेफ़रंस दस्तावेज़ देखें.

कलर मैट्रिक्स के साथ कोई `Image` फ़िल्टर लागू करना

कलर मैट्रिक्स ColorFilter विकल्प का इस्तेमाल करके, अपनी इमेज में बदलाव करें. उदाहरण के लिए, अपनी इमेज पर ब्लैक ऐंड व्हाइट फ़िल्टर लागू करने के लिए, ColorMatrix का इस्तेमाल करें और सैचुरेशन को 0f पर सेट करें.

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    colorFilter = ColorFilter.colorMatrix(ColorMatrix().apply { setToSaturation(0f) })
)CustomizeImageSnippets.kt

एक कुत्ते की इमेज, जिस पर ब्लैक ऐंड व्हाइट फ़िल्टर लागू किया गया है. इससे इमेज का सारा कलर सैचुरेशन हट गया है. — **नौवीं इमेज**. सैचुरेशन 0 (ब्लैक ऐंड व्हाइट इमेज) के साथ कलर मैट्रिक्स लागू किया गया है.

`Image` कंपोज़ेबल के कंट्रास्ट या चमक में बदलाव करना

किसी इमेज के कंट्रास्ट और चमक को बदलने के लिए, ColorMatrix का इस्तेमाल करके वैल्यू बदली जा सकती हैं:

val contrast = 2f // 0f..10f (1 should be default)
val brightness = -180f // -255f..255f (0 should be default)
val colorMatrix = floatArrayOf(
    contrast, 0f, 0f, 0f, brightness,
    0f, contrast, 0f, 0f, brightness,
    0f, 0f, contrast, 0f, brightness,
    0f, 0f, 0f, 1f, 0f
)
Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    colorFilter = ColorFilter.colorMatrix(ColorMatrix(colorMatrix))
)CustomizeImageSnippets.kt

एक कुत्ते की फ़ोटो, जिसमें चमक और कंट्रास्ट को बढ़ाया गया है. इससे फ़ोटो ज़्यादा साफ़ दिख रही है. — **10वीं इमेज**. `ColorMatrix` का इस्तेमाल करके, इमेज की चमक और कंट्रास्ट को अडजस्ट किया गया.

किसी `Image` कंपोज़ेबल के रंग उलटना

किसी इमेज के रंगों को उलटने के लिए, ColorMatrix को रंगों को उलटने के लिए सेट करें:

val colorMatrix = floatArrayOf(
    -1f, 0f, 0f, 0f, 255f,
    0f, -1f, 0f, 0f, 255f,
    0f, 0f, -1f, 0f, 255f,
    0f, 0f, 0f, 1f, 0f
)
Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    colorFilter = ColorFilter.colorMatrix(ColorMatrix(colorMatrix))
)CustomizeImageSnippets.kt

एक कुत्ते की इमेज, जिसमें रंग बदलने की सुविधा चालू है. इससे इमेज में नेगेटिव जैसा इफ़ेक्ट दिख रहा है. — **11वीं इमेज**. इमेज पर रंग उलटे गए हैं.

किसी `Image` कंपोज़ेबल को धुंधला करना

किसी इमेज को धुंधला करने के लिए, Modifier.blur() का इस्तेमाल करें. इसके लिए, radiusX और radiusY की वैल्यू दें, जो हॉरिज़ॉन्टल और वर्टिकल दिशा में ब्लर रेडियस को तय करते हैं.

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Crop,
    modifier = Modifier
        .size(150.dp)
        .blur(
            radiusX = 10.dp,
            radiusY = 10.dp,
            edgeTreatment = BlurredEdgeTreatment(RoundedCornerShape(8.dp))
        )
)CustomizeImageSnippets.kt

इमेज में एक कुत्ते पर गहरा ब्लर इफ़ेक्ट इस्तेमाल किया गया है. इससे वह धुंधला और आउट ऑफ़ फ़ोकस दिख रहा है. — **इमेज 12**. `BlurEffect` को किसी इमेज पर लागू किया गया.

Images ब्लर करते समय, BlurredEdgeTreatment.Unbounded के बजाय BlurredEdgeTreatment(Shape) का इस्तेमाल करने का सुझाव दिया जाता है. ऐसा इसलिए, क्योंकि इसका इस्तेमाल उन रेंडरिंग को धुंधला करने के लिए किया जाता है जिन्हें ओरिजनल कॉन्टेंट की सीमाओं से बाहर रेंडर किया जाना चाहिए. इमेज के मामले में, ऐसा हो सकता है कि वे बॉक्स के बाहर रेंडर न हों. वहीं, गोल कोनों वाले आयताकार को धुंधला करने के लिए, इस अंतर की ज़रूरत पड़ सकती है.

उदाहरण के लिए, अगर हम पिछली इमेज में BlurredEdgeTreatment को Unbounded पर सेट करते हैं, तो इमेज के किनारे शार्प होने के बजाय धुंधले दिखते हैं:

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description),
    contentScale = ContentScale.Crop,
    modifier = Modifier
        .size(150.dp)
        .blur(
            radiusX = 10.dp,
            radiusY = 10.dp,
            edgeTreatment = BlurredEdgeTreatment.Unbounded
        )
        .clip(RoundedCornerShape(8.dp))
)CustomizeImageSnippets.kt