<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -",
    "tvOS: 17.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 10.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Symbols",
  "identifier" : "/documentation/Symbols/NSSymbolScaleEffect",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Symbols"
    ],
    "preciseIdentifier" : "c:objc(cs)NSSymbolScaleEffect"
  },
  "title" : "NSSymbolScaleEffect"
}
-->

# NSSymbolScaleEffect

A type that scales the layers in a symbol-based image separately or as a whole.

```
@interface NSSymbolScaleEffect : NSSymbolEffect
```

## Overview

A scale animation draws attention to a symbol by changing the symbol’s scale indefinitely. You can choose to scale the symbol up or down.

## Topics

### Accessing symbol effects

[`effect`](/documentation/Symbols/NSSymbolScaleEffect/effect)

An animation that scales the layers in a symbol-based image separately or as a whole.

[`scaleDownEffect`](/documentation/Symbols/NSSymbolScaleEffect/scaleDownEffect)

An effect that scales the symbol down.

[`scaleUpEffect`](/documentation/Symbols/NSSymbolScaleEffect/scaleUpEffect)

An effect that scales the symbol up.

### Determining effect scope

[`effectWithByLayer`](/documentation/Symbols/NSSymbolScaleEffect/effectWithByLayer)

An effect that scales each layer separately.

[`effectWithWholeSymbol`](/documentation/Symbols/NSSymbolScaleEffect/effectWithWholeSymbol)

An effect that scales all layers simultaneously.


---

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)