Image

These nodes drive the interface image widget nl.image — the picture in a title screen, a save slot thumbnail, a decorative frame. They have nothing to do with stage images, character sprites, or anything a story shows during a playthrough; those are story assets, not UI widgets.

Conventions

• Self nodes only. Nothing here takes an Element input; the target is always the nl.image that owns the blueprint. The versions that act on a wired element are blueprint.element.image.* in Element, each with an element:nl.image input, and they appear only once the graph already holds a compatible binding.
• Graph kinds. The getters are pure and run in event, function, and macro graphs, including inside a Blueprint Value. The writers are latent and run in event and macro only.
• ImageAsset is a structured value, { kind: "imageAsset", assetId } — not a bare id string. The nullable form ImageAsset|null accepts null to mean no image. A plain string on one of these pins is still read as an asset id, which is how graphs saved before the type existed keep running.
• Writes rewrite the widget's imageFill (mode, assetId, cropPlacement) or its imageFlipX / imageFlipY, then queue a flush of the element. A write whose values match what is already there does nothing at all — no patch, no flush.
• An unusable input falls back to the current value. An unrecognised or empty fit mode, a non-numeric crop percentage, and an unwired boolean all leave that property as it was, rather than resetting it.
• Geometry, opacity, and variants are not here. Position, size, rotation, and opacity belong to Displayable, and a non-Default appearance variant never overrides the Default's fill mode or crop — so switching to a translucent variant cannot leave the picture stuck in crop.

Image Asset

blueprint.image.assetLiteral · Pure

The asset literal. The card shows the current thumbnail, the asset name, or a missing-asset state; clicking it opens the image asset picker.

With no image chosen the node outputs nothing, which on an ImageAsset|null input reads as clear it.

Get Image Asset

blueprint.image.getImageAsset · Pure

Set Image Asset

blueprint.image.setImageAsset · Latent

Points the widget at a different image and flushes it. The fill mode and crop rectangle are left alone.

Left unwired, the pin expands into a picture picker on the card: choosing an image writes it into the node's parameters, clearing it writes null. Wire the pin and the wired value wins.

Clear Image Asset

blueprint.image.clearImageAsset · Latent

Removes the widget's image — the same thing as Set Image Asset with null, without the pin.

Get Image Fit Mode

blueprint.image.getFitMode · Pure

Modes

Set Image Fit Mode

blueprint.image.setFitMode · Latent

Changes how the picture fills the box, keeping the current asset and crop rectangle.

Get Image Crop Rect

blueprint.image.getCropRect · Pure

Reads the crop rectangle. The four numbers are percentages of the widget's own box, not of the source image: leftPct / topPct place the picture's top-left corner inside the box, widthPct / heightPct are the size it is drawn at. So 0, 0, 100, 100 — what you get when nothing has been cropped — means fill the box exactly, and values above 100 or below 0 are how a picture larger than its box is expressed.

Set Image Crop Rect

blueprint.image.setCropRect · Latent

Get Image Flip X

blueprint.image.getFlipX · Pure

Set Image Flip X

blueprint.image.setFlipX · Latent

Mirrors the picture horizontally about its centre. Only the image content layer flips — the widget's box, border, and children are untouched.

Get Image Flip Y

blueprint.image.getFlipY · Pure

Set Image Flip Y

blueprint.image.setFlipY · Latent

Mirrors the picture vertically about its centre.

Get Visible

blueprint.image.getVisible · Pure

This is the same visibility Displayable exposes as its visible property key — one value, two ways to read it. For hiding a widget without removing it from the rendered tree, use Displayable's Set Display instead.

Set Visible

blueprint.image.setVisible · Latent

Get Enabled

blueprint.image.getEnabled · Pure

Set Enabled

blueprint.image.setEnabled · Latent

Turns interaction on the widget on or off. It maps to the underlying disable mechanism; there is no author-facing interactionDisabled property.