Core Image Filter Reference

Framework
CoreImage
Companion guide
Core Image Programming Guide

Overview

This reference describes the built-in filters available through the Core Image API. You can also find out about the built-in filters on a system by using the Core Image API. See Core Image Programming Guide.

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 object whose display name is Image.

inputBackgroundImage

A CIImage object 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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

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 object whose display name is Image.

inputTransform

On iOS, an NSValue object whose attribute type is CIAttributeTypeTransform. You must pass the transform as NSData using a statement similar to the following, where xform is an affine transform:

[myFilter setValue:[NSValue valueWithBytes:&xform
                                  objCType:@encode(CGAffineTransform)]
            forKey:@"inputTransform"];

On OSX, an NSAffineTransform object whose attribute type is CIAttributeTypeTransform.

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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIAffineTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTransform

On iOS, an NSValue object whose attribute type is CIAttributeTypeTransform. You must pass the transform as NSData using a statement similar to the following, where xform is an affine transform:

[myFilter setValue:[NSValue valueWithBytes:&xform
                                  objCType:@encode(CGAffineTransform)]
            forKey:@"inputTransform"];

On OSX, an NSAffineTransform object whose attribute type is CIAttributeTypeTransform.

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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIAffineTransform

Applies an affine transform to an image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputTransform

On iOS, an NSValue object whose attribute type is CIAttributeTypeTransform. You must pass the transform as NSData using a statement similar to the following, where xform is an affine transform:

[myFilter setValue:[NSValue valueWithBytes:&xform
                                  objCType:@encode(CGAffineTransform)]
            forKey:@"inputTransform"];

On OSX, an NSAffineTransform object whose attribute type is CIAttributeTypeTransform.

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
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CIAreaAverage

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

Parameters
inputImage

A CIImage object 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
  • Available in OS X v10.5 and later.

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 object 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
  • Available in OS X v10.5 and later.

CIAreaMaximum

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

Parameters
inputImage

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

inputExtent

The rectangular region of interest.

Discussion

Image component values should range from 0.0 to 1.0, inclusive.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Maximum
Availability
  • Available in OS X v10.5 and later.

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 object 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. Image component values should range from 0.0 to 1.0, inclusive.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Maximum Alpha
Availability
  • Available in OS X v10.5 and later.

CIAreaMinimum

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

Parameters
inputImage

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

inputExtent

The rectangular region of interest.

Discussion

Image component values should range from 0.0 to 1.0, inclusive.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Minimum
Availability
  • Available in OS X v10.5 and later.

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 object 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. Image component values should range from 0.0 to 1.0, inclusive.

Member of
CICategoryReduction, CICategoryStillImage, CICategoryVideo, CICategoryBuiltIn
Localized Display Name
Area Minimum Alpha
Availability
  • Available in OS X v10.5 and later.

CIBarsSwipeTransition

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputAngle

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

Default value: 3.14

inputWidth

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

Default value: 30.00

inputBarOffset

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

Default value: 10.00

inputTime

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

Default value: 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 filterThe result of using the CIBarsSwipeTransition filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CIBlendWithMask

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object whose display name is Background Image.

inputMaskImage

A CIImage object 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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIBloom

Softens edges and applies a pleasant glow to an image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 10.00

inputIntensity

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

Default value: 1.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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIBoxBlur

Blurs an image using a box-shaped convolution kernel.

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 10.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
  • Available in OS X v10.5 and later.

CIBumpDistortion

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputRadius

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

Default value: 300.00

inputScale

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

Default value: 0.50

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
  • Available in OS X v10.4 and later.

CIBumpDistortionLinear

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [300 300]

inputRadius

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

Default value: 300.00

inputAngle

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

Default value: 0.00

inputScale

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

Default value: 0.50

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
  • Available in OS X v10.5 and later.

CICheckerboardGenerator

Generates a checkerboard pattern.

Parameters
inputCenter

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

Default value: [150 150]

inputColor0

A CIColor object whose display name is Color 1.

inputColor1

A CIColor object whose display name is Color 2.

inputWidth

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

Default value: 80.00

inputSharpness

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

Default value: 1.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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CICircleSplashDistortion

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputRadius

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

Default value: 150.00

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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CICircularScreen

Simulates a circular-shaped halftone screen.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputWidth

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

Default value: 6.00

inputSharpness

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

Default value: 0.70

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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CICircularWrap

Wraps an image around a transparent circle.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputRadius

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

Default value: 150.00

inputAngle

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

Default value: 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
  • Available in OS X v10.4 and later.

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 object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputWidth

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

Default value: 6.00

inputAngle

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

Default value: 0.00

inputSharpness

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

Default value: 0.70

inputGCR

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

Default value: 1.00

inputUCR

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

Default value: 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
  • Available in OS X v10.4 and later.

CIColorBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIColorBurnBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIColorControls

Adjusts saturation, brightness, and contrast values.

Parameters
inputImage

A CIImage object whose display name is Image.

inputSaturation

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

Default value: 1.00

inputBrightness

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

inputContrast

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

Default value: 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
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CIColorCube

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCubeDimension

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

Default value: 2.00

inputCubeData

An NSData object whose display name is Cube Data.

Discussion

