Once a theme is open in the NUMBOS Theme Builder, the primary control surface is the top menu. This menu governs saving, file access, editor layout, and window visibility.
Options Menu #
The Options menu controls theme state, file access, and editor layout.
Save #
- Shortcut:
Ctrl + S - Saves the currently open theme, including layout, layers, effects, and metadata.
Reset #
- Shortcut:
Ctrl + R - Restores the current theme to its default state.
- This affects the theme itself, not the editor interface.
Reset Layout #
- Resets the Theme Builder window layout.
- This restores the default arrangement of editor windows (panels, docks, and tool areas).
- Theme data remains unchanged.
Open Directory #
- Opens the directory where the current theme resides.
- This exposes all files associated with the theme, including:
- Theme data JSON
- Info file
- Screenshots
- Any additional supporting files
Open Info File #
- Opens the theme’s info JSON file.
- This file contains:
- Theme name
- Description
- Author
- Version
- UUID
- Timestamp
Open Data File #
- Opens the theme data JSON.
- This file defines how the theme is constructed, including layers, visuals, effects, and layout rules.
Windows Menu #
The Windows menu controls which editor panels are visible. Each window can be toggled on or off independently.
Available windows:
- Layers
- Global Effects
- Layer
- Layer Effects
- Fonts
- NumBlocks
- Sounds
- Box Template
- Info Window
Each window serves a distinct role in theme construction and will be covered in detail in later sections.
Canvas Menu #
The Canvas menu controls the physical workspace for the theme.
Clicking Canvas reveals:
- Canvas Width
Sets the horizontal resolution of the theme canvas. - Canvas Height
Sets the vertical resolution of the theme canvas. - Canvas Color (RGBA)
Defines the background color of the canvas using:- Red
- Green
- Blue
- Alpha (transparency)
- Frame Color
Sets the color of the visible canvas frame inside the editor.
Canvas settings define the foundational coordinate space used by all layers, visuals, and boxes.
Grid Menu #
The Grid menu controls alignment and snapping behavior inside the editor.
Available options:
- Enable Grid
Checkbox to turn the grid on or off. - Grid Size
Slider that sets both the width and height of grid cells.- Default value: 32 pixels
- Grid Color (RGBA)
Controls the grid’s color and transparency using RGBA values.
The grid is a visual aid only and does not affect rendering unless snapping is used.
Camera Menu #
The Camera menu controls how the canvas is viewed inside the Theme Builder.
Clicking Camera reveals:
- Camera Position
Displays the current X and Y coordinates of the camera.- Default position: 1248, 704
- Zoom Level
Displays the current zoom factor.- Default zoom: 0.5 for a 3840 × 2160 canvas
- Reset Camera
Restores the camera to its default position and zoom. - Fit Canvas
Automatically adjusts the camera so the entire canvas fits within the editor view.
Camera settings affect only the editor view and do not change the theme itself.
View Menu #
The View menu provides visual debugging and preview controls.
Available toggles:
- Show Bounding Boxes
Displays bounding boxes for each layer. - Show Visual Shapes
Toggles the visibility of visual shape outlines.
These options help validate alignment, spacing, and layer boundaries during theme construction.
Play and Exit Controls #
At the end of the top menu are two global actions:
Play #
- Runs the currently loaded theme directly inside NUMBOS.
- This allows testing without leaving the Theme Builder.
Exit #
- Returns you to the Theme Browser.
- If unsaved changes exist, you will be prompted to save before exiting.
This completes the top-level editor controls and establishes the spatial and visual context before working with layers, effects, and assets.
