<!--
{
  "availability" : [
    "macOS: 10.4.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Quartz",
  "identifier" : "/documentation/Quartz/IKFilterBrowserPanel",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Quartz"
    ],
    "preciseIdentifier" : "c:objc(cs)IKFilterBrowserPanel"
  },
  "title" : "IKFilterBrowserPanel"
}
-->

# IKFilterBrowserPanel

Presents a user interface for browsing filters.

```
class IKFilterBrowserPanel
```

## Overview

The `IKFilterBrowserPanel` class provides a user interface that allows users to browse Core Image filters (<doc://com.apple.documentation/documentation/CoreImage/CIFilter-swift.class>), to preview a filter, and to get additional information about the filter, such as its description.

An `IKFilterBrowserPanel` object can be displayed as:

- a separate panel, that is, a utility window that floats on top of document windows
- a modal dialog
- a sheet, that is, a dialog that is attached to its parent window and must be dismissed by the user
- a view that an application can insert into a custom user  interface

An `IKFilterBrowserPanel` object can be configured through a style mask to use either the default or brushed metal look for windows. The size and number of visible controls are specified through an options dictionary. An `IKFilterBrowserPanel` object communicates selection changes through notifications.

The `IKFilterBrowserPanel` class allows the user to create filter collections that are stored with the `filterCollections` key in the `com.apple.CoreImageKit.plist` property list located in `~/Library/Preferences/`.

## Topics

### Getting a Filter Name

[`-  filterName`](/documentation/Quartz/IKFilterBrowserPanel/filterName())

Returns the name of the  filter that is currently selected in the filter browser.

### Displaying and Running the Panel

[`-  filterBrowserViewWithOptions:`](/documentation/Quartz/IKFilterBrowserPanel/filterBrowserView(options:))

Returns a view that contains a filter browser.

[`-  beginWithOptions:modelessDelegate:didEndSelector:contextInfo:`](/documentation/Quartz/IKFilterBrowserPanel/begin(options:modelessDelegate:didEnd:contextInfo:))

Displays the filter browser in a new utility window, unless the filter browser is already open.

[`-  beginSheetWithOptions:modalForWindow:modalDelegate:didEndSelector:contextInfo:`](/documentation/Quartz/IKFilterBrowserPanel/beginSheet(options:modalFor:modalDelegate:didEnd:contextInfo:))

Displays the filter browser in a sheet—that is, a dialog that is attached to its parent window and must be dismissed by the user.

[`-  runModalWithOptions:`](/documentation/Quartz/IKFilterBrowserPanel/runModal(options:))

Displays the filter browser in a modal dialog that must be dismissed by the user but that is not  attached to a window.

[`-  finish:`](/documentation/Quartz/IKFilterBrowserPanel/finish(_:))

Closes a filter browser view.

### Creating a Filter Browser Panel

[`+  filterBrowserPanelWithStyleMask:`](/documentation/Quartz/IKFilterBrowserPanel/filterBrowserPanel(withStyleMask:))

Creates a shared instance of the `IKFilterBrowserPanel` class.

### Constants

[Filter Browser Option Keys](/documentation/Quartz/filter-browser-option-keys)

Keys for filter browser options.

### Notifications

[`IKFilterBrowserWillPreviewFilterNotification`](/documentation/Quartz/IKFilterBrowserWillPreviewFilterNotification)

Posted before showing a filter preview, allowing an application to set the parameters of a filter.

[`IKFilterBrowserFilterSelectedNotification`](/documentation/Quartz/IKFilterBrowserFilterSelectedNotification)

Posted when the user clicks a filter name in the filter browser.

[`IKFilterBrowserFilterDoubleClickNotification`](/documentation/Quartz/IKFilterBrowserFilterDoubleClickNotification)

Posted when the user double-clicks a filter in the filter browser.

## Relationships

### Conforms To

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

[`NSTouchBarProvider`](/documentation/AppKit/NSTouchBarProvider)

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

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

[`NSAccessibilityProtocol`](/documentation/AppKit/NSAccessibilityProtocol)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`NSUserInterfaceItemIdentification`](/documentation/AppKit/NSUserInterfaceItemIdentification)

[`NSAccessibilityElementProtocol`](/documentation/AppKit/NSAccessibilityElementProtocol)

[`NSUserInterfaceValidations`](/documentation/AppKit/NSUserInterfaceValidations)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`NSMenuItemValidation`](/documentation/AppKit/NSMenuItemValidation)

[`NSStandardKeyBindingResponding`](/documentation/AppKit/NSStandardKeyBindingResponding)

[`NSAnimatablePropertyContainer`](/documentation/AppKit/NSAnimatablePropertyContainer)

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

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

[`NSAppearanceCustomization`](/documentation/AppKit/NSAppearanceCustomization)

[`NSUserActivityRestoring`](/documentation/AppKit/NSUserActivityRestoring)

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

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

### Inherits From

[`NSPanel`](/documentation/AppKit/NSPanel)

---

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)