Creator Docs

Animations

An animation makes a picture move or change over time. For example, a character can jump, or a background can fade into the next one. Make an animation once, then use it in many scenes.

The whole Animations page on a phone. The Transitions folder shows Crossfade, Fade-through, and Slide Mask 1s. Each animation shows its type and a small timeline. The whole Animations page on desktop. The file explorer on the left shows the Transitions and Updates folders. The animations Crossfade, Fade-through, and Slide Mask 1s are in the middle, each with its type and a small timeline.

Words to know

  • Update animation: Changes one picture while it is on the screen. For example, a character jumps.
  • Transition animation: Plays when a picture appears, goes away, or changes to another picture. For example, the old background fades out while the new one fades in.
  • Property: The thing that changes. For example, Alpha is how see-through a picture is. Position Y is how high or low it is.
  • Keyframe: One step of the animation. It says which value to reach and how long to take.
  • Timeline: The area under the picture that shows the keyframes. Time goes from left to right.

Open the Animations page

  1. Open your project. See Projects.

  2. Go to the Animations page.

    • Phone or tablet: Tap Assets in the bottom bar. Then tap Animations under Animated Assets.
    • Desktop: In the far left bar, click the Animated Assets button, below the Assets button. Then click Animations.
    The list of pages on a phone, opened from the Assets tab. Animations under Animated Assets is marked. The list of Animated Assets pages on desktop. The Animated Assets button in the far left bar and Animations in the list are marked.
    Animations is under Animated Assets.

The Animations page opens.

Create an animation

This page makes an update animation called Jump. The character moves up, then back down.

  1. Next to the Updates folder, tap Add.

    Animations page on a phone. The Add button on the Updates folder row is marked. The Animations page on desktop. The Add button on the Updates folder row is marked.
  2. In Name, type Jump. Check that Update is selected under Type. Then tap Continue.

    The Add Animation box on a phone with Jump typed in the Name field. Update under Type and the Continue button are marked. The Add Animation box on desktop with Jump typed in the Name field. Update under Type and the Continue button are marked.
    Choose Update or Transition here. You cannot change the type later.

The animation editor opens.

Parts of the animation editor

The animation editor on a phone. Number 1 marks the back button, 2 the undo and redo buttons, 3 the loop and play buttons, 4 the canvas, 5 the Timeline and Preview tabs, 6 the Add button, and 7 the timeline. The animation editor on desktop. Number 1 marks the back button, 2 the undo and redo buttons, 3 the loop and play buttons, 4 the canvas, 5 the Timeline and Preview tabs, 6 the Add button, and 7 the timeline.
The numbers match the list below.
  1. Back button: Goes back to the Animations page. Your changes save by themselves.
  2. Undo and redo: Undo the last change, or bring it back.
  3. Loop and play: The play button plays the animation. With the loop button on, it plays again and again.
  4. Canvas: Shows the animation.
  5. Timeline and Preview: Timeline shows the keyframes. Preview sets the pictures on the canvas.
  6. Add button: Adds a property.
  7. Timeline area: Shows a row for each property, with its keyframes. A new animation shows Add Property here.

Add a property

  1. Tap Add. The Add animation property box opens.

  2. Tap the box under Property. Then tap Position Y.

  3. Leave Tween Mode on Keyframes, and Initial value type on Default. Tap Add Property.

    The Add animation property box on a phone. Position Y is chosen under Property. The Position Y box and the Add Property button are marked. The Add animation property box on desktop. Position Y is chosen under Property. The Position Y box and the Add Property button are marked.

A row called y appears on the timeline. The timeline uses short names, such as y for Position Y.

Add keyframes

Jump needs 2 keyframes. The first moves the picture up. The second moves it back down.

  1. Tap the gray bar next to y. It says No keyframes.

    The animation editor on a phone with the row y on the timeline. The gray bar next to y, which says No keyframes, is marked. The animation editor on desktop with the row y on the timeline. The gray bar next to y, which says No keyframes, is marked.

    A keyframe appears on the bar.

  2. Open the keyframe.

    • Phone or tablet: Tap the keyframe.
    • Desktop: Right-click the keyframe. Then click Edit keyframe.
    The keyframe menu on desktop, opened with a right-click on the new keyframe. Edit keyframe is marked.

    The Edit Keyframe box opens.

  3. Change these values. Then tap Update.

    • Duration (ms): 300
    • Value: -100
    • Value type: Relative
    The Edit Keyframe box on a phone. Duration (ms) is 300, Value is -100, and Value type is Relative. These and the Update button are marked. The Edit Keyframe box on desktop. Duration (ms) is 300, Value is -100, and Value type is Relative. These and the Update button are marked.

    Relative adds the value to where the picture already is. -100 moves it 100 pixels up. 300 ms is less than a third of a second.

  4. Tap the empty part of the gray bar, to the right of the first keyframe. A second keyframe appears.

  5. Open the second keyframe, like in step 2. Change these values. Then tap Update.

    • Delay (ms): 0
    • Duration (ms): 300
    • Value: 100
    • Value type: Relative

    A new keyframe can start with a delay, so set Delay (ms) to 0.

