Files
AniCraft/docs/guide/coming-from-animate.md

13 KiB
Raw Permalink Blame History

Coming from Animate

If you already know Adobe Animate (or Flash before it), most of AniCraft will feel familiar. This chapter maps what you know to where it is in AniCraft, lists the keys that work the same, and is honest about what differs and what isn't there yet.

AniCraft is an independent, open-source project, and is not affiliated with or endorsed by Adobe.

On macOS, press ⌘ where this guide says Ctrl, and ⌥ where it says Alt.

Panels

AniCraft opens with its panels docked as in Animate's Essentials: tools on the left, the stage in the middle, Properties and the Library on the right, and the timeline at the bottom. As in Animate, you drag a panel's tab to dock it elsewhere (the timeline above the stage, for example), stack it with other panels or float it, and Window › Workspace has Essentials, Animator and Designer, plus your own saved workspaces and Reset.

In Animate In AniCraft
Tools The tools column on the left. A drawing tool's options show at the top of Properties while it is active.
Timeline The timeline at the bottom (Window › Timeline).
Properties Properties on the right (Window › Properties).
Library The Library on the right (Window › Library).
Motion Editor A tab beside the timeline (Window › Motion Editor).
Actions (F9) The Actions panel, same key (Window › Actions).
Movie Explorer (Alt+F3) Same key; a tab next to the Library (Window › Movie Explorer).
Output The Output panel inside Test Movie, and Window › Output, which keeps the last run's lines.
Align The Align panel on the right, and Modify › Align.
History The History panel on the right. Ctrl+click steps, then Save As Command… (saved commands).
Color and Swatches Window › Colour (stroke and fill, Swap, Black and White). Click the Fill or Stroke squares in the Tools panel, the Colour panel, or any colour swatch in Properties: web-safe swatches, a mixer, a hex field and an alpha. A solid fill's alpha is its own (0% is a clear fill, which is not the same as no fill). The fill's picker also sets its type (None, Solid, Linear, Radial, Bitmap) and a gradient's stops, each with its own alpha, overflow and Linear RGB, like the Color panel. Window › Swatches keeps the document's colours and gradients (click applies to the active stroke or fill, drag to reorder, import and export swatch files and GIMP .gpl palettes; not Adobe .aco/.ase/.clr).
Transform and Info Position, scale and rotation rows in Properties, and the Free Transform tool.
Scene The scene menu at the top left of the stage, Insert › New Scene and Modify › Scene.
Find and Replace Edit › Find and Replace (Ctrl+F).
Publish Settings File › Publish Settings… (Ctrl+Shift+F12).

Not in AniCraft yet: Components, Code Snippets, the Assets panel, and moving the Tools panel. See The workspace for a tour.

Tools and their keys

Each tool has the key you already know.

Tool Key Notes
Selection V Selects raw strokes and fills with the dot pattern; drag an edge to bend it.
Subselection A Points and handles, on raw drawings and drawing objects.
Free Transform Q Scale, skew (drag the line between two handles), rotate and move; Shift and Alt as you'd expect. Drag the white circle to move the transformation point, double-click it to centre it; a rotated instance's box turns with it.
Gradient Transform F Its own button (no flyouts yet). Gradient and bitmap fills, with Lock Fill.
Width U Variable-width strokes, with profiles in Properties.
Bone M Joins symbol instances into an armature, or draws bones inside a shape.
Bind Shift+M Chooses which points of a shape follow which bone.
Pen P Alt-click adds a point to a path.
Text T Static, dynamic and input text.
Pencil Shift+Y Smooth, Straighten and Ink modes.
Brush B Like Animate's Classic Brush: paints filled shapes, with pen pressure.
Eraser E Five erase modes and the Faucet.
Rectangle R With corner radius.
Oval O
PolyStar (none) Polygons and stars.
Line N Shift snaps to 45°.
Paint Bucket K With gap closing.
Ink Bottle S
Eyedropper I Picks fills, gradients, bitmaps and line styles.
Camera C Adds a camera layer.
Hand H Hold Space with any tool, too.
Zoom Z
Object Drawing J Toggles between merge drawing and drawing objects.

Not in AniCraft yet: the Lasso, Polygon and Magic Wand tools, the 3D tools, Asset Warp, the Paint Brush and Fluid Brush, Deco and the Spray Brush. More on the tools in Drawing.

Keys that work as in Animate

Action Key Menu in AniCraft
Insert frame F5 Insert › Timeline › Frame
Remove frame Shift+F5 Insert › Timeline › Remove Frame
Insert keyframe F6 Insert › Timeline › Keyframe
Clear keyframe Shift+F6 Insert › Timeline › Clear Keyframe
Insert blank keyframe F7 Insert › Timeline › Blank Keyframe
Convert to symbol F8 Modify › Convert to Symbol…
Actions panel F9 Window › Actions
Play and stop Enter Control › Play
Previous and next frame , and . Control
Test Movie Ctrl+Enter Control › Test Movie
Publish Shift+F12 File › Publish
Publish Settings Ctrl+Shift+F12 File › Publish Settings…
Import to Stage Ctrl+R File › Import › Import to Stage…
Edit symbols Ctrl+E Edit › Edit Symbols
Break apart Ctrl+B Modify › Break Apart
Duplicate Ctrl+D Edit › Duplicate
Paste in place Ctrl+Shift+V Edit › Paste in Place
Deselect all Ctrl+Shift+A Edit › Deselect All
Redo Ctrl+Y Edit › Redo
Cut, copy and paste frames Ctrl+Alt+X, Ctrl+Alt+C, Ctrl+Alt+V Edit › Timeline
Align left to bottom Ctrl+Alt+1 to Ctrl+Alt+6 Modify › Align
Rotate 90° CW and CCW Ctrl+Shift+9, Ctrl+Shift+7 Modify › Transform
Remove transform Ctrl+Shift+Z Modify › Transform › Remove Transform
Bring forward, send backward Ctrl+Up, Ctrl+Down Modify › Arrange
Bring to front, send to back Ctrl+Shift+Up, Ctrl+Shift+Down Modify › Arrange
Add shape hint Ctrl+Shift+H Modify › Shape › Add Shape Hint
Find and Replace, Find Next Ctrl+F, F3 Edit › Find and Replace
Movie Explorer Alt+F3 Window › Movie Explorer
Snap to objects Ctrl+Shift+/ View › Snapping › Snap to Objects
Zoom in and out Ctrl+=, Ctrl+- View
Preferences (Windows and Linux) Ctrl+U Edit › Preferences…
Help F1 Help › Help for This (the guide at the section for what you are pointing at)
Keyboard Shortcuts Ctrl+Alt+Shift+K Help › Keyboard Shortcuts

