Skip to content

Importing

Bring in Harmony scenes, vector files, pictures, sound and movies.

Work comes into Buhayin as Harmony scenes, vector files, pictures, layered files, sprite sheets, sound and movies. Most of it is under File then Import. Every import is one step you can take back with Undo, and what could not come across is listed so you can see it.

The Import menu

Open File and choose Import. These entries are in it:

EntryBrings in
Import image…One picture, or a layered PSD file
Import image sequence…A numbered run of pictures
Link to Images…Pictures kept as links to their files
Refresh Linked PicturesReads linked pictures again after their files change
Embed Linked PicturesStores the linked pictures inside the scene
Import sprite sheets…A sprite sheet, cut into drawings
Import sound…Sound clips
Movie as reference…A movie to draw over
Vector File…SVG, PDF and AI files as drawings
Transformations…Motion that was exported from a scene
Harmony Scene…A scene from a Harmony project
Audio Tracks…The audio tracks of an edit file

The picture entries are also in the Scene menu. You can drop picture files straight onto the stage, and sound files onto the Timeline.

Import a Harmony scene

  1. Choose File then Import then Harmony Scene….
  2. Pick the scene's .xstage file.
  3. If your current scene has been saved, the import goes into the same folder as that scene. If not, Buhayin asks which folder to import into.
  4. A progress bar shows while the import runs. You can keep working in the meantime.
  5. When it finishes, the imported scene opens in a window of its own, with a list of the first notes about what has no place in Buhayin.

A file that holds several scenes becomes one scene file for each scene. Harmony's own files are only read, never changed. Drawings and palettes come across as Buhayin drawings and palettes.

Import a vector file

Use this for artwork made elsewhere that you want as editable lines and fills.

  1. Choose File then Import then Vector File….
  2. Pick an SVG, a PDF or an AI file. An AI file has to be PDF compatible.
  3. The file lands on a new drawing layer, starting at the current frame. Each page of a PDF becomes one drawing on its own frame.
  4. The colours the file uses are added to your palette.

The file is read in the background with a progress bar when it takes a while. Anything the file held that Buhayin does not read is listed when it finishes. Nothing in the file is fetched from anywhere else.

Import pictures

One picture, or a layered file

  1. Choose File then Import then Import image….
  2. Pick a picture, or a PSD file.
  3. For a PSD, a box lists what will come in, layer by layer, before it does. Choose a Transparency setting and press Import.

Buhayin reads PNG, WebP, TIFF, OpenEXR, TGA and IFF pictures, and PSD files.

The Transparency choice says how the file's colours were made where they are clear:

  • Premultiplied with White
  • Premultiplied with Black
  • Straight
  • Clamp Colour to Alpha

If a picture looks fringed along its edges, import it again with a different choice. The Source colour space choice says which colour space the picture is in.

A numbered run of pictures

  1. Choose Import image sequence… and pick one picture of the run, or all of them.
  2. The box shows how Buhayin recognised the run: the layer name it will make and the step between numbers. Check the Transparency and Source colour space choices.
  3. Press Import. A progress bar runs with a Stop button, and the window stays usable.

Pictures that stay linked

Link to Images… keeps each picture with the scene and notes which file it came from. When you change the original file, choose Refresh Linked Pictures to read it again. Buhayin also does this once when a window opens, and says nothing if no file changed. Embed Linked Pictures stores the pictures inside the scene when you no longer need the links.

A sprite sheet

  1. Choose Import sprite sheets… and pick the sheet.
  2. In the box, set how many cells run across and down, and how many of them are drawings. The box shows the frames each one fills.
  3. Press Import. Each cell becomes a drawing.

Import a movie to draw over

Choose Movie as reference… and pick a .mov, .mp4, .m4v, .webm, .mkv or .avi file. The movie goes into the project's assets, and its sound goes onto a layer above. A movie brought in this way is a reference to draw over, and it is left out of an export.

Import sound

Choose Scene then Import sound…, or File then Import then Import sound…. Buhayin reads WAV, MP3, AAC (M4A), FLAC and Ogg files. You pick where the clips go and what they do to clips already there. Sound and lip sync has the steps.

Audio Tracks… takes the audio of an edit file in XML or AAF form. In its box you pick the file and choose Add New Tracks or Replace Tracks. If the file's frame rate is not the scene's, Buhayin asks whether to cancel, update the project or convert.

Import motion

File then Import then Transformations… reads a motion file written by File then Export Transformations…. In its box you pick the file, choose which nodes and frames to take, and choose Bake Frames or Create New Columns. Anything that could not come across is listed in a warnings box afterwards.

Import a 3D model

3D models come in from the Scene menu, not the File menu. Choose Scene then Import 3D model…. See The camera and depth.

Check what came in

After any import, play through the scene and look at the Timeline. If something looks wrong:

  1. Choose Scene then Check scene… to list problems and notes. It can fix what is fixable.
  2. Choose Scene then Check Files… to list pictures and sounds the scene names that are missing from disk.
  3. Open Window then Message Log to read what the import reported.

To turn a picture into editable lines after importing it, look for the vectorise command in the Scene menu.