Mac OS X Reference Library Apple Developer Connection spyglass button

Core Image Filter Reference

Framework
Companion guides

Overview

This reference describes the built-in filters available through the Core Image API. You can inspect filter parameters and see an image produced by a filter by using the CIFilterBrowser widget, available for ADC members from ADC Developer Connection Member Site.

Filters by Task

CICategoryBlur

CICategoryColorAdjustment

CICategoryColorEffect

CICategoryCompositeOperation

CICategoryDistortionEffect

CICategoryGenerator

CICategoryGeometryAdjustment

CICategoryGradient

CICategoryHalftoneEffect

CICategoryReduction

CICategorySharpen

CICategoryStylize

CICategoryTileEffect

CICategoryTransition

Filters

CIAdditionCompositing

Adds color components to achieve a brightening effect.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This filter is typically used to add highlights and lens flare effects. The formula used to create this filter is described in Thomas Porter and Tom Duff. 1984. Compositing Digital Images. Computer Graphics, 18 (3): 253-259.

Member of
CICategoryBuiltIn, CICategoryHighDynamicRange, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Addition

Figure 1  The result of using the CIAdditionCompositing filter

The result of using the CIAdditionCompositing filter
Availability

CIAffineClamp

Performs an affine transform on a source image and then clamps the pixels at the edge of the transformed image, extending them outwards.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTransform

An NSAffineTransform class whose display name is Transform.

Discussion

This filter performs similarly to the CIAffineTransform filter except that it produces an image with infinite extent. You can use this filter when you need to blur an image but you want to avoid a soft, black fringe along the edges.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Affine Clamp

Figure 2  The result of using the CIAffineClamp filter

The result of using the CIAffineClamp filter
Availability

CIAffineTile

Applies an affine transform to an image and then tiles the transformed image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTransform

An NSAffineTransform class whose display name is Transform.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Affine Tile

Figure 3  The result of using the CIAffineTile filter

The result of using the CIAffineTile filter
Availability

CIAffineTransform

Applies an affine transform to an image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTransform

An NSAffineTransform class whose display name is Transform.

Discussion

You can scale, translate, or rotate the input image. You can also apply a combination of these operations.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGeometryAdjustment
Localized Display Name
Affine Transform

Figure 4  The result of using the CIAffineTransform filter

The result of using the CIAffineTransform filter
Availability

CIAreaAverage

Returns a single-pixel image that contains the average color for the region of interest.

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Average
Availability

CIAreaHistogram

Returns a 1D image (inputCount wide by one pixel high) that contains the component-wise histogram computed for the specified rectangular area.

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

inputCount

The number of “buckets” for the histogram.

inputScale

A scaling factor. Core Image scales the histogram by dividing the scale by the area of the inputExtent rectangle.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Histogram
Availability

CIAreaMaximum

Returns a single-pixel image that contains the maximum color components for the region of interest.

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Maximum
Availability

CIAreaMaximumAlpha

Returns a single-pixel image that contains the color vector with the maximum alpha value for the region of interest.

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Discussion

If more than one pixel exists with the maximum alpha value, Core Image returns the vector that has the lowest x and y coordinate.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Maximum Alpha
Availability

CIAreaMinimum

Returns a single-pixel image that contains the minimum color components for the region of interest.

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Minimum
Availability

CIAreaMinimumAlpha

Returns a single-pixel image that contains the color vector with the minimum alpha value for the region of interest.

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Discussion

If more than one pixel exists with the minimum alpha value, Core Image returns the vector that has the lowest x and y coordinate.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Minimum Alpha
Availability

CIBarsSwipeTransition

Transitions from one image to another by passing a bar over the source image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 3.14 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 6.28 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 30.00 Minimum: 2.00 Maximum: 0.00 Slider minimum: 2.00 Slider maximum: 300.00 Identity: 30.00

inputBarOffset

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Bar Offset.

Default value: 10.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 100.00 Identity: 10.00

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
CIBarsSwipeTransition

Figure 5  The result of using the CIBarsSwipeTransition filter

The result of using the CIBarsSwipeTransition filter
Availability

CIBlendWithMask

Uses values from a grayscale mask to interpolate between an image and the background.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

inputMaskImage

A CIImage class whose display name is Mask Image.

Discussion

When a mask value is 0.0, the result is the background. When the mask value is 1.0, the result is the image.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Blend With Mask

Figure 6  The result of using the CIBlendWithMask filter

The result of using the CIBlendWithMask filter
Availability

CIBloom

Softens edges and applies a pleasant glow to an image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 10.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 100.00 Identity: 0.00

inputIntensity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Intensity.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Bloom

Figure 7  The result of using the CIBloom filter

The result of using the CIBloom filter
Availability

CIBoxBlur

Blurs an image using a box-shaped convolution kernel.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 10.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 100.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
CIBoxBlur

Figure 8  The result of using the CIBoxBlur filter

The result of using the CIBoxBlur filter
Availability

CIBumpDistortion

Creates a bump that originates at a specified point in the image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 300.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 600.00 Identity: 300.00

inputScale

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Scale.

Default value: 0.50 Minimum: -1.00 Maximum: 0.00 Slider minimum: -1.00 Slider maximum: 1.00 Identity: 0.00

Discussion

The bump can be concave or convex.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Bump Distortion

Figure 9  The result of using the CIBumpDistortion filter

The result of using the CIBumpDistortion filter
Availability

CIBumpDistortionLinear

Creates a concave or convex distortion that originates from a line in the image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [300 300] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 300.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 600.00 Identity: 300.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 6.28 Identity: 0.00

inputScale

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Scale.

Default value: 0.50 Minimum: -1.00 Maximum: 0.00 Slider minimum: -1.00 Slider maximum: 1.00 Identity: 1.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
CIBumpDistortionLinear

Figure 10  The result of using the CIBumpDistortionLinear filter

The result of using the CIBumpDistortionLinear filter
Availability

CICheckerboardGenerator

Generates a checkerboard pattern.

Parameters
inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 80.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 800.00 Identity: 80.00

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 1.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Discussion

You can specify the checkerboard size and colors, and the sharpness of the pattern.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGenerator
Localized Display Name
Checkerboard

Figure 11  The result of using the CICheckerboardGenerator filter

The result of using the CICheckerboardGenerator filter
Availability

CICircleSplashDistortion

Distorts the pixels starting at the circumference of a circle and emanating outward.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 150.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1000.00 Identity: 0.10

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Circle Splash Distortion

Figure 12  The result of using the CICircleSplashDistortion filter

The result of using the CICircleSplashDistortion filter
Availability

CICircularScreen

Simulates a circular-shaped halftone screen.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 6.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 2.00 Slider maximum: 50.00 Identity: 0.00

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 0.70 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryHalftoneEffect
Localized Display Name
Circular Screen

