The Export Dialog

One screen handles every export Novaboard can write. This page walks the dialog row by row, then lists the options each format adds on top.

Getting There

  • File → Export… ( Ctrl+Shift+Alt+Sor Ctrl+Shift+Alt+E ) opens the dialog with the file's saved exports. A file you have never exported opens on a PNG export
  • File → Repeat Last Export ( Ctrl+Alt+E ) runs the last export again without opening anything: the one export you ran, or the whole group if you ran several together. Editing an export takes it out of the group. The item stays greyed out until you have exported once
  • File → Export Timelapse… opens the same dialog on the Timelapse card. Also unbound by default, also in the command palette

How It Is Laid Out

The list of exports on the left, the filename and a live preview in the middle, a stack of collapsible rows on the right. The first row, What, is a grid of nine cards: Project, Image, Animation, Timelapse, Model, Sprite stack, Palette, Crafts and Engine. Picking a card opens the rows that apply to it (Format, Output, Area, Frames, Layers, Files, Effects, and whichever of Animation, Spritesheet, History, Model, Views, Pattern and Engine it needs) and hides the rest.

The export dialog with the Image card picked: the export list on the left, the filename above a preview of the art, and the What, Format and Output rows on the right, with Copy to clipboard and Download in the footer
An Image export: the list on the left, the filename and the preview in the middle, the rows on the right.
  • Several exports at once: Add export, under the list, adds an entry; each entry keeps its own card, format, options and filename, and can be duplicated or removed. Download all (Export all in the desktop app) next to it runs every entry; on the web several files come down as one zip named after the board. Ctrl/Cmd-click or Shift-click rows and the same button runs just those. The line above it counts what it will run, such as 3 configs · 9 files, and with rows picked it counts only those. The button at the bottom right runs the entry you are editing on its own
  • Split: fan one export out into one file per tag, per layer, or per slice
  • Per-export layer effects: the Effects row gives every export its own effect stack, applied only at export time. Ship a Bit Crusher GIF without touching the source file
  • Live preview: the stage plays animations, zooms (1:1 or fit, or double-click the zoom to type one), and compares before and after for lossy formats. Its badge shows the size in pixels, an estimate of the file size and how many files the entry writes
  • Filename first: the filename field above the preview shows the exact name and extension you will get for the entry you are editing, with token values in yellow. Click it to edit the name as typed, tokens highlighted. The dialog refuses to export while two exports would write the same name
  • Saved per file: exports are stored with the file and restored next time you open the dialog
  • Destination: in the desktop app, the folder button next to the filename picks where the file goes before you export; left alone it reads Choose on export and asks when you run it. Export all writes into a folder instead, shown above the Export all button; click it to change the folder. After an export, Reveal in folder opens the folder
  • Copy to clipboard: for a PNG, JPEG or WebP export that produces a single image, this button puts the picture on the system clipboard instead of saving a file
  • Cancel mid-export: the Cancel button under the progress bar stops an export that is encoding, and closing the dialog (Escape or the X) cancels it too
  • Stays open: the dialog stays open after an export, with a checkmark on the button, so you can send the next one

The Rows

Output

The Output row shapes the file every export writes:

  • Scale - Integer multiplier from 1x to 16x, with 1, 2, 4 and 8 one click away
  • Repeat (tiles) - Image card only. Columns × rows copies of the art side by side, up to 32 each way, to check that a tile's edges meet
  • Margin - Border around the art, in output pixels, added after scaling
  • Canvas - Native size, a preset (Instagram square, Instagram story, X post, Link preview, itch.io cover, Steam capsule) or Custom size, up to 8192 px each way. With a preset, Auto picks the largest integer scale that fits
  • Fit / Fill - With a preset or custom size: Fit the art inside the canvas, or Fill it and crop the edges
  • Background - Transparent, White, Black or Custom colour. Image exports set it here, and so do timelapses. Animations set theirs in the Animation row. Formats without alpha (JPEG, BMP and the like) always fill it

Under the scale, the row reads out the art size and the size of the file. A file too large to export is flagged there before you try. Margin, Canvas and Fit are left out where they cannot apply: sprite sheets, engine exports, models and sprite stacks size themselves.

