Core Image Filter Reference

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 inspect filter parameters and see an image produced by a filter by using the CIFilterBrowser widget, available in an XCode install at /Developer/Extras/Core Image/.

Filters by Task

CICategoryBlur

• CIBoxBlur
• CIDiscBlur
• CIGaussianBlur
• CIMedianFilter
• CIMotionBlur
• CINoiseReduction
• CIZoomBlur

CICategoryColorAdjustment

• CIColorControls
• CIColorMatrix
• CIExposureAdjust
• CIGammaAdjust
• CIHueAdjust
• CITemperatureAndTint
• CIToneCurve
• CIVibrance
• CIWhitePointAdjust

CICategoryColorEffect

• CIColorCube
• CIColorInvert
• CIColorMap
• CIColorMonochrome
• CIColorPosterize
• CIFalseColor
• CIMaskToAlpha
• CIMaximumComponent
• CIMinimumComponent
• CISepiaTone

CICategoryCompositeOperation

• CIAdditionCompositing
• CIColorBlendMode
• CIColorBurnBlendMode
• CIColorDodgeBlendMode
• CIDarkenBlendMode
• CIDifferenceBlendMode
• CIExclusionBlendMode
• CIHardLightBlendMode
• CIHueBlendMode
• CILightenBlendMode
• CILuminosityBlendMode
• CIMaximumCompositing
• CIMinimumCompositing
• CIMultiplyBlendMode
• CIMultiplyCompositing
• CIOverlayBlendMode
• CISaturationBlendMode
• CIScreenBlendMode
• CISoftLightBlendMode
• CISourceAtopCompositing
• CISourceInCompositing
• CISourceOutCompositing
• CISourceOverCompositing

CICategoryDistortionEffect

• CIBumpDistortion
• CIBumpDistortionLinear
• CICircleSplashDistortion
• CICircularWrap
• CIDisplacementDistortion
• CIGlassDistortion
• CIGlassLozenge
• CIHoleDistortion
• CIPinchDistortion
• CITorusLensDistortion
• CITwirlDistortion
• CIVortexDistortion

CICategoryGenerator

• CICheckerboardGenerator
• CIConstantColorGenerator
• CILenticularHaloGenerator
• CIRandomGenerator
• CIStarShineGenerator
• CIStripesGenerator
• CISunbeamsGenerator

CICategoryGeometryAdjustment

• CIAffineTransform
• CICrop
• CILanczosScaleTransform
• CIPerspectiveTransform
• CIStraightenFilter

CICategoryGradient

• CIGaussianGradient
• CILinearGradient
• CIRadialGradient

CICategoryHalftoneEffect

• CICircularScreen
• CICMYKHalftone
• CIDotScreen
• CIHatchedScreen
• CILineScreen

CICategoryReduction

• CIAreaAverage
• CIAreaHistogram
• CIRowAverage
• CIColumnAverage
• CIAreaMaximum
• CIAreaMinimum
• CIAreaMaximumAlpha
• CIAreaMinimumAlpha

CICategorySharpen

• CISharpenLuminance
• CIUnsharpMask

CICategoryStylize

• CIBlendWithMask
• CIBloom
• CIComicEffect
• CICrystallize
• CIEdges
• CIEdgeWork
• CIGloom
• CIHeightFieldFromMask
• CIHexagonalPixellate
• CIHighlightShadowAdjust
• CILineOverlay
• CIPixellate
• CIPointillize
• CIShadedMaterial
• CISpotColor
• CISpotLight

CICategoryTileEffect

• CIAffineClamp
• CIAffineTile
• CIEightfoldReflectedTile
• CIFourfoldReflectedTile
• CIFourfoldRotatedTile
• CIFourfoldTranslatedTile
• CIGlideReflectedTile
• CIKaleidoscope
• CIOpTile
• CIParallelogramTile
• CIPerspectiveTile
• CISixfoldReflectedTile
• CISixfoldRotatedTile
• CITriangleTile
• CITwelvefoldReflectedTile

CICategoryTransition

• CIBarsSwipeTransition
• CICopyMachineTransition
• CIDisintegrateWithMaskTransition
• CIDissolveTransition
• CIFlashTransition
• CIModTransition
• CIPageCurlTransition
• CIRippleTransition
• CISwipeTransition

Filters

CIAdditionCompositing

Adds color components to achieve a brightening effect.

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation

