User Guide

Overview

The canvas is the shared scene. Frames, texts, wall numbers and logos sit above the exhibition wall; the wall sits above the general background. Sizes are real-world values: frame kit and photo opening are shown in centimetres, moulding, rebate and mat margins in millimetres.

The main safety rule is simple: adding or deleting another frame or wall must not move already arranged frames and walls.

Photo upload

When one photo is loaded, it goes into an empty frame first. If the selected frame already contains a photo, BAGETKA duplicates/creates a new frame and loads the photo there. Existing photos are not overwritten silently.

When several photos are loaded, empty frames are filled first. New frames are created only when there are more photos than empty frames.

Without a wall, newly created frames are placed in a line with a 20 mm gap. On a selected wall, they are centred on the wall hanging axis and distributed evenly. If the group is wider than the wall, it remains centred and extends beyond both sides; the view is fitted so the result is visible.

Frame Format And Photo Opening

In BAGETKA, frame format means the kit size: mat board, glass and backing board. It is not the finished outer size of the framed work.

The frame rebate is always 5 mm on each side. Example: for a 300 x 400 mm kit and 20 mm moulding, the visible inner frame window is 290 x 390 mm, and the finished outer frame size is 330 x 430 mm.

The photo size shown in the footer and specification is the visible photo opening. If a fixed frame format is selected, a real photo is fitted as large as possible without cropping and without changing its proportions; the remaining area becomes mat margins.

Mat Board

Mat margins are measured from the visible inner frame window to the photo opening, not from the outer kit edge. With a 300 x 400 mm kit, 5 mm rebate and 5 mm mat margins, the visible photo opening is 280 x 380 mm.

By default, the bottom mat margin is kept slightly larger than the top margin when the photo is fitted automatically.

Multiple Frames

Use the Frames block to add one or several frames. The currently selected frame controls the left-side settings and the footer values. If several frames are selected, shared settings are applied to all selected frames.

On desktop, dragging frames shows snap guides for edges, centres and corners. Wall-based dimensions are calculated per wall: frames on one wall must not create placement dimensions on another wall.

When a horizontal row contains a compact multi-frame block, automatic spacing and vertical alignment treat that block as one unit with one outer bounding box. Manual editing inside the block is still allowed.

Exhibition Wall And Background

The Wall block adds an exhibition wall below frames and above the background. The default wall is 4 x 3 m, white, with a 1550 mm hanging axis. When walls are present, the general background is rendered slightly greyer than the walls.

Several walls can be added. + Wall adds a new default wall into free space inside the currently visible canvas area and selects it immediately. The With number checkbox is enabled by default: the new wall receives the next primary wall number. Width, height and hanging-axis height are editable fields. Wall edges can also be dragged with the mouse.

Shift + click selects several walls: if a wall is not selected it is added, and if it is already selected it is removed. With several walls selected, width, height, hanging-axis and color fields apply to all selected walls. In move mode (M), selected walls move together with their wall-owned frames, primary numbers and labels. Holding M enables temporary moving only while dragging.

+ Number adds or re-enables the selected wall primary number. A wall can have only one primary number: it can be edited, styled and hidden, but it cannot be moved to another wall or duplicated. Hide all numbers hides primary wall numbers only.

+ Text creates an additional wall label and opens the shared text editor. Additional labels can contain any text, be copied, deleted, moved to another wall or dragged outside walls to become free text on the background.

Wall photo modes repeat the background logic: colour, photo, fit, tile, stretch and tile scale. In tile mode, the scale slider changes the tile size.

Specification

The specification lists project positions, kit format, visible photo opening and finished outer frame size. The kit format is mat/glass/backing; the outer size is calculated from kit, rebate and moulding width.

When walls are used, the summary includes exhibition running metres. The note for mat margins follows the same rule as the canvas: margins are measured from the visible inner frame window.

Save And Export

Save writes the JSON project. If a JSON project is already opened or saved and the browser still has access to that file, Save writes changes back to the same file and shows a short “Changes saved” notice. New projects or browsers without file access ask for a new JSON project file.

Save as... opens a submenu: Save image..., Save project..., Batch processing..., Specification.... Export... opens Export (PNG) and Export layers (PSD).

The Save project dialog sequence is: Project (JSON), Project (JPG), Framed Works (JPG), Excel Specification (xlsx), Insurance (unavailable), Exhibition HTML (print / PDF) (unavailable).

Framed Works (JPG) exports each project work separately, cropped to the frame outline, with frame styling and without the external wall shadow. The source photo name receives the _bagetka suffix.

Excel Specification (.xlsx) can be saved separately or inside the project ZIP package. It contains the table of frames, walls and materials. Frame photos are currently not embedded in the Excel file so the workbook opens reliably in Excel and LibreOffice. Use Framed Works (JPG) or the HTML specification when image previews are needed.

Batch processing works only with one configured template frame in the project. If several frames are present, BAGETKA shows a warning with an OK button before the process starts. After a successful batch run, the modal closes and the footer shows a short completion notice with the file count.

PNG/JPG export saves the full visible canvas area between the side panels, including walls, wall numbers, wall labels, scene text, logo and dimensions. If the side panels are hidden, the full available canvas is exported. PSD uses the same visible canvas area; the wall is included in the flat visual result, not as a separate Wall layer.

Desktop Hotkeys

On macOS, use Cmd instead of Ctrl for global shortcuts. Hotkeys are disabled while typing in input fields. Zoom and pan change only the working view and are not stored in Undo / Redo.

Glossary

Frame kit format: the mat, glass and backing size. Rebate: the 5 mm overlap of the frame on each side. Inner frame window: the visible opening after rebate. Mat margin: the distance from the inner frame window to the photo opening. Exhibition wall: the wall plane that frames hang on. Primary wall number: the unique wall-bound number assigned by creation order. Wall label: an additional editable text object that can stay on a wall or become free text.