Area

The Area row picks which part of the canvas is exported:

  • Canvas - The whole thing, at its full size
  • Area - A rectangle you type: X, Y, width and height in canvas pixels. Picking it starts from the selection you have on the board, or the whole canvas when there is none, and the rectangle is stored with the export, so it keeps the same area after you deselect. Use current selection copies the selection you have now into the fields. A rectangle that reaches past the canvas is cut down to what the canvas has
  • Slice - One named slice, chosen from a dropdown. With two or more slices on the file, a button splits the export into one file per slice
  • Preview crop - Only offered once the area is a rectangle or a slice. On, the preview shows just what will be exported. Off, the preview keeps the whole canvas and draws the export area as a rect on top of it, which is the better way to check that the crop sits where you think it does

Frames

On the cards that write a single picture (Image, Palette and Crafts), the Frames row is one frame number. It follows the playhead until you change it; after that it stays on the frame you picked, and Follow playhead lets it go again.

For an export that can hold more than one frame, the Frames row decides which ones go in. It reports the resulting frame count underneath, and every frame number counts from 1, like the timeline.

  • Current frame - Just the frame you are on
  • All frames - The whole timeline; the label carries the count
  • Frame range - A From and To pair
  • Specific frames - A comma-separated list such as 1, 3, 5. Numbers that are not frames of the file are named under the field
  • By tag - Pick any number of animation tags from a dropdown. Only shown on files that have tags
  • Cells - Animation card only. Cuts the Area into a Columns × Rows grid and plays each cell as one frame, so a one-frame sprite sheet can still become a GIF. Take all the cells, one row, or one column. The row shows the cell size and warns when the area does not divide evenly

With two or more tags picked, a Split into one export per tag button appears. It turns the single export into one export per tag, each with its own filename, instead of one file holding every tag's frames.

Layers

Which layers get composited into the export:

  • Visible - Whatever is visible right now. The default
  • All - Everything, hidden layers included
  • Choose - Hand-pick them. The layer list below has an eye on every row; clicking one drops or restores that layer. Clicking an eye while on Visible or All switches you to Choose with the current set carried over, so "visible minus one" is a single click

With two or more layers included, a Split into one export per layer button fans the export out, one file per layer.

Files

Where the Layers row picks what goes in, the Files row decides whether it all lands in one file. It shows on the Image and Sprite stack cards, and on the Animation card with only the per-slice option.

  • Export frames separately - Image card only. One file per frame
  • Export layers separately - Off by default. On, you get one file per layer instead of one composited image (on a sprite stack, one PNG per slice). With both on, one file per frame per layer
  • Include hidden layers - Image card only. Adds the hidden ones to the per-layer output
  • Output - Individual Files, or a ZIP Bundle holding them all
  • One file per slice - Image and Animation cards. The export is written once for every slice, each file cut from its own slice. A name filter such as monster_* keeps only the matching slices (* is any run of characters, ? one character, empty means every slice). It replaces the frame and layer splits

A readout under the options lists the filenames you are about to get, up to a handful, then "+n more". Layer names are sanitized into the filename, so odd characters become underscores.

Asset Packs: Folders and Slice Names

A filename can hold folders: sprites/hero lands as hero.png inside a sprites folder. On the web the folders live inside the zip; in the desktop app Export all writes into a folder you pick once per file, creates the folders under it, and asks before replacing files that are already there. Tick Don't ask again in that question to stop it; Preferences ▸ Ask before replacing exported files turns it back on. A single download on the web keeps only the file name.

Three tokens fill in the slice an export is cut from:

  • {slice_name} - The slice's name
  • {slice_index} - Its position among the slices the export writes, from 1
  • {slice_index:2} - The same number padded with zeros to at least 2 digits (01, 02, ... 110)

More tokens name what else an export is split by:

  • {tag} - The tag, when Frames picks exactly one (as each part of a split per tag does). With Export frames separately, each frame's file takes the first tag the frame lies in
  • {layer} - The layer, when Layers picks exactly one, or each layer's file with One file per layer
  • {frame} - The frame number from 1, padded to at least 2 digits (more on a long timeline): the frame an Image shows, or each frame's file with Export frames separately. {frame:3} pads to at least 3

