YMM4 Plugin

https://scrapbox.io/ymm4plugin
Admin
A documentation site that provides a beginner-friendly guide and information on how to create video...
Tokens:31,546
Snippets:217
Trust Score:10
Update:9 months ago
Show doc for...
Tokens:
Raw
### YMM4 Plugin Project Setup Reference

Source: https://scrapbox.io/ymm4plugin/index

Provides a reference for setting up a YMM4 plugin project, specifically focusing on adding necessary assembly references. This is a crucial step to ensure the plugin can interact with YMM4.

```text
#67c69ffef4155c0000c0d139
```

--------------------------------

### Specify YMM4 Directory for Development

Source: https://scrapbox.io/ymm4plugin/%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90%E3%83%BB%E8%A8%AD%E5%AE%9A

This XML file is used to specify the path to the YukkuriMovieMaker (YMM4) installation directory for development purposes. This allows Visual Studio to locate the necessary YMM4 executables and libraries for debugging and building plugins. Ensure the path is correctly set and ends with a backslash.

```xml
<Project>
  <PropertyGroup>
   <YMM4DirPath>C:\YMM4\</YMM4DirPath>
  </PropertyGroup>
</Project>
```

--------------------------------

### C# Scene ComboBox for Plugins

Source: https://scrapbox.io/ymm4plugin/%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8B%E3%82%89%E4%BD%BF%E3%81%88%E3%82%8B%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E4%B8%80%E8%A6%A7

Implements a ComboBox for selecting scenes in plugins. Uses System.ComponentModel.DataAnnotations for display attributes and a custom SceneComboBox attribute. Manages a Guid parameter representing the selected scene, defaulting to an empty Guid.

```csharp
using System.Collections.Immutable;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Controls;
using YukkuriMovieMaker.Controls.AvalonEdit.FoldingStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.AutoCompletionStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.ToolBarStrategy;
using YukkuriMovieMaker.Plugin;
using YukkuriMovieMaker.Plugin.Effects;
using YukkuriMovieMaker.Resources.Localization;

public class SceneComboBoxExample
{
    [Display(GroupName = "グループ名", Name = "項目名", Description = "項目の説明")]
    [SceneComboBox]
    public Guid ParameterName { get => parameterName; set => Set(ref parameterName, value); }
    Guid parameterName = Guid.Empty;

    // Assume Set method exists for property change notification
    protected virtual bool Set<T>(ref T field, T value)
    {
        if (EqualityComparer<T>.Default.Equals(field, value)) return false;
        field = value;
        return true;
    }
}
```

--------------------------------

### Basic C# Class Structure for YMM4 Plugins

Source: https://scrapbox.io/ymm4plugin/index

Demonstrates the fundamental structure of a C# class, which is the basic building block for YMM4 plugins. A typical plugin involves implementing at least two classes: VideoEffect and VideoEffectProcessor.

```csharp
class SampleClass
{
}
```

--------------------------------

### Namespace Declaration for Video Effect Plugins

Source: https://scrapbox.io/ymm4plugin/VideoEffect%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%AE%9F%E8%A3%85

Demonstrates the C# namespace declaration required for video effect plugins that inherit from VideoEffectBase. This setup is essential for organizing plugin code and ensuring compatibility with the YukkuriMovieMaker framework.

```csharp
using YukkuriMovieMaker.Plugin.Effects;

namespace VideoEffectPluginTutorial
{
}
```

--------------------------------

### YukkuriMovieMaker.dll Assembly and Namespace

Source: https://scrapbox.io/ymm4plugin/index

Details the core assembly and namespace required for YMM4 plugin development. This information is essential for referencing YMM4's core functionalities within your plugin code.

```text
Assembly: `YukkuriMovieMaker.dll`
Namespace: `YukkuriMovieMaker.Project.Effects`
```

--------------------------------

### C# Source File Extension

Source: https://scrapbox.io/ymm4plugin/index

States the standard file extension for C# source code files, which are used for developing YMM4 plugins. Understanding file extensions is fundamental for any programming task.

```text
Extension: `cs`
```

--------------------------------

### Applying VideoEffect Attribute in YMM4 Plugins

Source: https://scrapbox.io/ymm4plugin/index

Shows how to apply the VideoEffect attribute to a class, which is necessary for YMM4 to recognize it as a video effect plugin. This attribute defines essential properties for the effect.

```csharp
using YukkuriMovieMaker.Plugin.Effects;

namespace VideoEffectPluginTutorial
{
  // The VideoEffect attribute is applied here
  // Placeholder for actual attribute usage
  // public class MyEffect : VideoEffectBase
  // {
  // }
}
```

--------------------------------

### C# SimpleEffect.cs 最終コード

Source: https://scrapbox.io/ymm4plugin/%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AB%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E3%82%92%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B

映像エフェクトプラグインの`SimpleEffect.cs`ファイルの最終的なコード全体を示します。アニメーションスライダーとトグルコントロールが追加された状態です。このコードは、プラグインのUI要素の定義と、エフェクトプロセッサの作成方法を含んでいます。

```csharp
using System.ComponentModel.DataAnnotations;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Controls;
using YukkuriMovieMaker.Exo;
using YukkuriMovieMaker.Player.Video;
using YukkuriMovieMaker.Plugin.Effects;

namespace VideoEffectPluginTutorial
{
    [VideoEffect("シンプルエフェクト", ["サンプル"], ["simple effect"])]
    class SimpleEffect : VideoEffectBase
    {
        public override string Label => "シンプルエフェクト";

        [Display(GroupName = "描画位置", Name = "X座標", Description = "横方向の描画位置")]
        [AnimationSlider("F1", "px", -100, 100)]
        public Animation X { get; } = new Animation(0, -9999, 9999);

        [Display(GroupName = "描画位置", Name = "反転", Description = "描画位置を反転する")]
        [ToggleSlider]
        public bool Invert { get => invert; set => Set(ref invert, value); }
        bool invert = false;

        public override IEnumerable<string> CreateExoVideoFilters(int keyFrameIndex, ExoOutputDescription exoOutputDescription)
        {
            return [];
        }

        public override IVideoEffectProcessor CreateVideoEffect(IGraphicsDevicesAndContext devices)
        {
            return new SimpleEffectProcessor(devices, this);
        }

        protected override IEnumerable<IAnimatable> GetAnimatables() => [X];
    }
}
```