This filter applies a mapping from RGB space to new color values that are defined in inputCubeData. For each RGBA pixel in inputImage the filter uses the R,G and B values to index into a thee dimensional texture represented by inputCubeData. inputCubeData contains floating point RGBA cells that contain linear premultiplied values. The data is organized into inputCubeDimension number of xy planes, with each plane of size inputCubeDimension by inputCubeDimension. Input pixel components R and G are used to index the data in x and y respectively, and B is used to index in z. In inputCubeData the R component varies fastest, followed by G, then B.

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 filterThe result of using the CIColorCube filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIColorDodgeBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIColorInvert

Inverts the colors in an image.

Parameters
inputImage

A CIImage object 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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIColorMap

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputGradientImage

A CIImage object 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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIColorMatrix

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputRVector

A CIVector object whose display name is Red Vector.

Default value: [1 0 0 0]

inputGVector

A CIVector object whose display name is Green Vector.

Default value: [0 1 0 0]

inputBVector

A CIVector object whose display name is Blue Vector.

Default value: [0 0 1 0]

inputAVector

A CIVector object whose display name is Alpha Vector.

Default value: [0 0 0 1]

inputBiasVector

A CIVector object whose display name is Bias Vector.

Default value: [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
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CIColorMonochrome

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputColor

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

inputIntensity

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

Default value: 1.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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIColorPosterize

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputLevels

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

Default value: 6.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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIColumnAverage

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

Parameters
inputImage

A CIImage object 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
  • Available in OS X v10.5 and later.

CIComicEffect

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

Parameters
inputImage

A CIImage object 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
  • Available in OS X v10.5 and later.

CIConstantColorGenerator

Generates a solid color.

Parameters
inputColor

A CIColor object 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
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CICopyMachineTransition

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputExtent

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

Default value: [0 0 300 300]

inputColor

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

inputTime

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

Default value: 0.00

inputAngle

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

Default value: 0.00

inputWidth

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

Default value: 200.00

inputOpacity

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

Default value: 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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CICrop

Applies a crop to an image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputRectangle

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

Default value: [0 0 300 300]

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
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CICrystallize

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 20.00

inputCenter

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

Default value: [150 150]

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
  • Available in OS X v10.4 and later.

CIDarkenBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

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
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIDepthOfField

Simulates a depth of field effect.

Parameters
inputImage

A CIImage object whose display name is Image.

inputPoint1

The focused region of the image stretches in a line between inputPoint1 and inputPoint2 of the image. A CIVector object whose attribute type is CIAttributeTypePosition.

inputPoint2

A CIVector object whose attribute type is CIAttributeTypePosition.

inputSaturation

A saturation effect applied to the in-focus regions of the image. An NSNumber object whose attribute type is CIAttributeTypeScalar. This value indications the amount to adjust the saturation on the in-focus portion of the image.

inputUnsharpMaskRadius

Specifies the radius of the unsharp mask effect applied to the in-focus area. An NSNumber object whose attribute type is CIAttributeTypeScalar.

inputUnsharpMaskIntensity

Specifies the intensity of the unsharp mask effect applied to the in-focus area. An NSNumber object whose attribute type is CIAttributeTypeScalar.

inputRadius

Controls how much the out-of-focus regions are blurred. An NSNumber object whose attribute type is CIAttributeTypeScalar. This value specifies the distance from the center of the effect.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Depth of Field
Figure 32  The result of using the CIDepthOfField filter
Availability
  • Available in OS X v10.6 and later.

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 object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Difference Blend Mode
Figure 33  The result of using the CIDifferenceBlendMode filter
The result of using the CIDifferenceBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIDiscBlur

Blurs an image using a disc-shaped convolution kernel.

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 8.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
CIDiscBlur
Figure 34  The result of using the CIDiscBlur filter
The result of using the CIDiscBlur filter
Availability
  • Available in OS X v10.5 and later.

CIDisintegrateWithMaskTransition

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputMaskImage

A CIImage object whose display name is Mask Image.

inputTime

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

Default value: 0.00

inputShadowRadius

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

Default value: 8.00

inputShadowDensity

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

Default value: 0.65

inputShadowOffset

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

Default value: [0 -10]

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Disintegrate with Mask
Figure 35  The result of using the CIDisintegrateWithMaskTransition filter
The result of using the CIDisintegrateWithMaskTransition filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIDisplacementDistortion

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputDisplacementImage

A CIImage object whose display name is Displacement Image.

inputScale

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

Default value: 50.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 36  The result of using the CIDisplacementDistortion filter
The result of using the CIDisplacementDistortion filter
Availability
  • Available in OS X v10.4 and later.

CIDissolveTransition

Uses a dissolve to transition from one image to another.

Parameters
inputImage

A CIImage object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputTime

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

Default value: 0.00

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Dissolve
Figure 37  The result of using the CIDissolveTransition filter
The result of using the CIDissolveTransition filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIDotScreen

Simulates the dot patterns of a halftone screen.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

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

Default value: 6.00

inputSharpness

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

Default value: 0.70

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryHalftoneEffect
Localized Display Name
Dot Screen
Figure 38  The result of using the CIDotScreen filter
The result of using the CIDotScreen filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIDroste

Recursively draws a portion of an image in imitation of an M. C. Escher drawing.

Parameters
inputImage

A CIImage object whose display name is Image.

inputInsetPoint0

A CIVector object whose attribute type is CIAttributeTypePosition.

Default value: [200 200 ]

inputInsetPoint1

A CIVector object whose attribute type is CIAttributeTypePosition.

Default value: [400 400 ]

inputStrands

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

Default value: 1

inputPeriodicity

An NSNumber object whose attribute type is CIAttributeTypeDistance.

Default value: 1

inputRotation

An NSNumber object whose attribute type is CIAttributeTypeDistance.

Default value: 0.00

inputZoom

An NSNumber object whose attribute type is CIAttributeTypeScalar.

Default value: 1

Member of
CICategoryBuiltIn, CICategoryStillImage, ToneCuCICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Droste
Figure 39  The result of using the CIDroste filter
Availability
  • Available in OS X v10.6 and later.

CIEdges

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputIntensity

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

Default value: 1.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Edges
Figure 40  The result of using the CIEdges filter
The result of using the CIEdges filter
Availability
  • Available in OS X v10.4 and later.

CIEdgeWork

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 3.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Edge Work
Figure 41  The result of using the CIEdgeWork filter
The result of using the CIEdgeWork filter
Availability
  • Available in OS X v10.4 and later.

CIEightfoldReflectedTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIEightfoldReflectedTile
Figure 42  The result of using the CIEightfoldReflectedTile filter
The result of using the CIEightfoldReflectedTile filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CIExclusionBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Exclusion Blend Mode
Figure 43  The result of using the CIExclusionBlendMode filter
The result of using the CIExclusionBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

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 object whose display name is Image.

inputEV

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

Default value: 0.50

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 44  The result of using the CIExposureAdjust filter
The result of using the CIExposureAdjust filter
Availability
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CIFalseColor

Maps luminance to a color ramp of two colors.

Parameters
inputImage

A CIImage object whose display name is Image.

inputColor0

A CIColor object whose display name is Color 1.

inputColor1

A CIColor object 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 45  The result of using the CIFalseColor filter
The result of using the CIFalseColor filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIFlashTransition

Transitions from one image to another by creating a flash.

Parameters
inputImage

A CIImage object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputCenter

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

Default value: [150 150]

inputExtent

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

Default value: [0 0 300 300]

inputColor

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

inputTime

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

Default value: 0.00

inputMaxStriationRadius

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

Default value: 2.58

inputStriationStrength

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

Default value: 0.50

inputStriationContrast

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

Default value: 1.38

inputFadeThreshold

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

Default value: 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 46  The result of using the CIFlashTransition filter
The result of using the CIFlashTransition filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIFourfoldReflectedTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputAcuteAngle

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

Default value: 1.57

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIFourfoldReflectedTile
Figure 47  The result of using the CIFourfoldReflectedTile filter
The result of using the CIFourfoldReflectedTile filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CIFourfoldRotatedTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIFourfoldRotatedTile
Figure 48  The result of using the CIFourfoldRotatedTile filter
The result of using the CIFourfoldRotatedTile filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CIFourfoldTranslatedTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputAcuteAngle

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

Default value: 1.57

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIFourfoldTranslatedTile
Figure 49  The result of using the CIFourfoldTranslatedTile filter
The result of using the CIFourfoldTranslatedTile filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CIGammaAdjust

Adjusts midtone brightness.

Parameters
inputImage

A CIImage object whose display name is Image.

inputPower

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

Default value: 0.75

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 50  The result of using the CIGammaAdjust filter
The result of using the CIGammaAdjust filter
Availability
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CIGaussianBlur

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 10.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Gaussian Blur
Figure 51  The result of using the CIGaussianBlur filter
The result of using the CIGaussianBlur filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIGaussianGradient

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

Parameters
inputCenter

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

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

inputColor0

A CIColor object whose display name is Color 1.

inputColor1

A CIColor object whose display name is Color 2.

inputRadius

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

Default value: 300.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGradient
Localized Display Name
Gaussian Gradient
Figure 52  The result of using the CIGaussianGradient filter
The result of using the CIGaussianGradient filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIGlassDistortion

Distorts an image by applying a glass-like texture.

Parameters
inputImage

A CIImage object whose display name is Image.

inputTexture

A CIImage object whose display name is Texture.

inputCenter

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

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

inputScale

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

Default value: 200.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 53  The result of using the CIGlassDistortion filter
The result of using the CIGlassDistortion filter
Availability
  • Available in OS X v10.4 and later.

CIGlassLozenge

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputPoint0

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

Default value: [150 150]

inputPoint1

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

Default value: [350 150]

inputRadius

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

Default value: 100.00

inputRefraction

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

Default value: 1.70

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Glass Lozenge
Figure 54  The result of using the CIGlassLozenge filter
The result of using the CIGlassLozenge filter
Availability
  • Available in OS X v10.4 and later.

CIGlideReflectedTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CIGlideReflectedTile
Figure 55  The result of using the CIGlideReflectedTile filter
The result of using the CIGlideReflectedTile filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CIGloom

Dulls the highlights of an image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 10.00

inputIntensity

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

Default value: 1.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Gloom
Figure 56  The result of using the CIGloom filter
The result of using the CIGloom filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIHardLightBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Hard Light Blend Mode
Figure 57  The result of using the CIHardLightBlendMode filter
The result of using the CIHardLightBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIHatchedScreen

Simulates the hatched pattern of a halftone screen.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

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

Default value: 6.00

inputSharpness

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

Default value: 0.70

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryHalftoneEffect
Localized Display Name
Hatched Screen
Figure 58  The result of using the CIHatchedScreen filter
The result of using the CIHatchedScreen filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIHeightFieldFromMask

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 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 59  The result of using the CIHeightFieldFromMask filter
The result of using the CIHeightFieldFromMask filter
Availability
  • Available in OS X v10.4 and later.

CIHexagonalPixellate

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputScale

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

Default value: 8.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
CIHexagonalPixellate
Figure 60  The result of using the CIHexagonalPixellate filter
The result of using the CIHexagonalPixellate filter
Availability
  • Available in OS X v10.5 and later.

CIHighlightShadowAdjust

Adjust the tonal mapping of an image while preserving spatial detail.

Parameters
inputImage

A CIImage object whose display name is Image.

inputHighlightAmount

An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Highlight Amount.

Default value: 1.00

inputShadowAmount

An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Shadow Amount.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Highlight and Shadows
Figure 61  The result of using the CIHighlightShadowAdjust filter
The result of using the CIHexagonalPixellate filter
Availability
  • Available in OS X v10.7 and later and in iOS 5.0 and later.

CIHoleDistortion

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputRadius

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

Default value: 150.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Hole Distortion
Figure 62  The result of using the CIHoleDistortion filter
The result of using the CIHoleDistortion filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIHueAdjust

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputAngle

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

Default value: 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 63  The result of using the CIHueAdjust filter
The result of using the CIHueAdjust filter
Availability
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CIHueBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Hue Blend Mode
Figure 64  The result of using the CIHueBlendMode filter
The result of using the CIHueBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIKaleidoscope

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCount

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

Default value: 6.00

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Kaleidoscope
Figure 65  The result of using the CIKaleidoscope filter
The result of using the CIKaleidoscope filter
Availability
  • Available in OS X v10.4 and later.

CILanczosScaleTransform

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputScale

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

Default value: 1.00

inputAspectRatio

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

Default value: 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 66  The result of using the CILanczosScaleTransform filter
The result of using the CILanczosScaleTransform filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CILenticularHaloGenerator

Simulates a lens flare.

Parameters
inputCenter

The center of the lens flare. A CIVector object whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150]

