---
title: "renderDestinationImage(_:sourceImages:pluginState:at:)"
framework: Professional Video Applications
role: symbol
role_heading: Instance Method
platforms: [fxplug 4.0+]
path: "professional_video_applications/fxtileableeffect/renderdestinationimage(_:sourceimages:pluginstate:at:)"
---

# renderDestinationImage(_:sourceImages:pluginState:at:)

Sends a request that the host wants your plug-in to do its rendering for a given output image tile.

## Declaration

```swift
func renderDestinationImage(_ destinationImage: FxImageTile, sourceImages: [FxImageTile], pluginState: Data?, at renderTime: CMTime) throws
```

## Parameters

- `destinationImage`: The output image tile that your plug-in should render to.
- `sourceImages`: An array of image tiles. Each one will have the size calculated in your plug-in’s doc://com.apple.professionalvideoapplications/documentation/professional_video_applications/FxTileableEffect/sourceTileRect(_:sourceImageIndex:sourceImages:destinationTileRect:destinationImage:pluginState:at:) method.
- `pluginState`: The NSData returned from your plug-in’s doc://com.apple.professionalvideoapplications/documentation/professional_video_applications/FxTileableEffect/pluginState(_:at:quality:) method.
- `renderTime`: The rational time at which to render your output.

## Mentioned in

Migrating FxPlug 3 plug-ins to FxPlug 4 Rendering in FxPlug Thread safety in plug-ins

## Discussion

Discussion The host calls method when it wants your plug-in to render an image tile of the output image. It passes in each of the input tiles needed as well as the plug-in state needed for the calculations. Your plug-in does all its rendering in this method. Do not attempt to use the FxParameterRetrievalAPI* object, as it is invalid at this time. Note that this method will be called on multiple threads at the same time.

## See Also

### Rendering an output

- [pluginState(_:at:quality:)](professional_video_applications/fxtileableeffect/pluginstate(_:at:quality:).md)
- [scheduleInputs(_:withPluginState:at:)](professional_video_applications/fxtileableeffect/scheduleinputs(_:withpluginstate:at:).md)