Figure 13  The result of using the CICircularScreen filter

The result of using the CICircularScreen filter
Availability

CICircularWrap

Wraps an image around a transparent circle.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 150.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 600.00 Identity: 0.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

Discussion

The distortion of the image increases with the distance from the center of the circle.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Circular Wrap Distortion

Figure 14  The result of using the CICircularWrap filter

The result of using the CICircularWrap filter
Availability

CICMYKHalftone

Creates a color, halftoned rendition of the source image, using cyan, magenta, yellow, and black inks over a white page.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 6.00 Minimum: 2.00 Maximum: 0.00 Slider minimum: 2.00 Slider maximum: 100.00 Identity: 6.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 0.70 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputGCR

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Gray Component Replacement.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 1.00

inputUCR

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Under Color Removal.

Default value: 0.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.50

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryHalftoneEffect
Localized Display Name
CMYK Halftone

Figure 15  The result of using the CICMYKHalftone filter

The result of using the CICMYKHalftone filter
Availability

CIColorBlendMode

Uses the luminance values of the background with the hue and saturation values of the source image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This mode preserves the gray levels in the image. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Color Blend Mode

Figure 16  The result of using the CIColorBlendMode filter

The result of using the CIColorBlendMode filter
Availability

CIColorBurnBlendMode

Darkens the background image samples to reflect the source image samples.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

Source image sample values that specify white do not produce a change. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Color Burn Blend Mode

Figure 17  The result of using the CIColorBurnBlendMode filter

The result of using the CIColorBurnBlendMode filter
Availability

CIColorControls

Adjusts saturation, brightness, and contrast values.

Parameters
inputImage

A CIImage class whose display name is Image.

inputSaturation

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Saturation.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 2.00 Identity: 1.00

inputBrightness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Brightness.

Default value: 0.00 Minimum: -1.00 Maximum: 0.00 Slider minimum: -1.00 Slider maximum: 1.00 Identity: 0.00

inputContrast

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Contrast.

Default value: 1.00 Minimum: 0.25 Maximum: 0.00 Slider minimum: 0.25 Slider maximum: 4.00 Identity: 1.00

Discussion

To calculate saturation, this filter linearly interpolates between a grayscale image (saturation = 0.0) and the original image (saturation = 1.0). The filter supports extrapolation: For values large than 1.0, it increases saturation.

To calculate contrast, this filter uses the following formula:

(color.rgb - vec3(0.5)) * contrast + vec3(0.5)

This filter calculates brightness by adding a bias value:

color.rgb + vec3(brightness)

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
Color Controls

Figure 18  The result of using the CIColorControls filter

The result of using the CIColorControls filter
Availability

CIColorCube

Uses a three-dimensional color table to transform the source image pixels.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCubeDimension

An NSNumber class whose attribute type is CIAttributeTypeCount and whose display name is Cube Dimension.

Default value: 2.00 Minimum: 2.00 Maximum: 128.00 Slider minimum: 0.00 Slider maximum: 0.00 Identity: 2.00 The value must be a power of two.

inputCubeData

An NSData class whose display name is Cube Data.

Discussion

The color table must be composed of floating-point RGBA cells that use premultiplied alpha. The cells are organized in a standard ordering. The columns and rows of the data are indexed by red and green, respectively. Each data plane is followed by the next higher plane in the data, with planes indexed by blue.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Color Cube

Figure 19  The result of using the CIColorCube filter

The result of using the CIColorCube filter
Availability

CIColorDodgeBlendMode

Brightens the background image samples to reflect the source image samples.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

Source image sample values that specify black do not produce a change. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Color Dodge Blend Mode

Figure 20  The result of using the CIColorDodgeBlendMode filter

The result of using the CIColorDodgeBlendMode filter
Availability

CIColorInvert

Inverts the colors in an image.

Parameters
inputImage

A CIImage class whose display name is Image.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Color Invert

Figure 21  The result of using the CIColorInvert filter

The result of using the CIColorInvert filter
Availability

CIColorMap

Performs a nonlinear transformation of source color values using mapping values provided in a table.

Parameters
inputImage

A CIImage class whose display name is Image.

inputGradientImage

A CIImage class whose attribute type is CIAttributeTypeGradient and whose display name is Gradient Image.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Color Map

Figure 22  The result of using the CIColorMap filter

The result of using the CIColorMap filter
Availability

CIColorMatrix

Multiplies source color values and adds a bias factor to each color component.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRVector

A CIVector class whose display name is Red Vector.

Default value: [1 0 0 0] Identity: [1 0 0 0]

inputGVector

A CIVector class whose display name is Green Vector.

Default value: [0 1 0 0] Identity: [0 1 0 0]

inputBVector

A CIVector class whose display name is Blue Vector.

Default value: [0 0 1 0] Identity: [0 0 1 0]

inputAVector

A CIVector class whose display name is Alpha Vector.

Default value: [0 0 0 1] Identity: [0 0 0 1]

inputBiasVector

A CIVector class whose display name is Bias Vector.

Default value: [0 0 0 0] Identity: [0 0 0 0]

Discussion

This filter performs a matrix multiplication, as follows, to transform the color vector:

s.r = dot(s, redVector)
s.g = dot(s, greenVector)
s.b = dot(s, blueVector)
s.a = dot(s, alphaVector)
s = s + bias
Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
Color Matrix

Figure 23  The result of using the CIColorMatrix filter

The result of using the CIColorMatrix filter
Availability

CIColorMonochrome

Remaps colors so they fall within shades of a single color.

Parameters
inputImage

A CIImage class whose display name is Image.

inputColor

A CIColor class whose attribute type is CIAttributeTypeOpaqueColor and whose display name is Color.

inputIntensity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Intensity.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Color Monochrome

Figure 24  The result of using the CIColorMonochrome filter

The result of using the CIColorMonochrome filter
Availability

CIColorPosterize

Remaps red, green, and blue color components to the number of brightness values you specify for each color component.

Parameters
inputImage

A CIImage class whose display name is Image.

inputLevels

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Levels.

Default value: 6.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 2.00 Slider maximum: 30.00 Identity: 300.00

Discussion

This filter flattens colors to achieve a look similar to that of a silk-screened poster.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Color Posterize

Figure 25  The result of using the CIColorPosterize filter

The result of using the CIColorPosterize filter
Availability

CIColumnAverage

Returns a 1-pixel high image that contains the average color for each scan column.

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Column Average
Availability

CIComicEffect

Simulates a comic book drawing by outlining edges and applying a color halftone effect.

Parameters
inputImage

A CIImage class whose display name is Image.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Comic Effect

Figure 26  The result of using the CIComicEffect filter

The result of using the CIComicEffect filter
Availability

CIConstantColorGenerator

Generates a solid color.

Parameters
inputColor

A CIColor class whose display name is Color.