inputColor

Controls the proportion of red, green, and blue halos. A CIColor object whose display name is Color.

inputHaloRadius

Controls the size of the lens flare. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Halo Radius.

Default value: 70.00

inputHaloWidth

Controls the width of the lens flare, that is, the distance between the inner flare and the outer flare. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Halo Width.

Default value: 87.00

inputHaloOverlap

Controls how much the red, green, and blue halos overlap. A value of 0 means no overlap (a lot of separation). A value of 1 means full overlap (white halos). An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Halo Overlap.

Default value: 0.77

inputStriationStrength

Controls the brightness of the rainbow-colored halo area. An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Striation Strength.

Default value: 0.50

inputStriationContrast

Controls the contrast of the rainbow-colored halo area. An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Striation Contrast.

Default value: 1.00

inputTime

Adds a randomness to the lens flare; it causes the flare to "sparkle" as it changes through various time values. An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Time.

Default value: 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 67  The result of using the CILenticularHaloGenerator filter
The result of using the CILenticularHaloGenerator filter
Availability
  • Available in OS X v10.4 and later.

CILightenBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Lighten Blend Mode
Figure 68  The result of using the CILightenBlendMode filter
The result of using the CILightenBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CILightTunnel

Rotates a portion of the input image specified by the center and radius parameters to give a tunneling effect.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

