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

Model View 3D

An interactive Qt Quick 3D model viewport with orbit, zoom, lighting, fit, and status events.

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
model_view_3d "assets/engine.glb", width: 520, height: 420, interactive: true, auto_rotate: true
API

Component properties

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

sourceSource configuration for Model View 3D.property
widthWidth configuration for Model View 3D.property
heightHeight configuration for Model View 3D.property
backgroundBackground configuration for Model View 3D.property
rotation_xRotation x configuration for Model View 3D.property
rotation_yRotation y configuration for Model View 3D.property
rotation_zRotation z configuration for Model View 3D.property
zoomZoom configuration for Model View 3D.property
minimum_zoomMinimum zoom configuration for Model View 3D.property
maximum_zoomMaximum zoom configuration for Model View 3D.property
interactiveInteractive configuration for Model View 3D.property
auto_rotateAuto rotate configuration for Model View 3D.property
auto_rotate_speedAuto rotate speed configuration for Model View 3D.property
reset_revisionReset revision configuration for Model View 3D.property
field_of_viewField of view configuration for Model View 3D.property
camera_distanceCamera distance configuration for Model View 3D.property
fit_sizeFit size configuration for Model View 3D.property
model_scaleModel scale configuration for Model View 3D.property
center_xCenter x configuration for Model View 3D.property
center_yCenter y configuration for Model View 3D.property
center_zCenter z configuration for Model View 3D.property
key_light_colorKey light color configuration for Model View 3D.property
fill_light_colorFill light color configuration for Model View 3D.property
light_brightnessLight brightness configuration for Model View 3D.property
antialiasingAntialiasing configuration for Model View 3D.property
visibleVisible configuration for Model View 3D.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.

clickNative event payload
double_clickNative event payload
rotation_changeNative event payload
zoom_changeNative event payload
loadedNative event payload
errorNative event payload
statusNative event payload