Image कंपोज़ेबल (contentScale, colorFilter) पर मौजूद प्रॉपर्टी का इस्तेमाल करके, इमेज को पसंद के मुताबिक बनाया जा सकता है. Image पर अलग-अलग इफ़ेक्ट लागू करने के लिए, मौजूदा Modifiers का भी इस्तेमाल किया जा सकता है. मॉडिफ़ायर का इस्तेमाल, किसी भी कंपोज़ेबल पर किया जा सकता है. सिर्फ़ Image कंपोज़ेबल पर नहीं. वहीं, contentScale और colorFilter, Image कंपोज़ेबल पर साफ़ तौर पर बताए गए पैरामीटर हैं.
कॉन्टेंट स्केल
इमेज को कांटने या उसके साइज़ को बदलने के लिए, contentScale विकल्प तय करें. डिफ़ॉल्ट रूप से, अगर आपने contentScale विकल्प नहीं चुना है, तो ContentScale.Fit का इस्तेमाल किया जाएगा.
यहां दिए गए उदाहरण में, इमेज कंपोज़ेबल को 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 )
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) )
गोल किनारों वाली शेप - इसके लिए, 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)) )
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()) )
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) )
अगर आपको ग्रेडिएंट बॉर्डर बनाना है, तो 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) )
कस्टम आसपेक्ट रेशियो सेट करना
किसी इमेज को पसंद के मुताबिक आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) में बदलने के लिए, Modifier.aspectRatio(16f/9f) का इस्तेमाल करें. इससे किसी इमेज (या किसी भी कंपोज़ेबल) के लिए, पसंद के मुताबिक रेशियो सेट किया जा सकता है.
Image( painter = painterResource(id = R.drawable.dog), contentDescription = stringResource(id = R.string.dog_content_description), modifier = Modifier.aspectRatio(16f / 9f) )
Modifier.aspectRatio(16f/9f) का इस्तेमाल करनाकलर फ़िल्टर - इमेज के पिक्सल के रंग बदलता है
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) )
अन्य BlendMode से अलग-अलग इफ़ेक्ट मिलते हैं. उदाहरण के लिए, किसी इमेज पर 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) )
उपलब्ध अलग-अलग ब्लेंड मोड के बारे में ज़्यादा जानने के लिए, 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) }) )
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)) )
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)) )
किसी Image कंपोज़ेबल को धुंधला करना
किसी इमेज को धुंधला करने के लिए, Modifier.blur() का इस्तेमाल करें. इसके लिए, radiusX और radiusY की वैल्यू दें. 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)) ) )
धुंधला करने Images के लिए, BlurredEdgeTreatment.Unbounded के बजाय BlurredEdgeTreatment(Shape) का इस्तेमाल करने का सुझाव दिया जाता है. ऐसा इसलिए, क्योंकि BlurredEdgeTreatment.Unbounded का इस्तेमाल उन रेंडरिंग को धुंधला करने के लिए किया जाता है जिन्हें ओरिजनल कॉन्टेंट की सीमाओं से बाहर रेंडर किया जाना चाहिए. इमेज के मामले में, ऐसा हो सकता है कि वे कॉन्टेंट की सीमाओं के बाहर रेंडर न हों. वहीं, गोल किनारों वाले रेक्टैंगल को धुंधला करने के लिए, इस अंतर की ज़रूरत पड़ सकती है.
उदाहरण के लिए, अगर हम ऊपर दी गई इमेज पर 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)) )
आपके लिए सुझाव
- ध्यान दें: JavaScript बंद होने पर लिंक टेक्स्ट दिखता है
- ग्राफ़िक्स मॉडिफ़ायर
- इमेज लोड हो रही हैं {:#loading-images}
- मटीरियल आइकॉन {:#material-icons}