Skip to content

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

  1. Select the target layer and add Custom Effect under Effects.
  2. Open Edit Effect Source.
  3. Add parameters to the code or change existing ones.
  4. Press Apply.
  5. Confirm that there is no error and that the effect on the selected layer was updated.
  6. Adjust the exposed control in the Effects panel without reopening the code.
  1. Read the reported location and message.
  2. Check the type, name, array length, and number of initial values one at a time.
  3. Press Apply again after correcting the code.
  4. 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.

OptionWhat it does
texture0The layer image used as input.
uvPixel coordinates from 0 to 1.
paramExposes a control in the Effects panel.
resolution / timeLayer dimensions and the current Timeline time.
Effect ParameterAdjusts an exposed float or vec4 value.

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.

TypeLimit
float array32 float values in total.
vec4 array8 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.

Where to checkWhat to check
Target layerThe layer that should receive the effect is selected.
EffectCustom Effect and the Effect Stack are enabled.
CodeYou pressed Apply after editing and no error remains.
ParameterIts value is not still equal to the initial value.
ArrayThe total stays within 32 float values or 8 vec4 values.
  • 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