SKSLスクリプト

SkiaSharp Shading Language (SKSL) シェーダーでカスタムフィルターエフェクトを定義します。Skia 上でピクセル単位のプログラムとして実行されます。

ライブラリでの場所

「ライブラリ」 → フィルターエフェクト → スクリプト → SKSLスクリプト

プロパティ

スクリプト (Script)

SKSL シェーダーのソース。

• 型: string
• 既定値:

  uniform shader src;
  uniform float progress;  // 0.0 - 1.0
  uniform float duration;  // seconds
  uniform float time;      // seconds
  uniform float width;     // render target width (device px)
  uniform float height;    // render target height (device px)
  // Also available:
  // uniform float2 iResolution;  // (width, height) in device px
  // uniform float  iScale;       // working density (device px per logical px)
  // uniform float  iTime;
  
  half4 main(float2 fragCoord) {
      half4 c = src.eval(fragCoord);
      return c;
  }

• アニメーション: 不可

使い方

main(float2 coord) → half4 のシェーダーを記述します。元レイヤーは src、アニメーション可能なパラメータは uniform として渡されます。

現在のピクセルの色だけを加工する場合は、half4 apply(half4 color) という形式も利用できます。入力色を受け取って出力色を返します。従来の main(float2) 形式も引き続き利用できます。

解像度スケーリング

Beutl は、プロジェクト解像度とは異なる作業密度でレンダリングすることがあります（縮小プレビューやスーパーサンプリングされた書き出しなど）。width / height / iResolution はその密度での出力全体の デバイスピクセル 寸法を表し、iScale は論理ピクセルあたりのデバイスピクセル数（作業密度）です（スケールなしのとき 1.0）。

正規化座標で動作するシェーダー（例: fragCoord / iResolution）は自動的に解像度非依存になり、変更は不要です。ピクセル単位の絶対値（固定の半径・オフセット・境界幅など）を使う場合は、iScale を掛けることでどの密度でも画面上の見た目の大きさを保てます。iScale を参照しないシェーダーは、スケール 1.0 のとき従来とまったく同じ結果になります。

ソース

src/Beutl.Engine/Graphics/FilterEffects/SKSLScriptEffect.cs