Skip to content

murasaqi/Unity_StageLightManeuver

Repository files navigation

Unity StageLightManeuver

Note

インストール用URLはこちら

https://github.com/murasaqi/Unity_StageLightManeuver.git?path=/jp.iridescenet.stagelightmaneuver

概要

UnityのTimeline上で直感的に照明演出を設計することができるアセットです。 DMXやArtnetで制御される照明コントロールシステムを参考に開発されており、実際のライブ照明に近い演出をつけることが可能です。

Overview

インストール

Git URLを使用してインストール

  1. Window > Package Manager を開きます。
  2. + > Add package from git URL... を選択します。
  3. https://github.com/murasaqi/Unity_StageLightManeuver.git?path=/jp.iridescenet.stagelightmaneuver を入力し、Add を押すことで最新版がインストールされます。

要件

  • Unity 2021.3.6f1 以上
  • URP or HDRP

Optional

機能例

  • Timelineから複数灯体の一括制御が可能

    • 大量のライトを一元管理しながら効率的にライト演出を作成できます。
    • グループごとに演出をつけることもできます。

    feature_overview

  • TimelineClipからチャンネルに応じたプロパティを設定することで、効率的に照明演出を設計できます

    • Intensity, Color, Pan/Tilt, Gobo をはじめとした 20以上のプロパティが用意されています

    • チャンネルの組み合わせで用途に合わせた灯体を作成することができます

    • クリップをブレンドにも対応しています

      property

      Light, Pan/Tilt Property 単体の動作と組み合わせた際の動作

      clip_blend

      クリップのブレンドによるライト消灯

  • TimelineClipをProfileとして保存し、クリップ間でパラメータの同期が可能です

  • VolumetricLightBeamと連携させることが可能です(後述) link_vlb

プリセット灯体

/Resources/SLSAssets/Lights/ 以下に URP対応のセットアップ済み灯体を同梱しています

Light Type File Name RenderPipeLine Rendering Image
LED Strobe SLM_LEDStrobe_URP.prefab URP
Moving Beam Light SLM_MovingBeamLight_URP.prefab URP
Moving Beam Light SLM_MovingBeamLight_URP_VLB_HD.prefab URP
Moving Beam Light SLM_MovingBeamLight_URP_VLB_SD.prefab URP
Moving Wash Light SLM_MovingWashLight_URP.prefab URP
Moving Wash Light SLM_MovingWashLight_URP_VLB.prefab URP
Rotating Wash Light SLM_RotatingWashLight_URP.prefab URP
Rotating Wash Light SLM_RotatingWashLight_URP_VLB.prefab URP

使い方

クイックスタート

SLM_QuickStart.mp4

以下にプリセット灯体を用いたタイムラインからの灯体制御例を示します。 この例ではURP上でMoving Beam Lightを扱います。

  1. シーンに /Resources/SLSAssets/Lights/SLM_MovingBeamLight_URP_HD.prefab を配置し、必要に応じてLightFixtureと各LightChannelの設定を変更します

    • 灯体がどんな機能に対応しているかは Stage Light Fixture によって管理されます
    • Stage Light Fixture に機能を登録するにはFixtureコンポーネントの Add New Channelから追加したい機能を選択します
      参考 fixture_ui
  2. 1で作成した灯体を複製し配置した後、それらを Stage Light Universe コンポーネントをもつゲームオブジェクトの子にします

  3. Stage Light Universe コンポーネントのコンテキストメニューから「Find Stage Light Fixtures」と「Initialize」を実行してください。これで灯体をタイムラインから操作できるようになります。

  4. タイムラインにStage Light Timeline Trackを作成し、トラックにStage Light Universeをバインドします

  5. トラックにクリップを作成すると灯体の対応チャンネルに応じて自動的にプロパティが追加されます

  6. クリップからプロパティの設定を変更すると、それに応じて灯体が制御されます

Volumetric Light Beamとの連携

本パッケージはVolumetric Light Beam(以下VLB)との連携にも対応しています。 以下の手順でVLBをパッケージとして取り込むことで、VLB付き灯体をStage Light Maneuverで制御できるようになります。

Note

試験的にセットアップウィザードの提供を行っています

セットアップウィザードによるセットアップがうまくいかない場合、手動でのセットアップを行ってください

slm_wizard

手動でのセットアップ方法
  1. アセットストアからVLBをインストール後 VLBのフォルダにcom.saladgamer.volumetriclightbeamという名前の Assembly Definition を作成してください

    • プラットフォーム設定はAnyに設定します
    • URPを使用する場合、com.saladgamer.volumetriclightbeamファイルの設定内にあるAssembly Definition References にUnity.RenderPipelines.Universal.Runtime を設定してください vlb_asmdef_refurp

    vlb_asmdef

  2. Assembly Definition の設置後、VLBのフォルダをPackagesフォルダ以下に移動してください

    move_vlb

  3. 以降VLBがついた灯体をStage Light Maneuverで制御すると、自動的にVLBのパラメータも更新されるようになります。

セットアップウィザードを使用したセットアップ方法

  1. アセットストアからVLBをダウンロードし、プロジェクトにインストールします
  2. メニューバーから Tools > Stage Light Maneuver > Integration Setup を選択します
  3. セットアップウィザードが表示されるので、Fix ALL をクリックしてください

Tip

1度の実行ではすべての設定が完了しない場合があります

その場合、再度 Fix ALL を実行してください

以下の画像のように、全てのステータスに緑のチェックマークがつけば設定は完了です

slm_wizard_all-green

Important

うまくいかない場合の対処

既知の問題として、VLB の削除や再インポートを行った場合に正常に動作しないことが確認されています

また、環境によっては正常に動作しない場合があります

以下の手順を行っても解決しない場合、手動でのセットアップを行ってください

  1. Edit > Project Settings > Player > Other Settings > Scripting Define Symbols を確認
  2. USE_VLB が設定されている場合は削除してください
  3. 削除完了後、 Unity を再起動してください

Contributor

Murasaqi
clocknote.
pon
RYUNOSUKE HIRAI
Kuyuri Iroha

Iridescent inc
TRIBALCON inc
Compositon inc

License

MIT License
Copyright (c) 2024 Murasaqi