---
title: "properties(_:)"
framework: Professional Video Applications
role: symbol
role_heading: Instance Method
platforms: [fxplug 4.0+]
path: "professional_video_applications/fxtileableeffect/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.

## Declaration

```swift
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.

## Mentioned in

Optimizing FxPlug plug-ins

## Discussion

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

- [kFxPropertyKey_NeedsFullBuffer](professional_video_applications/kfxpropertykey_needsfullbuffer.md)
- [kFxPropertyKey_VariesWhenParamsAreStatic](professional_video_applications/kfxpropertykey_varieswhenparamsarestatic.md)
- [kFxPropertyKey_ChangesOutputSize](professional_video_applications/kfxpropertykey_changesoutputsize.md)
- [kFxPropertyKey_DesiredProcessingColorInfo](professional_video_applications/kfxpropertykey_desiredprocessingcolorinfo.md)

## See Also

### Setting up your plug-in

- [init(apiManager:)](professional_video_applications/fxtileableeffect/init(apimanager:)-6vvaz.md)
- [PROAPIAccessing](professional_video_applications/proapiaccessing.md)
- [finishInitialSetup()](professional_video_applications/fxtileableeffect/finishinitialsetup().md)
- [pluginInstanceAddedToDocument()](professional_video_applications/fxtileableeffect/plugininstanceaddedtodocument().md)