Skip to content

Documentation versions

Previewing the interface ​

The preview is the image to the right of the object tree. It shows how the selected screen may look with its current properties. While editing, update it by clicking Refresh.

Show and update the image ​

  1. Choose the Screen you want above the tree.
  2. Click Preview at the top if the right pane is hidden.
  3. Click Refresh in the image pane and wait for the result.

Stop cancels the current image generation. ⛶ expands the preview; clicking it again brings back editing. Drag the line to the left of the image to resize the pane. After changing properties or resources, click Refresh again. The previous image can remain visible until the new one is ready.

Zoom in on an object or show the whole screen ​

Fit fits the image into the available space. −, +, and the percentage field beside them change zoom from 5 to 800%. Use these to inspect small objects.

With Show only the selected branch enabled in Settings, selecting a tree row shows only that object and its contents. Parent containers still determine its size and position. Clear selection above the tree restores the whole screen. This selection works on the existing image without starting a new calculation.

Inspect overlaps in the open screen ​

After a manual Refresh, the View controls above the image offer:

ModeDisplay
NormalThe original composition, retaining the selected-branch filter.
Spread branchesBranches of the currently open screen placed beside each other so overlapping content can be inspected.
X-rayPainted objects made translucent without changing their positions.

Increase Branch depth to split Spread branches into smaller groups. Ancestor paint gets a separate cell; descendants keep geometry calculated with their ancestors. You can explore visually without knowing container names or walking through the whole tree.

Hide top layers removes objects from the end of paint order. It counts painted objects, not inferred logical engine layers. Move the slider to reveal content below an occluder. Reset view restores the original composition and clears the cutoff.

Spread, X-ray and cutoff inspect the whole open screen despite tree selection. They use cached paint, do not edit BGIN and do not start another render. After document or resource changes, click Refresh again. These are inspection tools, not a simulation of game-code conditions deciding which objects are shown.

Change the resolution ​

Open Settings in the preview pane. Choose Resolution or enter Width and Height, the size of the entire screen in pixels. Aspect ratio links width and height using your chosen ratio; Free keeps them independent.

Resolution affects object positions and text size. To enlarge a small button, change zoom beside Fit rather than reducing the screen's Height.

Settings are remembered immediately. Close the dialog and click Refresh to see the changes. Reset to defaults restores the initial settings. Preview settings do not rewrite object properties in the BGIN file.

See an animation frame or button state ​

Movie is an object type that shows an image or animation from a sprite library. The ‹/› buttons in the image pane change its frame. Set an exact number in Settings → Movie frame, then click Refresh.

In the same dialog, State shows supported button states, Progress changes an indicator's fill, and Page selects a container page. These are visual simulations; they do not run game actions or play an animation continuously.

Every setting ​

Open the list of settings and what they do
FieldWhat it changes
ResolutionA screen-size preset, or manual entry using Custom resolution.
Width / HeightThe entire screen's width and height, 16–8192 pixels.
Aspect ratioThe width-to-height ratio; Free allows separate values.
Pixels per mmConversion of game measurements in millimeters to pixels. Also affects text-size limits.
BackgroundThe preview's background color.
Grid sizeSpacing between lines of the guide grid.
OpacityOverall image opacity from 0 to 1.
Movie frameThe animation frame number to inspect.
StateThe object's normal, pressed, toggled, or disabled appearance.
ProgressSupported indicator fill from 0 to 1.
PageThe container page number, starting at 0.
Scroll X / Scroll YHorizontal and vertical scrolling in supported objects.
Text scaleThe overall text-size multiplier. Use 1 for the normal scale.
Font languageA game font variant for the chosen language. Does not translate strings or change editor button language.
SwitchWhat it shows or enables
Show only the selected branchOnly the selected object and its contents, positioned within their parents. Clearing selection restores the whole screen. Applies immediately.
Show widget sprites and MovieObject and Movie images from the configured resources. Viewing a Sprite library itself works separately.
Show textText drawing. Hiding text still leaves its space in the layout calculation.
Interpolate Movie keyframesIntermediate positions and values between keyframes of supported animations.
Use external alpha masksTransparency from companion __alpha files. Embedded image transparency is retained.
Smooth texture scalingSmoothing when images are enlarged. Turn off to see individual pixels.
Apply container clippingCropping of contents in containers whose ClipRender property is enabled.
Use right-to-left layoutSupported right-to-left positioning. Does not mirror the entire screen or every image.
Show hidden objectsObjects hidden by their Visible property, drawn partially transparent for inspection.
Show object boundsOutlines around calculated object areas.
Show object namesNames beside these outlines.
Show object sizesObject width and height in pixels.
Show marginsThe inner area after applying the Margins property.
Show gridA guide grid using Grid size.
Show checkerboard backgroundA checker pattern that makes transparent areas visible.
Fill object boundsColored areas to inspect positioning. These are visual guides rather than game artwork.

If the result is unexpected ​

Click Render notes below the image to see warnings and missing resources. Also check View → Problems. After fixing an issue, click Refresh. Connect images and fonts through Resources.

The preview does not execute game code. Some properties are preserved but do not yet affect the image. Letter sizes and wrapping can differ from the game. A $STR_… string can remain literal: choosing Font language does not supply its translation. See troubleshooting for common problems.

New 5.8.0 property variants and color channels are preserved in the file, but variant selection and newer engine behavior are not reproduced yet. Evaluate binary support and preview accuracy separately.