Introduction

This section describes the user interface and how to work with documents.

Interface

Keyshape uses a toolbar and panels.

Tools - drawing and editing tools

Document Tabs - Home tab and a tab for each open document. The Home tab has shortcuts to recently opened documents and templates.

Toolbar - modify nodes, modify objects, snap and preview

Property Panel - set properties for selected objects

Log Panel - errors and warnings, such as compatibility issues or missing images and fonts

Time Controls - manage the animation time and playback

Timeline - shows keyframes for objects

Object Tree - all objects in a tree structure

Media Panel - manage bitmap images

Symbols Panel - manage symbols

Interface Tips

  • You can change values in numeric input fields by dragging with the mouse over the up and down arrows. Holding down the Shift or Option key modifies the rate of change.
  • When you move the mouse cursor over the canvas, the canvas will automatically receive focus so that keyboard shortcuts can be used.

Creating New Documents

The easiest way to create a new document is to select a template on the Home tab. You can also create a new document by choosing the File > New menu command.

Once you have created the document, you can adjust its dimensions, frame rate and title by selecting the document object in the Object Tree.

Opening Existing Documents

For quick access to earlier work, the Home tab lists recently opened documents. To open other documents, choose File > Open and select a file.

You can open Keyshape or SVG documents. Note that some SVG features, such as CSS stylesheets, masks and filters, are not supported.

If the document has linked images, you will be asked to grant permissions to access their folders. You can use Preferences to grant permanent permissions.

If the document has missing images or fonts, the Log Panel will display them. Select the log lines to see which objects are affected.

Saving Documents

You can save your work as a Keyshape document, which stores all the objects and embedded images in a single file.

By default, Keyshape documents are stored and compressed as standard zip archives. The file extension is .keyshape.

It is also possible to save uncompressed plain text Keyshape documents. Their file extension is .keyshapex. Plain text files are great for version control systems, third party tools, and manual tweaking but they are also larger. To reduce file size, avoid embedding images and converting text to paths.

Keyshape documents are based on the standard SVG file format with a few custom additions, like animations.

Managing Document Properties

You can modify the following document properties by selecting the document object in the Object Tree.

  • Document Dimensions - the width and height of the drawing area in pixels.
  • Opacity - the opacity of the entire document.
  • Background - the background color of the document. By default, the background color is transparent black. If you change the color, remember to change the alpha value to make the color visible.
  • Fps - the frame rate is only used as a guide for animations. It is not used in the final presentation when the document is viewed in a web browser. If you export the document as an animated GIF or MPEG-4, then the document frame rate can be used as the exported file's frame rate.
  • Title - the title of the document.
  • Browser Preview and Compatibility - the format to use when Preview in Browser is selected. The format is also used for browser compatibility checking.

Panning and Zooming

There are several ways to pan the canvas:

  • Drag on the canvas with the Hand tool.
  • Press down the space bar to quickly access the Hand tool and drag on the canvas.
  • Use two-finger scrolling on the trackpad.
  • Use the mouse wheel to pan the document vertically. Shift-mouse wheel pans horizontally.

There are multiple ways to zoom in and out:

  • Click with the Zoom tool to zoom in and Option-click to zoom out.
  • Select an area with the Zoom tool to zoom in to that area.
  • Option + two-finger slide to zoom in and out.
  • Pinch gestures to zoom in and out.
  • If you have a mouse with a scroll wheel, then hold down the Option key and use the mouse wheel to zoom in and out.
  • Double-click the icon of an object in the Object Tree to zoom in to that object.