Localized Display Name

Addition

Figure 1  The result of using the CIAdditionCompositing filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputTransform

An NSAffineTransform class whose display name is Transform.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

Affine Clamp

Figure 2  The result of using the CIAffineClamp filter

Availability

• Available in OS X v10.4 and later.

CIAffineTile

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputTransform

An NSAffineTransform class whose display name is Transform.

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

Affine Tile

Figure 3  The result of using the CIAffineTile filter

Availability

• Available in OS X v10.4 and later.

CIAffineTransform

Applies an affine transform to an image.

Parameters

inputImage

A CIImage class whose display name is Image.

inputTransform

An NSAffineTransform class whose display name is Transform.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGeometryAdjustment

Localized Display Name

Affine Transform

Figure 4  The result of using the CIAffineTransform filter

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 class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of

CICategoryReduction,  CICategoryStillImage,  CICategoryVideo,  CICategoryBuiltIn

Localized Display Name

Area Average

Availability

• 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 class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

inputCount

The number of “buckets” for the histogram.

inputScale

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

Member of

CICategoryReduction,  CICategoryStillImage,  CICategoryVideo,  CICategoryBuiltIn

Localized Display Name

Area Histogram

Availability

• 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 class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of

CICategoryReduction,  CICategoryStillImage,  CICategoryVideo,  CICategoryBuiltIn

Localized Display Name

Area Maximum

Availability

• 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 class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Discussion

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

Member of

CICategoryReduction,  CICategoryStillImage,  CICategoryVideo,  CICategoryBuiltIn

Localized Display Name

Area Maximum Alpha

Availability

• 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 class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of

CICategoryReduction,  CICategoryStillImage,  CICategoryVideo,  CICategoryBuiltIn

Localized Display Name

Area Minimum

Availability

• 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 class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Discussion

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

Member of

CICategoryReduction,  CICategoryStillImage,  CICategoryVideo,  CICategoryBuiltIn

Localized Display Name

Area Minimum Alpha

Availability

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

inputTargetImage

A CIImage class whose display name is Target Image.

inputAngle

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

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

inputWidth

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

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

inputBarOffset

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

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

inputTime

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

CIBarsSwipeTransition

Figure 5  The result of using the CIBarsSwipeTransition filter

Availability

• Available in OS X v10.5 and later.

CIBlendWithMask

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

inputMaskImage

A CIImage class whose display name is Mask Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Blend With Mask

Figure 6  The result of using the CIBlendWithMask filter

Availability

• Available in OS X v10.4 and later.

CIBloom

Softens edges and applies a pleasant glow to an image.

Parameters

inputImage

A CIImage class whose display name is Image.

inputRadius

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

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

inputIntensity

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Bloom

Figure 7  The result of using the CIBloom filter

Availability

• Available in OS X v10.4 and later.

CIBoxBlur

Blurs an image using a box-shaped convolution kernel.

Parameters

inputImage

A CIImage class whose display name is Image.

inputRadius

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryBlur

Localized Display Name

CIBoxBlur

Figure 8  The result of using the CIBoxBlur filter

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

inputCenter

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

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

inputRadius

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

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

inputScale

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

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

Discussion

The bump can be concave or convex.

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Bump Distortion

Figure 9  The result of using the CIBumpDistortion filter

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

inputCenter

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

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

inputRadius

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

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

inputAngle

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

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

inputScale

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

CIBumpDistortionLinear

Figure 10  The result of using the CIBumpDistortionLinear filter

Availability

• Available in OS X v10.5 and later.

CICheckerboardGenerator

Generates a checkerboard pattern.

Parameters

inputCenter

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

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

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

inputWidth

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

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

inputSharpness

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGenerator

Localized Display Name

Checkerboard

Figure 11  The result of using the CICheckerboardGenerator filter

Availability

• Available in OS X v10.4 and later.

CICircleSplashDistortion

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputRadius

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Circle Splash Distortion

Figure 12  The result of using the CICircleSplashDistortion filter

Availability

• Available in OS X v10.4 and later.

CICircularScreen

Simulates a circular-shaped halftone screen.

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputWidth

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

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

inputSharpness

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryHalftoneEffect

Localized Display Name

Circular Screen

Figure 13  The result of using the CICircularScreen filter

Availability

• Available in OS X v10.4 and later.

CICircularWrap