AniCraft also has Home and End (and Shift+, and Shift+.) for the first and last frame, and Shift+PageUp and Shift+PageDown for the previous and next scene.

Keys that differ

  • Ctrl+K opens AniCraft's command palette, which finds any command by name. Align is always on the right, and on Ctrl+Alt+1 to 6.
  • Ctrl+G and Ctrl+Shift+G group and ungroup, as in Animate. A drawing object that mixes colours, such as the result of a Union, is a group in AniCraft: double-click it to edit inside.
  • Ctrl+F8 (New Symbol): not there yet. Draw something and convert it with F8.
  • Ctrl+J (Document Settings): it is Modify › Document Settings, with no key by default.
  • Panel toggles such as Ctrl+L for the Library have no key yet; use the Window menu.
  • Ctrl+0 fits the stage in the window and Ctrl+1 shows it at 100 %.

Any key can be changed in Help › Keyboard Shortcuts (Ctrl+Alt+Shift+K, as in Animate), so you can bring back a habit of your own. See Preferences, shortcuts, accessibility and languages and the full list in the shortcut reference.

Concepts that work differently

Raw drawings and drawing objects

As in Animate, the Rectangle, Oval, PolyStar, Line, Pen, Pencil and Brush tools draw raw strokes and fills by default: they cut and join the shapes they touch on the same layer, a fill on top replaces what it covers, and lines split where they cross. The Selection tool shows a dot pattern on selected parts, a double-click selects connected strokes (or a fill with its outline), and dragging an edge bends it. Points snap to points, lines and fill edges within 10 screen pixels.

Press J for Object Drawing to draw shapes that stay separate. Scripts and the command line draw objects unless told otherwise.

This behaviour was rebuilt to match Animate closely, and the remaining differences are tracked in issue 42 on GitHub issues. One known gap: variable-width strokes don't take part in merging yet.

Classic, motion and shape tweens

All three are there, in Insert: Create Classic Tween, Create Motion Tween and Create Shape Tween.

  • Classic tweens (violet spans) work between two keyframes, with easing presets and custom curves, and follow a classic motion guide.
  • Motion tweens (sky-blue spans) animate one object property by property, with property keyframes, the Motion Editor and a motion path you can bend on the stage. Moving the object at a frame pins a point of the path to that frame, as in Animate.
  • Shape tweens (amber spans) morph between shapes, with shape hints.

The one big difference: motion tweens in Animate documents don't come across yet, so a .fla that uses them opens without that motion, and the import report says so. See Tweens.

Symbols

Graphic, movie clip and button symbols behave as you expect: graphics keep step with their parent timeline, movie clips play their own, and buttons have Up, Over, Down and Hit frames. Double-click an instance (or press Ctrl+E) to edit it in place. Paste an instance into another open document and its symbols come along, renamed if a name is taken. Not yet: shared libraries and dragging items from another document's Library. See Symbols and the Library.

ActionScript

AniCraft runs a subset of ActionScript 3.0 in frame scripts: timeline control (stop(), gotoAndPlay and friends, on named instances too), mouse and keyboard listeners, trace, setting and reading instance properties, variables, if, loops and functions. Scripts in an Animate document are always kept with it. One that uses more than the subset doesn't run at all (never halfway), and the Actions panel shows each problem with its line.

The Actions panel also offers a simple list of actions, so you can stop a movie or make a button go to a frame without writing code. Not yet: arrays, objects, switch, string methods, ActionScript 1.0 and 2.0, and scripts placed on instances. See Interactivity.

Files, Test Movie and publishing

  • AniCraft saves .anicraft documents, an open, documented format. It opens .fla, .xfl and XFL folders, as new, untitled documents, but can't save back to them. See Opening Animate files.
  • There is no SWF export. For the web, Export HTML Canvas writes one page that plays the movie, buttons and scripts in any browser. Video (with your own ffmpeg), GIF, animated PNG and WebP, Lottie, sprite sheets, SVG and PNG are there too, and File › Publish writes all the formats you choose at once. See Exporting and publishing.
  • Test Movie (Ctrl+Enter) opens in its own window with an Output panel; Esc closes it.

Not in AniCraft yet

Besides the tools and keys above, these are still to come:

  • saved workspaces and several open documents at once;
  • Envelope and Delete Envelope, and editing a multi-colour drawing object without opening it;
  • motion tweens and bones from Animate documents;
  • spring and joint translation for bones, and armatures mixing symbols and shapes;
  • the Brush's Paint Selection and Paint Inside modes, pressure curves and a brush library;
  • per-character text styles and text on a path;
  • full screen and zoom in Test Movie;
  • shared libraries;
  • SWF, AIR and other runtime targets.

The project's roadmap on GitHub keeps an honest, up-to-date list. If something you rely on is missing, tell us on GitHub issues.