zui docs v0.0.5
GitHub ↗
Display, content, and media Native Qt

Image

A native raster image renderer with asynchronous loading, cache, transforms, and fill modes.

Usage

Ruby example

Paste this complete Builder example inside the app surface from the Quickstart. Replace illustrative asset paths with files from your project.

Ruby
image "assets/dashboard.png", width: 640, height: 360, fill_mode: :preserve_aspect_crop
API

Component properties

16 component-specific values, plus shared item and layout properties.

sourceSource configuration for Image.property
widthWidth configuration for Image.property
heightHeight configuration for Image.property
source_widthSource width configuration for Image.property
source_heightSource height configuration for Image.property
fill_modeFill mode configuration for Image.property
horizontal_alignmentHorizontal alignment configuration for Image.property
vertical_alignmentVertical alignment configuration for Image.property
asynchronousAsynchronous configuration for Image.property
cacheCache configuration for Image.property
smoothSmooth configuration for Image.property
mipmapMipmap configuration for Image.property
mirrorMirror configuration for Image.property
auto_transformAuto transform configuration for Image.property
retain_while_loadingRetain while loading configuration for Image.property
visibleVisible configuration for Image.property
Show 14 shared item properties
enabledopacityscalerotationzfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

Subscribe with on widget, :event and keep behavior in Ruby.

progressNative event payload
statusNative event payload
loadedNative event payload
errorNative event payload