So anims/{tag}/{frame:2} with Export frames separately writes anims/idle/01.png, anims/idle/02.png, anims/jump/03.png and so on. A token with nothing to fill it, such as {tag} on a frame in no tag, stays in the name as typed.

A filename with a token gets no automatic _2x or _spritesheet suffix, only the extension, and a multi-file zip is named after the file. Out of focus, the filename field shows the path you will get. Any other word in braces is written as typed, shown in red, with a warning under the filename. To write a brace itself, double it: {{frame}} writes {frame}.

An example: a 480×704 sheet holds 110 monsters in a 10 × 11 grid, each monster a 48×64 block of 3 × 4 walking frames (one row per direction). Image ▸ Split Image in Slices mode, 10 columns, 11 rows and the name monster_{index:2} turns the grid into 110 slices named monster_01 to monster_110. Six exports then write the whole pack:

  • An Image PNG of the canvas named ALL MONSTERS/spr_mini_monsters_spritesheet
  • An Image PNG with One file per slice named Monster_{slice_index:2}/monster_{slice_index:2}_sheet
  • Four Animation GIFs with One file per slice and Frames set to Cells 3 × 4, taking row 1, 2, 3 and 4, Ping-pong at 3.33 fps, named Monster_{slice_index:2}/monster_{slice_index:2}_walking_down and so on

One Export all writes 551 files: the big sheet, and per monster a folder with its sheet and four four-frame walking GIFs. After an edit to the big sheet, the next Export all refreshes every one of them. A single export with One file per slice also downloads as one zip on the web, and in the desktop app any single export that writes several files goes into a folder.

Per-Format Options

Image formats

  • Quality - JPEG, WebP, AVIF and JPEG XL, 1 to 100
  • ICO - Icon Sizes: tick any of 16, 24, 32, 48, 64, 128 and 256 px. 32 px is on by default, and the file always holds at least one size
  • CUR - The sizes from 16 to 64 px, plus a Hotspot (the click point) in canvas pixels, rescaled for each size

Project (.nova)

The same options appear in the Save dialog, but each keeps its own settings.

  • Include edit history - On by default. Writes the file's history into the export so it can be scrubbed after reopening. Turn it off for a smaller hand-off copy
  • Include replay anchors - Nested under the history option and on by default. Anchors make history scrubbing fast on reopen. Turning them off makes a smaller file; they get rebuilt as needed
  • Include reference images - Only offered when the file has images in the reference viewer. On by default
  • Bundle referenced files - Only offered when the file actually has external objects. It pulls the referenced files into the export so it opens anywhere on its own
  • Embed imported fonts - Only offered when text uses a font you imported. On by default, so the text stays editable on another machine; the row says how much the fonts add to the file

Aseprite, Photoshop and OpenRaster

  • Bake layer effects into the pixels - On by default. These formats cannot carry Novaboard's layer effects, so the effects are drawn into the layer pixels. Off writes the raw cel pixels. Notes under the format name any group, adjustment layer, external object or tracing layer that comes out different from the canvas
  • Export Mode - Photoshop only: Current Frame, Frames as Groups or Layer Spritesheets (see Import & Export)
  • One file per frame - OpenRaster only, on animated files. OpenRaster has no animation, so it writes one frame (Frame to export) or one file per frame

MP4

  • Background: solid color or checkerboard, with its square size and two colors (H.264 has no alpha, so transparent pixels are flattened onto the chosen background)
  • Quality: 1 to 100, higher is better; it sets the encoder's bitrate
  • Export area: set in the Area row: whole canvas, a typed rectangle, or a slice
  • Streaming-friendly: the file's index is written at the start, so playback begins before the full download completes

MP4 export uses the browser's native H.264 encoder (WebCodecs). Browsers without H.264 encoding support show an error pointing you at WebM export instead. Frame timestamps match your project's framerate exactly.