Wraps an image around a transparent circle.

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputRadius

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

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

inputAngle

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Circular Wrap Distortion

Figure 14  The result of using the CICircularWrap filter

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

inputCenter

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

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

inputWidth

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

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

inputAngle

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

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

inputSharpness

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

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

inputGCR

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

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

inputUCR

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryHalftoneEffect

Localized Display Name

CMYK Halftone

Figure 15  The result of using the CICMYKHalftone filter

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

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

This mode preserves the gray levels in the image. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF 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

Availability

• Available in OS X v10.4 and later.

CIColorBurnBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

Source image sample values that specify white do not produce a change. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF 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

Availability

• Available in OS X v10.4 and later.

CIColorControls

Adjusts saturation, brightness, and contrast values.

Parameters

inputImage

A CIImage class whose display name is Image.

inputSaturation

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

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

inputBrightness

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

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

inputContrast

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

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

Discussion

To calculate saturation, this filter linearly interpolates between a grayscale image (saturation = 0.0) and the original image (saturation = 1.0). The filter supports extrapolation: For values large than1.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

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

inputCubeDimension

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

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

inputCubeData

An NSData class whose display name is Cube Data.

Discussion

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

Availability

• Available in OS X v10.4 and later.

CIColorDodgeBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

Source image sample values that specify black do not produce a change. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF 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

Availability

• Available in OS X v10.4 and later.

CIColorInvert

Inverts the colors in an image.

Parameters

inputImage

A CIImage class whose display name is Image.

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

Color Invert

Figure 21  The result of using the CIColorInvert filter

Availability

• Available in OS X v10.4 and later.

CIColorMap

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputGradientImage

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

Color Map

Figure 22  The result of using the CIColorMap filter

Availability

• Available in OS X v10.4 and later.

CIColorMatrix

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputRVector

A CIVector class whose display name is Red Vector.

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

inputGVector

A CIVector class whose display name is Green Vector.

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

inputBVector

A CIVector class whose display name is Blue Vector.

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

inputAVector

A CIVector class whose display name is Alpha Vector.

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

inputBiasVector

A CIVector class whose display name is Bias Vector.

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

Discussion

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

s.r = dot(s, redVector)

s.g = dot(s, greenVector)

s.b = dot(s, blueVector)

s.a = dot(s, alphaVector)

s = s + bias

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryColorAdjustment

Localized Display Name

Color Matrix

Figure 23  The result of using the CIColorMatrix filter

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

inputColor

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

inputIntensity

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

Color Monochrome

Figure 24  The result of using the CIColorMonochrome filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputLevels

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

Color Posterize

Figure 25  The result of using the CIColorPosterize filter

Availability

• Available in OS X v10.4 and later.

CIColumnAverage

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

Parameters

inputImage

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

inputExtent

The rectangular region of interest.

Member of

CICategoryReduction,  CICategoryStillImage,  CICategoryVideo,  CICategoryBuiltIn

Localized Display Name

Column Average

Availability

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Comic Effect

Figure 26  The result of using the CIComicEffect filter

Availability

• Available in OS X v10.5 and later.

CIConstantColorGenerator

Generates a solid color.

Parameters

inputColor

A CIColor class whose display name is Color.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGenerator

Localized Display Name

Constant Color

Figure 27  The result of using the CIConstantColorGenerator filter

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

inputTargetImage

A CIImage class whose display name is Target Image.

inputExtent

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

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

inputColor

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

inputTime

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

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

inputAngle

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

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

inputWidth

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

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

inputOpacity

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

Copy Machine

Figure 28  The result of using the CICopyMachineTransition filter

Availability

• Available in OS X v10.4 and later.

CICrop

Applies a crop to an image.

Parameters

inputImage

A CIImage class whose display name is Image.

inputRectangle

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGeometryAdjustment

Localized Display Name

Crop

Figure 29  The result of using the CICrop filter

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

inputRadius

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

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

inputCenter

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Crystallize

Figure 30  The result of using the CICrystallize filter

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

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The result is that the background image samples are replaced by any source image samples that are darker. Otherwise, the background image samples are left unchanged. The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF 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

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Difference Blend Mode

Figure 32  The result of using the CIDifferenceBlendMode filter

Availability

• Available in OS X v10.4 and later.

CIDiscBlur

Blurs an image using a disc-shaped convolution kernel.

