Importing¶

There's one way in and it handles everything: double-click empty space in the Outliner (or use the + menu / drag-and-drop). A single browse dialog opens where you can pick a folder or loose files — OVB decides what to do from what you chose.

The double-click dialog¶

Double-click → one file browser titled "Import — folder or file(s)". From there:

Pick a folder → OVB looks inside it (see the folder modes below).
Go into a folder and select image files → they import as a sequence (or a single frame).

One dialog, both jobs

You never have to choose "files mode" vs "folder mode" up front. Select a folder to import it as a drawing, or select individual .svg/.png/.jpg files inside a folder to import them as a sequence. The Choose button stays enabled for file selections.

The five import modes¶

You select…	OVB does…	Result
A folder whose subfolders are named for art layers (`Line Art`, `OL`, `Color Art`, `UL`…)	classifies each subfolder to its art layer	one drawing, each art layer filled from its subfolder
A folder that is itself one sequence	reads the images as a sequence	one art layer (name-classified, or the default)
A folder / files whose name says an art layer (`eye.CA.svg`, `line-art/…`)	routes to that art layer	that art layer, drawing named after the source
Multiple loose files (e.g. `draw_0001.svg … 0020.svg`)	treats them as one sequence	a sequence slot
A single file (one `.png` / `.svg` / `.jpg`)	one frame	a single-frame slot

Art-layer folder names¶

Subfolders and file names are matched to art layers, in any case and with any separators:

Underlay — UL, underlay
Colour Art — CA, color art, colour art
Line Art — LA, line, ink
Overlay — OL, overlay

Anything that doesn't classify lands on the default art layer (see below).

Where loose art lands by default¶

A loose sequence or single frame whose name gives no art-layer hint lands on the layer set in Preferences → Import → Default art layer (loose import) — Line Art by default.

Set your default once

If most of your imports are colour fills, change the default to Colour Art in Preferences. The feedback bar tells you which layer a guessed import landed on so you can correct it in the Inspector if needed.

How drawings are named¶

Single file → the file name, minus its extension and any trailing frame number. sketch.svg → sketch.
Sequence → the first file's name with the frame number stripped. draw_0001.svg … → draw (the common base — not draw_0001).

Art layers¶

Every drawing exposes Harmony's four art layers, top to bottom in z-order (Overlay draws on top, Underlay at the back):

Overlay → Line Art → Colour Art → Underlay

An art layer is bound once it has a sequence; empty ones stay dashes in the Outliner. You can fill, empty, move, or swap art layers from the Outliner's context menu.

Subartlayers (multi-pass)¶

A single art layer can hold more than one track — stacked subartlayers. Each track paints as a separate vector object in that one art layer, so an eye exported as two passes stays two editable objects rather than being flattened into one.

The stack reads top-down: the track at the top of the list draws on top (its vectors sit above the tracks below it).

The Subartlayers card (top of the Inspector) lists the tracks for the selected art layer.
Use the ▲ ▼ buttons to reorder, + to append another sequence as a new track, and ✕ to remove one.
On Apply, the first track of an art layer clears it (Replace mode) and later tracks append, so a re-import overwrites cleanly instead of duplicating.

Subartlayers are an OVB concept — Harmony has one layer

"Subartlayer" only exists inside OVB, as a way to organise passes before import. On Apply, every track is pasted into the same single Harmony art layer — Harmony has no such sub-division.

Nothing is flattened between tracks: each track's vectors stay separate objects on that layer, in the stacking order you set. The only flattening is within a track — if Merge split lines is on, the broken segments of that track are welded into single strokes. That merge happens inside each track, never across tracks.

Re-opening a drawing collapses the tracks into one

Because the subartlayer split lives only in OVB, it can't be read back from Harmony. When you re-open a drawing that was already imported, all of that art layer's objects come back as a single track — the individual vectors are still there and still separate, just no longer grouped into the original passes. There is no "propagation" of subartlayers on re-import: the multi-track structure is a one-way, import-time organiser, not something Harmony stores and hands back.

Reordering the objects in Harmony

Once imported, the tracks are just stacked vector objects on one art layer. Reorder them in Harmony with the drawing-desk keys — Ctrl+Page Up / Ctrl+Page Down to move a selected object one step, Ctrl+Shift+Page Up / Ctrl+Shift+Page Down to send it fully to front / back.