--------------------------------

### C# コンソール出力サンプル

Source: https://scrapbox.io/ymm4plugin/%E3%81%93%E3%81%AE%E3%82%B5%E3%82%A4%E3%83%88%E3%81%AE%E4%BD%BF%E3%81%84%E6%96%B9

C#で "YMM4Plugin" という文字列をコンソールに出力する基本的なコード例です。このコードは、プラグイン開発の初期段階で "Hello, World!" のような出力を確認するために使用できます。

```csharp
Console.WriteLine("YMM4Plugin");
```

--------------------------------

### EffectDescription Record in YMM4

Source: https://scrapbox.io/ymm4plugin/index

Defines the EffectDescription record, which is passed to the Update method of an IVideoEffectProcessor. It holds information about the item to which the effect is applied.

```csharp
record YukkuriMovieMaker.Player.Video.EffectDescription
{
  // Properties like item information would be defined here
}
```

--------------------------------

### DrawDescription Record for Drawing in YMM4

Source: https://scrapbox.io/ymm4plugin/index

Details the DrawDescription record, which contains drawing-related information such as position. This is used for rendering effects within YMM4.

```csharp
record YukkuriMovieMaker.Player.Video.DrawDescription
{
  Draw Vector3 // The XYZ drawing position
  CenterPoint Vector2 // The center position for text item flipping
}
```

--------------------------------

### C# トグルコントロールの追加

Source: https://scrapbox.io/ymm4plugin/%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AB%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E3%82%92%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B

映像エフェクトプラグインにトグルコントロールを追加するコード例です。描画位置の反転機能に使用されます。`Display`属性でUI上の表示を設定し、`ToggleSlider`属性でトグルとして機能するように定義します。このコントロールは`GetAnimatables`メソッドの変更を必要としません。

```csharp
[Display(GroupName = "描画位置", Name = "反転", Description = "描画位置を反転する")]
[ToggleSlider]
public bool Invert { get => invert; set => Set(ref invert, value); }
bool invert = false;
```

--------------------------------

### FrameTime Record for Time Information in YMM4

Source: https://scrapbox.io/ymm4plugin/index

Explains the FrameTime record, used to store time information in terms of frames and TimeSpan. This is crucial for time-based effects and animations.

```csharp
record YukkuriMovieMaker.Player.Video.FrameTime
{
  Frame int // Time in frames
  Time TimeSpan // Time as a TimeSpan object
}
```

--------------------------------

### 映像エフェクトプラグインの基本クラス実装 (C#)

Source: https://scrapbox.io/ymm4plugin/%E6%98%A0%E5%83%8F%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E4%BD%9C%E6%88%90%E5%85%A5%E9%96%80

映像エフェクトプラグインを作成するために最低限必要なVideoEffectクラスとVideoEffectProcessorクラスの実装例です。これらのクラスはプラグインの基本構造を定義します。No external dependencies are strictly required for this basic structure.

```csharp
public class VideoEffect : EffectParameter
{
    // VideoEffectクラスの実装
}

public class VideoEffectProcessor : EffectProcessor
{
    // VideoEffectProcessorクラスの実装
}
```

--------------------------------

### TimelineSourceUsage Enum in YMM4

Source: https://scrapbox.io/ymm4plugin/index

Describes the TimelineSourceUsage enumeration used in YMM4 to represent the state of preview or video output. This enum helps in managing playback and rendering states.

```csharp
enum YukkuriMovieMaker.Player.Video.TimelineSourceUsage
{
  Playing // Indicates preview playback is in progress
  // Other members would follow here
}
```

--------------------------------

### C# アニメーションスライダーの追加

Source: https://scrapbox.io/ymm4plugin/%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AB%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E3%82%92%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B

映像エフェクトプラグインにアニメーションスライダーを追加するコード例です。描画位置のX座標を制御するために使用されます。`Display`属性でUI上の表示を設定し、`AnimationSlider`属性でスライダーの挙動（範囲、単位など）を定義します。`GetAnimatables`メソッドでスライダーをプラグインに認識させます。

```csharp
[Display(GroupName = "描画位置", Name = "X座標", Description = "横方向の描画位置")]
[AnimationSlider("F1", "px", -100, 100)]
public Animation X { get; } = new Animation(0, -9999, 9999);
```

```csharp
protected override IEnumerable<IAnimatable> GetAnimatables() => [X];
```

--------------------------------

### DLL参照エラーの確認 (C#)

Source: https://scrapbox.io/ymm4plugin/%E6%98%A0%E5%83%8F%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E4%BD%9C%E6%88%90%E5%85%A5%E9%96%80

C#プロジェクトで映像エフェクトプラグイン開発中に発生しうる、DLL参照エラーの確認方法に関する説明です。原因と対策が示されており、プロジェクトに正しくDLLが追加されているかを確認することが重要です。

```csharp
// プロジェクトの参照設定を確認してください。
// "プロジェクトの作成・設定#67c69ffef4155c0000c0d139" を参照。
```

--------------------------------

### C# SimpleEffectProcessor クラス定義

Source: https://scrapbox.io/ymm4plugin/%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E5%80%A4%E3%82%92%E3%83%AD%E3%82%B8%E3%83%83%E3%82%AF%E3%81%A7%E4%BD%BF%E3%81%86

映像エフェクトの実際の処理を行うクラスです。コンストラクタでエフェクトの設定を受け取り、Input/Outputプロパティで画像データを扱います。

