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
- Choose the Screen you want above the tree.
- Click Preview at the top if the right pane is hidden.
- 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:
| Mode | Display |
|---|---|
| Normal | The original composition, retaining the selected-branch filter. |
| Spread branches | Branches of the currently open screen placed beside each other so overlapping content can be inspected. |
| X-ray | Painted 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
| Field | What it changes |
|---|---|
| Resolution | A screen-size preset, or manual entry using Custom resolution. |
| Width / Height | The entire screen's width and height, 16–8192 pixels. |
| Aspect ratio | The width-to-height ratio; Free allows separate values. |
| Pixels per mm | Conversion of game measurements in millimeters to pixels. Also affects text-size limits. |
| Background | The preview's background color. |
| Grid size | Spacing between lines of the guide grid. |
| Opacity | Overall image opacity from 0 to 1. |
| Movie frame | The animation frame number to inspect. |
| State | The object's normal, pressed, toggled, or disabled appearance. |
| Progress | Supported indicator fill from 0 to 1. |
| Page | The container page number, starting at 0. |
| Scroll X / Scroll Y | Horizontal and vertical scrolling in supported objects. |
| Text scale | The overall text-size multiplier. Use 1 for the normal scale. |
| Font language | A game font variant for the chosen language. Does not translate strings or change editor button language. |
| Switch | What it shows or enables |
|---|---|
| Show only the selected branch | Only the selected object and its contents, positioned within their parents. Clearing selection restores the whole screen. Applies immediately. |
| Show widget sprites and Movie | Object and Movie images from the configured resources. Viewing a Sprite library itself works separately. |
| Show text | Text drawing. Hiding text still leaves its space in the layout calculation. |
| Interpolate Movie keyframes | Intermediate positions and values between keyframes of supported animations. |
| Use external alpha masks | Transparency from companion __alpha files. Embedded image transparency is retained. |
| Smooth texture scaling | Smoothing when images are enlarged. Turn off to see individual pixels. |
| Apply container clipping | Cropping of contents in containers whose ClipRender property is enabled. |
| Use right-to-left layout | Supported right-to-left positioning. Does not mirror the entire screen or every image. |
| Show hidden objects | Objects hidden by their Visible property, drawn partially transparent for inspection. |
| Show object bounds | Outlines around calculated object areas. |
| Show object names | Names beside these outlines. |
| Show object sizes | Object width and height in pixels. |
| Show margins | The inner area after applying the Margins property. |
| Show grid | A guide grid using Grid size. |
| Show checkerboard background | A checker pattern that makes transparent areas visible. |
| Fill object bounds | Colored 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.