<!--
{
  "availability" : [
    "FxPlug: 4.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "professional_video_applications",
  "identifier" : "/documentation/professional_video_applications/FxTileableEffect/properties(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Professional Video Applications"
    ],
    "preciseIdentifier" : "c:objc(pl)FxTileableEffect(im)properties:error:"
  },
  "title" : "properties(_:)"
}
-->

# properties(_:)

Tells the host application about what the plug-in needs and supports, such as whether it renders in a gamma-corrected color space or a linear one.

```
func properties(_ properties: AutoreleasingUnsafeMutablePointer<NSDictionary>?) throws
```

## Parameters

`properties`

An <doc://com.apple.documentation/documentation/Foundation/NSDictionary> containing the values of any properties you want to tell the host you support or don’t support.

## Discussion

This method is called once per plug-in instantiation and the result is cached for later use by the host application. The dictionary returned by this method should contain various `kFxPropertyKeys` and their corresponding values.

## Topics

### Property Keys

[`var kFxPropertyKey_NeedsFullBuffer: String`](/documentation/professional_video_applications/kFxPropertyKey_NeedsFullBuffer)

A key that determines whether the plug-in needs the entire image to do its processing, and can’t tile its rendering.

[`var kFxPropertyKey_VariesWhenParamsAreStatic: String`](/documentation/professional_video_applications/kFxPropertyKey_VariesWhenParamsAreStatic)

A key that determines whether your rendering varies even when the parameters remain the same.

[`var kFxPropertyKey_ChangesOutputSize: String`](/documentation/professional_video_applications/kFxPropertyKey_ChangesOutputSize)

A key that determines whether your filter has the ability to change the size of its output to be different than the size of its input.

[`var kFxPropertyKey_DesiredProcessingColorInfo: String`](/documentation/professional_video_applications/kFxPropertyKey_DesiredProcessingColorInfo)

A key that determines whether your plug-in renders in linear or gamma-corrected color space.



---

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)