A CIVector object whose attribute type is CIAttributeTypePosition.

Default value: [150 150]

inputRotation

An NSNumber object whose attribute type is CIAttributeTypeAngle.

Default value: 0.00

inputRadius

An NSNumber object whose attribute type is CIAttributeTypeAngle.

Default value: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Light Tunnel
Figure 69  The result of using the CILightTunnel filter
Availability
  • Available in iOS 6.0 and later.

CILinearGradient

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

Parameters
inputPoint0

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

Default value: [0 0]

inputPoint1

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

Default value: [200 200]

inputColor0

A CIColor object whose display name is Color 1.

inputColor1

A CIColor object whose display name is Color 2.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGradient
Localized Display Name
Linear Gradient
Figure 70  The result of using the CILinearGradient filter
The result of using the CILinearGradient filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CILineOverlay

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputNRNoiseLevel

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

Default value: 0.07

inputNRSharpness

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

Default value: 0.71

inputEdgeIntensity

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

Default value: 1.00

inputThreshold

An NSNumber object 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 object whose attribute type is CIAttributeTypeScalar and whose display name is Contrast.

Default value: 50.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 71  The result of using the CILineOverlay filter
The result of using the CILineOverlay filter
Availability
  • Available in OS X v10.5 and later.

CILineScreen

