QR

The QR widget encodes a string you specify into a QR code image and displays it on screen.
Use it to turn a URL, text, or any other value into a scannable code, and place a logo image at the center if you want one.

Definition and role

The QR widget encodes the string in value as a QR code and draws it as a square image. Set the background color and the size, and overlay a logo image at the center.

• Category: Contents
• Default background color: #FFFFFF (white) — the QR modules and eyes (the corner squares) are always black
• Always rendered as a square (the smaller of width and height becomes the side length)

Features

Feature	Description
QR code generation	Converts the string in value into a QR code and renders it. When the value is empty, Lucy Studio is displayed instead.
Center logo	Set an image in image to overlay a logo at the center of the code. Adjust its size with logoRatio.
Background color	Set the QR background color with color (white by default). The module and eye colors are always black.
Size (square)	Uses the smaller of width and height as the side length, so the code is always square.

How to use

1. Open the Contents category in the left widget palette.
2. Drag and drop the QR item onto the canvas.
3. In the Properties panel on the right, enter the string to encode — a URL, text, and so on — in value.
4. If you need a center logo, set it in image and adjust its size with logoRatio.
5. Adjust the background color (color) and the size (Size) as needed.

Properties

Property	Description	Default	Value / type
value	String to encode as a QR code. Falls back to Lucy Studio when empty.	Empty string	String
image	Logo image overlaid at the center of the code (optional)	None	Image
placeholder	Fallback text shown when the value is empty — not functional in the current version.	Not set	String
Size	Widget size — width and height. Falls back to the layout area or 200 when not set. The QR code uses the smaller of the two as its side length and stays square (expand to see width and height)	Not set	Number (px)
color	QR background color (the module and eye colors are always black)	#FFFFFF (white)	Color
colorBlendMode	Color blend mode — not functional in the current version.	Not set	Blend mode
fit	Image fit mode — not functional in the current version.	Not set	fill / contain / cover / fitWidth / fitHeight / none / scaleDown
alignment	Alignment — not functional in the current version.	center	Alignment
repeat	Repeat mode — not functional in the current version.	noRepeat	repeat / repeatX / repeatY / noRepeat
centerSlice	Center slice region — not functional in the current version.	Not set	Rectangular region
matchTextDirection	Match text direction — not functional in the current version.	Off (false)	True / false
gaplessPlayback	Gapless playback — not functional in the current version.	Off (false)	True / false
isAntiAlias	Anti-aliasing — not functional in the current version.	Off (false)	True / false
filterQuality	Filter quality — not functional in the current version.	low	none / low / medium / high
semanticLabel	Semantic label — not functional in the current version.	Not set	String
excludeFromSemantics	Exclude from semantics — not functional in the current version.	Off (false)	True / false
logoRatio	Center logo size as a ratio of the side length. Clamped to 0–0.5.	0.28	Number (0–0.5)

note

The image-related properties marked "not functional in the current version" in the table above (fit, repeat, alignment, filterQuality, and so on) are registered alongside the rest, but they have no effect on QR rendering.

Notes and tips

warning

When value is empty, the code automatically encodes Lucy Studio. Always enter the value you want.

tip

Adding a center logo automatically raises the error correction level to compensate for the covered area (M without a logo, Q with one). logoRatio is clamped to 0–0.5 and defaults to 0.28.

Learn more

tip

For the full set of Widget Control items (Property, Method, and Event) that script this widget, visit QR Widget Control.