```csharp
using Vortice.Direct2D1;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Player.Video;

namespace VideoEffectPluginTutorial
{
    class SimpleEffectProcessor : IVideoEffectProcessor
    {
        readonly SimpleEffect item;
        ID2D1Image? input;

        public SimpleEffectProcessor(IGraphicsDevicesAndContext devices, SimpleEffect item)
        {
            this.item = item;
        }

        public ID2D1Image Output => input ?? throw new NullReferenceException(nameof(input) + " is null");

        public void ClearInput()
        {
            input = null;
        }
        
        public void Dispose()
        {
        }

        public void SetInput(ID2D1Image? input)
        {

```

--------------------------------

### C# Unformatted Opacity in Effect Plugin

Source: https://scrapbox.io/ymm4plugin/%E6%8F%8F%E7%94%BB%E4%BD%8D%E7%BD%AE%E4%BB%A5%E5%A4%96%E3%81%AE%E5%80%A4%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%99%E3%82%8B

C#で映像エフェクトの不透明度を設定するコード例です。不透明度は0.0から1.0の範囲で指定し、0.5は50%の不透明度を意味します。これはEffectDescriptionのOpacityプロパティを更新します。

```csharp
public DrawDescription Update(EffectDescription effectDescription)
{
    var opacity = 0.5;
 
    return effectDescription.DrawDescription with
    {
        Opacity = effectDescription.DrawDescription.Opacity * opacity
    };
}
```

--------------------------------

### プラグインの配布 (GitHubリポジトリ例)

Source: https://scrapbox.io/ymm4plugin/%E6%98%A0%E5%83%8F%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E4%BD%9C%E6%88%90%E5%85%A5%E9%96%80

作成したYMM4プラグインの配布方法に関する解説で、GitHubリポジトリの活用例が示されています。配布する際にはタグ付けが推奨されており、リポジトリのトピック設定が役立ちます。

```markdown
https://github.com/manju-summoner/YukkuriMovieMaker4PluginSamples#リポジトリのトピック
```

--------------------------------

### コントロールの値を利用したロジック実装 (C#)

Source: https://scrapbox.io/ymm4plugin/%E6%98%A0%E5%83%8F%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E4%BD%9C%E6%88%90%E5%85%A5%E9%96%80

映像エフェクトプラグインにおいて、追加したコントロール（例: スライダー）の値をロジックで使用し、描画位置などを動的に変更するC#コード例です。これにより、ユーザーの操作に応じてエフェクトが変化するようになります。コントロールの値はプロパティ経由でアクセスします。

```csharp
public override DrawDescription Update(EffectDescription effectDescription)
{
    var description = base.Update(effectDescription);
    // SliderValue を使用して描画位置などを変更
    description.PositionX = SliderValue;
    return description;
}
```

--------------------------------

### C# アニメーションスライダーの値を取得して描画位置に反映

Source: https://scrapbox.io/ymm4plugin/%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E5%80%A4%E3%82%92%E3%83%AD%E3%82%B8%E3%83%83%E3%82%AF%E3%81%A7%E4%BD%BF%E3%81%86

Updateメソッド内でアニメーションスライダーの値（X座標）を取得し、描画位置に加算します。スライダーの値はdouble型で取得されるため、float型に変換してから適用する必要があります。

```csharp
var frame = effectDescription.ItemPosition.Frame;
var length = effectDescription.ItemDuration.Frame;
var fps = effectDescription.FPS;

var x = item.X.GetValue(frame, length, fps);

return effectDescription.DrawDescription with
{
    Draw = new(
        effectDescription.DrawDescription.Draw.X + (float)x,
        effectDescription.DrawDescription.Draw.Y,
        effectDescription.DrawDescription.Draw.Z)
};

```

--------------------------------

### Configure .csproj for YMM4 Plugin Development

Source: https://scrapbox.io/ymm4plugin/%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90%E3%83%BB%E8%A8%AD%E5%AE%9A

This XML configuration sets up a .NET project for YMM4 plugin development. It specifies the target framework, enables implicit usings and nullable features, integrates WPF support, and configures source path mapping for debugging. It also includes references to necessary YMM4 and DirectX DLLs and defines a post-build event to copy the compiled DLL to the YMM4 plugin directory.

```xml
<Project Sdk="Microsoft.NET.Sdk">
 
 <PropertyGroup>
  <TargetFramework>net10.0-windows10.0.19041.0</TargetFramework>
  <ImplicitUsings>enable</ImplicitUsings>
  <Nullable>enable</Nullable>
  <UseWPF>true</UseWPF>
  
  <!--Pdb内にソースコードのフルパスを含めない-->
  <RepoRoot>$([System.IO.Path]::GetFullPath('$(MSBuildThisFileDirectory)..\'))</RepoRoot>
  <PathMap>$(RepoRoot)=.</PathMap>
 </PropertyGroup>
 
 <ItemGroup>
  <Reference Include="YukkuriMovieMaker.Controls">
   <HintPath>$(YMM4DirPath)YukkuriMovieMaker.Controls.dll</HintPath>
  </Reference>
  <Reference Include="YukkuriMovieMaker.Plugin">
   <HintPath>$(YMM4DirPath)YukkuriMovieMaker.Plugin.dll</HintPath>
  </Reference>
  <Reference Include="SharpGen.Runtime">
   <HintPath>$(YMM4DirPath)SharpGen.Runtime.dll</HintPath>
  </Reference>
  <Reference Include="SharpGen.Runtime.COM">
   <HintPath>$(YMM4DirPath)SharpGen.Runtime.COM.dll</HintPath>
  </Reference>
  <Reference Include="Vortice.Direct2D1">
   <HintPath>$(YMM4DirPath)Vortice.Direct2D1.dll</HintPath>
  </Reference>
  <Reference Include="Vortice.DirectX">
   <HintPath>$(YMM4DirPath)Vortice.DirectX.dll</HintPath>
  </Reference>
  <Reference Include="Vortice.Mathematics">
   <HintPath>$(YMM4DirPath)Vortice.Mathematics.dll</HintPath>
  </Reference>
 </ItemGroup>
 
 <!--ビルド後にYMM4のプラグインフォルダにdllをコピーする-->
 <Target Name="PostBuild" AfterTargets="PostBuildEvent">
   <Exec Command="mkdir &quot;$(YMM4DirPath)user\plugin\$(ProjectName)&quot; &gt; NUL 2&gt;&amp;1&#xD;&#xA;copy &quot;$(TargetPath)&quot; &quot;$(YMM4DirPath)user\plugin\$(ProjectName)&quot;" />
 </Target>
</Project>
```

