<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: 16.0.0 -",
    "macOS: 13.0.0 -",
    "tvOS: 16.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MetalFX",
  "identifier" : "/documentation/MetalFX/MTLFXTemporalScaler",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "MetalFX"
    ],
    "preciseIdentifier" : "c:objc(pl)MTLFXTemporalScaler"
  },
  "title" : "MTLFXTemporalScaler"
}
-->

# MTLFXTemporalScaler

An upscaling effect that generates a higher resolution texture in a render pass by analyzing multiple input textures over time.

```
protocol MTLFXTemporalScaler : MTLFXTemporalScalerBase
```

## Overview

The MetalFX temporal scaler increases the size of your input texture to a larger output texture. You can use the scaler to upscale every frame of your app’s scene or rendering in real time. With a scaler, you can draw more complicated scenes in less time by intentionally rendering to a lower resolution to save time before upscaling.

Create an [`MTLFXTemporalScaler`](/documentation/MetalFX/MTLFXTemporalScaler) instance by following these steps:

1. Create and configure an [`MTLFXTemporalScalerDescriptor`](/documentation/MetalFX/MTLFXTemporalScalerDescriptor) instance.
2. Call the descriptor’s [`makeTemporalScaler(device:)`](/documentation/MetalFX/MTLFXTemporalScalerDescriptor/makeTemporalScaler(device:)) method.

Upscale a rendering by following these steps for every render pass:

1. Set the temporal scaler’s `MTLFXTemporalScaler/colorTexture` property to the input texture.
2. Set the scaler’s `MTLFXTemporalScaler/inputContentWidth` and `MTLFXTemporalScaler/inputContentHeight` properties.
3. Set the scaler’s `MTLFXTemporalScaler/outputTexture` property to your destination texture.
4. Encode the upscale commands to an <doc://com.apple.documentation/documentation/Metal/MTLCommandBuffer> by calling the temporal scaler’s [`encode(commandBuffer:)`](/documentation/MetalFX/MTLFXTemporalScaler/encode(commandBuffer:)) method.

## Topics

### Configuring the image input

### Configuring the depth input

### Configuring the motion input

### Configuring the reactive mask input

### Configuring the image output

### Synchronizing untracked resources

### Encoding a temporal scaling effect

[`encode(commandBuffer:)`](/documentation/MetalFX/MTLFXTemporalScaler/encode(commandBuffer:))

Adds the temporal scaling command to a render pass’s command buffer.

### Inspecting the fixed settings



---

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)