<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 26.0.0 -",
    "watchOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Symbols",
  "identifier" : "/documentation/Symbols/DrawOnSymbolEffect",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Symbols"
    ],
    "preciseIdentifier" : "s:7Symbols18DrawOnSymbolEffectV"
  },
  "title" : "DrawOnSymbolEffect"
}
-->

# DrawOnSymbolEffect

A symbol effect that applies the DrawOn animation to symbol images.

```
struct DrawOnSymbolEffect
```

## Overview

The DrawOn animation makes the symbol visible either as a whole, or
one motion group at a time, animating parts of the symbol with draw data.

## Topics

### Instance Properties

[`var byLayer: DrawOnSymbolEffect`](/documentation/Symbols/DrawOnSymbolEffect/byLayer)

Returns a copy of the effect requesting an animation that
applies separately to each motion group.

[`var configuration: SymbolEffectConfiguration`](/documentation/Symbols/DrawOnSymbolEffect/configuration)

The configuration for the effect.

[`var individually: DrawOnSymbolEffect`](/documentation/Symbols/DrawOnSymbolEffect/individually)

Returns a copy of the effect requesting an animation that
applies separately to each motion group, where only
one motion group is active at a time.

[`var wholeSymbol: DrawOnSymbolEffect`](/documentation/Symbols/DrawOnSymbolEffect/wholeSymbol)

Returns a copy of the effect requesting an animation that
applies to all motion groups simultaneously.

## Relationships

### Conforms To

[`Escapable`](/documentation/Swift/Escapable)

[`IndefiniteSymbolEffect`](/documentation/Symbols/IndefiniteSymbolEffect)

[`Hashable`](/documentation/Swift/Hashable)

[`TransitionSymbolEffect`](/documentation/Symbols/TransitionSymbolEffect)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Copyable`](/documentation/Swift/Copyable)

[`Sendable`](/documentation/Swift/Sendable)

[`SymbolEffect`](/documentation/Symbols/SymbolEffect)

[`Equatable`](/documentation/Swift/Equatable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)