The bar now has 2 keyframes. Relative values show a Δ, such as Δ-100.

On desktop, you can also click a keyframe. Then change its values in Keyframe Details on the right.

Preview the animation

The canvas shows a white box until you choose a picture. Preview pictures only help you see the animation.

  1. Under the canvas, tap Preview. Then tap the box under Target Image.

    The Preview tab of the animation editor on a phone. The Preview tab and Select image under Target Image are marked. The Preview tab of the animation editor on desktop. The Preview tab and Select image under Target Image are marked.
  2. Tap a picture, such as a character. Then tap OK.

    To add a background, tap the box under BG Image and choose a picture.

  3. In the top right, tap the play button.

    The animation editor on a phone. The canvas shows Makkuro in front of the Lecture hall. The play button in the top right is marked. The animation editor on desktop. The canvas shows Makkuro in front of the Lecture hall. The play button in the top right is marked.

The picture jumps up and comes back down.

Open an animation

Open an animation to change it later.

  • Phone or tablet: Tap the animation. Then tap Edit at the bottom of the screen.
  • Desktop: Double-click the animation.
The panel at the bottom of the Animations page on a phone, for Crossfade. The Edit button is marked. The Animations page on desktop. The Crossfade animation is marked.

Transition animations

A transition animation changes one picture into another. For example, background A changes to background B.

Outgoing and Incoming

The timeline of a transition has 2 groups of rows:

  • Outgoing: Changes picture A, the one that leaves.
  • Incoming: Changes picture B, the one that arrives.

Both groups play at the same time, on one timeline. So A can fade out while B fades in.

Sometimes there is only one picture:

  • When a picture appears and nothing was there before, only the Incoming rows have a picture to change.
  • When a picture goes away and nothing takes its place, only the Outgoing rows have a picture to change.

To add a property, tap Add. Then tap Outgoing or Incoming, and tap a property. The row appears right away.

The Crossfade animation in the editor on a phone. The timeline has Outgoing and Incoming rows. The menu from the Add button is open, with Outgoing, Incoming, and Mask marked. The Crossfade animation in the editor on desktop. The timeline has Outgoing and Incoming rows. The menu from the Add button is open, with Outgoing, Incoming, and Mask marked.

Initial values

Each row starts from the normal value of its picture. A picture is normally fully visible, so its alpha starts at 1.

This matters when a picture should fade in. If Incoming alpha starts at 1, B shows at once, on top of A. Give it an initial value of 0 instead.

A simple fade uses 2 rows:

  • Outgoing alpha: One keyframe with the value 0. A starts at 1, so it fades out.
  • Incoming alpha: An initial value of 0, and one keyframe with the value 1. So B fades in.

To set an initial value:

  • Phone or tablet: Tap the row name, such as alpha. Tap Edit Initial Value. Under Value Source, choose Custom Value. Type the number in Custom Initial Value. Then tap Update.
  • Desktop: Click the row name, such as alpha. On the right, under Initial value type, click Value. Then type the number under Initial value.

The initial value shows next to the row name. A dash (—) means the row starts from the normal value.

Preview a transition

Under the canvas, tap Preview. A transition has 3 picture boxes:

  • BG Image: A background behind both pictures.
  • Outgoing Image: Picture A.
  • Incoming Image: Picture B.

Tap a box and choose a picture. Then tap the play button. Until you choose pictures, A is a white box and B is a black box.

Masks

Mask shows the new picture bit by bit, following a black and white image. You choose that image from your Images page.

This black and white image is the mask image. Its colors decide the order:

  • White parts show the new picture first.
  • Black parts show the new picture last.
  • Gray parts show it in between.

For example, a mask image can go from black on the left to white on the right. Then the new picture shows on the right side first.

To add a mask:

  1. In a transition animation, tap Add. Then tap Mask. The Add Mask box opens.
  2. Under Image, tap Select image. Tap your mask image, then tap OK.
  3. Change the other settings if you need to. Then tap Add Mask.
The Add Mask box on a phone, with the mask image wipe chosen. It shows Channel, Invert, Softness, Image, Progress Duration (ms), Progress Easing, and the Add Mask button. The Add Mask box on desktop, with the mask image wipe chosen. It shows Channel, Invert, Softness, Image, Progress Duration (ms), Progress Easing, and the Add Mask button.
Setting What it does
Channel Which part of the mask image to use. Greyscale uses how light or dark each part is. Alpha uses how see-through each part is. Solid parts show the new picture first, and see-through parts show it last.
Invert On flips the order. Black parts then show the new picture first, and white parts last.
Softness How soft the edge between the 2 pictures is. 0 makes a sharp edge. A bigger number makes a smoother edge. The box starts at 0.08.
Image The mask image. You must choose one before you can tap Add Mask.
Progress Duration (ms) How long the mask takes. The box starts at 900.
Progress Easing How the speed changes during the mask. Linear keeps the same speed.