Simulates the line pattern of a halftone screen.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

inputWidth

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

Default value: 6.00

inputSharpness

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

Default value: 0.70

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryHalftoneEffect
Localized Display Name
Line Screen
Figure 72  The result of using the CILineScreen filter
The result of using the CILineScreen filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CILuminosityBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Luminosity Blend Mode
Figure 73  The result of using the CILuminosityBlendMode filter
The result of using the CILuminosityBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIMaskToAlpha

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

Parameters
inputImage

A CIImage object 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 74  The result of using the CIMaskToAlpha filter
The result of using the CIMaskToAlpha filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIMaximumComponent

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

Parameters
inputImage

A CIImage object 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
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

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 object whose display name is Image.

inputBackgroundImage

A CIImage object 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 75  The result of using the CIMaximumCompositing filter
The result of using the CIMaximumCompositing filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIMedianFilter

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

Parameters
inputImage

A CIImage object whose display name is Image.

Discussion

The effect is to reduce noise.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Median
Figure 76  The result of using the CIMedianFilter filter
The result of using the CIMedianFilter filter
Availability
  • Available in OS X v10.4 and later.

CIMinimumComponent

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

Parameters
inputImage

A CIImage object 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
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

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 object whose display name is Image.

inputBackgroundImage

A CIImage object 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 77  The result of using the CIMinimumCompositing filter
The result of using the CIMinimumCompositing filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIModTransition

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputCenter

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

Default value: [150 150]

inputTime

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

Default value: 0.00

inputAngle

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

Default value: 2.00

inputRadius

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

Default value: 150.00

inputCompression

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

Default value: 300.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Mod
Figure 78  The result of using the CIModTransition filter
The result of using the CIModTransition filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

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 object whose display name is Image.

inputRadius

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

Default value: 20.00

inputAngle

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

Default value: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Motion Blur
Figure 79  The result of using the CIMotionBlur filter
The result of using the CIMotionBlur filter
Availability
  • Available in OS X v10.4 and later.

CIMultiplyBlendMode

Multiplies the input image samples with the background image samples.

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Multiply Blend Mode
Figure 80  The result of using the CIMultiplyBlendMode filter
The result of using the CIMultiplyBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIMultiplyCompositing

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 81  The result of using the CIMultiplyCompositing filter
The result of using the CIMultiplyCompositing filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CINoiseReduction

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputNoiseLevel

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

Default value: 0.02

inputSharpness

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

Default value: 0.40

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 82  The result of using the CINoiseReduction filter
The result of using the CINoiseReduction filter
Availability
  • Available in OS X v10.4 and later.

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 object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputScale

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

Default value: 2.80

inputAngle

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

Default value: 0.00

inputWidth

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

Default value: 65.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Op Tile
Figure 83  The result of using the CIOpTile filter
The result of using the CIOpTile filter
Availability
  • Available in OS X v10.4 and later.

CIOverlayBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Overlay Blend Mode
Figure 84  The result of using the CIOverlayBlendMode filter
The result of using the CIOverlayBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIPageCurlTransition

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputBacksideImage

A CIImage object whose display name is Backside Image.

inputShadingImage

A CIImage object whose display name is Shading Image.

inputExtent

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

Default value: [0 0 300 300]

inputTime

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

Default value: 0.00

inputAngle

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

Default value: 0.00

inputRadius

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

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Page Curl
Figure 85  The result of using the CIPageCurlTransition filter
The result of using the CIPageCurlTransition filter
Availability
  • Available in OS X v10.4 and later.

CIParallelogramTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputAcuteAngle

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

Default value: 1.57

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Parallelogram Tile
Figure 86  The result of using the CIParallelogramTile filter
The result of using the CIParallelogramTile filter
Availability
  • Available in OS X v10.4 and later.

CIPerspectiveTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTopLeft

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

Default value: [118 484]

inputTopRight

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

Default value: [646 507]

inputBottomRight

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

Default value: [548 140]

inputBottomLeft

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

Default value: [155 153]

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Perspective Tile
Figure 87  The result of using the CIPerspectiveTile filter
The result of using the CIPerspectiveTile filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIPerspectiveTransform

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTopLeft

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

Default value: [118 484]

inputTopRight

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

Default value: [646 507]

inputBottomRight

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

Default value: [548 140]

inputBottomLeft

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

Default value: [155 153]

Discussion

You can use the perspective filter to skew an image.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGeometryAdjustment
Localized Display Name
Perspective Transform
Figure 88  The result of using the CIPerspectiveTransform filter
The result of using the CIPerspectiveTransform filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIPerspectiveTransformWithExtent

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputExtent

A CIVector object whose whose attribute type is CIAttributeTypeRectangle. If you pass [image extent] you’ll get the same result as using the CIPerspectiveTransform filter.

inputTopLeft

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

Default value: [118 484]

inputTopRight

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

Default value: [646 507]

inputBottomRight

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

Default value: [548 140]

inputBottomLeft

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

Default value: [155 153]

Discussion

You can use the perspective filter to skew an the portion of the image defined by extent. See CIPerspectiveTransform for an example of the output of this filter when you supply the input image size as the extent.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGeometryAdjustment
Localized Display Name
Perspective Transform With Extent
Availability
  • Available in iOS 6.0 and later.