Parameters

inputImage

A CIImage class whose display name is Image.

inputRadius

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryBlur

Localized Display Name

CIDiscBlur

Figure 33  The result of using the CIDiscBlur filter

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

inputTargetImage

A CIImage class whose display name is Target Image.

inputMaskImage

A CIImage class whose display name is Mask Image.

inputTime

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

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

inputShadowRadius

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

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

inputShadowDensity

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

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

inputShadowOffset

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

Disintegrate with Mask

Figure 34  The result of using the CIDisintegrateWithMaskTransition filter

Availability

• Available in OS X v10.4 and later.

CIDisplacementDistortion

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputDisplacementImage

A CIImage class whose display name is Displacement Image.

inputScale

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Displacement Distortion

Figure 35  The result of using the CIDisplacementDistortion filter

Availability

• Available in OS X v10.4 and later.

CIDissolveTransition

Uses a dissolve to transition from one image to another.

Parameters

inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputTime

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

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

Dissolve

Figure 36  The result of using the CIDissolveTransition filter

Availability

• Available in OS X v10.4 and later.

CIDotScreen

Simulates the dot patterns of a halftone screen.

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

inputSharpness

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryHalftoneEffect

Localized Display Name

Dot Screen

Figure 37  The result of using the CIDotScreen filter

Availability

• Available in OS X v10.4 and later.

CIEdges

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputIntensity

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Edges

Figure 38  The result of using the CIEdges filter

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

inputRadius

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Edge Work

Figure 39  The result of using the CIEdgeWork filter

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

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

CIEightfoldReflectedTile

Figure 40  The result of using the CIEightfoldReflectedTile filter

Availability

• Available in OS X v10.5 and later.

CIExclusionBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Exclusion Blend Mode

Figure 41  The result of using the CIExclusionBlendMode filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputEV

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

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

Discussion

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

s.rgb * pow(2.0, ev)

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryColorAdjustment

Localized Display Name

Exposure Adjust

Figure 42  The result of using the CIExposureAdjust filter

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

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

False Color

Figure 43  The result of using the CIFalseColor filter

Availability

• Available in OS X v10.4 and later.

CIFlashTransition

Transitions from one image to another by creating a flash.

Parameters

inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputCenter

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

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

inputExtent

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

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

inputColor

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

inputTime

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

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

inputMaxStriationRadius

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

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

inputStriationStrength

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

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

inputStriationContrast

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

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

inputFadeThreshold

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

Flash

Figure 44  The result of using the CIFlashTransition filter

Availability

• Available in OS X v10.4 and later.

CIFourfoldReflectedTile

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputAcuteAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

CIFourfoldReflectedTile

Figure 45  The result of using the CIFourfoldReflectedTile filter

Availability

• Available in OS X v10.5 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 class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

CIFourfoldRotatedTile

Figure 46  The result of using the CIFourfoldRotatedTile filter

Availability

• Available in OS X v10.5 and later.

CIFourfoldTranslatedTile

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputAcuteAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

CIFourfoldTranslatedTile

Figure 47  The result of using the CIFourfoldTranslatedTile filter

Availability

• Available in OS X v10.5 and later.

CIGammaAdjust

Adjusts midtone brightness.

Parameters

inputImage

A CIImage class whose display name is Image.

inputPower

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

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

Discussion

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

pow(s.rgb, vec3(power))

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryColorAdjustment

Localized Display Name

Gamma Adjust

Figure 48  The result of using the CIGammaAdjust filter

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

inputRadius

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryBlur

Localized Display Name

Gaussian Blur

Figure 49  The result of using the CIGaussianBlur filter

Availability

• Available in OS X v10.4 and later.

CIGaussianGradient

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

Parameters

inputCenter

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

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

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

inputRadius

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGradient

Localized Display Name

Gaussian Gradient

Figure 50  The result of using the CIGaussianGradient filter

Availability

• Available in OS X v10.4 and later.

CIGlassDistortion

Distorts an image by applying a glass-like texture.

Parameters

inputImage

A CIImage class whose display name is Image.

inputTexture

A CIImage class whose display name is Texture.

inputCenter

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

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

inputScale

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Glass Distortion

Figure 51  The result of using the CIGlassDistortion filter

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

inputPoint0

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

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

inputPoint1

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

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

inputRadius

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

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

inputRefraction

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Glass Lozenge

