---
title: areaAverage()
framework: coreimage
role: symbol
role_heading: Type Method
path: coreimage/cifilter-swift.class/areaaverage()
---

# areaAverage()

Returns a 1 x 1 pixel image that contains the average color for the region of interest.

## Declaration

```swift
class func areaAverage() -> any CIFilter & CIAreaAverage
```

## Return Value

Return Value A 1 x 1 pixel image containing the average color for the region of interest.

## Discussion

Discussion This filter calculates the average color of the area defined by extent and creates a 1 x 1 pixel image with the result. The filter processes each color component (red, green, blue, alpha) of the input image independently. The area average filter uses the following properties: The following code creates a filter that calculates the average color of a 500 x 500 set of pixels from the center of the image: func averageArea(inputImage: CIImage) -> CIImage {     let filter = CIFilter.areaAverage()     filter.inputImage = inputImage     filter.extent = CGRect(         x: inputImage.extent.width/2-250,         y: inputImage.extent.height/2-250,         width: 500,         height: 500)     return filter.outputImage! }

## See Also

### Filters

- [areaHistogram()](coreimage/cifilter-swift.class/areahistogram().md)
- [areaLogarithmicHistogram()](coreimage/cifilter-swift.class/arealogarithmichistogram().md)
- [areaMaximum()](coreimage/cifilter-swift.class/areamaximum().md)
- [areaMaximumAlpha()](coreimage/cifilter-swift.class/areamaximumalpha().md)
- [areaMinimum()](coreimage/cifilter-swift.class/areaminimum().md)
- [areaMinimumAlpha()](coreimage/cifilter-swift.class/areaminimumalpha().md)
- [areaMinMax()](coreimage/cifilter-swift.class/areaminmax().md)
- [areaMinMaxRed()](coreimage/cifilter-swift.class/areaminmaxred().md)
- [columnAverage()](coreimage/cifilter-swift.class/columnaverage().md)
- [histogramDisplay()](coreimage/cifilter-swift.class/histogramdisplay().md)
- [kMeans()](coreimage/cifilter-swift.class/kmeans().md)
- [rowAverage()](coreimage/cifilter-swift.class/rowaverage().md)