--------------------------------

### C# Unformatted Zoom in Effect Plugin

Source: https://scrapbox.io/ymm4plugin/%E6%8F%8F%E7%94%BB%E4%BD%8D%E7%BD%AE%E4%BB%A5%E5%A4%96%E3%81%AE%E5%80%A4%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%99%E3%82%8B

C#で映像エフェクトの拡大率を設定するコード例です。XとY軸をまとめて、または個別に設定できます。Zoomプロパティはfloat型で、XとYの値を指定します。値0.5は50%の拡大率を意味します。

```csharp
public DrawDescription Update(EffectDescription effectDescription)
{
    var zoom = 0.5;
 
    return effectDescription.DrawDescription with
    {
        Zoom = effectDescription.DrawDescription.Zoom * (float)zoom
    };
}
```

```csharp
public DrawDescription Update(EffectDescription effectDescription)
{
    var zoomX = 0.5;
    var zoomY = 2.1;
 
    return effectDescription.DrawDescription with
    {
        Zoom = new(
            effectDescription.DrawDescription.Zoom.X * (float)zoomX,
            effectDescription.DrawDescription.Zoom.Y * (float)zoomY)
    };
}
```

--------------------------------

### C# トグルの値を取得して描画位置を反転

Source: https://scrapbox.io/ymm4plugin/%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E5%80%A4%E3%82%92%E3%83%AD%E3%82%B8%E3%83%83%E3%82%AF%E3%81%A7%E4%BD%BF%E3%81%86

Updateメソッド内でトグルの値（Invert）を取得し、その値に応じてX座標の値を反転させます。これにより、スライダーで設定した描画位置のプラスマイナスを反転させることができます。

```csharp
var frame = effectDescription.ItemPosition.Frame;
var length = effectDescription.ItemDuration.Frame;
var fps = effectDescription.FPS;

var x = item.X.GetValue(frame, length, fps);
var invert = item.Invert;

if (invert)
{
    x *= -1;
}

return effectDescription.DrawDescription with
{
    Draw = new(
        effectDescription.DrawDescription.Draw.X + (float)x,
        effectDescription.DrawDescription.Draw.Y,
        effectDescription.DrawDescription.Draw.Z)
};

```

--------------------------------

### 描画位置以外の値の変更 (C#)

Source: https://scrapbox.io/ymm4plugin/%E6%98%A0%E5%83%8F%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E4%BD%9C%E6%88%90%E5%85%A5%E9%96%80

映像エフェクトプラグインで、描画位置だけでなく拡大率や不透明度といった他のパラメータも変更するC#コード例です。これにより、より複雑で多様な映像効果を作成することが可能になります。DrawDescriptionクラスの他のプロパティを操作します。

```csharp
public override DrawDescription Update(EffectDescription effectDescription)
{
    var description = base.Update(effectDescription);
    // 拡大率や不透明度などを変更
    description.Scale = 1.5f;
    description.Opacity = 0.5f;
    return description;
}
```

--------------------------------

### Simplify DrawDescription Update (C#)

Source: https://scrapbox.io/ymm4plugin/%E3%81%9D%E3%81%AE%E4%BB%96%E3%81%AE%E6%9B%B8%E5%BC%8F%E9%96%A2%E4%BF%82

このコードスニペットは、effectDescription.DrawDescriptionへの冗長なアクセスを削減し、コードの可読性を向上させるC#の例です。varエイリアスを使用して、より簡潔な記述を実現します。

```csharp
public DrawDescription Update(EffectDescription effectDescription)
{
    var opacity = 0.5;
    var zoom = 1.2;
    var rotationZ = 95;

    var drawDesc = effectDescription.DrawDescription;

    return drawDesc with
    {
        Opacity = opacity,
        Zoom = drawDesc.Zoom * (float)zoom,
        Rotation = new(
            drawDesc.Rotation.X,
            drawDesc.Rotation.Y,
            drawDesc.Rotation.Z + rotationZ)
    };
}
```

--------------------------------

### エフェクトにロジックを追加 (C#)

Source: https://scrapbox.io/ymm4plugin/%E6%98%A0%E5%83%8F%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E4%BD%9C%E6%88%90%E5%85%A5%E9%96%80

作成した映像エフェクトプラグインに、描画位置の変更などのロジックを追加するC#コード例です。このコードは、エフェクトに動的な動作を実装するための基本的な構造を示します。Updateメソッド内でエフェクトのロジックを記述します。

```csharp
public override DrawDescription Update(EffectDescription effectDescription)
{
    // ロジックの実装
    return base.Update(effectDescription);
}
```

--------------------------------

### C# SimpleEffect クラス定義

Source: https://scrapbox.io/ymm4plugin/%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E5%80%A4%E3%82%92%E3%83%AD%E3%82%B8%E3%83%83%E3%82%AF%E3%81%A7%E4%BD%BF%E3%81%86

映像エフェクトプラグインのメインクラスです。X座標、Y座標のアニメーションスライダーと、描画位置反転用のトグルを定義しています。

