Skip to content

sigma-axis/aviutl2_script_GroundShadow2_S

BranchesTags

Repository files navigation

GroundShadow2_S AviUtl/AviUtl ExEdit2 スクリプト

影を立体的に地面へ落とすアニメーション効果 / フィルタ効果．地面だけでなく壁や天井など任意角度の平面に影を落とせます．GroundShadow_S の拡張版です (変更点はこちら).

無印の AviUtl と AviUtl ExEdit2 の両方に対応しています．

ダウンロードはこちら． 紹介動画．

使用例1

使用例2

  • イラスト: 琴葉茜 琴葉葵 (c) AI Inc.

動作要件

AviUtl (無印)

AviUtl ExEdit2

導入方法

  • AviUtl (無印) の場合

    以下のフォルダのいずれかに GroundShadow2_S.anm, GroundShadow2_S.lua, GroundShadow2_S.frag の 3 つのファイルをコピーしてください．

    1. exedit.auf のあるフォルダにある script フォルダ
    2. (1) のフォルダにある任意の名前のフォルダ

  • AviUtl ExEdit2 の場合

    GroundShadow2_S.anm2 ファイル対して，以下のいずれかの操作をしてください．

    1. AviUtl2 のプレビュー画面にドラッグ&ドロップ．

    2. 以下のフォルダのいずれかにコピー．

      1. スクリプトフォルダ
        • AviUtl2 のメニューの「その他」 ➡️ 「アプリケーションデータ」 ➡️ 「スクリプトフォルダ」で表示されます．
      2. (1) のフォルダにある任意の名前のフォルダ

    初期状態だと「フィルタ効果を追加」メニューの「装飾」に GroundShadow2_S が追加されています．

    • 「オブジェクト追加メニューの設定」の「ラベル」項目で分類を変更できます．

パラメタの説明

AviUtl (無印) 版では AviUtl ExEdit2 版と比べてパラメタの並びが異なっていたり，一部がパラメタ設定ダイアログ経由での設定になりますが，特記事項がない限り基本的には同じ機能です．

AviUtl (無印) 版のGUI AviUtl (無印) 版のパラメタ設定ダイアログ

AviUtl ExEdit2 版のGUI

地面位置

影を落とす “地面” の位置を指定します．ここで指定した座標を通り，「地面角度」と「回転」で指定した角度の平面に影を落とします．プレビューのアンカーをドラッグすることでも調整できます．

  • 緑のアンカー線を操作することで指定できます．

    • オブジェクトが “地面” に接する点にアンカーを置くことで “地面に立っている” ような表現ができます．オブジェクトから離すと “地面から浮いている” ように見えます．

    • AviUtl (無印) の場合，オブジェクトに拡大率や回転などが設定されていると，アンカー位置を正しく取得できない場合があります．

  • 座標は 3 次元で指定します．オブジェクトと平行で，オブジェクトの奥にある平面などに影を投射することもできます．

オブジェクトの中心からの相対座標で {<X座標>, <Y座標>, <Z座標>} とピクセル単位で記述します．初期値は {0,200,0}.

地面角度

影を落とす先の “地面” の仰角を指定します．「回転」が 0 の場合，カメラ視点を基準として次のように決まります:

負の値 0 正の値
下り坂 水平 上り坂

単位は度数法で最小値は -180, 最大値は 180, 初期値は 0.

光源角度 / 光源傾斜

光の入射角を指定します．「回転」が 0 の場合，「光源角度」で上下方向が，「光源傾斜」で左右方向が，カメラ視点を基準として次のように決まります:

パラメタ 負の値 0 正の値
「光源角度」 上から下 手前から奥への水平方向 下から上
「光源傾斜」 右から左 左右にまっすぐ 左から右

「光源角度」の単位は度数法で最小値は -180, 最大値は 180, 初期値は -45.

「光源傾斜」は傾斜量 (角度の正接 ($\tan$ 関数) の値) の % 単位で，最小値は -800 (約 $-82.87\degree$), 最大値は 800 (約 $82.87\degree$), 初期値は 0.

回転

影を落とす先の「地面」の回転角を指定します．回転軸は $z$ 軸方向 (手前から奥への方向) で，時計回りに正．これに連動して，「光源角度」や「光源傾斜」で指定した “光源” の角度も回転します．

単位は度数法で最小値は -720, 最大値は 720, 初期値は 0.

「カメラ位置」

立体射影を計算する際の，カメラ位置の $x, y$ 座標を指定します．プレビューのアンカーをドラッグすることでも調整できます．

  • 青いアンカー線を操作することで指定できます．

    • オブジェクトに拡大率や回転などが設定されていた場合，アンカー位置を正しく取得できない場合があります．

