Skip to content

Transition Effects

When changing background and character appearances with @back and @char or performing scene transition with @startTrans and @finishTrans commands, you can additionally specify which transition effect to use. For example, following command will transition to "River" background using "DropFade" transition effect:

nani
@back River.DropFade

When no transition effect is specified a cross-fade is used by default.

You can also specify duration of the transition (in seconds) with the time parameter:

nani
@back River.DropFade time:1.5

The above statement will transition to "River" background using "DropFade" transition over 1.5 seconds. Default time for all transitions is 0.35 seconds.

In case you wish to skip to the next command immediately after executing the transition (and not wait for the duration of the effect), you can set wait parameter to false. E.g.:

nani
@back River.Ripple time:1.5 wait:false
@bgm PianoTheme

— "PianoTheme" background music will start playing right away and won't be delayed for 1.5 seconds, while the transition is in progress.

Some of the transition effects also support additional parameters, which you can control with params parameter:

nani
@back River.Ripple params:10,5,0.02

— will set frequency of the ripple effect to 10, speed to 5 and amplitude to 0.02. When no params is specified, default parameters will be used.

If you wish to modify selected parameters, you can skip others and they'll have their default values:

nani
@back River.Ripple params:,,0.02

All the transition parameters are of decimal type.

The above examples work for characters as well, just provide the transition via a standalone transition parameter:

nani
@char CharID.Appearance transition:TransitionType params:...

You can find available transition effects with their parameters and default values in the docs below.

BandedSwirl

cover

Parameters

NameDefault
Twist amount5
Frequency10

Examples

nani
; Apply the transition with default parameters
@back Appearance.BandedSwirl

; Apply the transition with defeault twist amount, but low frequency
@back Appearance.BandedSwirl params:,2.5

Blinds

cover

Parameters

NameDefault
Count6

Examples

nani
; Apply the transition with default parameters
@back Appearance.Blinds

; Apply the transition using 30 blinds instead of default 6
@back Appearance.Blinds params:30

CircleReveal

cover

Parameters

NameDefault
Fuzzy amount0.25

Examples

nani
; Apply the transition with default parameters
@back Appearance.CircleReveal

; Apply the transition with a high fuzzy amount
@back Appearance.CircleReveal params:3.33

CircleStretch

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.CircleStretch

CloudReveal

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.CloudReveal

Crossfade

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.Crossfade

Crumble

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.Crumble

Dissolve

cover

Parameters

NameDefault
Step99999

Examples

nani
; Apply the transition with default parameters
@back Appearance.Dissolve

; Apply the transition with a low step
@back Appearance.Dissolve params:100

DropFade

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.DropFade

LineReveal

cover

Parameters

NameDefault
Fuzzy amount0.25
Line Normal X0.5
Line Normal Y0.5
Reverse0

Examples

nani
; Apply the transition with default parameters
@back Appearance.LineReveal

; Apply the transition with a vertical line slide
@back Appearance.LineReveal params:,0,1

; Apply the transition in reverse (right to left)
@back Appearance.LineReveal params:,,,1

Pixelate

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.Pixelate

RadialBlur

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.RadialBlur

RadialWiggle

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.RadialWiggle

RandomCircleReveal

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.RandomCircleReveal

Ripple

cover

Parameters

NameDefault
Frequency20
Speed10
Amplitude0.5

Examples

nani
; Apply the transition with default parameters
@back Appearance.Ripple

; Apply the transition with a high frequency and amplitude
@back Appearance.Ripple params:45,,1.1

RotateCrumble

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.RotateCrumble

Saturate

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.Saturate

Shrink

cover

Parameters

NameDefault
Speed200

Examples

nani
; Apply the transition with default parameters
@back Appearance.Shrink

; Apply the transition with a low speed
@back Appearance.Shrink params:50

SlideIn

cover

Parameters

NameDefault
Slide amount1

Examples

nani
; Apply the transition with default parameters
@back Appearance.SlideIn

SwirlGrid

cover

Parameters

NameDefault
Twist amount15
Cell count10

Examples

nani
; Apply the transition with default parameters
@back Appearance.SwirlGrid

