Unity_StageLightManeuver

KO | EN

gitlite — search

#python #go #android #rust #docker #nodejs #macos #java #windows #awesome #cli #pytorch #ios #open-source

Unity_StageLightManeuver

(★ 120)

No description available.

Unity_StageLightManeuver Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Unity StageLightManeuver

> [!Note]
> インストール用URLはこちら
> ```
> https://github.com/murasaqi/Unity_StageLightManeuver.git?path=/jp.iridescenet.stagelightmaneuver
> ```

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

![Overview](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/69f82e8a-3115-4442-8db2-5d69b145a264)

## インストール
#### 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
* [Volumetric Light Beam](https://assetstore.unity.com/packages/vfx/shaders/volumetric-light-beam-99888)の制御に対応しています。
    * Volumetric Light Beamと連携するには別途Assembly Definitionの設定が必要です。
    * 詳細については [Volumetric Light Beamとの連携](#volumetric-light-beamとの連携) を参照してください

## 機能例

- Timelineから複数灯体の一括制御が可能
    - 大量のライトを一元管理しながら効率的にライト演出を作成できます。
    - グループごとに演出をつけることもできます。

![feature_overview](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/f3426147-89bc-4f57-a68b-8e6f8d9499b0)

- TimelineClipからチャンネルに応じたプロパティを設定することで、効率的に照明演出を設計できます
    - Intensity, Color, Pan/Tilt, Gobo をはじめとした 20以上のプロパティが用意されています
    - チャンネルの組み合わせで用途に合わせた灯体を作成することができます
    - クリップをブレンドにも対応しています
    
        ![property](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/90de445d-baab-45a7-bcf8-d9681a950523)
        > Light, Pan/Tilt Property 単体の動作と組み合わせた際の動作
        
        ![clip_blend](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/690e6683-dece-4a5e-b7f5-9ea2b7462cfa)
        > クリップのブレンドによるライト消灯

- TimelineClipをProfileとして保存し、クリップ間でパラメータの同期が可能です
- [VolumetricLightBeam](https://assetstore.unity.com/packages/vfx/shaders/volumetric-light-beam-99888)と連携させることが可能です（後述）
    ![link_vlb](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/b3ada0a7-3cc6-4b11-87a0-d719b5d7e266)

## プリセット灯体

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

| Light Type | File Name | RenderPipeLine | Rendering Image |
|:-----------|:----------|:--------------:|:---------------:|
| LED Strobe | `SLM_LEDStrobe_URP.prefab` | URP | <img src="https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/9ec8d8da-bb7d-4592-b10d-e672d2564feb" width="64"> |
| Moving Beam Light | `SLM_MovingBeamLight_URP.prefab` | URP | <img src="https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/748592c8-13c9-46a2-8706-4f44d19fd7c4" width="64"> |
| Moving Beam Light | `SLM_MovingBeamLight_URP_VLB_HD.prefab` | URP | <img src="https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/748592c8-13c9-46a2-8706-4f44d19fd7c4" width="64"> |
| Moving Beam Light | `SLM_MovingBeamLight_URP_VLB_SD.prefab` | URP | <img src="https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/748592c8-13c9-46a2-8706-4f44d19fd7c4" width="64"> |
| Moving Wash Light | `SLM_MovingWashLight_URP.prefab` | URP | <img src="https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/5bbdb09e-9554-43a9-ad40-7bf0e0941d3c" width="64"> |
| Moving Wash Light | `SLM_MovingWashLight_URP_VLB.prefab` | URP | <img src="https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/5bbdb09e-9554-43a9-ad40-7bf0e0941d3c" width="64"> |
| Rotating Wash Light | `SLM_RotatingWashLight_URP.prefab` | URP | <img src="https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/f2a705c5-4260-4ccc-8a56-caf522ec8975" width="64"> |
| Rotating Wash Light | `SLM_RotatingWashLight_URP_VLB.prefab` | URP | <img src="https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/f2a705c5-4260-4ccc-8a56-caf522ec8975" width="64"> |

## 使い方

### **クイックスタート**
 [tutorial](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/acd11990-80a2-4ea1-ba1c-964e0ed2a19a)
 
以下にプリセット灯体を用いたタイムラインからの灯体制御例を示します。
この例では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`から追加したい機能を選択します
          <blockquote><details><summary>参考</summary>
              ![fixture_ui](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/a1569ee6-a03a-4816-a3c3-6e57f765664f)
          </details></blockquote>
    
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](https://github.com/user-attachments/assets/648a0909-e9a3-4e34-bde1-f7fdec81d04d)

<details><summary>手動でのセットアップ方法</summary>

1. アセットストアからVLBをインストール後 VLBのフォルダに`com.saladgamer.volumetriclightbeam`という名前の Assembly Definition を作成してください
    * プラットフォーム設定はAnyに設定します
    * URPを使用する場合、`com.saladgamer.volumetriclightbeam`ファイルの設定内にあるAssembly Definition References に`Unity.RenderPipelines.Universal.Runtime` を設定してください
                       ![vlb_asmdef_refurp](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/73a2ae12-f58a-422d-9290-47e82f9a9f8d)
        
    ![vlb_asmdef](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/92ee03d3-1b7a-4f88-a50e-363dfd3a6dc6)

2. Assembly Definition の設置後、VLBのフォルダをPackagesフォルダ以下に移動してください
    
    ![move_vlb](https://github.com/murasaqi/Unity_StageLightManeuver/assets/49616225/e4c89bea-7b2e-486f-9f29-bf92387cc524)
    
3. 以降VLBがついた灯体をStage Light Maneuverで制御すると、自動的にVLBのパラメータも更新されるようになります。

</details>

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

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

> [!TIP]
>
> 1度の実行ではすべての設定が完了しない場合があります
>
> その場合、再度 `Fix ALL` を実行してください
>
> 以下の画像のように、全てのステータスに緑のチェックマークがつけば設定は完了です
>
> ![slm_wizard_all-green](https://github.com/user-attachments/assets/97c39dfc-79ac-4b0b-acc3-24b83e2362ed)

> [!IMPORTANT]
>
> **うまくいかない場合の対処**
>
> 既知の問題として、VLB の削除や再インポートを行った場合に正常に動作しないことが確認されています
>
> また、環境によっては正常に動作しない場合があります
>
> 以下の手順を行っても解決しない場合、手動でのセットアップを行ってください
>
> 1. `Edit` > `Project Settings` > `Player` > `Other Settings` > `Scripting Define Symbols` を確認
> 2. `USE_VLB` が設定されている場合は削除してください
> 3. 削除完了後、 Unity を再起動してください

## Contributor

[Murasaqi](https://github.com/murasaqi)  
[clocknote.](https://github.com/clocknote)  
[pon](https://github.com/AJpon)  
[RYUNOSUKE HIRAI](https://github.com/Hirai0827)  
[Kuyuri Iroha](https://github.com/kuyuri-iroha)

Iridescent inc  
TRIBALCON inc  
Compositon inc

## License

Unity_StageLightManeuver

Unity_StageLightManeuver Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Unity_StageLightManeuver

Unity_StageLightManeuver Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README