Figure 52  The result of using the CIGlassLozenge filter

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

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

CIGlideReflectedTile

Figure 53  The result of using the CIGlideReflectedTile filter

Availability

• Available in OS X v10.5 and later.

CIGloom

Dulls the highlights of an image.

Parameters

inputImage

A CIImage class whose display name is Image.

inputRadius

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

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

inputIntensity

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Gloom

Figure 54  The result of using the CIGloom filter

Availability

• Available in OS X v10.4 and later.

CIHardLightBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Hard Light Blend Mode

Figure 55  The result of using the CIHardLightBlendMode filter

Availability

• Available in OS X v10.4 and later.

CIHatchedScreen

Simulates the hatched pattern of a halftone screen.

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

inputSharpness

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryHalftoneEffect

Localized Display Name

Hatched Screen

Figure 56  The result of using the CIHatchedScreen filter

Availability

• Available in OS X v10.4 and later.

CIHeightFieldFromMask

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputRadius

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Height Field From Mask

Figure 57  The result of using the CIHeightFieldFromMask filter

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

inputCenter

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

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

inputScale

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

CIHexagonalPixellate

Figure 58  The result of using the CIHexagonalPixellate filter

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

inputHighlightAmount

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

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

inputShadowAmount

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Highlight and Shadows

Figure 59  The result of using the CIHighlightShadowAdjust filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputCenter

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

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

inputRadius

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Hole Distortion

Figure 60  The result of using the CIHoleDistortion filter

Availability

• Available in OS X v10.4 and later.

CIHueAdjust

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputAngle

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryColorAdjustment

Localized Display Name

Hue Adjust

Figure 61  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 with the hue of the source image.

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

The formula used to create this filter is described in the PDF specification, which is available online from the Adobe Developer Center. See PDF Reference and Adobe Extensions to the PDF Specification.

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Hue Blend Mode

Figure 62  The result of using the CIHueBlendMode filter

Availability

• Available in OS X v10.4 and later.

CIKaleidoscope

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputCount

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

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

inputCenter

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

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

inputAngle

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

Kaleidoscope

Figure 63  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 class whose display name is Image.

inputScale

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

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

inputAspectRatio

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

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

Discussion

You typically use this filter to scale down an image.

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGeometryAdjustment

Localized Display Name

Lanczos Scale Transform

Figure 64  The result of using the CILanczosScaleTransform filter

Availability

• Available in OS X v10.4 and later.

CILenticularHaloGenerator

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

Parameters

inputCenter

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

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

inputColor

A CIColor class whose display name is Color.

inputHaloRadius

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

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

inputHaloWidth

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

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

inputHaloOverlap

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

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

inputStriationStrength

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

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

inputStriationContrast

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

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

inputTime

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGenerator

Localized Display Name

Lenticular Halo

Figure 65  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 class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Lighten Blend Mode

Figure 66  The result of using the CILightenBlendMode filter

Availability

• Available in OS X v10.4 and later.

CILinearGradient

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

Parameters

inputPoint0

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

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

inputPoint1

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

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

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGradient

Localized Display Name

Linear Gradient

Figure 67  The result of using the CILinearGradient filter

Availability

• Available in OS X v10.4 and later.

CILineOverlay

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputNRNoiseLevel

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

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

inputNRSharpness

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

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

inputEdgeIntensity

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

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

inputThreshold

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

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

inputContrast

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Line Overlay

Figure 68  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 class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

inputSharpness

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryHalftoneEffect

Localized Display Name

Line Screen

Figure 69  The result of using the CILineScreen filter

Availability

• Available in OS X v10.4 and later.

CILuminosityBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Luminosity Blend Mode

Figure 70  The result of using the CILuminosityBlendMode filter

Availability

• Available in OS X v10.4 and later.

CIMaskToAlpha

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

Parameters

inputImage

A CIImage class whose display name is Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

Mask To Alpha

Figure 71  The result of using the CIMaskToAlpha filter

Availability

• Available in OS X v10.4 and later.

CIMaximumComponent

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

Parameters

inputImage

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

Maximum Component

Availability

• Available in OS X v10.5 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 class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation

Localized Display Name

Maximum

Figure 72  The result of using the CIMaximumCompositing filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

Discussion

The effect is to reduce noise.

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryBlur

Localized Display Name

Median