WebM

  • VP9 with VP8 fallback: uses VP9 when the browser supports it; otherwise falls back to VP8
  • Background: solid color or checkerboard; transparent pixels are flattened onto the chosen background (alpha is not preserved)
  • Quality: 1 to 100, higher is better; it sets the encoder's bitrate
  • Export area: set in the Area row: whole canvas, a typed rectangle, or a slice
  • Frame-accurate timing: explicit per-frame timestamps match your project's FPS exactly. The MediaRecorder fallback below records in real time, so its timing can drift

WebM export uses the browser's native VP9/VP8 encoder (WebCodecs) where available, and falls back to MediaRecorder for browsers that lack WebCodecs support.

GIF

Frame rate, direction (forward, reverse, ping-pong) and background live in the Animation row and apply to every animated export. The rest are GIF's own:

  • Quality - 1-30 setting, higher is better (controls how many colors the encoder keeps)
  • Palette - One palette per frame, or one shared palette for the whole file
  • Dither - None, Floyd-Steinberg, Atkinson or Ordered
  • Repeat - Loop count (0 = loop forever, or a specific number of plays)
  • Normalize frame timing - When on, re-times frames against a base FPS for consistent playback
  • Base FPS - Used only when normalize timing is on, and starts at the export's FPS. Otherwise each frame keeps its own duration: unchanged frames follow the Animation row's frame rate, pinned frames keep their milliseconds

Before writing, GIF export names any frame shorter than 20 ms, since most players slow those down.

GIF stores frame delays in steps of 10 ms, so the row tells you the frame rate the file will really play at when it differs from the one you typed. GIF transparency is on or off: a partly transparent pixel is written solid.

APNG

  • Full transparency - Unlike GIF, APNG supports full 8-bit alpha
  • Repeat - Loop count, same as GIF
  • Timing - Each frame's own delay; unchanged frames follow the Animation row's frame rate

Sprite Sheet

  • Layout - Horizontal strip (single row), vertical strip (single column), or a grid
  • Columns - Grid layout only, 1 to 32; the rows follow from the frame count
  • Padding - Spacing between cells, 0 to 64 px
  • Split by tag - One sheet with a row or column per animation tag. It needs By tag picked in the Frames row
  • Orientation - When splitting by tag, lay each tag out as a row or as a column
  • Include JSON metadata - A sidecar JSON file with frame rects and tag info
  • Background - Sprite sheets have their own background choice, kept apart from the one animations use
  • Rows - Only on a Model or Sprite stack sheet with more than one view. Layout above pours views and frames into the layout in order; Row per view instead gives each direction its own row and runs the timeline along the columns, which is the shape most engines expect from a directional walk sheet

The output image format is chosen in the Format row: pick PNG, JPEG, WebP or BMP Sprite Sheet under the Animation card.

SVG

Each pixel becomes a <rect> element, grouped by color to keep the file small. The result scales to any size without blur, which suits web graphics, icons and print.

Netpbm

Export to portable bitmap formats (PBM, PGM, PPM, PAM):

  • Format choice - PBM (1-bit), PGM (grayscale), PPM (color), PAM (with alpha)
  • ASCII or Binary - Human-readable or compact encoding
  • Bit depth - 8-bit or 16-bit output, on everything except PBM
  • Luminance Threshold - PBM only, 0 to 255, 128 by default. It is the brightness cut that decides which pixels come out black and which come out white. Raise it to keep more detail in the highlights, lower it to keep more in the shadows
  • Dithering - PBM only: None, Floyd-Steinberg or Ordered

GraphicsGale

  • Color Depth - 24bpp RGB or 8bpp Indexed. Pick 8bpp when the receiving project expects an indexed .gal; 24bpp keeps every color the file has

Palette

The Palette card exports the file's palette rather than its pixels.

  • Only colours used on the canvas - Skips palette entries the art never actually paints with. The Format row also reports how many colours the export writes
  • Swatch size - PNG Strip only, 1 to 64 px per swatch
  • Columns - PNG Strip only, 0 to 64. 0 puts every swatch on a single row

Timelapse

