---
title: cumulative
framework: symbols
role: symbol
role_heading: Instance Property
path: symbols/variablecolorsymboleffect/cumulative
---

# cumulative

An effect that enables each layer of a symbol-based image in sequence.

## Declaration

```swift
var cumulative: VariableColorSymbolEffect { get }
```

## Discussion

Discussion This effect enables each successive variable layer, and the layer remains enabled until the end of the animation cycle. This effect cancels the iterative variant.

## See Also

### Controlling fill style

- [iterative](symbols/variablecolorsymboleffect/iterative.md)