Rooms
Workspaces in T2D are called "rooms". Different animation rooms hold panels that are optimized for different workflows. Rooms can be added, removed, or changed as necessary in "Room Editing Mode".
Rooms can only be added in "Room Editing Mode" where the workspace is unlocked.
- In the room menu (top), right-click on any of the room tabs and select "New Room" (a new room will be added to the menu)
- Double click on a room name to rename the room to the name of your choice
- Left-click and drag the pane's header/title area into a floating position
- For horizontal bar panels, grab the left edge (be careful to miss the close button)
- For other panels, grab the top bar
- As you drag, line up the curser so that it overlaps the boundary of the location you would like to place it
- When a colored bar appears, release the panel pane (it should snap into position)
- Go to Panels → "Reset to Default Rooms"
- Close and restart Tahoma to see changes
Resizing a Panel
- Make sure that the workspace is locked
- Adjust the size of a panel by clicking and dragging on the dark boundary lines - either vertically or horizontally
Expanding Panels
The Viewer and ComboViewer panels can be mazimized to take up most of the program panel, while leaving the room menu visible.
- Hover over the panel and press the back quote key `
- Double-click on the panel header (top bar) of the panel
The Viewer can also enter "Full screen Mode", where the Viewer takes up the entire screen.
- To make the Viewer full screen, hover the cursor over the Viewer and use the shortcut alt-F
- To exit the Viewer from full screen, hover the cursor over the Viewer and use the shortcut alt-F
Panels
File Browser - gives you access to supported files and directories
Function Editor - gives you more specific control over the pacing of special effects and keyframes
Level Strip - displays all the drawings in the active level - not all of these drawings are necessarily exposed in the scene
Level Palette - where you add/adjust/access colors for the active level
Stage/FX Schematic - an alternate display of scene elements for parenting and path manipulation | special effects in a node format
Style Editor - Allows you to edit the color, texture, brush and etc. of the selected style
Toolbar - a vertical menu of animation editing tools that can be used in the viewer area
Tool option bar - displays the properties of the selected tool
Viewer - used to create drawings, view the selected frame, and play the animation
Combo viewer - a fusion of the viewer, horizontal toolbar, and the tool option bar in a single panel
Timeline - keeps track of drawings, keyframes, audio and pacing of the animation
Command Bar, also called the Xsheet Toolbar - gives direct access to frequently used commands
History - allows you to see your previous steps and go back to a previous step
Stop Motion Controls - take photos for stop motion animation techniques directly in Tahoma with a webcam or Canon DSLR
Clean-up settings - allows for converting scanned raster into the smart raster format
Color model - allows you to use an image (scanned, digital, or in-program) to load or copy color information to the active level
Export Panel - exports final versions of an animation without special FX or mesh modifications applied
Flip book - allows you to preview an animation with FX applied and can show a rendered animation
Message center - displays error and warning messages from Tahoma
Record audio - allows you to record and insert audio directly in program (the audio can be edited later through cutting, copying & pasting but advanced editing must be done outside of Tahoma)
Scene cast - allows you to access, save, and load scenes and levels
Studio palette - where you add/adjust/access any saved palettes
Batch servers - allows multiple renders or image cleanups to be processed
Tasks - displays tasks submitted for batch processing
The command bar can be customized to add your most used commands for easy access:
- Add a command:
- Right-click on an empty segment of the command bar
- Select "Customize Command Bar"
- In the left column, search for the command you want to add
- Drag and drop the command to the desired position in the right column
- Add separators in the same way as necessary
- Remove a command:
- In the left column, right-click on the command
- Select "Remove..."
- Select "OK" when all customization is finished
Projects
In Tahoma, a project holds all the resources for an animation or production. Projects usually have several related scenes that make up a completed story.
There is not a single project file - instead the project directory holds all of the project content. This allows you to easily access different project resources to reuse them in other projects or share them with other animators when working as part of a team.
The active scene name and the active project name, always display at the top of the Tahoma window, and in the header of the Viewer panel - ie. SceneName[Project Name].
Projects can be stored anywhere on the local computer or connected networks/drives. It is helpful to keep projects together in a single location for easy access and organization. In your computer's file browser (Finder on macOS), create a projects folder in the Documents directory - ie. Documents/Animations
The Sandbox is the default project when you open Tahoma for the first time. It is intended for experimentation, not for serious work. Since the Sandbox is stored within the Tahoma app itself, it can be accessed by other users of Tahoma on the computer. At the same time, that makes the Sandbox harder to backup then other projects.
New projects can be created when Tahoma opens, with the startup panel, or at any time through the menu (File &rrar; Project Management → New Project).
DO NOT leave the Sandbox as the active project for class assignments - it is not private and takes more steps to backup.
- Choose "New Project" in either the startup window or the menu (File → Project Management → New Project)
- Select the project location
- Give your project a name
- Press "Ok"
-
If using the startup window, give your first scene for the project a descriptive name and select "Create Scene"
- If the project was created through the menu, save the default untitled scene to give it a descriptive name (CMD+S | CTRL+S or File → Save All)
This assumes that you have installed Tahoma on your home computer. It is free and available for both macOS and Windows at Tahoma2d.org. After installing Tahoma at home, make sure your preferences are the same as what you have at school. Revisit the "Customize" section under the "Workspace" tab for recommended preferences.
- Download your most recent, zipped, active project folder from Google Drive or your thumb drive
- On macOS:
- In Finder, open your downloads folder and drag the file from Downloads folder (or your thumb drive) and drop it in a folder for your home animations folder (Documents/Animations)
- Double-click on the .zip file and the folder should uncompress/open
- On Windows:
- In Windows Explorer (the file manager not the browser), go to the downloads folder
- Select the .zip file and drag it into a folder for your home animations folder (C://Documents/Animations)
- Right-click on the .zip file → Extract All
- In Tahoma, use the startup pop-up to select your project and load the desired scene
Scenes
A scene is a discrete segment of an animation/story. It is usually an event, action, or conversation that takes place at a single time and in a single place.
New scenes can be created when Tahoma opens, with the startup panel, or at any time through the menu (File → New Scene or CMD+N | CTRL+N). New scenes will always be created in the active project.
Using the default untitled scenes can prevent auto-save from working, so unless you are just experimenting, always set a descriptive file name.
- In either the Startup panel, or when saving an untitled scene for the first time (File → Save All or CMD+S | CTRL+S)in the "Save Scene" window, choose a descriptive scene name
- Use the default size/resolution settings unless you have specific size requirements
- Leave "Frame Rate" set to the standard 24fps
- Select "Create Scene"
Scenes can be changed through:
- The Startup panel - choose a recent scene from the sidebar or choose "Open Another Scene" to select a scene from the browser
- The program menu: "File → Load Scene" to choose a scene from the browser or "File → Open Recent Scene File" to choose a recent scene
- The shortcut CMD-L | CTRL+L
Loading a scene from a different project will change the active project.
Due to the potential technology issues, you are responsible for backing up your work regularly. Technology can fail at any time so frequent backups are important to prevent loss of work. Remember it is your responsibility to always have an up-to-date backup if something goes wrong. It is recommended to back up in Google Drive, but feel free to use a thumb drive or etc. for backups if preferred.
- Zip your project folder on macOS:
- In Finder, navigate to your animation folder (Documents/Animations/ or etc.)
- Right click on the folder for your active project and select "Compress"”"
- Zip your project folder on Windows:
- In Windows Explorer, navigate to your animation folder (Documents/Animations/)
- Right click on the folder for your active project and select "Send To → Compressed(Zipped) Folder"
- In a web browser (likely Safari or Chrome), go to Google Drive and sign in
- Drag and drop the zipped project folder from Finder | Windows Explorer to a backup folder in Google Drive (you could also select "New" → file upload)

If you have backed up this project previously, you may want to use a different name for the new backup, or rename the old backup before uploading.
Levels are the resource files that combine together to make an animation. There are multiple types of levels but most often they are a single image or a sequence of images. The separate images in a level are called frames.
There are multiple ways to create new drawing levels directly in Tahoma. Creating levels with the Command Bar is often fastest.
The command bar is in the "2D" room by default, but can be added elsewhere through the panels menu.
- In the Timeline (or Xsheet), left-click an empty cell (where you want the first frame to start) - or (Timeline only) - click on the first cell of an existing level

- Left-click on the new level button for your desired level type in the Command Bar (one of the 3 leftmost buttons)
- Make changes to the New Level Pop-up as necessary (most of the defaults are fine, unless you need to change the level type):
- Make sure to name the level very specifically (ie. Fred_head_profile), so that you can identify levels easily and quickly (avoid most symbols in the level names)
- "From" and "To" refers to the range (number) of frames you would like to add to the level (this can be changed at any time)
- "Step" refers to the number of times a frame is repeated consecutively (2 is the standard for smoother animation with a better pace)
- "Increment" refers to the number of each frame (ie. a value of 1 would result in frames numbered 1, 2, 3... while a value of 2 would result in frames numbered 1, 3, 5...)
- When your settings are adjusted as desired, select "OK" - or "Apply" if you want to make another new level directly after

New levels can also be created through the context-menu when right-clicking on a cell in the Timeline or through the Levels menu at the top of the program window.
Existing files can be loaded or imported from outside of Tahoma and from other Projects/Scenes inside of Tahoma. Loading a level creates a link to the existing file. Importing a level makes a copy in the Project's Extras folder. Whether you load or import external files can be set in Preferences.
You can drag & drop into the Viewer, Timeline, and File Browser in order to load or import files into your scene. The process is the same:
- In the Timeline, right-click an empty cell (where you want the first frame to start) - or (Timeline only) right-click on the first cell of the existing layer that should display underneath the imported level

- Drag your file from it's location (in Finder, desktop or etc.) to either:
- the Viewer
- the Timeline
- The Scene Cast (bottom right of the Browser Room)
- Release your file
- If this is your first time loading a file, select "Import" or "Load"
- You can choose to always import or always load by checking "Always do this action" before making your choice

- Make any adjustments to the level location in the Timeline if necessary
Alternatively, you can use the the File Browser to select your file and choose "Load", or left-click an empty cell in the Timeline (where you want the first frame to start) and choose "Load Level", or use the command from the Level menu at the top of the program window.
Moving Levels
Levels or portions of levels can be moved in the Timeline through dragging and dropping with the dragbar. You can also use standard copy and paste commands, either through the menu or with standard shortcuts (Copy: CMD+C | CTRL+C, Cut: CMD+X | CTRL+X, Paste: CMD+V | CTRL+V, Delete: Delete ).
- In the Timeline, left-click and drag the drag bar (on the left or top edge of the column header) to a new location
- Release to drop the column into that new position
- In the Timeline, click and drag across the layer or column headers to select multiple columns
- Left-click and drag the drag bar of a selected layer/column (on the bottom or left edge of the header) to a new location
- Release to drop the column into that new position
Moving Part of a Level Without Keyframes
- In the Timeline, select the cells you would like to move (Left-click + drag)
- Click, hold and drag the drag bar (on the left edge of the cells) to a new location
- Release to drop the selected cells in that new position
Moving Part of a Level With Keyframes
- In the Timeline, select the cells you would like to move (CMD-Left-click + drag)
- Click, hold and drag the drag bar (on the left edge of the cells) to a new location
- Release to drop the selected cells in that new position
Deleting (or Unlinking) Columns/layers, Levels & Frames
Deleting resources from the Timeline or from the scene is actually unlinking instead of true deleting. The files remain available for the scene and project - even if they are not visible. To completely delete levels and frames they must be removed from the Timeline first, then the scene and lastly from the project.
Unlinking Frames
Entire Levels or just selected Frames can be unlinked from the scene.
- In the Timeline, click and drag to select the frames you want to remove
- Use the shortcut:
- Delete - to remove the frames while maintaining the existing placement of surrounding frames
- Cut (CMD+X | CTRL+X) - to remove the frames while leaving no empty space between surrounding frames
Deleting Columns/Layers
- In the Timeline either:
- Left-click on the Layer/Column Header:
- Use shortcuts:
- Delete
- Cut (CMD+X | CTRL+X)
- Right-click on the Layer/Column Header:
- Select Delete
- In the Stage Schematic:
- Left-click on the Layer/Column node
- Use shortcuts:
- Delete
- Cut (CMD+X | CTRL+X)
Once levels have been removed from the Timeline, they can be removed from the scene and from the entire project.
Removing Unwanted Levels from the Scene
-
In the Browser room, right-click in the "Scene Cast" (bottom-right)
- Click on "Remove All Unused Levels"
Deleting Levels/Files from the Project
- In the Browser room, find your unwanted level in the "File Browser" (top-right)
- Vector and Smart Raster levels will be located in the drawings folder
- Raster levels and imported files (.psd, video, audio & etc.) will be located in the extras folder
- Right-click on the unwanted level and select "Delete"
Saving Levels
Levels can be saved individually or with all of the scene data. Be careful - if only the scene data is saved, you can lose a whole session of drawing. Level save options are available in the Level menu.
Auto-save
Auto-save can save the scene and level data at the same time. If something goes wrong, auto-save can save the day.
- Turn on Auto-save in Preferences → General
- 7 minutes is often a good starting value.
Save-All Shortcut
- Use CMD+S | CTRL+S to save both the scene and the level at the same time
Converting Levels
Converting to Vector*
- In the Timeline, select the level (or frames) that you want to convert
- Click on the left edge of the frames to select the whole level
- In the top menu, go to Level → Convert to Vectors
- Adjust the conversion settings as desired
- Toggle on preview (the eye icon)
- Mode → Centerline
- If there are fills, make sure to check "Preserve Painted Areas"
- Other settings can be adjusted if necessary
- Click "Convert"
- For Raster levels drawn only with black:
- In the Timeline, select the level (or frames) that you want to convert
- Click on the left edge of the frames to select the whole level
- In the top menu, go to Level → Convert to Vectors
- Adjust the conversion settings as desired
- Toggle on preview (the eye icon)
- Mode → Centerline
- Other settings can be adjusted if necessary
- Click "Convert"
- For Raster levels that include colors:
This does not give an exact copy of the drawings but instead creates outlines around the different strokes of each drawing
- In the Xsheet, select the level (or frames) that you want to convert
- Click on the left edge of the frames to select the whole level
- In the top menu, go to Level → Convert to Vectors
- Set mode to outline
- Toggle on preview (the eye icon should be yellow)
- Adjust the conversion settings as desired
- Click "Convert"
Converting to simplified vectors sometimes makes a vector level easier to fill.
- In the Timeline, left-click + drag to select the cells in the Vector level that you want to simplify
- In the top menu, go to Level → Replace Vectors with Simplified Vectors
* Converted Vector levels are not directly compatible with the Level Strip's Inbetweener functions
Converting to Raster Formats
- In the Timeline, left-click + drag to select the cells in the Vector level that you want to convert
- In the top menu, go to Level → Vector to Smart Raster
Follow the "Cleanup" directions to convert from Raster to Smart Raster. More details coming soon.
At this point converting to Raster is possible but very time consuming. Each frame has to be converted individually.
- In the Timeline, select an individual frame from the vector or smart raster level you would like to convert
- In the viewer, use the select tool to select the entire drawing
- CMD+C | CTRL+C to copy
- In the Timeline, select the corresponding frame in the raster level
- CMD+V | CTRL+V to paste
- Repeat for as many frames as you want/need to convert
The Timeline and it's alternate view the Xsheet (short for Exposure sheet), are 2 ways of organizing/viewing the collection of resources that make up your animation. Here you can load/create files, see/adjust the order and pacing of your images/audio, add notes and more.
Switch views by right-clicking in the layer/column name or thumbnail icon and choose "Toggle Orientation", towards the bottom of the context menu.
The Timeline's horizontal orientation is based off of modern digital animation and video editing. The compact size can allow more of your resources to be seen and can be more familiar.
The Timeline exposes specific frames from your levels (individual resource files) in horizontal layers. Each layer holds at least one level, though sometimes there may be more. In the Timeline, levels span horizontally across one or more cells. The more cells a level spans across, the longer the level exists in the animation.
Drawings in a level are sometimes displayed out of order in the Timeline. A single drawing may be utilized multiple times in the layer. Sometimes certain drawings in a level may not be exposed at all in the layer or scene.
The Timeline has an additional "Zoom in" or "Zoom out" capability to either contract or expand the cells of the Timeline horizontally. At its most compact, the Timeline is able to display signifigantly more cells without the need to scroll horizontally.
Visually, the cells in a single Timeline column (from each visible layer) are combined to form a single frame. When this happens, layers on the top are visually in front of layers on the bottom. Frames/cells/columns on the left of the Timeline take place at the beginning of the animation while frames/cells/columns at the end of the Timeline take place at the end of the animation.
The Xsheet and it's vertical orientation is based on traditional animation's exposure sheets. With the Xsheet view it is often easier to visually identify resources & to reorder them.
The Xsheet exposes specific frames from your levels (those individual resource files) in vertical columns. Levels span vertically across one or more cells, instead of horizontally. The more cells a level spans across, the longer the level exists in the animation.
Drawings in a level are sometimes displayed out of order in the Xsheet. A single drawing may be utilized multiple times in the column. Sometimes certain drawings in a level may not be exposed at all in the column or scene.
Visually, the cells in a single Xsheet row (from each visible column) are combined to form a single frame. When this happens, columns on the left are visually behind columns on the right. Frames/cells/rows at the top of the Xsheet take place at the beginning of the animation while frames/cells/rows at the bottom of the Xsheet take place at the end of the animation.
In the layer header (left of the layer) or column header (top of the column), you can control visibility and editability of the layers/columns:
layers/columns can be locked/unlocked to prevent or allow further editing; they are unlocked
by default
preview and render(export) visibility is on by default
camerastand visibility (what you see in the viewer) is on by default
additional visibility settings (these will not be visible in render/preview)
- color filters can be added to visually separate your levels
- opacity adjustment
- Selecting a single layer/column
- Click on the layer/column icon or name in the header area
- Selecting multiple layers/columns:
- Left-click and drag across consecutive thumbnail icons or layer/colum names
- Cmd-click on the icons/names to select non-consecutive layers/columns
- Selecting a single cell:
- Selecting multiple cells:
- Left-click and drag across the cells
- Selecting all cells in a layer/column:
- Left-click on the left edge dragbar of a cell
Layer/column headers and individual cells have drag bars to allow for easy drag and drop positioning of the entire column/layer or of a selection of cells.
- Move the entire layer by clicking and dragging the top edge of the layer name
- Move the entire column by clicking and dragging the top bar with the column name
- Moving selected cells
- In the Timeline:
- Click and drag the top edge drag bar to reposition the cells and drop them into a new location
- In the Xsheet:
- Click and drag the left edge drag bar to reposition the cells and drop them into a new location
Command Bar
The Command Bar - also called the Xsheet Toolbar, allows you fast access to commonly used commands when the Xsheet/Timeline is active.
In most default configurations of the command bar, there are buttons to:
- add new levels
Vector Levels
Smart Raster Levels
Raster Levels
set the number of steps
repeat selected frames in a column
create sub-xsheets
enter a sub-xsheet
exit a sub-xsheet
The command bar can be customized to add your most used commands for easy access:
- Add a command:
- Right-click on an empty segment of the command bar
- Select "Customize Command Bar"
- In the left column, search for the command you want to add
- Drag and drop the command to the desired position in the right column
- Add separators in the same way as necessary
- Remove a command:
- In the left column, right-click on the command
- Select "Remove..."
- Select "OK" when all customization is finished