Mask progress

After you add a mask, a Mask row appears on the timeline. It shows a small copy of the mask image.

The row has one keyframe for the progress of the mask. Progress goes from 0 to 1:

  • At 0, you see only the outgoing picture.
  • Between 0 and 1, the new picture spreads over the old one, in the order of the mask.
  • At 1, you see only the incoming picture.

The length of this keyframe is the Progress Duration. To change the time or the easing later, open the keyframe, like in Add keyframes.

The animation editor on a phone, stopped at 500 ms of a mask transition. Night sky appears from the right over Lecture hall. The Mask row on the timeline, with its small black and white mask image, is marked. The animation editor on desktop, stopped at 500 ms of a mask transition. Night sky appears from the right over Lecture hall. The Mask row on the timeline, with its small black and white mask image, is marked.
At 500 ms, the right side already shows the new picture.

To change the other mask settings later:

  • Phone or tablet: Tap the Mask row. The Mask box opens. Change the settings, then tap Done. To delete the mask, tap Remove.
  • Desktop: Click the Mask row. The settings show on the right. To delete the mask, click the trash button at the top right. Desktop also shows Initial value, the progress at the start. Keep it at 0.

Use an animation in a scene

Many line actions have an Animation box, such as Background, Characters, and Visuals. This example uses Characters.

  1. Add a character to a scene. See Line action: Characters.

  2. Tap the box under Animation. Then tap Jump.

    The Characters action on a phone with Makkuro. The list under Animation is open. Jump, an Update animation, is marked. The Characters action on desktop with Makkuro. The list under Animation is open. Jump, an Update animation, is marked.
    Each animation shows its type, Update or Transition.
  3. Tap Submit.

When the line plays, the character jumps.

After you choose an animation, more settings appear below it:

  • Playback Speed: How fast the animation plays. 1 is normal speed, and 2 is twice as fast.
  • Loop: Loop plays the animation again and again. Only update animations have this setting.

Reference

Properties

Property What it changes Animation type
Camera Moves and zooms the view, like a camera. You set it in the Adjust camera box. Update and transition
Alpha How see-through the picture is. 0 is invisible, and 1 is fully visible. Update and transition
Position X and Position Y Where the picture is, in pixels. X is left and right. Y is up and down. Update and transition
Translate X and Translate Y Moves the picture by screen sizes. 1 moves it one full screen width or height. Update and transition
Scale X and Scale Y How big the picture is. 1 is normal size. Update and transition
Rotation How much the picture turns, in degrees. Update and transition
Blur X and Blur Y How blurry the picture is. Update only
  • You can add each property only once. In a transition, you can add it once to Outgoing and once to Incoming.
  • You cannot use Position X and Translate X together. The same is true for Position Y and Translate Y.
  • You cannot use Camera together with Position, Translate, or Scale.

Keyframe values

Value What it does
Delay (ms) Waits before the keyframe starts. 1000 ms is 1 second.
Duration (ms) How long the change takes.
Value The value at the end of the keyframe.
Value type Absolute uses the value as it is. Relative adds the value to the value before.
Easing How the speed changes during the keyframe. Linear keeps the same speed.

Property settings

These are in the Add animation property box.

  • Tween Mode: Keyframes uses the keyframes that you add. Auto has no keyframes. When the value changes, the picture moves smoothly to the new value. For example, with Auto on Position X, a character slides to a new spot instead of jumping there. Only update animations have this setting.
  • Initial value type: Default starts from the value the picture has when the animation starts. Value starts from a number that you choose.

Good to know

  • An animation can be used in many scenes. A change to it changes every place that uses it.
  • To copy an animation, use Duplicate. On a phone or tablet, tap the animation, then tap Duplicate. On desktop, right-click it, then click Duplicate.
  • To see one moment, tap a time on the ruler above the timeline.

Problems and fixes

  • The canvas shows only a white box. Tap Preview, then choose a Target Image. In a transition, choose an Outgoing Image and an Incoming Image.
  • In a transition, the new picture shows at once. Give the Incoming alpha row an initial value of 0. See Initial values.
  • I cannot tap Add Mask. Choose a mask image under Image first.
  • Nothing moves when I tap play. Check that the row has keyframes. A row that says No keyframes does nothing.
  • The picture jumps to a strange place. Check Value type. Absolute moves the picture to that exact spot. Relative moves it from where it is.
  • I cannot find Blur X or Blur Y. Blur works only in update animations.
  • A property is missing from the list. You already added it, or it cannot be used with a property you added. See Properties.

Next steps