<!--
{
  "availability" : [
    "macCatalyst: -",
    "macOS: 10.3.0 - 14.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSShowAnimationEffect",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:@F@NSShowAnimationEffect"
  },
  "title" : "NSShowAnimationEffect"
}
-->

# NSShowAnimationEffect

Runs a system animation effect.

```
extern void NSShowAnimationEffect(NSAnimationEffect animationEffect, NSPoint centerLocation, NSSize size, id animationDelegate, SEL didEndSelector, void *contextInfo);
```

## Parameters

`animationEffect`

The type of animation you want to apply.

`centerLocation`

The location at which to show the animated image, specified in screen coordinates. The animation is centered on the point you specify.

`size`

The desired size of the animated image. Specify <doc://com.apple.documentation/documentation/Foundation/NSZeroSize> to perform the animation at the default size.

`animationDelegate`

The object to notify when the animation completes. Specify `nil` if you do not need to be notified when the animation completes.

`didEndSelector`

The selector of `animationDelegate` to call when the animation completes. Specify `nil` if you do not need to be notified when the animation completes. If you specify a selector, the corresponding method should have the following signature:

```objc
    - (void)animationEffectDidEnd:(void *)contextInfo;
```

`contextInfo`

A pointer to any optional information you want passed as a parameter to the selector in the `didEndSelector` parameter.

## Discussion

This function runs one of the standard system animation effects, which includes display and sound. For example, you can use this function to display the puff of smoke effect. For a complete list of animation effects, see [`NSAnimationEffect`](/documentation/AppKit/NSAnimationEffect).

---

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)