オブジェクトの中心からの相対座標で {<X座標>, <Y座標>} とピクセル単位で記述します．初期値は {0,-200}.

視野幅

立体射影を計算する際の，カメラの視野角を調整します．単位は % で，視野角の正接 ($\tan$ 関数の値) の割合で指定します．

  • 大きくすると立体感が強くなり，遠くの影がさらに小さく，近くの影はさらに大きくなります．
  • 小さくすると立体感が弱くなり，遠くの影と近くの影の大きさに違いが出にくくなります．
  • 0 を指定すると直投影 (orthographic projection) な描画ができます．

最小値は 0, 最大値は 10000, 初期値は 100.

影色

影の色を指定します．初期値は 000000 (黒).

影色強さ

「影色」を適用する強さ指定します．0 だと元オブジェクトと同じ色で影を描画します．

単位は % で最小値は 0, 最大値は 100, 初期値は 100.

影の濃さ

影の不透明度を指定します．

単位は % で最小値は 0, 最大値は 100, 初期値は 50.

前景透明度

影の元となるオブジェクトの透明度を指定します．

単位は % で最小値は 0, 最大値は 100, 初期値は 0.

光拡散 / 境界ぼかし

影のぼかし方を指定します．

  • 「光拡散」は光源の入射角のブレ量で，オブジェクトと “地面” に映る影との距離が長いほどぼかし量が大きくなります．

  • 「境界ぼかし」は元画像にそのままかけるぼかし量で，“地面” との距離に依存しません．

「光拡散」は拡散角度の正接 ($\tan$ 関数の値) の % 単位で，最小値は 0, 最大値は 70 (約 $\pm 35\degree$), 初期値は 5 (約 $\pm 2.867\degree$).

「境界ぼかし」はピクセル単位で最小値は 0, 最大値は 500, 初期値は 4.

影の範囲

「地面位置」で指定した $x, y$ 座標 に近い部分のみを影の描画対象にします．描画対象の範囲を「地面位置」からの距離で指定，0 を指定すると現在オブジェクト全てが描画対象になります．

ピクセル単位で指定し最小値は 0, 最大値は 4000, 初期値は 0.

先端ぼかし

「影の範囲」が 0 以外の場合にのみ有効で，描画範囲の先端部分の不透明度を距離に応じて減衰させます．

薄くなる部分の距離をピクセル単位で指定．最小値は 0, 最大値は 2000, 初期値は 0.

影位置移動

影の描画位置を平行移動で動かします．プレビューのアンカーをドラッグすることでも調整できます．

  • 線のついていないアンカーを操作することで指定できます．

    • AviUtl (無印) の場合，オブジェクトに拡大率や回転などが設定されていると，アンカー位置を正しく取得できない場合があります．

{<X移動量>, <Y移動量>} の書式でピクセル単位で記述します．初期値は {0,0} (移動なし).

精度

「光拡散」の計算の精度を指定します．数値が大きいほど滑らかな描画結果になりますが動作が遅くなります．シェーダープログラム内での繰り返し回数の上限値で，奇数の平方のうち指定値を超えない最大数が実効的な値です．

最小値は 1, 初期値は 529.

AviUtl ExEdit2 版だと，最大値は 9801.

画像最大幅 / 画像最大高さ

AviUtl ExEdit2 版のみにある設定です．AviUtl (無印) 版では，環境設定の最大画像サイズに固定です．

フィルタ効果後の画像の最大サイズをピクセル単位で指定します．

  • 光源と地面の角度の組み合わせによっては，理論上の計算結果が現実的には扱えない画像サイズになることがあるため，予め上限を設定しておく必要があります．初期状態だと $2000 \times 2000$ のサイズを最大想定にしています．
  • この値を大きくする場合，system.conf ファイル内の [Config] 以下，TemporaryImageCacheSize の項目の見直しも検討してください．max_w と max_h の積が TemporaryImageCacheSize の半分未満に収まる程度がサイズ限界の目安です．
  • フィルタオブジェクトとして使用した場合，この設定は無視されます (常にシーンの画面サイズに相当する値).

最小値は 1024, 最大値は 16384, 初期値は 2000.

PI

パラメタインジェクション (parameter injection) です．各種パラメタを Lua の数式で直接指定できます．また，任意のスクリプトコードを実行する記述領域にもなります．

AviUtl (無印) 版と AviUtl ExEdit2 版で指定方法が異なります．

AviUtl (無印) 版の PI

初期値は nil. テーブル型を指定すると obj.track0 などの代替値として使用されます．

