---
title: "init(device:kernelWidth:kernelHeight:values:)"
framework: metalperformanceshaders
role: symbol
role_heading: Initializer
path: "metalperformanceshaders/mpsimagedilate/init(device:kernelwidth:kernelheight:values:)"
---

# init(device:kernelWidth:kernelHeight:values:)

Initializes the kernel with a specified width, height, and weight values.

## Declaration

```swift
init(device: any MTLDevice, kernelWidth: Int, kernelHeight: Int, values: UnsafePointer<Float>)
```

## Parameters

- `device`: The Metal device the filter will run on.
- `kernelWidth`: The width of the kernel. Must be an odd number.
- `kernelHeight`: The height of the kernel. Must be an odd number.
- `values`: The set of values to use as the dilate probe. The values are copied into the filter. To avoid image lightening or darkening, the center value should be 0.0f.

## Return Value

Return Value Returns an initialized kernel object with specific width, height, and weight values.

## Discussion

Discussion Each dilate shape probe defines a 3D surface of values. These are arranged in order left to right, then top to bottom in a 1D array. (values[kernelWidth*y+x] = probe[y][x]) Values should be generally be in the range [0,1] with the center pixel tending towards 0 and edges towards 1. However, any numerical value is allowed. Calculations are subject to the usual floating-point rounding error.