CIPinchDistortion

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputRadius

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

Default value: 300.00

inputScale

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

Default value: 0.50

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Pinch Distortion
Figure 89  The result of using the CIPinchDistortion filter
The result of using the CIPinchDistortion filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIPixellate

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputScale

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

Default value: 8.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Pixellate
Figure 90  The result of using the CIPixellate filter
The result of using the CIPixellate filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIPointillize

Renders the source image in a pointillistic style.

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 20.00

inputCenter

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

Default value: [150 150]

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Pointillize
Figure 91  The result of using the CIPointillize filter
The result of using the CIPointillize filter
Availability
  • Available in OS X v10.4 and later.

CIRadialGradient

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

Parameters
inputCenter

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

Default value: [150 150]

inputRadius0

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

Default value: 5.00

inputRadius1

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

Default value: 100.00

inputColor0

A CIColor object whose display name is Color 1.

inputColor1

A CIColor object 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 92  The result of using the CIRadialGradient filter
The result of using the CIRadialGradient filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

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 93  The result of using the CIRandomGenerator filter
The result of using the CIRandomGenerator filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

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 object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputShadingImage

A CIImage object whose display name is Shading Image.

inputCenter

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

Default value: [150 150]

inputExtent

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

Default value: [0 0 300 300]

inputTime

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

Default value: 0.00

inputWidth

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

Default value: 100.00

inputScale

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

Default value: 50.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Ripple
Figure 94  The result of using the CIRippleTransition filter
The result of using the CIRippleTransition filter
Availability
  • Available in OS X v10.4 and later.

CIRowAverage

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

Parameters
inputImage

A CIImage object 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
  • Available in OS X v10.5 and later.

CISaturationBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Saturation Blend Mode
Figure 95  The result of using the CISaturationBlendMode filter
The result of using the CISaturationBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIScreenBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Screen Blend Mode
Figure 96  The result of using the CIScreenBlendMode filter
The result of using the CIScreenBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CISepiaTone

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputIntensity

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

Default value: 1.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Sepia Tone
Figure 97  The result of using the CISepiaTone filter
The result of using the CISepiaTone filter
Availability
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CIShadedMaterial

Produces a shaded image from a height field.

Parameters
inputImage

A CIImage object whose display name is Image.

inputShadingImage

A CIImage object whose display name is Shading Image.

inputScale

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

Default value: 10.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 98  The result of using the CIShadedMaterial filter
The result of using the CIShadedMaterial filter
Availability
  • Available in OS X v10.4 and later.

CISharpenLuminance

Increases image detail by sharpening.

Parameters
inputImage

A CIImage object whose display name is Image.

inputSharpness

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

Default value: 0.40

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 99  The result of using the CISharpenLuminance filter
The result of using the CISharpenLuminance filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CISixfoldReflectedTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CISixfoldReflectedTile
Figure 100  The result of using the CISixfoldReflectedTile filter
The result of using the CISixfoldReflectedTile filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CISixfoldRotatedTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CISixfoldRotatedTile
Figure 101  The result of using the CISixfoldRotatedTile filter
The result of using the CISixfoldRotatedTile filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CISoftLightBlendMode

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 Reference and Adobe Extensions to the PDF Specification.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Soft Light Blend Mode
Figure 102  The result of using the CISoftLightBlendMode filter
The result of using the CISoftLightBlendMode filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CISourceAtopCompositing

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 103  The result of using the CISourceAtopCompositing filter
The result of using the CISourceAtopCompositing filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CISourceInCompositing

Uses the background image to define what to leave in the input image, effectively cropping the input image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 104  The result of using the CISourceInCompositing filter
The result of using the CISourceInCompositing filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CISourceOutCompositing

Uses the background image to define what to take out of the input image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 105  The result of using the CISourceOutCompositing filter
The result of using the CISourceOutCompositing filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CISourceOverCompositing

Places the input image over the input background image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputBackgroundImage

A CIImage object 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 106  The result of using the CISourceOverCompositing filter
The result of using the CISourceOverCompositing filter
Availability
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CISpotColor

Replaces one or more color ranges with spot colors.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenterColor1

A CIColor object whose display name is Center Color 1.

inputReplacementColor1

A CIColor object whose display name is Replacement Color 1.

inputCloseness1

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

Default value: 0.22

inputContrast1

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

Default value: 0.98

inputCenterColor2

A CIColor object whose display name is Center Color 2.

inputReplacementColor2

A CIColor object whose display name is Replacement Color 2.

inputCloseness2

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

Default value: 0.15

inputContrast2

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

Default value: 0.98

inputCenterColor3

A CIColor object whose display name is Center Color 3.

inputReplacementColor3

A CIColor object whose display name is Replacement Color 3.

inputCloseness3

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

Default value: 0.50

inputContrast3

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

Default value: 0.99

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Spot Color
Figure 107  The result of using the CISpotColor filter
The result of using the CISpotColor filter
Availability
  • Available in OS X v10.5 and later.

CISpotLight

Applies a directional spotlight effect to an image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputLightPosition

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

Default value: [400 600 150]

inputLightPointsAt

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

Default value: [200 200 0]