Discussion

You typically use the output of this filter as the input to another filter.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGenerator
Localized Display Name
Constant Color

Figure 27  The result of using the CIConstantColorGenerator filter

The result of using the CIConstantColorGenerator filter
Availability

CICopyMachineTransition

Transitions from one image to another by simulating the effect of a copy machine.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputExtent

A CIVector class whose attribute type is CIAttributeTypeRectangle and whose display name is Extent.

Default value: [0 0 300 300] Identity: (null)

inputColor

A CIColor class whose attribute type is CIAttributeTypeOpaqueColor and whose display name is Color.

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 6.28 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 200.00 Minimum: 0.10 Maximum: 0.00 Slider minimum: 0.10 Slider maximum: 500.00 Identity: 200.00

inputOpacity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Opacity.

Default value: 1.30 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 3.00 Identity: 1.30

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Copy Machine

Figure 28  The result of using the CICopyMachineTransition filter

The result of using the CICopyMachineTransition filter
Availability

CICrop

Applies a crop to an image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRectangle

A CIVector class whose attribute type is CIAttributeTypeRectangle and whose display name is Rectangle.

Default value: [0 0 300 300] Identity: (null)

Discussion

The size and shape of the cropped image depend on the rectangle you specify.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGeometryAdjustment
Localized Display Name
Crop

Figure 29  The result of using the CICrop filter

The result of using the CICrop filter
Availability

CICrystallize

Creates polygon-shaped color blocks by aggregating source pixel-color values.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 20.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 100.00 Identity: 1.00

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Crystallize

Figure 30  The result of using the CICrystallize filter

The result of using the CICrystallize filter
Availability

CIDarkenBlendMode

Creates composite image samples by choosing the darker samples (from either the source image or the background).

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The result is that the background image samples are replaced by any source image samples that are darker. Otherwise, the background image samples are left unchanged. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Darken Blend Mode

Figure 31  The result of using the CIDarkenBlendMode filter

The result of using the CIDarkenBlendMode filter
Availability

CIDifferenceBlendMode

Subtracts either the source image sample color from the background image sample color, or the reverse, depending on which sample has the greater brightness value.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

Source image sample values that are black produce no change; white inverts the background color values. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Difference Blend Mode

Figure 32  The result of using the CIDifferenceBlendMode filter

The result of using the CIDifferenceBlendMode filter
Availability

CIDiscBlur

Blurs an image using a disc-shaped convolution kernel.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 8.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 100.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
CIDiscBlur

Figure 33  The result of using the CIDiscBlur filter

The result of using the CIDiscBlur filter
Availability

CIDisintegrateWithMaskTransition

Transitions from one image to another using the shape defined by a mask.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputMaskImage

A CIImage class whose display name is Mask Image.

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputShadowRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Shadow Radius.

Default value: 8.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 50.00 Identity: 0.00

inputShadowDensity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Shadow Density.

Default value: 0.65 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputShadowOffset

A CIVector class whose attribute type is CIAttributeTypeOffset and whose display name is Shadow Offset.

Default value: [0 -10] Identity: [0 0]

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Disintegrate with Mask

Figure 34  The result of using the CIDisintegrateWithMaskTransition filter

The result of using the CIDisintegrateWithMaskTransition filter
Availability

CIDisplacementDistortion

Applies the grayscale values of the second image to the first image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputDisplacementImage

A CIImage class whose display name is Displacement Image.

inputScale

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Scale.

Default value: 50.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 200.00 Identity: 0.00

Discussion

The output image has a texture defined by the grayscale values.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Displacement Distortion

Figure 35  The result of using the CIDisplacementDistortion filter

The result of using the CIDisplacementDistortion filter
Availability

CIDissolveTransition

Uses a dissolve to transition from one image to another.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Dissolve

Figure 36  The result of using the CIDissolveTransition filter

The result of using the CIDissolveTransition filter
Availability

CIDotScreen

Simulates the dot patterns of a halftone screen.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 6.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 2.00 Slider maximum: 50.00 Identity: 0.00

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 0.70 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryHalftoneEffect
Localized Display Name
Dot Screen

Figure 37  The result of using the CIDotScreen filter

The result of using the CIDotScreen filter
Availability

CIEdges

Finds all edges in an image and displays them in color.

Parameters
inputImage

A CIImage class whose display name is Image.

inputIntensity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Intensity.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 10.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Edges

Figure 38  The result of using the CIEdges filter

The result of using the CIEdges filter
Availability

CIEdgeWork

Produces a stylized black-and-white rendition of an image that looks similar to a woodblock cutout.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 3.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 20.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Edge Work

Figure 39  The result of using the CIEdgeWork filter

The result of using the CIEdgeWork filter
Availability

CIEightfoldReflectedTile

Produces a tiled image from a source image by applying an 8-way reflected symmetry.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIEightfoldReflectedTile

Figure 40  The result of using the CIEightfoldReflectedTile filter

The result of using the CIEightfoldReflectedTile filter
Availability

CIExclusionBlendMode

Produces an effect similar to that produced by the CIDifferenceBlendMode filter but with lower contrast.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

Source image sample values that are black do not produce a change; white inverts the background color values. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Exclusion Blend Mode

Figure 41  The result of using the CIExclusionBlendMode filter

The result of using the CIExclusionBlendMode filter
Availability

CIExposureAdjust

Adjusts the exposure setting for an image similar to the way you control exposure for a camera when you change the F-stop.

Parameters
inputImage

A CIImage class whose display name is Image.

inputEV

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is EV.

Default value: 0.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: -10.00 Slider maximum: 10.00 Identity: 0.00

Discussion

This filter multiplies the color values, as follows, to simulate exposure change by the specified F-stops:

s.rgb * pow(2.0, ev)

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
Exposure Adjust

Figure 42  The result of using the CIExposureAdjust filter

The result of using the CIExposureAdjust filter
Availability

CIFalseColor

Maps luminance to a color ramp of two colors.

Parameters
inputImage

A CIImage class whose display name is Image.

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

Discussion

False color is often used to process astronomical and other scientific data, such as ultraviolet and x-ray images.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
False Color

Figure 43  The result of using the CIFalseColor filter

The result of using the CIFalseColor filter
Availability

CIFlashTransition

Transitions from one image to another by creating a flash.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputExtent

A CIVector class whose attribute type is CIAttributeTypeRectangle and whose display name is Extent.

Default value: [0 0 300 300] Identity: (null)

inputColor

A CIColor class whose attribute type is CIAttributeTypeOpaqueColor and whose display name is Color.

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputMaxStriationRadius

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Maximum Striation Radius.

Default value: 2.58 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 10.00 Identity: 2.58

inputStriationStrength

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Striation Strength.

Default value: 0.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 3.00 Identity: 0.50