```csharp
using System.ComponentModel.DataAnnotations;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Controls;
using YukkuriMovieMaker.Exo;
using YukkuriMovieMaker.Player.Video;
using YukkuriMovieMaker.Plugin.Effects;

namespace VideoEffectPluginTutorial
{
    [VideoEffect("シンプルエフェクト", ["サンプル"], ["simple effect"])]
    class SimpleEffect : VideoEffectBase
    {
        public override string Label => "シンプルエフェクト";

        [Display(GroupName = "描画位置", Name = "X座標", Description = "横方向の描画位置")]
        [AnimationSlider("F1", "px", -100, 100)]
        public Animation X { get; } = new Animation(0, -9999, 9999);

        [Display(GroupName = "描画位置", Name = "Y座標", Description = "縦方向の描画位置")]
        [AnimationSlider("F1", "px", -100, 100)]
        public Animation Y { get; } = new Animation(0, -9999, 9999);

        [Display(GroupName = "描画位置", Name = "反転", Description = "描画位置を反転する")]
        [ToggleSlider]
        public bool Invert { get => invert; set => Set(ref invert, value); }
        bool invert = false;

        public override IEnumerable<string> CreateExoVideoFilters(int keyFrameIndex, ExoOutputDescription exoOutputDescription)
        {
            return [];
        }

        public override IVideoEffectProcessor CreateVideoEffect(IGraphicsDevicesAndContext devices)
        {
            return new SimpleEffectProcessor(devices, this);
        }

        protected override IEnumerable<IAnimatable> GetAnimatables() => [X, Y];
    }
}

```

--------------------------------

### エフェクトにコントロールを追加 (C#)

Source: https://scrapbox.io/ymm4plugin/%E6%98%A0%E5%83%8F%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E4%BD%9C%E6%88%90%E5%85%A5%E9%96%80

映像エフェクトプラグインにスライダーなどのコントロールを追加し、ユーザーがエフェクトのパラメータを調整できるようにするC#コード例です。これにより、エフェクトの挙動を外部から制御可能になります。コントロールの追加には、EffectParameterクラスの継承や属性の使用が含まれます。

```csharp
// コントロールの追加例 (スライダー)
[Range(0, 100)]
public int SliderValue { get; set; }
```

--------------------------------

### Implementing IVideoEffectProcessor Interface Methods (C#)

Source: https://scrapbox.io/ymm4plugin/VideoEffectProcessor%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%AE%9F%E8%A3%85

This code snippet shows the implementation of the IVideoEffectProcessor interface methods within the SimpleEffectProcessor class. It includes setting up the Output property, handling input image clearing and setting, disposing resources, and updating the effect description for preview.

```csharp
using Vortice.Direct2D1;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Player.Video;

namespace VideoEffectPluginTutorial
{
    class SimpleEffectProcessor : IVideoEffectProcessor
    {
        readonly SimpleEffect item;
        ID2D1Image? input;

        public SimpleEffectProcessor(IGraphicsDevicesAndContext devices, SimpleEffect item)
        {
            this.item = item;
        }

        public ID2D1Image Output => input ?? throw new NullReferenceException(nameof(input) + " is null");

        public void ClearInput()
        {
            input = null;
        }

        public void Dispose()
        {
        }

        public void SetInput(ID2D1Image? input)
        {
            this.input = input;
        }

        public DrawDescription Update(EffectDescription effectDescription)
        {
            return effectDescription.DrawDescription;
        }
    }
}
```

--------------------------------

### C# Multiple Unformatted Properties in Effect Plugin

Source: https://scrapbox.io/ymm4plugin/%E6%8F%8F%E7%94%BB%E4%BD%8D%E7%BD%AE%E4%BB%A5%E5%A4%96%E3%81%AE%E5%80%A4%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%99%E3%82%8B

C#で映像エフェクトの複数のプロパティ（不透明度、拡大率、回転角）を同時に更新するコード例です。プロパティはカンマ区切りで複数指定できます。これにより、より複雑なエフェクトを効率的に実装できます。

```csharp
public DrawDescription Update(EffectDescription effectDescription)
{
    var opacity = 0.5;
    var zoom = 1.2;
    var rotationZ = 95;
 
    return effectDescription.DrawDescription with
    {
        Opacity = opacity,
        Zoom = effectDescription.DrawDescription.Zoom * (float)zoom,
        Rotation = new(
            effectDescription.DrawDescription.Rotation.X,
            effectDescription.DrawDescription.Rotation.Y,
            effectDescription.DrawDescription.Rotation.Z + rotationZ)
    };
}
```

--------------------------------

### VideoEffectクラスの抽象メソッド実装 (C#)

Source: https://scrapbox.io/ymm4plugin/VideoEffect%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%AE%9F%E8%A3%85

VideoEffectクラスの必須メソッド（Label, CreateExoVideoFilters, CreateVideoEffect, GetAnimatables）を実装します。これらのメソッドは、エフェクトの表示名、Exo出力設定、VideoEffectProcessorの生成、およびアニメーションスライダーの定義を担当します。

```csharp
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Exo;
using YukkuriMovieMaker.Player.Video;
using YukkuriMovieMaker.Plugin.Effects;

namespace VideoEffectPluginTutorial
{
    [VideoEffect("シンプルエフェクト", ["サンプル"], ["simple effect"])]
    class SimpleEffect : VideoEffectBase
    {
        public override string Label => "シンプルエフェクト";

        public override IEnumerable<string> CreateExoVideoFilters(int keyFrameIndex, ExoOutputDescription exoOutputDescription)
        {
            return [];
        }

        public override IVideoEffectProcessor CreateVideoEffect(IGraphicsDevicesAndContext devices)
        {
            return new SimpleEffectProcessor(devices, this);
        }

        protected override IEnumerable<IAnimatable> GetAnimatables() => [];
    }
}
```

--------------------------------

### C# Unformatted Invert in Effect Plugin

