コンテンツにスキップ

カスタムエフェクト

確認記録:Umoupen 0.9.51 build 540(2026-08-27) · 確認範囲

カスタムエフェクトは、画像の各ピクセルを処理するプログラム(シェーダー)を自分で記述する効果です。レイヤーエフェクトとして選択レイヤーへ適用します。コード内で公開した設定値は、効果パネルから調整できます。

場所: レイヤーパネル → Effect/Custom Effect

  1. 対象レイヤーを選び、効果でCustom Effectを追加します。
  2. Edit Effect Sourceを開きます。
  3. コードに設定値を追加、または既存の設定値を変更します。
  4. 適用を押します。
  5. エラーがなく、選択レイヤーのエフェクトが更新されたことを確認します。
  6. 効果パネルに公開された設定値を動かし、コードを開き直さずに見た目を調整します。
  1. 表示された箇所とメッセージを確認します。
  2. 型、名前、配列の長さ、初期値の個数を一つずつ確認します。
  3. 修正後にもう一度適用を押します。
  4. 前回の有効な状態から更新されたことを確認します。

無効なコードは選択レイヤーへ反映されません。エラーを修正してから、もう一度適用を押します。

項目働き
texture0入力となるレイヤー画像
uv0〜1のピクセル座標
param効果パネルへ操作を公開
解像度/timeレイヤーの大きさとタイムライン上の時刻
Effect Parameter公開したfloat/vec4の値を調整

カスタムエフェクトの設定値には、配列を使えます。配列は効果パネルで折りたたみ可能な一組の操作として表示され、各要素を個別に調整できます。

型上限
float配列合計32個のfloat値
vec4配列合計8個のvec4値

配列の長さと初期値はコード内へ固定値で記述し、型、長さ、初期値の個数を一致させます。

確認する場所確認内容
対象レイヤー効果をかけるレイヤーが選択されているか
エフェクトCustom EffectとエフェクトスタックがONか
コード編集後に適用を押したか、エラーが残っていないか
設定値初期値と同じ値のままになっていないか
配列floatは合計32値、vec4は合計8値の上限内か
  • 現行実装から確認:カスタムエフェクト設定値の配列を折りたたみ可能な操作群として生成し、floatは合計32値、vec4は合計8値まで扱う処理。
  • 公式案内から確認:0.9.51の更新告知にエフェクトのarray type対応が記載されています。
  • 未確認:build 540の効果パネル表示、配列を使った効果の適用結果。
  • 証拠記録:F-20260827-001、F-20260827-002

変更履歴

日付対象バージョン変更内容
2026-10-17概念説明の補足(動作の再検証なし)用語の意味と関連概念の説明先を日英で補足
2026-10-11—操作対象と結果が伝わるよう本文・画像説明を見直し、曖昧な表現と重複説明を整理。英語版も同期。(仕様の再確認なし)
2026-09-26Umoupen 0.9.59 build 611Effect Parameterの説明の「フローティング表示」をfloatへ訂正(英語版の校閲で見つかった日本語正本の誤り)
2026-09-02Umoupen 0.9.51 build 540最小の設定値から適用する手順、エラーの直し方、反映されない場合の確認順を追加
2026-08-27Umoupen 0.9.51 build 540カスタムエフェクトのfloat/vec4配列と上限を追加
2026-08-26Umoupen 0.9.50 build 534関連記事を追加し、検索と確認時点の派生表示に対応
2026-08-24Umoupen 0.9.49 build 530組込み日本語翻訳表に登録された表示名を本文へ反映
2026-08-23Umoupen 0.9.49 build 530説明文と記事名を日本語中心に整理し、現行画面の英語表示名は操作表記と検索語に維持
2026-08-23Umoupen 0.9.49 build 530画面上の場所を冒頭へ追加
2026-08-23Umoupen 0.9.49 build 530初版作成

組込み翻訳

日本語表示build 530の英語キー
適用Apply
効果Effects
レイヤーLayers