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

# subtractBlendMode()

Blends colors by subtracting color values from two images.

## Declaration

```swift
class func subtractBlendMode() -> any CIFilter & CICompositeOperation
```

## Return Value

Return Value The modified image.

## Discussion

Discussion This method applies the subtract-blend mode filter to an image. The effect calculates the colors in the output image by subtracting the color values that differ between the background image and the input image. The subtract-blend mode filter uses the following properties: The following code creates a filter that results in the image becoming darker with less detail: func subtractBlendMode(inputImage: CIImage, backgroundImage: CIImage) -> CIImage {     let colorBlendFilter = CIFilter.subtractBlendMode()     colorBlendFilter.inputImage = inputImage     colorBlendFilter.backgroundImage = backgroundImage     return colorBlendFilter.outputImage! }

## See Also

### Filters

- [additionCompositing()](coreimage/cifilter-swift.class/additioncompositing().md)
- [colorBlendMode()](coreimage/cifilter-swift.class/colorblendmode().md)
- [colorBurnBlendMode()](coreimage/cifilter-swift.class/colorburnblendmode().md)
- [colorDodgeBlendMode()](coreimage/cifilter-swift.class/colordodgeblendmode().md)
- [darkenBlendMode()](coreimage/cifilter-swift.class/darkenblendmode().md)
- [differenceBlendMode()](coreimage/cifilter-swift.class/differenceblendmode().md)
- [divideBlendMode()](coreimage/cifilter-swift.class/divideblendmode().md)
- [exclusionBlendMode()](coreimage/cifilter-swift.class/exclusionblendmode().md)
- [hardLightBlendMode()](coreimage/cifilter-swift.class/hardlightblendmode().md)
- [hueBlendMode()](coreimage/cifilter-swift.class/hueblendmode().md)
- [lightenBlendMode()](coreimage/cifilter-swift.class/lightenblendmode().md)
- [linearBurnBlendMode()](coreimage/cifilter-swift.class/linearburnblendmode().md)
- [linearDodgeBlendMode()](coreimage/cifilter-swift.class/lineardodgeblendmode().md)
- [linearLightBlendMode()](coreimage/cifilter-swift.class/linearlightblendmode().md)
- [luminosityBlendMode()](coreimage/cifilter-swift.class/luminosityblendmode().md)