Skip to content

AnimationsEditor is a graphical tool for designing animations based on Animations-Core. Bring your morphs to life using up to four handpicked animations. Effortlessly add generated code to your squeak project. Code less and achieve more - with AnimationsEditor. (SWT22-03)

License

hpi-swa-teaching/AnimationsEditor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AnimationsEditor

GitHub license GitHub issues GitHub stars GitHub Workflow Status (branch) GitHub repo size GitHub All Releases Coverage Status

AnimationsEditor is a graphical tool for designing animations based on Animations-Core. Bring your morphs to life using six handpicked animations. Effortlessly create animations in Squeak. Code less and achieve more - with AnimationsEditor.

start

Features

AnimationsEditor provides you with a broad toolset to bring your morphs to life. Select any visible morph in your Squeak image and use up to five animations for offering your users a fully animated Squeak experience:

  • position Let your morph wander around the screen.
  • color Make your morphs chameleons: Change their color to any Hex coded color using a smooth transition effect.
  • rotation Rotate your morph up to 360 degrees.
  • size Let your morphs grow and shrink their size according to your needs.
  • image source (Only for ImageMorphs) Animate the image used as your morph with a smooth transition. Bongo cat approved!
  • text (Only for TextMorphs) Change the displayed text in your morph, great for storytelling!

Add multiple keyframes for each property at different timestamps to see an ever-evolving animation!

Fear of creating too complex animations and losing sight of whats happening? Fear not, for the timeline is always shown at the bottom to tell you when you have set keyframes for every property!

Watch your animations whenever you want with Play Animations. Have a great animation that you want to use as a blueprint for future animations? Save it as a JSON to your disk, share it, and load it back into the animation editor by using Load JSON.

Installation

Ready for AnimationsEditor? Follow our lean setup guide to install AnimationsEditor.

Getting Started with AnimationsEditor

Follow our step by step guide for using AnimationsEditor.

Preparations

  1. Install and open a supported Squeak image (see setup guide).
  2. Open AnimationsEditor by executing AnimationsEditor open. Now you should see the GUI of AnimationsEditor.

Pro Tip: Use 'Button for it' on this code snippet in order to have quick access to AnimationsEditor.

AnimationsEditor open.

Select morph

  1. Create a morph in your Squeak image - this is the morph we want to bring to life. In case you are just playing around, create a dummy Morph with Morph new openInHand
  2. Click on Add Morph
  3. Click on your previous created Morph using left mouse key with 'opt'/'alt' key pressed. With Windows OS you can also use the middle mouse key.

Your morph should have been added to the property inspector. The property inspector provides you up to five properties to animate, depending on the type of morph you added.

add-morph

Supported animations

Morph color

Enter a hex coded color into the text field or simply use the integrated color picker, add a keyframe and press Play animations.

color

Morph rotation

Enter an integer value in the text field, add a keyframe and press Play animations.

rotation

Morph position

Enter the desired x- and y position the morph should move to, add a keyframe and press Play animations.

position

Morph size

Enter the desired height and width of the morph, add a keyframe and press Play animations.

size

ImageMorph image source

Tell it where your image is saved, add a keyframe and press Play animations.

image source

TextMorph text

Enter the text you want to show, add a keyframe and press Play animations.

text

Start- & Endtime

Adjust the duration of your playing field with start- and endtime; Keyframes outside of these boundaries will not be used (but still saved if you want to adjust later!)

duration

Save animation

Configure your animation with AnimationsEditor and save everything in a JSON by pressing Save animation.

saving

Load animation

Load in a previously saved animation by pressing Load JSON.

loading

The Timeline

The timeline shows you your created keyframes of the properties of your selected object. Its bounds are the start- and endtime. You will never lose sight of your created animations!

Development

CI Pipeline and coverage

The CI pipeline is implemented using GitHub actions, and push is executed on each piece of code. The AnimationsEditor package is therefor executed under mac, ubuntu and windows on Squeak 5.3, Squeak 5.2, Squeak 5.1 and Squeak Trunk. In addition, the codecoverage is monitored and the badges above are updated.

Documentation

For our complete documentation, visit our wiki, which contains the following parts:

  • Small overview to get into using the AnimationsEditor.
  1. Introduction to the AnimationsEditor
  • See beyond the UI and learn how the AnimationsEditor is built and the code behind it.
  1. In-depth look

Contributors

Legacy:

About

AnimationsEditor is a graphical tool for designing animations based on Animations-Core. Bring your morphs to life using up to four handpicked animations. Effortlessly add generated code to your squeak project. Code less and achieve more - with AnimationsEditor. (SWT22-03)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published