Tweenコルーチン

拡張メソッド

名前空間：SilCilSystem.Tween

Assembly：SilCilSystem.Packages

Tweenコルーチンは変数の値をある値から別の値へと時間変化させる拡張メソッドです。 1から10まで3秒間で値を増やしたり、赤から青に1秒で変化させたりできます。

対応している型

Primitive型

Unityのstruct型

使用例

例えば、1から10まで3秒間で値を変化させる場合は以下のように書きます。

using UnityEngine;
using SilCilSystem.Variables;
using SilCilSystem.Tween;

public class TestTweenFloat : MonoBehaviour
{
    [SerializeField] private VariableFloat m_value = default;

    private void Start()
    {
        // コルーチンなので、StartCoroutineで呼ぶ.
        StartCoroutine(m_value.Tween(1f, 10f, 3f));
    }
}

コルーチンメソッドを作成し、yield returnすることで、変化が終わるまで待機することもできます。

using UnityEngine;
using System.Collections;
using SilCilSystem.Variables;
using SilCilSystem.Tween;
using SilCilSystem.Math; // イージング関数の指定で既に用意されているものを使用する場合は必要.

public class TestTweenFloatSequence : MonoBehaviour
{
    [SerializeField] private VariableFloat m_value = default;

    private void Start()
    {
        StartCoroutine(MyCoroutine());
    }

    private IEnumerator MyCoroutine()
    {
        // 1から10まで3秒で変化させる.
        yield return m_value.Tween(1f, 10f, 3f);

        // 現在の値から100まで2秒で変化させる.
        yield return m_value.Tween(100f, 2f);

        // イージング関数を指定することも可能.
        yield return m_value.Tween(1f, 10f, 3f, CurveTypeDefinition.CurveType.EaseInOutQuad);

        // イージング関数はラムダ式でもOK.
        yield return m_value.Tween(1f, 10f, 3f, x => Mathf.Sqrt(x));
    }
}

実装

全てのTweenコルーチンは以下のメソッドを呼び出しています。

internal static IEnumerator Tween<T>(this Variable<T> variable, T start, T end, float time, Func<T, T, float, T> lerp, Func<float, float> curve)
{
    float timer = 0f;
    while (timer < time)
    {
        timer += Time.deltaTime;
        variable.Value = lerp(start, end, curve(Mathf.Clamp01(timer / time)));
        yield return null;
    }
    variable.Value = lerp(start, end, curve(1f));
}

ドキュメントトップへ

ダウンロードページへ