The Timelapse card replays your edit history. The result is a GIF, a WebM or MP4 video, a sprite sheet, or a new file with one frame per sample. The History row decides what gets sampled:

  • Commit Range - A First commit and a Last commit handle on one slider, or Select All for the whole history. The row counts the commits in range
  • Sampling - All commits, every N commits, every N seconds, or a fixed number of frames. A readout shows how many frames you will get from how many commits
  • Extend last frame - Linger on the finished art, 1 to 60 seconds (2 by default). Not offered on the sprite sheet
  • End card - GIF, WebM and MP4 only, on by default. Ends on a short "made with novaboard.app" card
  • Preview frame - Places the finished drawing as the first frame, so GIF and video previews (which show the first frame) present the final art

The frame rate lives in the Animation row. The background of a GIF, WebM, MP4 or sprite sheet timelapse is chosen in the Output row. New File writes no file at all: it opens a new file in the workspace with one frame per sample.

Model and Sprite Stack

Two cards render your layers as a 3D-ish object. Model projects them as voxels, Sprite stack stacks them the rotsprite way. Both share the Views row, and Model can write a MagicaVoxel .vox file instead of rendering anything.

  • Views - 1, 4, 8, 16, 24, or a custom count up to 72. The row reports the degrees between views
  • Start angle - Where the rotation begins, 0 to 359 degrees
  • Spin - Clockwise or counter-clockwise
  • Timeline while spinning - Play the animation along the rotation, or loop the whole animation once per view (the usual 8-direction walk sheet)
  • Use preview camera - Copy angle, pitch, spacing and lighting from the Preview panel
  • Package as - New file, GIF, Sprite sheet, or PNG sequence
  • Model only - Orthographic or Perspective camera, Pitch from -89 to 89 degrees, Enable lighting, and a Frame size of Fit every view, Board size, or Custom pixels (up to 2048, before the Output scale)
  • Sprite stack only - Layer Spacing 0 to 20 (1 is the flat three-quarter look), plus a Margin of 0 to 32 px that keeps the frame the same size at every angle. Export layers separately in the Files row writes one PNG per slice instead of a spin

The .vox Option

Switching the Model card's format from Rendered views to .vox file writes a MagicaVoxel model instead of images: one voxel per opaque pixel, one Z slice per layer, and the file's palette as colors. Rendering options fall away, since nothing is being rendered.

  • Frames - Current Frame or All Frames
  • Voxel readout - Sits above the options and shows the canvas size, how many layers become slices, and the resulting voxel count in thousands. Past roughly 20k voxels it warns that rendering every view will take a while
  • Size limit - Files larger than 256×256 cannot be voxelised at all, and the row says so instead of offering the option

Only visible raster layers count as slices. Draft layers, reference layers and adjustment layers are skipped.

Crafts Pattern

The Crafts card turns the art into a cross-stitch chart or a bead pattern, one stitch or bead per pixel. The Pattern row holds its settings. See Import & Export for the color systems themselves and how colors are matched.

  • Page Size - PDF only: A4 or Letter
  • Cell size (mm) - PDF only, 1 to 20 mm. How big each printed cell comes out
  • Cell size (px) - Image output only, 4 to 64 px
  • Include color legend - Image output only. Adds the symbol-to-color key beside the chart (the PDF always carries one)
  • Threads / Beads / Blocks - Three rows over one choice of color system, so only the row that owns the current system shows a selection. Threads covers DMC, Anchor, Madeira and Cosmo; Beads covers Hama, Perler, PhotoPearls and Artkal (with an A / C / S series picker); Blocks is Artkal's building-block line
  • Fabric Count (per inch) - 6 to 32. Used to work out the finished size of a stitched piece. Bead systems ignore it and use their own physical pitch instead
  • Tint cells with color - Fill each cell with its thread or bead color behind the symbol
  • Show grid lines - Draw the chart grid
  • Trim empty border - Crop the transparent margin away before charting
  • Padding (cells) - 0 to 20 empty cells around the pattern

Under the fabric count sits a size readout: the pattern in stitches or beads, then the finished piece in inches and centimetres. A Pattern Preview button renders the chart, page by page, before you commit to the export.