inputStriationContrast

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Striation Contrast.

Default value: 1.38 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 5.00 Identity: 1.38

inputFadeThreshold

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Fade Threshold.

Default value: 0.85 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.85

Discussion

The flash originates from a point you specify. Small at first, it rapidly expands until the image frame is completely filled with the flash color. As the color fades, the target image begins to appear.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Flash

Figure 44  The result of using the CIFlashTransition filter

The result of using the CIFlashTransition filter
Availability

CIFourfoldReflectedTile

Produces a tiled image from a source image by applying a 4-way reflected symmetry.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputAcuteAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Acute Angle.

Default value: 1.57 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 1.57

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIFourfoldReflectedTile

Figure 45  The result of using the CIFourfoldReflectedTile filter

The result of using the CIFourfoldReflectedTile filter
Availability

CIFourfoldRotatedTile

Produces a tiled image from a source image by rotating the source image at increments of 90 degrees.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIFourfoldRotatedTile

Figure 46  The result of using the CIFourfoldRotatedTile filter

The result of using the CIFourfoldRotatedTile filter
Availability

CIFourfoldTranslatedTile

Produces a tiled image from a source image by applying 4 translation operations.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputAcuteAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Acute Angle.

Default value: 1.57 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 1.57

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIFourfoldTranslatedTile

Figure 47  The result of using the CIFourfoldTranslatedTile filter

The result of using the CIFourfoldTranslatedTile filter
Availability

CIGammaAdjust

Adjusts midtone brightness.

Parameters
inputImage

A CIImage class whose display name is Image.

inputPower

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Power.

Default value: 0.75 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.10 Slider maximum: 3.00 Identity: 1.00

Discussion

This filter is typically used to compensate for nonlinear effects of displays. Adjusting the gamma effectively changes the slope of the transition between black and white. It uses the following formula:

pow(s.rgb, vec3(power))

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
Gamma Adjust

Figure 48  The result of using the CIGammaAdjust filter

The result of using the CIGammaAdjust filter
Availability

CIGaussianBlur

Spreads source pixels by an amount specified by a Gaussian distribution.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 10.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 100.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Gaussian Blur

Figure 49  The result of using the CIGaussianBlur filter

The result of using the CIGaussianBlur filter
Availability

CIGaussianGradient

Generates a gradient that varies from one color to another using a Gaussian distribution.

Parameters
inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 300.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 800.00 Identity: 300.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGradient
Localized Display Name
Gaussian Gradient

Figure 50  The result of using the CIGaussianGradient filter

The result of using the CIGaussianGradient filter
Availability

CIGlassDistortion

Distorts an image by applying a glass-like texture.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTexture

A CIImage class whose display name is Texture.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputScale

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Scale.

Default value: 200.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.01 Slider maximum: 500.00 Identity: 0.00

Discussion

The raised portions of the output image are the result of applying a texture map.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Glass Distortion

Figure 51  The result of using the CIGlassDistortion filter

The result of using the CIGlassDistortion filter
Availability

CIGlassLozenge

Creates a lozenge-shaped lens and distorts the portion of the image over which the lens is placed.

Parameters
inputImage

A CIImage class whose display name is Image.

inputPoint0

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Point 1.

Default value: [150 150] Identity: (null)

inputPoint1

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Point 2.