Source: https://scrapbox.io/ymm4plugin/%E6%8F%8F%E7%94%BB%E4%BD%8D%E7%BD%AE%E4%BB%A5%E5%A4%96%E3%81%AE%E5%80%A4%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%99%E3%82%8B

C#で映像エフェクトの左右反転を設定するコード例です。Invertプロパティはブール値で、trueにすると左右反転が有効になります。三項条件演算子を使用して、現在の設定を反転させることも可能です。

```csharp
public DrawDescription Update(EffectDescription effectDescription)
{
    var invert = true;
 
    return effectDescription.DrawDescription with
    {
        Invert = invert ? !effectDescription.DrawDescription.Invert : effectDescription.DrawDescription.Invert
    };
}
```

--------------------------------

### Adding Fields and Constructor to SimpleEffectProcessor (C#)

Source: https://scrapbox.io/ymm4plugin/VideoEffectProcessor%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%AE%9F%E8%A3%85

This code snippet adds the necessary fields and constructor to the SimpleEffectProcessor class to hold references to the SimpleEffect item and the input image. It initializes the class to be used within the Yukkuri Movie Maker plugin structure.

```csharp
using Vortice.Direct2D1;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Player.Video;

namespace VideoEffectPluginTutorial
{
    class SimpleEffectProcessor : IVideoEffectProcessor
    {
        readonly SimpleEffect item;
        ID2D1Image? input;

        public SimpleEffectProcessor(IGraphicsDevicesAndContext devices, SimpleEffect item)
        {
            this.item = item;
        }
    }
}
```

--------------------------------

### C# Unformatted Rotation in Effect Plugin

Source: https://scrapbox.io/ymm4plugin/%E6%8F%8F%E7%94%BB%E4%BD%8D%E7%BD%AE%E4%BB%A5%E5%A4%96%E3%81%AE%E5%80%A4%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%99%E3%82%8B

C#で映像エフェクトの回転角を設定するコード例です。X, Y, Z軸の回転角を度数法で指定します。RotationプロパティはVector3型で、各軸の回転値を加算して更新します。

```csharp
public DrawDescription Update(EffectDescription effectDescription)
{
    var rotationX = 50.5;
    var rotationY = -30.6;
    var rotationZ = 95.6;
 
    return effectDescription.DrawDescription with
    {
        Rotation = new(
            effectDescription.DrawDescription.Rotation.X + (float)rotationX,
            effectDescription.DrawDescription.Rotation.Y + (float)rotationY,
            effectDescription.DrawDescription.Rotation.Z + (float)rotationZ)
    };
}
```

--------------------------------

### C# クラス定義とメンバの例

Source: https://scrapbox.io/ymm4plugin/%E3%82%AF%E3%83%A9%E3%82%B9

C#におけるクラスの基本的な定義方法を示します。`class` キーワードを使用し、クラス名、フィールド（情報）、およびメソッド（動作）を定義します。この例では、`Name`という文字列フィールドと`ShowName`というコンソール出力メソッドを持つ`SampleClass`を定義しています。

```csharp
class SampleClass
{
    string Name = "まんじゅう";

    void ShowName()
    {
        Console.WriteLine(Name);
    }
}
```

--------------------------------

### Configuring VideoEffect Keywords

Source: https://scrapbox.io/ymm4plugin/VideoEffect%E5%B1%9E%E6%80%A7

Illustrates how to define search keywords for an effect using the third parameter of the VideoEffect attribute. Multiple keywords can be provided, or the list can be empty. The effect's name is also automatically used as a keyword.

```csharp
[VideoEffect("シンプルエフェクト", ["サンプル"], ["simple effect", "プラグイン"])]
```

```csharp
[VideoEffect("シンプルエフェクト", ["サンプル"], [])]
```

--------------------------------

### VideoEffectクラスの基本設定 (C#)

Source: https://scrapbox.io/ymm4plugin/VideoEffect%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%AE%9F%E8%A3%85

VideoEffectクラスの基本構造を定義し、映像エフェクトの名前、カテゴリ、検索ワードを設定します。この属性は、エフェクトがYukkuriMovieMakerにどのように表示され、検索されるかを決定します。

```csharp
using YukkuriMovieMaker.Plugin.Effects;

namespace VideoEffectPluginTutorial
{
    [VideoEffect("シンプルエフェクト", ["サンプル"], ["simple effect"])]
    class SimpleEffect : VideoEffectBase
    {
    }
}
```

--------------------------------

### TimelineSourceUsage Enum

Source: https://scrapbox.io/ymm4plugin/TimelineSourceUsage

Represents the state of preview and video export.

```APIDOC
## TimelineSourceUsage Enum

### Description
Represents the state of preview and video export.

### Members
- **Playing**: Preview playback in progress
- **Paused**: Preview paused
- **Exporting**: Video export in progress
```

--------------------------------

### Adding Fully Qualified Name for Console.WriteLine in C#

Source: https://scrapbox.io/ymm4plugin/%E5%9E%8B%E3%81%BE%E3%81%9F%E3%81%AF%E5%90%8D%E5%89%8D%E7%A9%BA%E9%96%93%E3%81%AE%E5%90%8D%E5%89_2bc30f_%93%E3%81%A8%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%97%E3%81%A6%E3%81%8F%E3%81%A0%E3%81%95%E3%81%84%29

Demonstrates how to use the fully qualified name for Console.WriteLine to resolve potential 'using' directive issues. This approach avoids the need for a specific 'using System;' directive.

```csharp
System.Console.WriteLine("");
```

--------------------------------

### Configuring VideoEffect Categories

Source: https://scrapbox.io/ymm4plugin/VideoEffect%E5%B1%9E%E6%80%A7

Shows how to set effect categories using the second parameter of the VideoEffect attribute. Multiple categories can be assigned, or the list can be left empty.

```csharp
[VideoEffect("シンプルエフェクト", ["サンプル", "さんぷる"], ["simple effect"])]
```