Figure 73  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 class whose display name is Image. This is the image data you want to process.

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

Minimum Component

Availability

• Available in OS X v10.5 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 class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation

Localized Display Name

Minimum

Figure 74  The result of using the CIMinimumCompositing filter

Availability

• Available in OS X v10.4 and later.

CIModTransition

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputCenter

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

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

inputTime

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

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

inputAngle

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

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

inputRadius

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

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

inputCompression

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

Mod

Figure 75  The result of using the CIModTransition filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputRadius

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

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

inputAngle

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryBlur

Localized Display Name

Motion Blur

Figure 76  The result of using the CIMotionBlur filter

Availability

• Available in OS X v10.4 and later.

CIMultiplyBlendMode

Multiplies the source image samples with the background image samples.

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Multiply Blend Mode

Figure 77  The result of using the CIMultiplyBlendMode filter

Availability

• Available in OS X v10.4 and later.

CIMultiplyCompositing

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation

Localized Display Name

Multiply

Figure 78  The result of using the CIMultiplyCompositing filter

Availability

• Available in OS X v10.4 and later.

CINoiseReduction

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputNoiseLevel

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

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

inputSharpness

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryBlur

Localized Display Name

Noise Reduction

Figure 79  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 class whose display name is Image.

inputCenter

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

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

inputScale

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

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

inputAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

Op Tile

Figure 80  The result of using the CIOpTile filter

Availability

• Available in OS X v10.4 and later.

CIOverlayBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Overlay Blend Mode

Figure 81  The result of using the CIOverlayBlendMode filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputBacksideImage

A CIImage class whose display name is Backside Image.

inputShadingImage

A CIImage class whose display name is Shading Image.

inputExtent

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

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

inputTime

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

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

inputAngle

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

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

inputRadius

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

Page Curl

Figure 82  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 class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputAcuteAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

Parallelogram Tile

Figure 83  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 class whose display name is Image.

inputTopLeft

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

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

inputTopRight

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

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

inputBottomRight

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

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

inputBottomLeft

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

Perspective Tile

Figure 84  The result of using the CIPerspectiveTile filter

Availability

• Available in OS X v10.4 and later.

CIPerspectiveTransform

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputTopLeft

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

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

inputTopRight

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

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

inputBottomRight

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

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

inputBottomLeft

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

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

Discussion

You can use the perspective filter to skew an image.

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGeometryAdjustment

Localized Display Name

Perspective Transform

Figure 85  The result of using the CIPerspectiveTransform filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputCenter

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

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

inputRadius

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

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

inputScale

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Pinch Distortion

Figure 86  The result of using the CIPinchDistortion filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputCenter

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

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

inputScale

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Pixellate

Figure 87  The result of using the CIPixellate filter

Availability

• Available in OS X v10.4 and later.

CIPointillize

Renders the source image in a pointillistic style.

Parameters

inputImage

A CIImage class whose display name is Image.

inputRadius

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

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

inputCenter

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Pointillize

Figure 88  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 class whose attribute type is CIAttributeTypePosition and whose display name is Center.

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

inputRadius0

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

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

inputRadius1

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

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

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGradient

Localized Display Name

Radial Gradient

Figure 89  The result of using the CIRadialGradient filter

Availability

• Available in OS X v10.4 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 90  The result of using the CIRandomGenerator filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputShadingImage

A CIImage class whose display name is Shading Image.

inputCenter

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

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

inputExtent

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

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

inputTime

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

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

inputWidth

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

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

inputScale

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

Ripple

Figure 91  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 class whose display name is Image. This is the image data you want to process.

inputExtent

The rectangular region of interest.

Member of

CICategoryReduction,  CICategoryStillImage,  CICategoryVideo,  CICategoryBuiltIn

Localized Display Name

Row Average

Availability

• Available in OS X v10.5 and later.

CISaturationBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Saturation Blend Mode

Figure 92  The result of using the CISaturationBlendMode filter

Availability

• Available in OS X v10.4 and later.

CIScreenBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Screen Blend Mode

Figure 93  The result of using the CIScreenBlendMode filter

Availability

• Available in OS X v10.4 and later.

CISepiaTone

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputIntensity

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryVideo,  CICategoryColorEffect

Localized Display Name

Sepia Tone

Figure 94  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 class whose display name is Image.

inputShadingImage