inputBrightness

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

Default value: 3.00

inputConcentration

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

Default value: 0.10

inputColor

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

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryStylize
Localized Display Name
Spot Light
Figure 108  The result of using the CISpotLight filter
The result of using the CISpotLight filter
Availability
  • Available in OS X v10.4 and later.

CIStarShineGenerator

Generates a starburst pattern that is similar to a supernova; can be used to simulate a lens flare.

Parameters
inputCenter

The center of the flare. A CIVector object whose attribute type is CIAttributeTypePosition and whose display name is Center.

Default value: [150 150]

inputColor

The color of the flare. A CIColor object whose display name is Color.

inputRadius

Controls the size of the flare. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Radius.

Default value: 50.00

inputCrossScale

Controls the ratio of the cross flare size relative to the round central flare. An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Cross Scale.

Default value: 15.00

inputCrossAngle

Controls the angle of the flare. An NSNumber object whose attribute type is CIAttributeTypeAngle and whose display name is Cross Angle.

Default value: 0.60

inputCrossOpacity

Controls the thickness of the cross flare. An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Cross Opacity.

Default value: -2.00

inputCrossWidth

Has the same overall effect as the inputCrossOpacity parameter. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Cross Width.

Default value: 2.50

inputEpsilon

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

Default value: -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 109  The result of using the CIStarShineGenerator filter
The result of using the CIStarShineGenerator filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIStraightenFilter

Rotates the source image by the specified angle in radians.

Parameters
inputImage

A CIImage object whose display name is Image.

inputAngle

An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Angle.

Default value: 0.00

Discussion

The image is scaled and cropped so that the rotated image fits the extent of the input image.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryGeometryAdjustment
Localized Display Name
Straighten
Figure 110  The result of using CIStraightenFilter filter
Availability
  • Available in OS X v10.7 and later and in iOS 5.0 and later.

CIStretchCrop

Distorts an image by stretching and or cropping it to fit a target size.

Parameters
inputImage

A CIImage object whose display name is Image.

inputSize

A CIVector object whose display name is Size. This value specifies the size of the output image in pixels.

inputCropAmount

An NSNumber object whose display name is CropAmount. This value determines if, and how much, cropping should be used to achieve the target size. If the value is 0, the image is stretched but not cropped. If the value is 1, the image is cropped but not stretched. Values in-between use stretching and cropping proportionally.

inputCenterStretchAmount

An NSNumber object whose display name is CenterStretchAmount. This value determines how much stretching to apply to the center of the image, if stretching is indicated by the inputCropAmount value. A value of 0 causes the center of the image to maintain its original aspect ratio. A value of 0 causes the image to be stretched uniformly.

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
CIStretchCrop
Figure 111  The result of using the CIStretchCrop filter
Availability
  • Available in OS X v10.6 and later.

CIStripesGenerator

Generates a stripe pattern.

Parameters
inputCenter

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

Default value: [150 150]

inputColor0

A CIColor object whose display name is Color 1.

inputColor1

A CIColor object whose display name is Color 2.

inputWidth

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

Default value: 80.00

inputSharpness

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

Default value: 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 112  The result of using the CIStripesGenerator filter
The result of using the CIStripesGenerator filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CISunbeamsGenerator

Generates a sun effect.

Parameters
inputCenter

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

Default value: [150 150]

inputColor

A CIColor object whose display name is Color.

inputSunRadius

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

Default value: 40.00

inputMaxStriationRadius

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

Default value: 2.58

inputStriationStrength

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

Default value: 0.50

inputStriationContrast

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

Default value: 1.38

inputTime

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

Default value: 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 113  The result of using the CISunbeamsGenerator filter
The result of using the CISunbeamsGenerator filter
Availability
  • Available in OS X v10.4 and later.

CISwipeTransition

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputTargetImage

A CIImage object whose display name is Target Image.

inputExtent

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

Default value: [0 0 300 300]

inputColor

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

inputTime

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

Default value: 0.00

inputAngle

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

Default value: 0.00

inputWidth

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

Default value: 300.00

inputOpacity

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

Default value: 0.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTransition
Localized Display Name
Swipe
Figure 114  The result of using the CISwipeTransition filter
The result of using the CISwipeTransition filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CITemperatureAndTint

Adapts the reference white point for an image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputNeutral

A CIVector object whose attribute type is CIAttributeTypeOffset and whose display name is Neutral.

Default value: [6500, 0]

inputTargetNeutral

A CIVector object whose attribute type is CIAttributeTypeOffset and whose display name is TargetNeutral

Default value: [6500, 0]

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
Temperature and Tint
Figure 115  The result of using the CITemperatureAndTint filter
Availability
  • Available in OS X v10.7 and later and in iOS 5.0 and later.

CIToneCurve

Adjusts tone response of the R, G, and B channels of an image.

Parameters
inputImage

A CIImage object whose display name is Image.

inputPoint0

A CIVector object whose attribute type is CIAttributeTypeOffset.

Default value: [0, 0]

inputPoint1

A CIVector object whose attribute type is CIAttributeTypeOffset.

Default value: [0.25, 0.25]

inputPoint2

A CIVector object whose attribute type is CIAttributeTypeOffset.

