Custom effects
Verification record: Umoupen 0.9.51 build 540 (2026-08-27) · Verification scope
A custom effect uses a shader, a program you write to process image pixels. Apply it to the selected layer as a layer effect. Parameters exposed in the code can be adjusted in the Effects panel.
Location: Layers panel → Effect / Custom Effect
Test the smallest change first
Section titled “Test the smallest change first”- Select the target layer and add
Custom Effectunder Effects. - Open
Edit Effect Source. - Add parameters to the code or change existing ones.
- Press Apply.
- Confirm that there is no error and that the effect on the selected layer was updated.
- Adjust the exposed control in the Effects panel without reopening the code.
If an error appears
Section titled “If an error appears”- Read the reported location and message.
- Check the type, name, array length, and number of initial values one at a time.
- Press Apply again after correcting the code.
- Confirm that the effect changed from the previous valid state.
Invalid code is not applied to the selected layer. Correct the errors, then press Apply again.
Main options
Section titled “Main options”| Option | What it does |
|---|---|
| texture0 | The layer image used as input. |
| uv | Pixel coordinates from 0 to 1. |
| param | Exposes a control in the Effects panel. |
| resolution / time | Layer dimensions and the current Timeline time. |
| Effect Parameter | Adjusts an exposed float or vec4 value. |
Array parameters
Section titled “Array parameters”Custom effect parameters can use arrays. An array appears in the Effects panel as a collapsible group of controls, and each element can be adjusted separately.
| Type | Limit |
|---|---|
| float array | 32 float values in total. |
| vec4 array | 8 vec4 values in total. |
Write the array length and initial values as constants in the code. The type, length, and number of initial values must match.
If no change is visible
Section titled “If no change is visible”| Where to check | What to check |
|---|---|
| Target layer | The layer that should receive the effect is selected. |
| Effect | Custom Effect and the Effect Stack are enabled. |
| Code | You pressed Apply after editing and no error remains. |
| Parameter | Its value is not still equal to the initial value. |
| Array | The total stays within 32 float values or 8 vec4 values. |
Related articles
Section titled “Related articles”Verification
Section titled “Verification”- Verified from the current implementation: The implementation generates custom-effect array parameters as collapsible control groups and supports up to 32 float values or 8 vec4 values in total.
- Verified from official information: The 0.9.51 update announcement describes array-type support for effects.
- Unverified: The build 540 Effects panel, results of applying an effect that uses arrays, and the Windows version.
- Evidence records: F-20260827-001, F-20260827-002