When to use it
Use for product imagery that needs shared fitting, aspect ratio, radius, and labeling. Keep decoding, caching, network policy, placeholders, retries, and optimizer behavior in the application or platform loader.
Data displayAndroid
Image
Present native images with shared fit, ratio, radius, and accessibility behavior.
Native example
Use Image
Use for product imagery that needs shared fitting, aspect ratio, radius, and labeling. Keep decoding, caching, network policy, placeholders, retries, and optimizer behavior in the application or platform loader.
LumenImage(
painter = painterResource(R.drawable.mountain_valley),
label = "Mountain valley at sunrise",
aspectRatio = 16f / 9f,
fit = LumenImageFit.Cover
)Reference
Public API
The primary shared and platform-specific options exposed by LumenImage.
| API | Values or type | Default | Description |
|---|---|---|---|
| painter | Native image source or content | Required | Supplies image pixels through the platform-native delivery path. |
| fit | Contain · Cover | cover | Controls how the image fits its available bounds. |
| aspectRatio | Float? | null | Reserves a positive finite width-to-height ratio when provided. |
| radius | None · Sm · Md · Lg · Full | lg | Clips the image with a shared semantic corner radius. |
| label | String? | null | Names meaningful imagery; omit only for decorative images. |
Native behavior
Design and accessibility
Accessibility
Images are decorative when their label is absent; a label exposes the complete image as one native accessibility element.
Shared component