カスタムエフェクト
確認記録:Umoupen 0.9.51 build 540(2026-08-27) · 確認範囲
カスタムエフェクトは、画像の各ピクセルを処理するプログラム(シェーダー)を自分で記述する効果です。レイヤーエフェクトとして選択レイヤーへ適用します。コード内で公開した設定値は、効果パネルから調整できます。
場所: レイヤーパネル → Effect/Custom Effect
最小の変更で試す
Section titled “最小の変更で試す”- 対象レイヤーを選び、効果で
Custom Effectを追加します。 Edit Effect Sourceを開きます。- コードに設定値を追加、または既存の設定値を変更します。
- 適用を押します。
- エラーがなく、選択レイヤーのエフェクトが更新されたことを確認します。
- 効果パネルに公開された設定値を動かし、コードを開き直さずに見た目を調整します。
エラーが出たとき
Section titled “エラーが出たとき”- 表示された箇所とメッセージを確認します。
- 型、名前、配列の長さ、初期値の個数を一つずつ確認します。
- 修正後にもう一度適用を押します。
- 前回の有効な状態から更新されたことを確認します。
無効なコードは選択レイヤーへ反映されません。エラーを修正してから、もう一度適用を押します。
| 項目 | 働き |
|---|---|
| texture0 | 入力となるレイヤー画像 |
| uv | 0〜1のピクセル座標 |
| param | 効果パネルへ操作を公開 |
| 解像度/time | レイヤーの大きさとタイムライン上の時刻 |
| Effect Parameter | 公開したfloat/vec4の値を調整 |
配列の設定値
Section titled “配列の設定値”カスタムエフェクトの設定値には、配列を使えます。配列は効果パネルで折りたたみ可能な一組の操作として表示され、各要素を個別に調整できます。
| 型 | 上限 |
|---|---|
| float配列 | 合計32個のfloat値 |
| vec4配列 | 合計8個のvec4値 |
配列の長さと初期値はコード内へ固定値で記述し、型、長さ、初期値の個数を一致させます。
変化がないとき
Section titled “変化がないとき”| 確認する場所 | 確認内容 |
|---|---|
| 対象レイヤー | 効果をかけるレイヤーが選択されているか |
| エフェクト | 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-26 | Umoupen 0.9.59 build 611 | Effect Parameterの説明の「フローティング表示」をfloatへ訂正(英語版の校閲で見つかった日本語正本の誤り) |
| 2026-09-02 | Umoupen 0.9.51 build 540 | 最小の設定値から適用する手順、エラーの直し方、反映されない場合の確認順を追加 |
| 2026-08-27 | Umoupen 0.9.51 build 540 | カスタムエフェクトのfloat/vec4配列と上限を追加 |
| 2026-08-26 | Umoupen 0.9.50 build 534 | 関連記事を追加し、検索と確認時点の派生表示に対応 |
| 2026-08-24 | Umoupen 0.9.49 build 530 | 組込み日本語翻訳表に登録された表示名を本文へ反映 |
| 2026-08-23 | Umoupen 0.9.49 build 530 | 説明文と記事名を日本語中心に整理し、現行画面の英語表示名は操作表記と検索語に維持 |
| 2026-08-23 | Umoupen 0.9.49 build 530 | 画面上の場所を冒頭へ追加 |
| 2026-08-23 | Umoupen 0.9.49 build 530 | 初版作成 |
組込み翻訳
| 日本語表示 | build 530の英語キー |
|---|---|
| 適用 | Apply |
| 効果 | Effects |
| レイヤー | Layers |