Skip to content

General usage

Csongor Zih edited this page Jan 29, 2025 · 3 revisions

General editing functions

This app supports undo and redo, copy and paste, and you can use them with the usual shortcuts. To view and customize shortcuts, open the Keybind editor in the wtherion menu.

Most editing functionality is provided by tools, which are described in the Tools reference.

Editor layout

The editor is comprised of the canvas, which is the main area where you can draw and edit your map, the sidebar on the left side of the screen, and the toolbar between them. The sidebar can be toggled using the button at the bottom of the toolbar.

The sidebar contains the menubar at the top, followed by settings panels, which change based on context, and the Scraps panel at the bottom.

The toolbar contains all tools in wtherion, followed by global toggles and tool-specific actions.

Pan & Zoom

Use ^Ctrl + scroll to zoom and Space + drag left mouse button to pan around.

Tip

If these feel slow or sluggish, try following the advice on the Performance page.

If the keyboard focus is inside an input (for example in a settings panel), press Esc to blur, otherwise pressing Space will just input a space.

Use the View menu to reset the view to the default zoom level and position.

Scrap management

The Scraps panel is shown in the bottom of the sidebar. This panel shows all the scraps in the project, which can be reordered, deleted and renamed. A project must always have at least one scrap, so you can't delete the last one, and new projects are created with one scrap by default.

Each scrap has a visibility checkbox, which can be used to hide it from view. Note that this does not exclude it from exports or saves.

XVI editing

When you import XVI graphics into your project, a separate layer will be created for it, which will be shown along with scraps, except their names will be in italics. These layers however will not be included in any exports. If you add any objects to these layers, they will be ignored as well.

You can move, resize and rotate XVI graphics just like any other object, by using the Select tool while the layer is selected.

History panel

This panel shows all the actions you've made that have been recorded by wtherion. When you press undo, it jumps back one step to the previous entry, and pressing redo will jump forward, if there are any entries to go forward to. You can also click any of the entries in the panel to jump straight to that point in the history.

Note

Because of the way undo is implemented, not every action creates a history entry. When you make changes (for example on a settings panel) and you don't see these as an entry in the history, you should not press undo, because these changes will be lost and redo won't recover them. You should only use undo when you know what the last entry was, and you want to undo it.

Configuration

You can change the editor's settings by clicking the wtherion menu > Configuration.

Locking objects

You can lock objects to prevent them from being selected or edited. This can be done by selecting the object and using the Toggle items locked action in the toolbar. You can also unlock all selected objects with the Unlock selected action. This is particularly useful when editing areas with objects inside them, or complex sections of a map.

Import and export

Important

wtherion has some limitations you should keep in mind when importing and exporting TH2 files. These are described in the Import export limitations page.