rewrite-parameters

name	rewrite-parameters
description	Rewrite Parameters from AviUtl1 to AviUtl2
targets	["*"]

rewrite-paramters

AviUtl1から2の更新点として、パラメーターの拡張があります。 このプロジェクトでは、AviUtl1の制限の都合でかなり制限されたパラメーターをAviUtl2で制約がなくなったパラメーターに書き換えることを目的としています。

前提知識：パラメーターの種類

track

スライダーとして指定できるパラメーター。

---$track:表示名
---min=最小値
---max=最大値
---step=刻み値（1/0.1/0.01/0.001）
local param1 = 0 -- デフォルト値

check

チェックボックスとして指定できるパラメーター。

---$check:表示名
local param2 = false -- デフォルト値。0または1をデフォルトにすると数値が代入されるようになる。

value

Luaの値として指定するパラメーター。

---$value:表示名
local param3 = 0 -- デフォルト値

---$value:表示名
local param4 = ""

---$value:表示名
local param5 = { 0, 0 }

color

色を指定するパラメーター。

---$color:表示名
local param6 = 0xFFFFFF -- デフォルト値。`nil`をデフォルトにすると「選択なし」を指定できるようになる。

select

選択肢から選ぶパラメーター。

---$select:表示名
---option1=0
---option2=1
---option3=2
local param7 = 0 -- デフォルト値

group

パラメーターをグループ化するためのパラメーター。グループ化されたパラメーターは、AviUtlのパラメーターウィンドウで折りたたむことができます。

--group:グループ名,デフォルトの展開状態（true/false）

---$track:パラメーター1
---min=0
---max=100
---step=1
local param1 = 0

--group:グループ2,false

---$check:パラメーター2
local param2 = false

--group:
--^グループの終端

（今のところ、あまりUIがよくないため、指示された時以外はグループ化はしないでください）

valueからtrackへの書き換え

AviUtl1ではスライダーとして指定できるパラメーター（track）が4つまでしか作成できず、それ以外のパラメーターはLuaの値（value）の数値として指定する必要がありました。 AviUtl2ではこの制限がなくなったため、AviUtl1でvalueとして指定されていたパラメーターのうち、スライダーのほうが適しているものをtrackに書き換えます。

例えば、以下のようなコードがあったとします。

---$value:幅
local param1 = 0

このコードは、AviUtl1では幅を指定するパラメーターをLuaの値として指定していましたが、AviUtl2ではスライダーとして指定できるようになったため、以下のように書き換えます。

---$track:幅
---min=0
---max=1000
---step=1
local param1 = 0

min/max/stepの値は、パラメーターの内容に応じて適切な値を指定してください。

value・trackからselectへの書き換え

AviUtl1では、選択肢から選ぶパラメーター（select）が作成できなかったため、選択肢をLuaの値（value）やスライダー（track）の数値として指定する必要がありました。 AviUtl2では選択肢から選ぶパラメーターが作成できるようになったため、AviUtl1でvalueやtrackとして指定されていたパラメーターのうち、選択肢から選ぶほうが適しているものをselectに書き換えます。

例えば、以下のようなコードがあったとします。

---$value:モード[1-3]
local param1 = 1

このコードは、AviUtl1ではモードを指定するパラメーターをLuaの値として指定していましたが、AviUtl2では選択肢から選ぶパラメーターが作成できるようになったため、以下のように書き換えます。

---$select:モード
---モードA=1
---モードB=2
---モードC=3
local param1 = 1

このように、AviUtl1でvalueやtrackとして指定されていたパラメーターのうち、選択肢から選ぶほうが適しているものをselectに書き換えることで、より直感的なパラメーターを作成することができます。

valueからcolorへの書き換え

AviUtl1では、色を指定するパラメーター（color）が作成できなかったため、色をLuaの値（value）の数値として指定する必要がありました。 AviUtl2では色を指定するパラメーターが作成できるようになったため、AviUtl1でvalueとして指定されていたパラメーターのうち、色を指定するほうが適しているものをcolorに書き換えます。

例えば、以下のようなコードがあったとします。

---$value:色
local param1 = 0xFFFFFF

このコードは、AviUtl1では色を指定するパラメーターをLuaの値として指定していましたが、AviUtl2では色を指定するパラメーターが作成できるようになったため、以下のように書き換えます。

---$color:色
local param1 = 0xFFFFFF

このように、AviUtl1でvalueとして指定されていたパラメーターのうち、色を指定するほうが適しているものをcolorに書き換えることで、より直感的なパラメーターを作成することができます。

名前の変更

AviUtl1ではパラメーターの名前の表示域が狭かったため、パラメーターに半角カタカナを使用することが一般的でした。 AviUtl2ではパラメーターの名前の表示域が広くなったため、パラメーターの名前を全角で書き換えることができます。

例えば、以下のようなコードがあったとします。

---$track:ｶﾀｶﾅ
---min=0
---max=100
---step=1
local param1 = 0

このコードは、AviUtl1ではパラメーターの名前に半角カタカナを使用していましたが、AviUtl2ではパラメーターの名前の表示域が広くなったため、以下のように書き換えます。

---$track:カタカナ
---min=0
---max=100
---step=1
local param1 = 0

このように、AviUtl1でパラメーターの名前に半角カタカナを使用していたものを全角で書き換えることで、より見やすいパラメーターを作成することができます。

名前被りの修正

AviUtl1では、パラメーターを変数名で区別していました：

---$value:値
local param1 = 0

---$value:値
local param2 = 0

AviUtl2では、パラメーターの名前で区別するようになったため、同じ名前のパラメーターが複数存在することができなくなりました。 そのため、AviUtl1で同じ名前のパラメーターが複数存在していた場合は、AviUtl2では名前を変更する必要があります。

例えば、以下のようなコードがあったとします。

---$value:値
local param1 = 0
---$value:値
local param2 = 0

このコードは、AviUtl1では同じ名前のパラメーターが複数存在していましたが、AviUtl2では同じ名前のパラメーターが複数存在できないため、以下のように書き換えます。

---$value:値1
local param1 = 0
---$value:値2
local param2 = 0

また、このようなケース以外は、パラメーターの名前を変更する必要はありません。