Screen effects — IngevoraMirage

Screen effectsA screen effect is a short animation that plays in an overlay above your app's own screens. It uses no camera and no face: think of confetti when a player wins, a badge that pops in, or a flash with a shake.Every effect has a fixed length. Set it in Effect settings as Duration (ms), from 100 to 10 000. The effect always ends there.LayersAn effect has up to 8 layers, drawn in list order: the first at the back, the last on top. Add layer offers five kinds:

Layer

What it draws

Its own settings

Particles

Small images thrown from a point

Origin X and Origin Y, Emitter, Burst at start, Max particles alive

Full-screen sprite

A sprite sheet over the whole screen

Sprite sheet, Fit, Start (ms)

Motion

A shake, a flash or a pulse

Motion, Intensity, Start (ms), Duration (ms), Frequency (Hz)

Image

A still image anywhere on the screen

Position X and Position Y, Scale, Rotation (°), Opacity

Sprite

A sprite sheet anywhere on the screen

Sprite sheet, the same placement as an image, Start (ms)

Fit is Contain (each frame fits inside the screen) or Cover (each frame fills the screen and the overflow is cropped). For sprite sheets, see Sprite sheets.Where things goPositions are fractions of the screen: (0, 0) is the top-left corner and (1, 1) the bottom-right. Scale is the width as a multiple of the screen's shorter side, up to 2. Particle speed, size and gravity use the shorter side too, so an effect keeps its look on any phone.Motion

Shake moves the effect's other layers back and forth.

Pulse grows and shrinks the other layers about the centre of the screen.

Flash draws a white fill over the whole screen. Frequency (Hz) is the number of flashes per second.

Shake and pulse fade out over their duration. At Intensity 1, a shake moves layers up to 3 % of the screen's shorter side, and a pulse grows them by up to 10 %. A motion moves only the effect's own layers; it can't move your app's screen.Timing

A sprite or a motion that is visible at the start begins at its Start (ms). One started by an action begins at that action instead.

A motion must end within the effect: its start plus its duration can't pass the effect's length. A sprite's start must come before the end. The Issues tab flags anything that doesn't fit.

At the end, everything stops at once. Sprites and motions are cut, and particles vanish.

If your app plays the effect again while it is running, both plays run on their own, and the later one is drawn on top.

If your app stops an effect early, it ends at once, without effect.ended.

The timelineThe timeline sits below the viewer. Its ruler runs from 0 to the effect's length, with a tick every half second. Each layer has a row with a bar for when it plays:

images and particles: the whole effect;

a motion: from its start, for its duration;

a sprite: from its start, for its frame count divided by its frames per second; to the end when it loops, with a lighter tail when it holds its last frame;

a dashed bar: the layer starts hidden, and a trigger shows it.

Click a row to select its layer. Click or drag on the ruler to jump: the viewer replays the effect from 0 up to that time, so particles and sprites are where they would be. On the ruler, the left and right arrow keys move 100 ms (with Shift, 1 second), and Home and End go to either end. Keyframe clips have rows of their own; see Keyframe animation.TriggersAn effect's triggers listen to:

Lifecycle — effect.started at time 0, and effect.ended at the end. Actions on effect.ended have no visible result, because nothing draws after the end.

Host event — any name your app sends, such as level.complete.

Effects have no face signals and no threshold. Their actions are Show, Hide, Play sprite, Emit particles, Run motion and Play animation. See Triggers and your events.The phone-screen viewerThe viewer plays the draft over a generic phone screen of 390 × 845 points, with grey placeholder bars instead of a real app. Click an image or a sprite to select it. Drag it to move it, drag a corner to resize it, drag the round handle to rotate it, or use its Opacity slider. When the effect ends, the viewer shows Effect ended with Restart.Screen effects have no Test on phone and no preview images.Before you deliverScreen effects must be switched on for your workspace, or the delivery API answers 403. The Developers page shows which products are on. An effect's images add up to at most 3 MiB, and your workspace may have a flashing limit or a screen-coverage cap. See Rules and keep-out zones.