Skip to content本文へ移動

@celesta-plugin/lottie

After Effects から書き出した Lottie アニメーションを、動画のフレームに合わせて描く。

@celesta-plugin/lottie は、After Effects から Bodymovin で書き出した Lottie の JSON を、コンポジションのフレームに合わせて描きます。各フレームはその時刻だけから決まるパス・グループ・マスクとして描かれるので、プレビュー、書き出し、@celesta.studio/web のどれでも同じ絵になり、どのフレームへスクラブしても再生したときと同じ結果になります。

ブラウザのプレイグラウンド(@celesta.studio/web)ではプラグインは不要です。@celesta-plugin/lottie をそのまま使えます。

アニメーションを置く

JSON ファイルを読み込み、その内容を data に渡します。

import { Composition, Sequence } from '@celesta.studio/react';
import { Lottie } from '@celesta-plugin/lottie';

import confetti from './confetti.json';

export default function Root() {
  return (
    <Composition width={1920} height={1080} fps={60} durationInFrames={300}>
      <Lottie data={confetti} x={960} y={540} anchorX={0.5} anchorY={0.5} width={800} />
      <Sequence from={120}>
        <Lottie data={confetti} endFrame={30} playbackRate={2} loop={false} />
      </Sequence>
    </Composition>
  );
}
Props 用途
data Lottie の JSON の内容です。
width / height 描く大きさです。既定はファイルの w × h で、片方だけなら縦横比を保ちます。この枠の外は描かれません。
playbackRate 再生速度です。既定は 1 で、負の値で逆再生します。
loop 既定は true です。false では endFrame の 1 フレーム前で止まります。
startFrame / endFrame 再生する範囲を、ファイル自身のフレームで指定します。既定はファイルの ip / op です。
assetsPath 画像レイヤーのファイルがあるフォルダです。<Image> の src と同じくエントリからの相対パスです。既定は各画像アセットの u です。
onWarning 描けない機能を見つけたときのメッセージを受け取ります。既定は console.warn で、ファイルごとに 1 回だけ呼ばれます。

x、y、anchorX、anchorY、rotation、opacity などの共通の props も使えます。再生は、囲んでいる Sequence のフレーム 0 から始まります。ファイルのフレームの間は補間するので、30 fps のファイルも 60 fps の動画で滑らかに動きます。

対応している機能

  • レイヤー:シェイプ、プリコンポジション(タイムリマップと伸縮を含む)、平面、画像、ヌル。親子関係、ブレンドモード。
  • マスク:加算、減算、交差、反転、不透明度。トラックマット:アルファ、ルミナンス、それぞれの反転。
  • シェイプ:グループ、パス、長方形(角丸を含む)、楕円、スター、多角形、塗り、線(破線、線端、角)、線形・円形グラデーション、パスのトリミング。

次の機能は描かれず、警告が出ます:テキストレイヤー、エクスプレッション、エフェクトとレイヤースタイル、3D レイヤー、自動方向、パスの結合、リピーター、角を丸くする、偶奇の塗りルール、円形グラデーションのハイライト、マスクの拡張、埋め込まれた(base64 の)画像。画像は別ファイルとして書き出してください。inspectLottie(data) は、描かずに同じメッセージの配列を返します。

インストールせずに、試してみよう。

ブラウザで Celesta を動かせます。書き出しもできます。

プレイグラウンドを開く