A CIImage class whose display name is Shading Image.

inputScale

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

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

Discussion

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

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

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Shaded Material

Figure 95  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 class whose display name is Image.

inputSharpness

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategorySharpen

Localized Display Name

Sharpen Luminance

Figure 96  The result of using the CISharpenLuminance filter

Availability

• Available in OS X v10.4 and later.

CISixfoldReflectedTile

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

CISixfoldReflectedTile

Figure 97  The result of using the CISixfoldReflectedTile filter

Availability

• Available in OS X v10.5 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 class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

CISixfoldRotatedTile

Figure 98  The result of using the CISixfoldRotatedTile filter

Availability

• Available in OS X v10.5 and later.

CISoftLightBlendMode

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryCompositeOperation

Localized Display Name

Soft Light Blend Mode

Figure 99  The result of using the CISoftLightBlendMode filter

Availability

• Available in OS X v10.4 and later.

CISourceAtopCompositing

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation

Localized Display Name

Source Atop

Figure 100  The result of using the CISourceAtopCompositing filter

Availability

• Available in OS X v10.4 and later.

CISourceInCompositing

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation

Localized Display Name

Source In

Figure 101  The result of using the CISourceInCompositing filter

Availability

• Available in OS X v10.4 and later.

CISourceOutCompositing

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation

Localized Display Name

Source Out

Figure 102  The result of using the CISourceOutCompositing filter

Availability

• Available in OS X v10.4 and later.

CISourceOverCompositing

Places the second image over the first.

Parameters

inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation

Localized Display Name

Source Over

Figure 103  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 class whose display name is Image.

inputCenterColor1

A CIColor class whose display name is Center Color 1.

inputReplacementColor1

A CIColor class whose display name is Replacement Color 1.

inputCloseness1

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

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

inputContrast1

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

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

inputCenterColor2

A CIColor class whose display name is Center Color 2.

inputReplacementColor2

A CIColor class whose display name is Replacement Color 2.

inputCloseness2

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

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

inputContrast2

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

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

inputCenterColor3

A CIColor class whose display name is Center Color 3.

inputReplacementColor3

A CIColor class whose display name is Replacement Color 3.

inputCloseness3

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

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

inputContrast3

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Spot Color

Figure 104  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 class whose display name is Image.

inputLightPosition

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

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

inputLightPointsAt

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

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

inputBrightness

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

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

inputConcentration

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

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

inputColor

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryStylize

Localized Display Name

Spot Light

Figure 105  The result of using the CISpotLight filter

Availability

• Available in OS X v10.4 and later.

CIStarShineGenerator

Generates a starburst pattern.

Parameters

inputCenter

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

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

inputColor

A CIColor class whose display name is Color.

inputRadius

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

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

inputCrossScale

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

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

inputCrossAngle

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

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

inputCrossOpacity

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

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

inputCrossWidth

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

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

inputEpsilon

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

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

Discussion

The output image is typically used as input to another filter

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGenerator

Localized Display Name

Star Shine

Figure 106  The result of using the CIStarShineGenerator filter

Availability

• Available in OS X v10.4 and later.

CIStraightenFilter

Rotates the source image by the specified angle in radians.

Parameters

inputImage

A CIImage class whose display name is Image.

inputAngle

An NSNumber class whose attribute type is CIAttributeTypeScalar and whose display name is Angle

Default value: 0.00 Slider minimum: -3.14 Slider maximum: 3.14 Identity: 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 107  The result of using CIStraightenFilter filter

Availability

• Available in OS X v10.4 and later and in iOS 5.0 and later.

CIStripesGenerator

Generates a stripe pattern.

Parameters

inputCenter

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

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

inputColor0

A CIColor class whose display name is Color 1.

inputColor1

A CIColor class whose display name is Color 2.

inputWidth

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

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

inputSharpness

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGenerator

Localized Display Name

Stripes

Figure 108  The result of using the CIStripesGenerator filter

Availability

• Available in OS X v10.4 and later.

CISunbeamsGenerator

Generates a sun effect.

Parameters

inputCenter

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

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

inputColor

A CIColor class whose display name is Color.

inputSunRadius

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

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

inputMaxStriationRadius

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

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

inputStriationStrength

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

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

inputStriationContrast

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

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

inputTime

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryGenerator

Localized Display Name

Sunbeams

Figure 109  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 class whose display name is Image.

