Trailエフェクトの使い方 の変更点

[[API Reference]] > [[flixel.addons.effects]] > FlxTrail > Trailエフェクトの使い方

*Trailエフェクトの使い方 [#c3fa64dc]
#ref(001.png);

FlxSpriteの軌跡を表示するTrailエフェクトの使い方を紹介します。

**使い方 [#dce99cc1]
使い方は簡単で、Trailエフェクトを表示したいFlxSpriteを new() の引数に渡すだけです。
#geshi(Actionscript){{

*** Project.xmlの修正 [#w1fc89b7]
まずは、Project.xml に flixel-addonsを有効にする記述します。

#geshi(XML){{
  <!-- flixel-addons を有効にする -->
  <haxelib name="flixel-addons" />
}}

*** ソースコードの記述 [#ubc31a5c]
ソースコードの記述は簡単で、Trailエフェクトを表示したいFlxSpriteを new() の引数に渡すだけです。
#geshi(Actionscript3){{
/// Horming.hx
class Horming extends FlxSprite {

  // 生成
  override public function create() {
    this(0, 0);
    makeGraphic(4, 4, FlxColor.CYAN);

    // Trailエフェクト生成
    FlxG.state.add(new FlxTrail(this));
  }
}
}}

**インスタンスを使いまわす場合 [#y99bb6c5]
インスタンスを使いまわす場合は、生成後に kill() して必要なタイミングで revive() を呼び出し再表示します。また resetTrail() を呼び出して前回の描画情報を消しておきます。
#geshi(Actionscript){{
/// Horming.hx
class Horming extends FlxSprite {

  // Trailエフェクト
  private var _trail:FlxTrail;

  // 生成
  override public function create() {
    this(-100, -100);
    makeGraphic(4, 4, FlxColor.CYAN);
    kill(); // いったん消す

    // Trailエフェクト生成
    _trail = new FlxTrail(this);
    FlxG.state.add(_trail);
    _trail.kill(); // いったん消す
  }

  // 生成
  public function init():Void {
    revive();
    _trail.revive(); // 再表示
    _trail.resetTail(); // 表示をリセットする
  }

  // 消滅
  public function vanish():Void {
    kill();
    _trail.kill();
  }
}
}}

** FlxTrailのコンストラクタ引数の説明 [#va4be386]
FlxTrailのコンストラクタには以下の引数が指定可能です。
 FlxTrail.new(Sprite:FlxSprite, ?Image:Dynamic, Length:Int = 10, Delay:Int = 3, Alpha:Float = 0.3, Diff:Float = 0.05)
- Sprite:FlxSprite : 軌跡を表示するFlxSpriteを指定します
- Image:Dynamic : Trailエフェクトの画像。nullの場合は指定したFlxSpriteの画像を使用します
- Length:Int : 軌跡の数。多くするとたくさんの軌跡が表示されます
- Delay:Int : 更新頻度。0を指定すると毎フレーム更新しますが処理が重たくなります
- Alpha:Float : 最初のTrailエフェクトのAlpha値
- Diff:Float : 次のTrailエフェクトから減算するAlpha値

** より詳しい情報 [#k8ede03b]
FlxTrailについてより詳しい情報は、「FlxTrail」のページに記載しています