Default value: [350 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1000.00 Identity: 100.00

inputRefraction

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Refraction.

Default value: 1.70 Minimum: -5.00 Maximum: 0.00 Slider minimum: -5.00 Slider maximum: 5.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Glass Lozenge

Figure 52  The result of using the CIGlassLozenge filter

The result of using the CIGlassLozenge filter
Availability

CIGlideReflectedTile

Produces a tiled image from a source image by translating and smearing the image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIGlideReflectedTile

Figure 53  The result of using the CIGlideReflectedTile filter

The result of using the CIGlideReflectedTile filter
Availability

CIGloom

Dulls the highlights of an image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 10.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 100.00 Identity: 0.00

inputIntensity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Intensity.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Gloom

Figure 54  The result of using the CIGloom filter

The result of using the CIGloom filter
Availability

CIHardLightBlendMode

Either multiplies or screens colors, depending on the source image sample color.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

If the source image sample color is lighter than 50% gray, the background is lightened, similar to screening. If the source image sample color is darker than 50% gray, the background is darkened, similar to multiplying. If the source image sample color is equal to 50% gray, the source image is not changed. Image samples that are equal to pure black or pure white result in pure black or white. The overall effect is similar to what you would achieve by shining a harsh spotlight on the source image. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Hard Light Blend Mode

Figure 55  The result of using the CIHardLightBlendMode filter

The result of using the CIHardLightBlendMode filter
Availability

CIHatchedScreen

Simulates the hatched pattern of a halftone screen.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 6.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 2.00 Slider maximum: 50.00 Identity: 0.00

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 0.70 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryHalftoneEffect
Localized Display Name
Hatched Screen

Figure 56  The result of using the CIHatchedScreen filter

The result of using the CIHatchedScreen filter
Availability

CIHeightFieldFromMask

Produces a continuous three-dimensional, loft-shaped height field from a grayscale mask.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 10.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 300.00 Identity: 10.00

Discussion

The white values of the mask define those pixels that are inside the height field while the black values define those pixels that are outside. The field varies smoothly and continuously inside the mask, reaching the value 0 at the edge of the mask. You can use this filter with the CIShadedMaterial filter to produce extremely realistic shaded objects.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Height Field From Mask

Figure 57  The result of using the CIHeightFieldFromMask filter

The result of using the CIHeightFieldFromMask filter
Availability

CIHexagonalPixellate

Maps an image to colored hexagons whose color is defined by the replaced pixels.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputScale

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Scale.

Default value: 8.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 100.00 Identity: 1.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
CIHexagonalPixellate

Figure 58  The result of using the CIHexagonalPixellate filter

The result of using the CIHexagonalPixellate filter
Availability

CIHoleDistortion

Creates a circular area that pushes the image pixels outward, distorting those pixels closest to the circle the most.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 150.00 Minimum: 0.01 Maximum: 0.00 Slider minimum: 0.01 Slider maximum: 1000.00 Identity: 0.10

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Hole Distortion

Figure 59  The result of using the CIHoleDistortion filter

The result of using the CIHoleDistortion filter
Availability

CIHueAdjust

Changes the overall hue, or tint, of the source pixels.

Parameters
inputImage

A CIImage class whose display name is Image.

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

Discussion

This filter essentially rotates the color cube around the neutral axis.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
Hue Adjust

Figure 60  The result of using the CIHueAdjust filter

The result of using the CIHueAdjust filter
Availability

CIHueBlendMode

Uses the luminance and saturation values of the background with the hue of the source image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Hue Blend Mode

Figure 61  The result of using the CIHueBlendMode filter

The result of using the CIHueBlendMode filter
Availability

CIKaleidoscope

Produces a kaleidoscopic image from a source image by applying 12-way symmetry.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCount

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Count.

Default value: 6.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 64.00 Identity: 0.00

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Kaleidoscope

Figure 62  The result of using the CIKaleidoscope filter

The result of using the CIKaleidoscope filter
Availability

CILanczosScaleTransform

Produces a high-quality, scaled version of a source image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputScale

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Scale.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.05 Slider maximum: 1.50 Identity: 1.00

inputAspectRatio

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Aspect Ratio.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.50 Slider maximum: 2.00 Identity: 1.00

Discussion

You typically use this filter to scale down an image.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGeometryAdjustment
Localized Display Name
Lanczos Scale Transform

Figure 63  The result of using the CILanczosScaleTransform filter

The result of using the CILanczosScaleTransform filter
Availability

CILenticularHaloGenerator

Simulates a halo that is generated by the diffraction associated with the spread of a lens.

Parameters
inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputColor

A CIColor class whose display name is Color.

inputHaloRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Halo Radius.

Default value: 70.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1000.00 Identity: 0.00

inputHaloWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Halo Width.

Default value: 87.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 300.00 Identity: 0.00

inputHaloOverlap

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Halo Overlap.

Default value: 0.77 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputStriationStrength

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Striation Strength.

Default value: 0.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 3.00 Identity: 0.00

inputStriationContrast

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Striation Contrast.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 5.00 Identity: 0.00

inputTime

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Discussion

This filter is typically applied to another image to simulate lens flares and similar effects.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGenerator
Localized Display Name
Lenticular Halo

Figure 64  The result of using the CILenticularHaloGenerator filter

The result of using the CILenticularHaloGenerator filter
Availability

CILightenBlendMode

Creates composite image samples by choosing the lighter samples (either from the source image or the background).

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The result is that the background image samples are replaced by any source image samples that are lighter. Otherwise, the background image samples are left unchanged. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Lighten Blend Mode

Figure 65  The result of using the CILightenBlendMode filter

The result of using the CILightenBlendMode filter
Availability

CILinearGradient

Generates a gradient that varies along a linear axis between two defined endpoints.

Parameters
inputPoint0

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Point 1.

Default value: [0 0] Identity: (null)

inputPoint1

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Point 2.

Default value: [200 200] Identity: (null)

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGradient
Localized Display Name
Linear Gradient

Figure 66  The result of using the CILinearGradient filter

The result of using the CILinearGradient filter
Availability

CILineOverlay

Creates a sketch that outlines the edges of an image in black.

Parameters
inputImage

A CIImage class whose display name is Image.

inputNRNoiseLevel

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is NR Noise Level.

Default value: 0.07 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 0.10 Identity: 0.00

inputNRSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is NR Sharpness.

Default value: 0.71 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 2.00 Identity: 0.00

inputEdgeIntensity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Edge Intensity.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 200.00 Identity: 0.00

inputThreshold

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Threshold.

Default value: 0.10 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputContrast

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Contrast.

Default value: 50.00 Minimum: 0.25 Maximum: 0.00 Slider minimum: 0.25 Slider maximum: 200.00 Identity: 1.00

Discussion

The portions of the image that are not outlined are transparent.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Line Overlay

Figure 67  The result of using the CILineOverlay filter

The result of using the CILineOverlay filter
Availability

CILineScreen

Simulates the line pattern of a halftone screen.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 6.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 2.00 Slider maximum: 50.00 Identity: 0.00

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 0.70 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryHalftoneEffect
Localized Display Name
Line Screen

Figure 68  The result of using the CILineScreen filter

The result of using the CILineScreen filter
Availability

CILuminosityBlendMode

Uses the hue and saturation of the background with the luminance of the source image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This mode creates an effect that is inverse to the effect created by the CIColorBlendMode filter. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Luminosity Blend Mode

Figure 69  The result of using the CILuminosityBlendMode filter

The result of using the CILuminosityBlendMode filter
Availability

CIMaskToAlpha

Converts a grayscale image to a white image that is masked by alpha.

Parameters
inputImage

A CIImage class whose display name is Image.

Discussion

The white values from the source image produce the inside of the mask; the black values become completely transparent.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Mask To Alpha

Figure 70  The result of using the CIMaskToAlpha filter

The result of using the CIMaskToAlpha filter
Availability

CIMaximumComponent

Returns a grayscale image from max(r,g,b).

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Maximum Component
Availability

CIMaximumCompositing

Computes the maximum value, by color component, of two input images and creates an output image using the maximum values.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This is similar to dodging. The formula used to create this filter is described in Thomas Porter and Tom Duff. 1984. Compositing Digital Images. Computer Graphics, 18 (3): 253-259.

Member of
CICategoryBuiltIn, CICategoryHighDynamicRange, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Maximum

Figure 71  The result of using the CIMaximumCompositing filter

The result of using the CIMaximumCompositing filter
Availability

CIMedianFilter

Computes the median value for a group of neighboring pixels and replaces each pixel value with the median.

Parameters
inputImage

A CIImage class whose display name is Image.

Discussion

The effect is to reduce noise.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Median

Figure 72  The result of using the CIMedianFilter filter

The result of using the CIMedianFilter filter
Availability

CIMinimumComponent

Returns a grayscale image from min(r,g,b).

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Minimum Component
Availability

CIMinimumCompositing

Computes the minimum value, by color component, of two input images and creates an output image using the minimum values.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This is similar to burning. The formula used to create this filter is described in Thomas Porter and Tom Duff. 1984. Compositing Digital Images. Computer Graphics, 18 (3): 253-259.

Member of
CICategoryBuiltIn, CICategoryHighDynamicRange, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Minimum

Figure 73  The result of using the CIMinimumCompositing filter

The result of using the CIMinimumCompositing filter
Availability

CIModTransition

Transitions from one image to another by revealing the target image through irregularly shaped holes.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 2.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -6.28 Slider maximum: 6.28 Identity: 2.00

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 150.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 0.00

inputCompression

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Compression.

Default value: 300.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 100.00 Slider maximum: 800.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Mod

Figure 74  The result of using the CIModTransition filter

The result of using the CIModTransition filter
Availability

CIMotionBlur

Blurs an image to simulate the effect of using a camera that moves a specified angle and distance while capturing the image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 20.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 100.00 Identity: 0.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Motion Blur

Figure 75  The result of using the CIMotionBlur filter

The result of using the CIMotionBlur filter
Availability

CIMultiplyBlendMode

Multiplies the source image samples with the background image samples.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This results in colors that are at least as dark as either of the two contributing sample colors. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Multiply Blend Mode

Figure 76  The result of using the CIMultiplyBlendMode filter

The result of using the CIMultiplyBlendMode filter
Availability

CIMultiplyCompositing

Multiplies the color component of two input images and creates an output image using the multiplied values.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This filter is typically used to add a spotlight or similar lighting effect to an image. The formula used to create this filter is described in Thomas Porter and Tom Duff. 1984. Compositing Digital Images. Computer Graphics, 18 (3): 253-259.

Member of
CICategoryBuiltIn, CICategoryHighDynamicRange, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Multiply

Figure 77  The result of using the CIMultiplyCompositing filter

The result of using the CIMultiplyCompositing filter
Availability

CINoiseReduction

Reduces noise using a threshold value to define what is considered noise.

Parameters
inputImage

A CIImage class whose display name is Image.

inputNoiseLevel

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Noise Level.

Default value: 0.02 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 0.10 Identity: 0.00

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 0.40 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 2.00 Identity: 0.00

Discussion

Small changes in luminance below that value are considered noise and get a noise reduction treatment, which is a local blur. Changes above the threshold value are considered edges, so they are sharpened.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Noise Reduction

Figure 78  The result of using the CINoiseReduction filter

The result of using the CINoiseReduction filter
Availability

CIOpTile

Segments an image, applying any specified scaling and rotation, and then assembles the image again to give an op art appearance.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputScale

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Scale.

Default value: 2.80 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.10 Slider maximum: 10.00 Identity: 1.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 65.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 1000.00 Identity: 65.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Op Tile

Figure 79  The result of using the CIOpTile filter

The result of using the CIOpTile filter
Availability

CIOverlayBlendMode

Either multiplies or screens the source image samples with the background image samples, depending on the background color.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The result is to overlay the existing image samples while preserving the highlights and shadows of the background. The background color mixes with the source image to reflect the lightness or darkness of the background. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Overlay Blend Mode

Figure 80  The result of using the CIOverlayBlendMode filter

The result of using the CIOverlayBlendMode filter
Availability

CIPageCurlTransition

Transitions from one image to another by simulating a curling page, revealing the new image as the page curls.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputBacksideImage

A CIImage class whose display name is Backside Image.

inputShadingImage

A CIImage class whose display name is Shading Image.

inputExtent

A CIVector class whose attribute type is CIAttributeTypeRectangle and whose display name is Extent.

Default value: [0 0 300 300] Identity: (null)

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 100.00 Minimum: 0.01 Maximum: 0.00 Slider minimum: 0.01 Slider maximum: 200.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Page Curl

Figure 81  The result of using the CIPageCurlTransition filter

The result of using the CIPageCurlTransition filter
Availability

CIParallelogramTile

Warps an image by reflecting it in a parallelogram, and then tiles the result.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputAcuteAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Acute Angle.

Default value: 1.57 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 1.57

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Parallelogram Tile

Figure 82  The result of using the CIParallelogramTile filter

The result of using the CIParallelogramTile filter
Availability

CIPerspectiveTile

Applies a perspective transform to an image and then tiles the result.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTopLeft

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Top Left.

Default value: [118 484] Identity: (null)

inputTopRight

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Top Right.

Default value: [646 507] Identity: (null)

inputBottomRight

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Bottom Right.

Default value: [548 140] Identity: (null)

inputBottomLeft

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Bottom Left.

Default value: [155 153] Identity: (null)

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Perspective Tile

Figure 83  The result of using the CIPerspectiveTile filter

The result of using the CIPerspectiveTile filter
Availability

CIPerspectiveTransform

Alters the geometry of an image to simulate the observer changing viewing position.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTopLeft

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Top Left.

Default value: [118 484] Identity: (null)

inputTopRight

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Top Right.

Default value: [646 507] Identity: (null)

inputBottomRight

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Bottom Right.

Default value: [548 140] Identity: (null)

inputBottomLeft

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Bottom Left.

Default value: [155 153] Identity: (null)

Discussion

You can use the perspective filter to skew an image.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGeometryAdjustment
Localized Display Name
Perspective Transform

Figure 84  The result of using the CIPerspectiveTransform filter

The result of using the CIPerspectiveTransform filter
Availability

CIPinchDistortion

Creates a rectangular-shaped area that pinches source pixels inward, distorting those pixels closest to the rectangle the most.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 300.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1000.00 Identity: 0.00

inputScale

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Scale.

Default value: 0.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Pinch Distortion

Figure 85  The result of using the CIPinchDistortion filter

The result of using the CIPinchDistortion filter
Availability

CIPixellate

Makes an image blocky by mapping the image to colored squares whose color is defined by the replaced pixels.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputScale

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Scale.

Default value: 8.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 100.00 Identity: 1.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Pixellate

Figure 86  The result of using the CIPixellate filter

The result of using the CIPixellate filter
Availability

CIPointillize

Renders the source image in a pointillistic style.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 20.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 100.00 Identity: 1.00

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Pointillize

Figure 87  The result of using the CIPointillize filter

The result of using the CIPointillize filter
Availability

CIRadialGradient

Generates a gradient that varies radially between two circles having the same center.

Parameters
inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius0

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius 1.

Default value: 5.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 800.00 Identity: 5.00

inputRadius1

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius 2.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 800.00 Identity: 100.00

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

Discussion

It is valid for one of the two circles to have a radius of 0.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGradient
Localized Display Name
Radial Gradient

Figure 88  The result of using the CIRadialGradient filter

The result of using the CIRadialGradient filter
Availability

CIRandomGenerator

Generates an image of infinite extent whose pixel values are made up of four independent, uniformly-distributed random numbers in the 0 to 1 range.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGenerator
Localized Display Name
Random Generator

Figure 89  The result of using the CIRandomGenerator filter

The result of using the CIRandomGenerator filter
Availability

CIRippleTransition

Transitions from one image to another by creating a circular wave that expands from the center point, revealing the new image in the wake of the wave.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputShadingImage

A CIImage class whose display name is Shading Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputExtent

A CIVector class whose attribute type is CIAttributeTypeRectangle and whose display name is Extent.

Default value: [0 0 300 300] Identity: (null)

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 1.00 Maximum: 0.00 Slider minimum: 10.00 Slider maximum: 300.00 Identity: 0.00

inputScale

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Scale.

Default value: 50.00 Minimum: -50.00 Maximum: 0.00 Slider minimum: -50.00 Slider maximum: 50.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Ripple

Figure 90  The result of using the CIRippleTransition filter

The result of using the CIRippleTransition filter
Availability

CIRowAverage

Returns a 1-pixel high image that contains the average color for each scan row.

Parameters
inputImage

A CIImage class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Row Average
Availability

CISaturationBlendMode

Uses the luminance and hue values of the background with the saturation of the source image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

Areas of the background that have no saturation (that is, pure gray areas) do not produce a change. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Saturation Blend Mode

Figure 91  The result of using the CISaturationBlendMode filter

The result of using the CISaturationBlendMode filter
Availability

CIScreenBlendMode

Multiplies the inverse of the source image samples with the inverse of the background image samples.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This results in colors that are at least as light as either of the two contributing sample colors. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Screen Blend Mode

Figure 92  The result of using the CIScreenBlendMode filter

The result of using the CIScreenBlendMode filter
Availability

CISepiaTone

Maps the colors of an image to various shades of brown.

Parameters
inputImage

A CIImage class whose display name is Image.

inputIntensity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Intensity.

Default value: 1.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Sepia Tone

Figure 93  The result of using the CISepiaTone filter

The result of using the CISepiaTone filter
Availability

CIShadedMaterial

Produces a shaded image from a height field.

Parameters
inputImage

A CIImage class whose display name is Image.

inputShadingImage

A CIImage class whose display name is Shading Image.

inputScale

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Scale.

Default value: 10.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.50 Slider maximum: 200.00 Identity: 0.00

Discussion

The height field is defined to have greater heights with lighter shades, and lesser heights (lower areas) with darker shades. You can combine this filter with the CIHeightFieldFromMask filter to produce quick shadings of masks, such as text.

This filter sets the input image as a height-field (multiplied by the scale parameter), and computes a normal vector for each pixel. It then uses that normal vector to look up the reflected color for that direction in the input shading image.

The input shading image contains the picture of a hemisphere, which defines the way the surface is shaded. The look-up coordinate for a normal vector is:

(normal.xy + 1.0) * 0.5 * vec2(shadingImageWidth, shadingImageHeight)

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Shaded Material

Figure 94  The result of using the CIShadedMaterial filter

The result of using the CIShadedMaterial filter
Availability

CISharpenLuminance

Increases image detail by sharpening.

Parameters
inputImage

A CIImage class whose display name is Image.

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 0.40 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 2.00 Identity: 0.00

Discussion

It operates on the luminance of the image; the chrominance of the pixels remains unaffected.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategorySharpen
Localized Display Name
Sharpen Luminance

Figure 95  The result of using the CISharpenLuminance filter

The result of using the CISharpenLuminance filter
Availability

CISixfoldReflectedTile

Produces a tiled image from a source image by applying a 6-way reflected symmetry.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CISixfoldReflectedTile

Figure 96  The result of using the CISixfoldReflectedTile filter

The result of using the CISixfoldReflectedTile filter
Availability

CISixfoldRotatedTile

Produces a tiled image from a source image by rotating the source image at increments of 60 degrees.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CISixfoldRotatedTile

Figure 97  The result of using the CISixfoldRotatedTile filter

The result of using the CISixfoldRotatedTile filter
Availability

CISoftLightBlendMode

Either darkens or lightens colors, depending on the source image sample color.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

If the source image sample color is lighter than 50% gray, the background is lightened, similar to dodging. If the source image sample color is darker than 50% gray, the background is darkened, similar to burning. If the source image sample color is equal to 50% gray, the background is not changed. Image samples that are equal to pure black or pure white produce darker or lighter areas, but do not result in pure black or white. The overall effect is similar to what you would achieve by shining a diffuse spotlight on the source image. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Blend Modes: Addendum.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Soft Light Blend Mode

Figure 98  The result of using the CISoftLightBlendMode filter

The result of using the CISoftLightBlendMode filter
Availability

CISourceAtopCompositing

Places the source image over the background image, then uses the luminance of the background image to determine what to show.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The composite shows the background image and only those portions of the source image that are over visible parts of the background. The formula used to create this filter is described in Thomas Porter and Tom Duff. 1984. Compositing Digital Images. Computer Graphics, 18 (3): 253-259.

Member of
CICategoryBuiltIn, CICategoryHighDynamicRange, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Source Atop

Figure 99  The result of using the CISourceAtopCompositing filter

The result of using the CISourceAtopCompositing filter
Availability

CISourceInCompositing

Uses the second image to define what to leave in the source image, effectively cropping the image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The formula used to create this filter is described in Thomas Porter and Tom Duff. 1984. Compositing Digital Images. Computer Graphics, 18 (3): 253-259.

Member of
CICategoryBuiltIn, CICategoryHighDynamicRange, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Source In

Figure 100  The result of using the CISourceInCompositing filter

The result of using the CISourceInCompositing filter
Availability

CISourceOutCompositing

Uses the second image to define what to take out of the first image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The formula used to create this filter is described in Thomas Porter and Tom Duff. 1984. Compositing Digital Images. Computer Graphics, 18 (3): 253-259.

Member of
CICategoryBuiltIn, CICategoryHighDynamicRange, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Source Out

Figure 101  The result of using the CISourceOutCompositing filter

The result of using the CISourceOutCompositing filter
Availability

CISourceOverCompositing

Places the second image over the first.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The formula used to create this filter is described in Thomas Porter and Tom Duff. 1984. Compositing Digital Images. Computer Graphics, 18 (3): 253-259.

Member of
CICategoryBuiltIn, CICategoryHighDynamicRange, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Source Over

Figure 102  The result of using the CISourceOverCompositing filter

The result of using the CISourceOverCompositing filter
Availability

CISpotColor

Replaces one or more color ranges with spot colors.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenterColor1

A CIColor class whose display name is Center Color 1.

inputReplacementColor1

A CIColor class whose display name is Replacement Color 1.

inputCloseness1

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Closeness1.

Default value: 0.22 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 0.50 Identity: 0.00

inputContrast1

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Contrast 1.

Default value: 0.98 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputCenterColor2

A CIColor class whose display name is Center Color 2.

inputReplacementColor2

A CIColor class whose display name is Replacement Color 2.

inputCloseness2

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Closeness 2.

Default value: 0.15 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 0.50 Identity: 0.00

inputContrast2

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Contrast 2.

Default value: 0.98 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputCenterColor3

A CIColor class whose display name is Center Color 3.

inputReplacementColor3

A CIColor class whose display name is Replacement Color 3.

inputCloseness3

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Closeness 3.

Default value: 0.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 0.50 Identity: 0.00

inputContrast3

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Contrast 3.

Default value: 0.99 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Spot Color

Figure 103  The result of using the CISpotColor filter

The result of using the CISpotColor filter
Availability

CISpotLight

Applies a directional spotlight effect to an image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputLightPosition

A CIVector class whose attribute type is CIAttributeTypePosition3 and whose display name is Light Position.

Default value: [400 600 150] Identity: (null)

inputLightPointsAt

A CIVector class whose attribute type is CIAttributeTypePosition3 and whose display name is Light Points At.

Default value: [200 200 0] Identity: (null)

inputBrightness

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Brightness.

Default value: 3.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 10.00 Identity: 1.00

inputConcentration

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Concentration.

Default value: 0.10 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.50 Identity: 20.00

inputColor

A CIColor class whose attribute type is CIAttributeTypeOpaqueColor and whose display name is Color.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Spot Light

Figure 104  The result of using the CISpotLight filter

The result of using the CISpotLight filter
Availability

CIStarShineGenerator

Generates a starburst pattern.

Parameters
inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputColor

A CIColor class whose display name is Color.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 50.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 300.00 Identity: 50.00

inputCrossScale

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Cross Scale.

Default value: 15.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 100.00 Identity: 15.00

inputCrossAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Cross Angle.

Default value: 0.60 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.60

inputCrossOpacity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Cross Opacity.

Default value: -2.00 Minimum: -8.00 Maximum: 0.00 Slider minimum: -8.00 Slider maximum: 0.00 Identity: -2.00

inputCrossWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Cross Width.

Default value: 2.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.50 Slider maximum: 10.00 Identity: 2.50

inputEpsilon

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Epsilon.

Default value: -2.00 Minimum: -8.00 Maximum: 0.00 Slider minimum: -8.00 Slider maximum: 0.00 Identity: -2.00

Discussion

The output image is typically used as input to another filter

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGenerator
Localized Display Name
Star Shine

Figure 105  The result of using the CIStarShineGenerator filter

The result of using the CIStarShineGenerator filter
Availability

CIStripesGenerator

Generates a stripe pattern.

Parameters
inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 80.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 800.00 Identity: 80.00

inputSharpness

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Sharpness.

Default value: 1.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 1.00

Discussion

You can control the color of the stripes, the spacing, and the contrast.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGenerator
Localized Display Name
Stripes

Figure 106  The result of using the CIStripesGenerator filter

The result of using the CIStripesGenerator filter
Availability

CISunbeamsGenerator

Generates a sun effect.

Parameters
inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputColor

A CIColor class whose display name is Color.

inputSunRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Sun Radius.

Default value: 40.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 800.00 Identity: 40.00

inputMaxStriationRadius

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Maximum Striation Radius.

Default value: 2.58 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 10.00 Identity: 2.58

inputStriationStrength

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Striation Strength.

Default value: 0.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 3.00 Identity: 0.50

inputStriationContrast

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Striation Contrast.

Default value: 1.38 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 5.00 Identity: 1.38

inputTime

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Discussion

You typically use the output of the sunbeams filter as input to a composite filter.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGenerator
Localized Display Name
Sunbeams

Figure 107  The result of using the CISunbeamsGenerator filter

The result of using the CISunbeamsGenerator filter
Availability

CISwipeTransition

Transitions from one image to another by simulating a swiping action.

Parameters
inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputExtent

A CIVector class whose attribute type is CIAttributeTypeRectangle and whose display name is Extent.

Default value: [0 0 300 300] Identity: (null)

inputColor

A CIColor class whose attribute type is CIAttributeTypeOpaqueColor and whose display name is Color.

inputTime

An NSNumber class whose attribute type is CIAttributeTypeTime and whose display name is Time.

Default value: 0.00 Minimum: 0.00 Maximum: 1.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 300.00 Minimum: 0.10 Maximum: 0.00 Slider minimum: 0.10 Slider maximum: 800.00 Identity: 0.00

inputOpacity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Opacity.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Swipe

Figure 108  The result of using the CISwipeTransition filter

The result of using the CISwipeTransition filter
Availability

CITorusLensDistortion

Creates a torus-shaped lens and distorts the portion of the image over which the lens is placed.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 160.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 500.00 Identity: 160.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 80.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 200.00 Identity: 80.00

inputRefraction

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Refraction.

Default value: 1.70 Minimum: -5.00 Maximum: 0.00 Slider minimum: -5.00 Slider maximum: 5.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Torus Lens Distortion

Figure 109  The result of using the CITorusLensDistortion filter

The result of using the CITorusLensDistortion filter
Availability

CITriangleTile

Maps a triangular portion of image to a triangular area and then tiles the result.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Triangle Tile

Figure 110  The result of using the CITriangleTile filter

The result of using the CITriangleTile filter
Availability

CITwelvefoldReflectedTile

Produces a tiled image from a source image by rotating the source image at increments of 30 degrees.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 0.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 0.00

inputWidth

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 1.00 Slider maximum: 200.00 Identity: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CITwelvefoldReflectedTile

Figure 111  The result of using the CITwelvefoldReflectedTile filter

The result of using the CITwelvefoldReflectedTile filter
Availability

CITwirlDistortion

Rotates pixels around a point to give a twirling effect.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 300.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 500.00 Identity: 300.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 3.14 Minimum: 0.00 Maximum: 0.00 Slider minimum: -12.57 Slider maximum: 12.57 Identity: 0.00

Discussion

You can specify the number of rotations as well as the center and radius of the effect.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Twirl Distortion

Figure 112  The result of using the CITwirlDistortion filter

The result of using the CITwirlDistortion filter
Availability

CIUnsharpMask

Increases the contrast of the edges between pixels of different colors in an image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 2.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 100.00 Identity: 0.00

inputIntensity

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Intensity.

Default value: 0.50 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 1.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategorySharpen
Localized Display Name
Unsharp Mask

Figure 113  The result of using the CIUnsharpMask filter

The result of using the CIUnsharpMask filter
Availability

CIVortexDistortion

Rotates pixels around a point to simulate a vortex.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputRadius

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 300.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 800.00 Identity: 300.00

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeAngle and whose display name is Angle.

Default value: 56.55 Minimum: 0.00 Maximum: 0.00 Slider minimum: -94.25 Slider maximum: 94.25 Identity: 0.00

Discussion

You can specify the number of rotations as well the center and radius of the effect.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Vortex Distortion

Figure 114  The result of using the CIVortexDistortion filter

The result of using the CIVortexDistortion filter
Availability

CIWhitePointAdjust

Adjusts the reference white point for an image and maps all colors in the source using the new reference.

Parameters
inputImage

A CIImage class whose display name is Image.

inputColor

A CIColor class whose display name is Color.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
White Point Adjust

Figure 115  The result of using the CIWhitePointAdjust filter

The result of using the CIWhitePointAdjust filter
Availability

CIZoomBlur

Simulates the effect of zooming the camera while capturing the image.

Parameters
inputImage

A CIImage class whose display name is Image.

inputCenter

A CIVector class whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150] Identity: (null)

inputAmount

An NSNumber class whose attribute type is CIAttributeTypeDistance and whose display name is Amount.

Default value: 20.00 Minimum: 0.00 Maximum: 0.00 Slider minimum: 0.00 Slider maximum: 200.00 Identity: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Zoom Blur

Figure 116  The result of using the CIZoomBlur filter

The result of using the CIZoomBlur filter
Availability


Last updated: 2008-07-11

Did this document help you? Yes It's good, but... Not helpful...