```csharp
[VideoEffect("シンプルエフェクト", [], ["simple effect"])]
```

--------------------------------

### Applying the VideoEffect Attribute in C#

Source: https://scrapbox.io/ymm4plugin/VideoEffect%E5%B1%9E%E6%80%A7

Demonstrates how to apply the VideoEffect attribute to a class inheriting from VideoEffectBase. This attribute registers the effect with YukkuriMovieMaker, specifying its name, categories, and search keywords.

```csharp
using YukkuriMovieMaker.Plugin.Effects;

namespace VideoEffectPluginTutorial
{
    [VideoEffect("シンプルエフェクト", ["サンプル"], ["simple effect"])]
    class SimpleEffect : VideoEffectBase
    {
        // ... effect implementation ...
    }
}
```

--------------------------------

### Update Method Signature for Effect Description

Source: https://scrapbox.io/ymm4plugin/%E3%81%BE%E3%81%A8%E3%82%81%EF%BC%88%E3%82%B7%E3%83%B3%E3%83%97%E3%83%AB%E3%81%AA%E3%82%A8%E3%83%95%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90%EF%BC%89

This C# code snippet shows the signature of the `Update` method within the `DrawDescription` class, which is responsible for updating the effect description. It takes an `EffectDescription` object as input and returns an updated `EffectDescription` object.

```csharp
public DrawDescription Update(EffectDescription effectDescription)
```

--------------------------------

### Video DrawDescription Properties

Source: https://scrapbox.io/ymm4plugin/DrawDescription

This section describes the properties available for the DrawDescription object, which stores information about video effects applied to items.

```APIDOC
## Properties of YukkuriMovieMaker.Player.Video.DrawDescription

### Description
Represents the drawing properties for video elements, including position, scaling, rotation, and opacity.

### Method
N/A (Object properties)

### Endpoint
N/A (Object properties)

### Parameters
#### Object Properties
- **Draw** (Vector3) - Description of the drawing position XYZ.
- **CenterPoint** (Vector2) - Description of the center point for horizontal flipping of text items.
- **Zoom** (Vector2) - Description of the zoom level in the XY plane.
- **Rotation** (Vector3) - Description of the rotation angles in XYZ.
- **Camera** (Matrix4x4) - Description of the camera matrix.
- **ZoomInterpolationMode** (InterpolationMode) - Description of the interpolation mode for zoom.
- **Opacity** (double) - Description of the opacity level.
- **Invert** (bool) - Description of whether horizontal flipping is enabled.
- **Controllers** (ImmutableList<VideoEffectController>) - Description of controllable points available in the preview.

### Request Example
N/A (Object properties)

### Response
#### Success Response (N/A - Object properties)
- **Draw** (Vector3) - The XYZ coordinates of the drawing position.
- **CenterPoint** (Vector2) - The center point for horizontal flipping.
- **Zoom** (Vector2) - The XY zoom factors.
- **Rotation** (Vector3) - The XYZ rotation angles.
- **Camera** (Matrix4x4) - The camera transformation matrix.
- **ZoomInterpolationMode** (InterpolationMode) - The interpolation method used for zoom.
- **Opacity** (double) - The transparency level (0.0 to 1.0).
- **Invert** (bool) - True if horizontal flipping is applied, false otherwise.
- **Controllers** (ImmutableList<VideoEffectController>) - A list of objects that allow manipulation of effect parameters in the preview.

#### Response Example
N/A (Object properties)
```

--------------------------------

### C# GetAnimatables Method for Multiple Properties

Source: https://scrapbox.io/ymm4plugin/%E3%82%A2%E3%83%8B%E3%83%A1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%B9%E3%83%A9%E3%82%A4%E3%83%80%E3%83%BC

Demonstrates how to return multiple animatable properties from the `GetAnimatables` method. Properties are comma-separated within the collection.

```csharp
protected override IEnumerable<IAnimatable> GetAnimatables() => [Name, Name2, Name3];
```

--------------------------------

### SimpleEffectProcessor Class Implementation in C#

Source: https://scrapbox.io/ymm4plugin/VideoEffectProcessor%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%AE%9F%E8%A3%85

This C# code defines the SimpleEffectProcessor class, which inherits from IVideoEffectProcessor. It includes methods for managing input image, clearing it, disposing resources, and updating the drawing description based on the effect.

```csharp
public SimpleEffectProcessor(IGraphicsDevicesAndContext devices, SimpleEffect item)
        {
            this.item = item;
        }

        public ID2D1Image Output => input ?? throw new NullReferenceException(nameof(input) + " is null");

        public void ClearInput()
        {
            input = null;
        }

        public void Dispose()
        {
        }

        public void SetInput(ID2D1Image? input)
        {
            this.input = input;
        }

        public DrawDescription Update(EffectDescription effectDescription)
        {
            return effectDescription.DrawDescription;
        }
    }
}
```

--------------------------------

### C# Directory Selector for Plugins

Source: https://scrapbox.io/ymm4plugin/%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8B%E3%82%89%E4%BD%BF%E3%81%88%E3%82%8B%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E4%B8%80%E8%A6%A7

Implements a directory selection control for plugin properties. Uses System.ComponentModel.DataAnnotations for display attributes and a custom DirectorySelector attribute. Manages a string parameter for the selected directory path.

```csharp
using System.Collections.Immutable;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Controls;
using YukkuriMovieMaker.Controls.AvalonEdit.FoldingStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.AutoCompletionStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.ToolBarStrategy;
using YukkuriMovieMaker.Plugin;
using YukkuriMovieMaker.Plugin.Effects;
using YukkuriMovieMaker.Resources.Localization;

public class DirectorySelectorExample
{
    [Display(GroupName = "グループ名", Name = "項目名", Description = "項目の説明")]
    [DirectorySelector]
    public string ParameterName { get => parameterName; set => Set(ref parameterName, value); }
    string parameterName = "";

    // Assume Set method exists for property change notification
    protected virtual bool Set<T>(ref T field, T value)
    {
        if (EqualityComparer<T>.Default.Equals(field, value)) return false;
        field = value;
        return true;
    }
}
```