; Apply the transition with high twist and low cell count
@back Appearance.SwirlGrid params:30,4

Swirl

cover

Parameters

NameDefault
Twist amount15

Examples

nani
; Apply the transition with default parameters
@back Appearance.Swirl

; Apply the transition with high twist
@back Appearance.Swirl params:25

Water

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.Water

Waterfall

cover

Examples

nani
; Apply the transition with default parameters
@back Appearance.Waterfall

Wave

cover

Parameters

NameDefault
Magnitude0.1
Phase14
Frequency20

Examples

nani
; Apply the transition with default parameters
@back Appearance.Wave

; Apply the transition with a high magnitude and low frequency
@back Appearance.Wave params:0.75,,5

Custom Transition Effects

Dissolve Mask

You can make custom transitions based on a dissolve mask texture. Dissolve mask is a greyscale texture, where the color defines when the pixel will transition to the target texture. For example, consider following spiral dissolve mask:

cover

— the black square in the top-right corner indicates that the transition target should be displayed there at the start of the transition and the pure-white square in the center will transition in the very end.

TIP

For optimal memory usage, set "Single Channel" and "Red" in the dissolve texture import settings. Also, make sure Non-Power of 2 and Generate Mip Maps options are disabled to prevent visual artifacts.

cover

To make a custom transition, use Custom transition mode and specify path (relative to project "Resources" folder) to the dissolve mask texture via the dissolve parameter, eg:

nani
@back Appearance.Custom dissolve:Textures/Spiral

To smooth (fuzz) borders of the transition, use first parameter in 0 (no smoothing) to 100 (max smoothing) range, eg:

nani
@back Appearance.Custom dissolve:Textures/Spiral params:90

To invert the transition (brighter areas of the dissolve mask will be displayed first), set second parameter to 1, eg:

nani
@back Appearance.Custom dissolve:Textures/Spiral params:,1

Check out the following video for the usage examples.

cover

Custom Shader

It's possible to add a completely custom transition effect via a custom actor shader ↗.

WARNING

The topic requires graphic programming skills in Unity. We're not providing any support or tutorials on writing custom shaders; consult the support page for more information.

Create a new shader and assign it to Custom Texture Shader property of the actors, which are supposed to use the custom transition effects; see custom actor shader guide for more information on how to create and assign custom actor shaders.

When a transition name is specified in a script command, shader keyword ↗ with the same name (prefixed with NANINOVEL_TRANSITION_) is enabled in the material used by the actor.

To add your own transitions to a custom actor shader, use multi_compile directive, eg:

c
#pragma multi_compile_local _ NANINOVEL_TRANSITION_CUSTOM1 NANINOVEL_TRANSITION_CUSTOM2

— will add Custom1 and Custom2 transitions.

You can then use conditional directives to select a specific render method based on the enabled transition keyword. When re-using built-in actor shader, it's possible to implement custom transitions via ApplyTransitionEffect method, which is used in the fragment handler:

c
fixed4 ApplyTransitionEffect(sampler2D mainTex, float2 mainUV,
    sampler2D transitionTex, float2 transitionUV, float progress,
    float4 params, float2 randomSeed, sampler2D cloudsTex, sampler2D customTex)
{
    const fixed4 CLIP_COLOR = fixed4(0, 0, 0, 0);
    fixed4 mainColor = Tex2DClip01(mainTex, mainUV, CLIP_COLOR);
    fixed4 transColor = Tex2DClip01(transitionTex, transitionUV, CLIP_COLOR);

    #ifdef NANINOVEL_TRANSITION_CUSTOM1 // Custom1 transition.
    return transitionUV.x > progress ? mainColor
        : lerp(mainColor / progress * .1, transColor, progress);
    #endif

    #ifdef NANINOVEL_TRANSITION_CUSTOM2 // Custom2 transition.
    return lerp(mainColor * (1.0 - progress), transColor * progress, progress);
    #endif

    // When no transition keywords enabled default to crossfade.
    return lerp(mainColor, transColor, progress);
}

You'll then be able to invoke the added transitions in the same way as the built-in ones, eg:

nani
@back Snow.Custom1
@back River.Custom2

For the complete shader example see custom actor shader guide.