Default value: [0.5, 0.5]

inputPoint3

A CIVector object whose attribute type is CIAttributeTypeOffset.

Default value: [0.75, 0.75]

inputPoint4

A CIVector object whose attribute type is CIAttributeTypeOffset.

Default value: [1, 1]

Discussion

The input points are five x,y values that are interpolated using a spline curve. The curve is applied in a perceptual (gamma 2) version of the working space.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
Tone Curve
Figure 116  The result of using the CIToneCurve filter
The result of using the CIHueAdjust filter
Availability
  • Available in OS X v10.7 and later and in iOS 5.0 and later.

CITorusLensDistortion

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputRadius

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

Default value: 160.00

inputWidth

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

Default value: 80.00

inputRefraction

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

Default value: 1.70

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryDistortionEffect
Localized Display Name
Torus Lens Distortion
Figure 117  The result of using the CITorusLensDistortion filter
The result of using the CITorusLensDistortion filter
Availability
  • Available in OS X v10.4 and later.

CITriangleKaleidoscope

Maps a triangular portion of an input image to create a kaleidoscope effect.

Parameters
inputImage

A CIImage object whose display name is Image.

inputPoint

A CIVector object whose attribute type is CIAttributeTypePosition.

Default value: [150 150]

inputSize

A NSNumber object whose attribute type is CIAttributeTypeScalar.

Default value: 700.00

inputRotation

An NSNumber object whose attribute type is CIAttributeTypeAngle.

Default value: –0.36

inputDecay

An NSNumber object whose attribute type is CIAttributeTypeScalar.

Default: 0.85

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Triangle Kaleidoscope
Figure 118  The result of using the CITriangleKaleidoscope filter
Availability
  • Available in iOS 6.0 and later.

CITriangleTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

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

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
Triangle Tile
Figure 119  The result of using the CITriangleTile filter
The result of using the CITriangleTile filter
Availability
  • Available in OS X v10.4.

CITwelvefoldReflectedTile

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAngle

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

Default value: 0.00

inputWidth

The width, along with the inputCenter parameter, defines the portion of the image to tile. An NSNumber object whose attribute type is CIAttributeTypeDistance and whose display name is Width.

Default value: 100.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryTileEffect
Localized Display Name
CITwelvefoldReflectedTile
Figure 120  The result of using the CITwelvefoldReflectedTile filter
The result of using the CITwelvefoldReflectedTile filter
Availability
  • Available in OS X v10.5 and later and in iOS 6.0 and later.

CITwirlDistortion

Rotates pixels around a point to give a twirling effect.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputRadius

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

Default value: 300.00

inputAngle

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

Default value: 3.14

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 121  The result of using the CITwirlDistortion filter
The result of using the CITwirlDistortion filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIUnsharpMask

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 2.50

inputIntensity

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

Default value: 0.50

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategorySharpen
Localized Display Name
Unsharp Mask
Figure 122  The result of using the CIUnsharpMask filter
The result of using the CIUnsharpMask filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIVibrance

Adjusts the saturation of an image while keeping pleasing skin tones.

Parameters
inputImage

A CIImage object whose display name is Image.

inputAmount

An NSNumber object whose attribute type is CIAttributeTypeScalar and whose display name is Amount.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
Vibrance
Figure 123  The result of using the CIVibrance filter
The result of using the CIHueAdjust filter
Availability
  • Available in OS X v10.7 and later and in iOS 5.0 and later.

CIVignette

Reduces the brightness of an image at the periphery.

Parameters
inputImage

A CIImage object whose display name is Image.

inputRadius

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

Default value: 1.00

inputIntensity

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

Default value: 0.0

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryVideo, CICategoryColorEffect
Localized Display Name
Vignette
Figure 124  The result of using the CIVignette filter
Availability
  • Available in OS 5.0 and later.

CIVortexDistortion

Rotates pixels around a point to simulate a vortex.

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputRadius

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

Default value: 300.00

inputAngle

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

Default value: 56.55

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 125  The result of using the CIVortexDistortion filter
The result of using the CIVortexDistortion filter
Availability
  • Available in OS X v10.4 and later and in iOS 6.0 and later.

CIWhitePointAdjust

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputColor

A CIColor object whose display name is Color.

Member of
CICategoryBuiltIn, CICategoryNonSquarePixels, CICategoryInterlaced, CICategoryStillImage, CICategoryVideo, CICategoryColorAdjustment
Localized Display Name
White Point Adjust
Figure 126  The result of using the CIWhitePointAdjust filter
The result of using the CIWhitePointAdjust filter
Availability
  • Available in OS X v10.4 and later and in iOS 5.0 and later.

CIZoomBlur

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

Parameters
inputImage

A CIImage object whose display name is Image.

inputCenter

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

Default value: [150 150]

inputAmount

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

Default value: 20.00

Member of
CICategoryBuiltIn, CICategoryStillImage, CICategoryVideo, CICategoryBlur
Localized Display Name
Zoom Blur
Figure 127  The result of using the CIZoomBlur filter
The result of using the CIZoomBlur filter
Availability
  • Available in OS X v10.4 and later.


© 2012 Apple Inc. All Rights Reserved. (Last updated: 2012-12-13)

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