zui docs v0.0.5
GitHub ↗
Drawing and interaction Native Qt

Canvas

A retained command-driven canvas for custom 2D drawing and pointer interaction.

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
canvas [{ op: :fill_rect, x: 20, y: 20, width: 180, height: 90, color: "#b7ff5a" }, { op: :text, x: 36, y: 70, text: "Native canvas", color: "#101408", size: 18 }], width: 420, height: 220, antialiasing: true
API

Component properties

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

commandsCommands configuration for Canvas.property
widthWidth configuration for Canvas.property
heightHeight configuration for Canvas.property
canvas_widthCanvas width configuration for Canvas.property
canvas_heightCanvas height configuration for Canvas.property
tile_widthTile width configuration for Canvas.property
tile_heightTile height configuration for Canvas.property
render_targetRender target configuration for Canvas.property
render_strategyRender strategy configuration for Canvas.property
antialiasingAntialiasing configuration for Canvas.property
smoothSmooth configuration for Canvas.property
backgroundBackground configuration for Canvas.property
continuousContinuous configuration for Canvas.property
fpsFps configuration for Canvas.property
visibleVisible configuration for Canvas.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.

paintNative event payload
errorNative event payload
clickNative event payload
double_clickNative event payload
pressNative event payload
releaseNative event payload
hoverNative event payload