--------------------------------

### C# Audio Spectrum Type ComboBox for Plugins

Source: https://scrapbox.io/ymm4plugin/%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8B%E3%82%89%E4%BD%BF%E3%81%88%E3%82%8B%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E4%B8%80%E8%A6%A7

Provides a ComboBox for selecting audio spectrum types in plugins. Uses System.ComponentModel.DataAnnotations for display attributes and a custom AudioSpectrumTypeComboBox attribute. Manages a Type parameter, defaulting to the primary IAudioSpectrumPlugin type.

```csharp
using System.Collections.Immutable;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Controls;
using YukkuriMovieMaker.Controls.AvalonEdit.FoldingStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.AutoCompletionStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.ToolBarStrategy;
using YukkuriMovieMaker.Plugin;
using YukkuriMovieMaker.Plugin.Effects;
using YukkuriMovieMaker.Resources.Localization;

public class AudioSpectrumTypeComboBoxExample
{
    [Display(GroupName = "グループ名", Name = "項目名", Description = "項目の説明")]
    [AudioSpectrumTypeComboBox]
    public Type ParameterName { get => parameterName; set => Set(ref parameterName, value); }
    Type parameterName = PluginLoader.GetPrimaryPluginType<YukkuriMovieMaker.Plugin.Shape.IAudioSpectrumPlugin>();

    // Assume Set method exists for property change notification
    protected virtual bool Set<T>(ref T field, T value)
    {
        if (EqualityComparer<T>.Default.Equals(field, value)) return false;
        field = value;
        return true;
    }
}
```

--------------------------------

### Enabling AviUtl Support Indicator

Source: https://scrapbox.io/ymm4plugin/VideoEffect%E5%B1%9E%E6%80%A7

Demonstrates how to explicitly show the YMM4-only mark in the effect addition screen by setting 'IsAviUtlSupported' to 'false' in the VideoEffect attribute. Note: Setting this to false enables the mark, indicating it is YMM4 specific.

```csharp
[VideoEffect("シンプルエフェクト", ["サンプル"], ["simple effect"], IsAviUtlSupported = false)]
```

--------------------------------

### C# Text Editor for Plugins

Source: https://scrapbox.io/ymm4plugin/%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8B%E3%82%89%E4%BD%BF%E3%81%88%E3%82%8B%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E4%B8%80%E8%A6%A7

Implements a multi-line text editor control for plugin properties. Uses System.ComponentModel.DataAnnotations for display attributes and a custom TextEditor attribute, which can configure properties like AcceptsReturn. Manages a string parameter.

```csharp
using System.Collections.Immutable;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Controls;
using YukkuriMovieMaker.Controls.AvalonEdit.FoldingStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.AutoCompletionStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.ToolBarStrategy;
using YukkuriMovieMaker.Plugin;
using YukkuriMovieMaker.Plugin.Effects;
using YukkuriMovieMaker.Resources.Localization;

public class TextEditorExample
{
    [Display(GroupName = "グループ名", Name = "項目名", Description = "項目の説明")]
    [TextEditor(AcceptsReturn = true)]
    public string ParameterName { get => parameterName; set => Set(ref parameterName, value); }
    string parameterName = "";

    // Assume Set method exists for property change notification
    protected virtual bool Set<T>(ref T field, T value)
    {
        if (EqualityComparer<T>.Default.Equals(field, value)) return false;
        field = value;
        return true;
    }
}
```

--------------------------------

### C# File Selector for Plugins

Source: https://scrapbox.io/ymm4plugin/%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8B%E3%82%89%E4%BD%BF%E3%81%88%E3%82%8B%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%E4%B8%80%E8%A6%A7

Provides a file selection control for plugin properties. Uses System.ComponentModel.DataAnnotations for display attributes and a custom FileSelector attribute, which can specify the file group type. Manages a string parameter for the selected file path.

```csharp
using System.Collections.Immutable;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations;
using YukkuriMovieMaker.Commons;
using YukkuriMovieMaker.Controls;
using YukkuriMovieMaker.Controls.AvalonEdit.FoldingStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.AutoCompletionStrategy;
using YukkuriMovieMaker.Controls.AvalonEdit.ToolBarStrategy;
using YukkuriMovieMaker.Plugin;
using YukkuriMovieMaker.Plugin.Effects;
using YukkuriMovieMaker.Resources.Localization;

public class FileSelectorExample
{
    [Display(GroupName = "グループ名", Name = "項目名", Description = "項目の説明")]
    [FileSelector(YukkuriMovieMaker.Settings.FileGroupType.ImageItem)]
    public string ParameterName { get => parameterName; set => Set(ref parameterName, value); }
    string parameterName = "";

    // Assume Set method exists for property change notification
    protected virtual bool Set<T>(ref T field, T value)
    {
        if (EqualityComparer<T>.Default.Equals(field, value)) return false;
        field = value;
        return true;
    }
}
```

--------------------------------

### Implement Toggle Slider with C# in YMM4Plugin

Source: https://scrapbox.io/ymm4plugin/%E3%83%88%E3%82%B0%E3%83%AB%E3%82%B9%E3%83%A9%E3%82%A4%E3%83%80%E3%83%BC

This snippet demonstrates how to use the `[ToggleSlider]` attribute in C# to create a boolean toggle control. It includes setting group name, display name, and description for the property. The initial value of the toggle can also be configured. This is intended for use within the YMM4Plugin's PropertyEditor.

```csharp
[Display(GroupName = "グループ名", Name = "名前", Description = "項目の説明")]
[ToggleSlider]
public bool Toggle { get => toggle; set => Set(ref toggle, value); }
bool toggle = false;
```
Tokens:
Raw