{
  [1] = track0, -- number 型で "地面角度" の項目を上書き，または nil.
  [2] = track1, -- number 型で "光源角度" の項目を上書き，または nil.
  [3] = track2, -- number 型で "光源傾斜" の項目を上書き，または nil.
  [4] = track3, -- number 型で "回転" の項目を上書き，または nil.
}

AviUtl ExEdit2 版の PI

テーブル型の中身として解釈され，各種パラメタの代替値として使用されます．初期値は空欄．

{
  ground_pos = { x, y, z },    -- table 型で "地面位置" の項目を上書き，または nil.
  ground_angle = ground_angle, -- number 型で "地面角度" の項目を上書き，または nil.
  light_angle = light_angle,   -- number 型で "光源角度" の項目を上書き，または nil.
  light_slope = light_slope,   -- number 型で "光源傾斜" の項目を上書き，または nil.
  rotation = rotation,         -- number 型で "回転" の項目を上書き，または nil.
  camera_pos = { x, y },       -- table 型で "カメラ位置" の項目を上書き，または nil.
  camera_fov = camera_fov,     -- number 型で "視野幅" の項目を上書き，または nil.
  col = col,                   -- number 型で "影色" の項目を上書き，または nil.
  col_alpha = col_alpha,       -- number 型で "影色強さ" の項目を上書き，または nil.
  alpha = alpha,               -- number 型で "影の濃さ" の項目を上書き，または nil.
  front_alpha = front_alpha,   -- number 型で "前景透明度" の項目を上書き，または nil.
  conic_blur = conic_blur,     -- number 型で "光分散" の項目を上書き，または nil.
  edge_blur = edge_blur,       -- number 型で "境界ぼかし" の項目を上書き，または nil.
  len = len,                   -- number 型で "影の範囲" の項目を上書き，または nil.
  tip_blur = tip_blur,         -- number 型で "先端ぼかし" の項目を上書き，または nil.
  pos = { x, y },              -- table 型で "影位置移動" の項目を上書き，または nil.,
  quality = quality,           -- number 型で "精度" の項目を上書き，または nil.
  max_w = max_w,               -- number 型で "画像最大幅" の項目を上書き，または nil.
  max_h = max_h,               -- number 型で "画像最大高さ" の項目を上書き，または nil.
}
  • テキストボックスには冒頭末尾の波括弧 ({}) を省略して記述してください．

GroundShadow_S からの変更点

GroundShadow_S からの変更点は以下の通りです．

TIPS

  1. AviUtl 無印版の場合，テキストエディタで GroundShadow2_S.anm, GroundShadow2_S.lua, GroundShadow2_S.frag を開くと冒頭付近にファイルバージョンが付記されています．

    --
-- VERSION: v1.05
--

    ファイル間でバージョンが異なる場合，更新漏れの可能性があるためご確認ください．

改版履歴

  • v1.05 (for beta25) (2025-12-22)

    • AviUtl2 版でパラメタ「精度」「画像最大幅」「画像最大高さ」を追加．

      • パラメタインジェクション経由のみの指定だったのを，独立のパラメタに分離．
      • それに伴って，パラメタインジェクションの初期値を空欄に変更．

    • AviUtl2 版でフィルタオブジェクトとして使えるように設定．

    • AviUtl2 beta25 で動作確認．

  • v1.04 (for beta22a) (2025-12-05)

    • AviUtl2 版でパラメタをグループ化して整理．

    • AviUtl2 beta22a で動作確認．

  • v1.03 (for beta20) (2025-11-17)

    • AviUtl2 版でのシェーダー処理を一部簡略化．

    • AviUtl2 beta20 で動作確認．

  • v1.02 (for beta12) (2025-09-25)

    • AviUtl (無印) 版で 影色強さ が低いとき，影の上下左右端の 1 ピクセル幅が黒っぽくなることがあったのを修正．

    • AviUtl2 beta12 で動作確認．

  • v1.01 (for beta11a) (2025-09-20)

    • AviUtl (無印) 版で，エラーメッセージが間違っていたのを修正．

    • AviUtl2 beta11a で動作確認．

  • v1.00 (for beta5) (2025-08-10)

    • 初版．

ライセンス

このプログラムの利用・改変・再頒布等に関しては MIT ライセンスに従うものとします．

The MIT License (MIT)

Copyright (C) 2025 sigma-axis

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

https://mit-license.org/

連絡・バグ報告

About

影を立体的に平面へ落とすAviUtl/AviUtl2スクリプト．

www.nicovideo.jp/watch/sm45275176

Topics

aviutl aviutl-script aviutl2 aviutl2-script

Resources

Readme

License

MIT license
Activity

Stars

4 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases 6

v1.05-for-beta25 (2025-12-22) Latest
Dec 22, 2025
+ 5 releases

Packages

No packages published

Languages