inputTargetImage

A CIImage class whose display name is Target Image.

inputExtent

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

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

inputColor

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

inputTime

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

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

inputAngle

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

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

inputWidth

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

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

inputOpacity

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTransition

Localized Display Name

Swipe

Figure 110  The result of using the CISwipeTransition filter

Availability

• Available in OS X v10.4 and later.

CITemperatureAndTint

Adapts the reference white point for an image.

Parameters

inputImage

A CIImage class whose display name is Image.

inputNeutral

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

Default value: [6500, 0] Identity: [6500, 0]

inputTargetNeutral

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

Default value: [6500, 0] Identity: [6500, 0]

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryColorAdjustment

Localized Display Name

Temperature and Tint

Figure 111  The result of using the CITemperatureAndTint filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputPoint0

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

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

inputPoint1

A CIVector class whose attribute type is CIAttributeTypeOffset and whose display name is Point 2l

Default value: [0.25, 0.25] Identity: [0.25, 0.25]

inputPoint2

A CIVector class whose attribute type is CIAttributeTypeOffset and whose display name is Point 3l

Default value: [0.5, 0.5] Identity: [0.5, 0.5]

inputPoint3

A CIVector class whose attribute type is CIAttributeTypeOffset and whose display name is Point 4

Default value: [0.75, 0.75] Identity: [0.75, 0.75]

inputPoint4

A CIVector class whose attribute type is CIAttributeTypeOffset and whose display name is Point 5

Default value: [1, 1] Identity: [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 112  The result of using the CIToneCurve filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputCenter

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

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

inputRadius

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

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

inputWidth

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

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

inputRefraction

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Torus Lens Distortion

Figure 113  The result of using the CITorusLensDistortion filter

Availability

• Available in OS X v10.4 and later.

CITriangleTile

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

Triangle Tile

Figure 114  The result of using the CITriangleTile filter

Availability

• Available in OS X v10.4 and later.

CITwelvefoldReflectedTile

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputAngle

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

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

inputWidth

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryTileEffect

Localized Display Name

CITwelvefoldReflectedTile

Figure 115  The result of using the CITwelvefoldReflectedTile filter

Availability

• Available in OS X v10.5 and later.

CITwirlDistortion

Rotates pixels around a point to give a twirling effect.

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputRadius

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

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

inputAngle

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Twirl Distortion

Figure 116  The result of using the CITwirlDistortion filter

Availability

• Available in OS X v10.4 and later.

CIUnsharpMask

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputRadius

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

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

inputIntensity

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategorySharpen

Localized Display Name

Unsharp Mask

Figure 117  The result of using the CIUnsharpMask filter

Availability

• Available in OS X v10.4 and later.

CIVibrance

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

Parameters

inputImage

A CIImage class whose display name is Image.

inputAmount

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

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

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryColorAdjustment

Localized Display Name

Vibrance

Figure 118  The result of using the CIVibrance filter

Availability

• Available in OS X v10.4 and later and in iOS 5.0 and later.

CIVortexDistortion

Rotates pixels around a point to simulate a vortex.

Parameters

inputImage

A CIImage class whose display name is Image.

inputCenter

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

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

inputRadius

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

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

inputAngle

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

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

Discussion

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryDistortionEffect

Localized Display Name

Vortex Distortion

Figure 119  The result of using the CIVortexDistortion filter

Availability

• Available in OS X v10.4 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 class whose display name is Image.

inputColor

A CIColor class whose display name is Color.

Member of

CICategoryBuiltIn,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo,  CICategoryColorAdjustment

Localized Display Name

White Point Adjust

Figure 120  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 class whose display name is Image.

inputCenter

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

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

inputAmount

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

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

Member of

CICategoryBuiltIn,  CICategoryStillImage,  CICategoryVideo,  CICategoryBlur

Localized Display Name

Zoom Blur

Figure 121  The result of using the CIZoomBlur filter

Availability

• Available in OS X v10.4 and later.

Next

---

© 2011 Apple Inc. All Rights Reserved. (Last updated: 2011-10-12)

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

Shop the Apple Online Store (1-800-MY-APPLE), visit an Apple Retail Store, or find a reseller.

• Mailing Lists
• RSS Feeds

Copyright © 2010 Apple Inc. All rights reserved.

• Terms of Use
• Privacy Policy