Default value

empty list

This var is a list of graphical filters to use for post-processing effects, applied in order. You can assign this value a list, an individual filter, or null to empty it.

obj/blurry
    filters = filter(type="blur", size=1)

Atoms with the KEEP_TOGETHER flag will apply their filters after the composite image has been drawn. Filters will also apply to any maptext the atom has.

See the filters section for more information on individual filters.

Named Filters

Filters can be created with a name argument. That name can be used to access the filter in the list (e.g. filters["drunk_blur"] instead of using a numeric index, which is helpful for managing animations and updating multiple filters on an object.

Adding a new filter with the same name as an existing filter will remove the old one, since only one of a given filter name can be used on an appearance at a time.

You can also remove a named filter from the list simply by subtracting the name instead of the filter itself. That is, filters -= filters["foo"] and filters -= "foo" do the same thing.

See also