Skip to content

Exporting

Write movies, picture sequences, GIFs, sprite sheets and PDFs.

Export writes your scene out as a movie, a numbered set of pictures, an animated GIF, a sprite sheet, a soundtrack or a printed page. One dialog does most of it. Everything is made on your computer and nothing is uploaded.

The Export dialog, set to an MP4 movie of frames 1 to 48, with More options folded away
The Export dialog, set to an MP4 movie of frames 1 to 48, with More options folded away

Export a movie

  1. Choose File then Export…, or press Cmd+Shift+E (Cmd+Shift+Y does the same). The blue Export button at the top right of the editor opens the same dialog.
  2. Under Targets, leave Quick export selected. It exports without saving a target.
  3. Set Format to MP4 · H.264, WebM · VP9 or MOV · ProRes.
  4. Leave Output on Movie. It is under More options, which the dialog keeps folded until you open it.
  5. Set Frames. The first choice, named for the whole scene (for example Scene 1 to 48), writes every frame. Other choices are listed below.
  6. Set Size and Quality. Colour space is under More options too.
  7. Set Save to to Movie file.
  8. Press Check Scene if you want Buhayin to look for problems first. It then reports "Scene checked" or how many problems it found.
  9. Press Export. Choose a file name and a folder. The folder starts at your Downloads folder.

The sound track is written alongside the picture. A movie made of a scene with nothing drawn is refused: the dialog says there is nothing to export.

Which movie format

FormatCarries
MP4 · H.264H.264
WebM · VP9VP9
MOV · ProResProRes, in Proxy, LT, standard, HQ and 4444

ProRes 4444 keeps transparency. For the other ProRes choices, pick the level from the codec list. Set Output to Movie and frames and Buhayin also writes the frames as a PNG sequence beside the movie.

Choose the frames

Frames offers these choices:

ChoiceWrites
The whole scene, such as Scene 1 to 48Every frame
Range, with its first and last frameThe scene's playback range, when it has one
Frame NThe frame the editor is on. The choice follows the playhead while the dialog is open
Custom framesA first and a last frame you type
Selected framesFrames you tick from a list, with Select all and Unselect all. This is for Quick export only

Nothing exports while no frame is ticked.

Choose the size and colour

Size offers the scene's full size and its shares: 3/4, 2/3, 1/2, 1/3 and 1/4. Custom adds a width and a height you type.

Colour space writes the pictures in the scene's working colour space or another you choose, and tags them with it.

Quality is Final or Draft.

Separation writes only part of the picture instead of the whole of it: Line art, Colour art or Matte. Leave it on Whole picture for a normal export.

Layers lists every layer. All layers writes them all. To export some, pick them in the list. Past eight layers a filter box appears above the list.

Burn in

Burn in puts text on each frame of the export, which is useful for reviews. You can burn in the frame number, the timecode, the scene name, the shot and panel, the dialogue, and a note of your own up to 64 letters. Each is a switch set to On or Off.

Export pictures

  1. Set Format to a sequence: PNG sequence · zip, JPEG sequence · zip, TIFF sequence · zip, EXR sequence · zip or PSD sequence · layered.
  2. Set the frames, size and colour space as above.
  3. Set the format's own fields:
FormatFields
PNG, TIFF, PSDDepth: 8 or 16 bits
PNGColour: with alpha or without
TIFFCompression: LZW or none
EXRDepth: half or full float, and a Compression choice
JPEGJPEG quality, in percent
All of themFrame number: Automatic or 1 to 6 digits, and First number, the number frame 1 takes
  1. Set Save to to Zip file to get one archive, or Folder · a file each to write a numbered file for each frame into a folder you choose.

A PSD sequence writes a layered file for each frame. For the formats that can keep transparency, a Background choice appears: Paper · white or Transparent.

Export an animated GIF

  1. Set Format to GIF · animated and Save to to GIF file.
  2. Set Colours, from 256 down to 2. Fewer colours make a smaller file.
  3. Set Colour reduction to Selective, Adaptive or Perceptual.
  4. Set Dithering to None, Diffusion, Pattern or Noise.
  5. Set Transparency to Off, or to Black shows through.
  6. Set Loop to Loop · forever or Play once.
  7. Press Export and choose a .gif file.

Buhayin remembers your GIF choices for next time.

Export a sprite sheet

A sprite sheet lays frames out as one picture with a data file that says where each one is.

  1. Set Format to Sprite sheet · PNG + JSON.
  2. Set Layout to the grid or to one of the packed layouts.
  3. Set Empty frames to Keep or Leave out, and Repeated frames to Keep or Draw once. A packed sheet can also be Trimmed.
  4. Set Largest sheet, the widest and tallest the sheet may be.
  5. Press Export.

File then Export Sprite Sheets opens the same dialog already set to a sheet of one layout.

The last format in the list, Skeleton, writes skeleton data as JSON with an image for each attachment, for game engines.

Save a target and render them all

A target is a saved set of export choices, kept with the scene. Use them when you export the same thing again and again.

  1. Set up the dialog the way you want it.
  2. Press the + beside Targets to save it as a target. A target that is already shown offers Duplicate as a new target instead.
  3. Tick a target to include it in Render All.
  4. Press Render All to export every ticked target in turn.

A target that is switched off is skipped by Render all. Only a single run of frames can be saved in a target, which is why Selected frames is for Quick export alone.

Export from a terminal

The app carries a command line tool, buhayin-cli, whose export command writes pictures, movies and sprite sheets from scene files without opening the editor, which suits exporting many scenes in one go. See the command line tool for where it is and how to run it.

Other ways to export

These are all under the File menu:

  • Quick Frames… opens the Export dialog set to Quick export at Draft quality.
  • Export Audio… opens it on the scene's sound alone, as a WAV file. You choose the sample rate, mono or stereo, and 16 bit or 8 bit.
  • Layout Image…, Layout Image from Selection… and Layout Image from Markers… write a single image of the scene, a selection or its markers. You choose the frames, the format (PNG, JPEG, TIFF or PSD), the size and whether the background is transparent.
  • Export Transformations… writes the motion of pegs and drawings to a file that Import Transformations reads back.
  • Print then Node View… prints the Node View.

The Xsheet has its own File menu, with Print… and Export PDF…, which write the Xsheet as printed pages. Hidden columns are left out.

In the storyboard window the File menu also has an Export submenu for the board: a PDF, a movie of each shot, a picture of each panel and an edit list. See Storyboarding.

If an export is refused

  • Nothing to export: the scene has nothing drawn. Draw something, or check the frames you chose.
  • Pick at least one frame: you chose Selected frames and ticked none.
  • A skeleton takes one run of frames: choose a single range.
  • Press Check Scene and fix what it lists. A missing picture or sound shows up there.