Advanced Search

Log In | Not a Member?

Contact ADC

Next Page > Hide TOC

Core Image Filter Reference

Overview

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

Filters by Task

CICategoryBlur

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

CICategoryColorAdjustment

• CIColorControls
• CIColorMatrix
• CIExposureAdjust
• CIGammaAdjust
• CIHueAdjust
• 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

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
• 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

Localized Display Name

Figure 1  The result of using the CIAdditionCompositing filter

Availability

• Available in Mac 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

Localized Display Name

Figure 2  The result of using the CIAffineClamp filter

Availability

• Available in Mac 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

Localized Display Name

Figure 3  The result of using the CIAffineTile filter

Availability

• Available in Mac 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

Localized Display Name

Figure 4  The result of using the CIAffineTransform filter

Availability

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

Localized Display Name

Availability

• Available in Mac 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

Localized Display Name

Availability

• Available in Mac 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

Localized Display Name

Availability

• Available in Mac 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

Localized Display Name

Availability

• Available in Mac 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

Localized Display Name

Availability

• Available in Mac 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

Localized Display Name

Availability

• Available in Mac 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

Localized Display Name

Figure 5  The result of using the CIBarsSwipeTransition filter

Availability

• Available in Mac 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

Localized Display Name

Figure 6  The result of using the CIBlendWithMask filter

Availability

• Available in Mac 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

Localized Display Name

Figure 7  The result of using the CIBloom filter

Availability

• Available in Mac 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

Localized Display Name

Figure 8  The result of using the CIBoxBlur filter

Availability

• Available in Mac 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

Localized Display Name

Figure 9  The result of using the CIBumpDistortion filter

Availability

• Available in Mac 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

Localized Display Name

Figure 10  The result of using the CIBumpDistortionLinear filter

Availability

• Available in Mac 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: 0.00 Slider minimum: 0.00 Slider maximum: 800.00 Identity: 80.00

inputSharpness

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

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

Discussion

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

Member of

Localized Display Name

Figure 11  The result of using the CICheckerboardGenerator filter

Availability

• Available in Mac 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

Localized Display Name

Figure 12  The result of using the CICircleSplashDistortion filter

Availability

• Available in Mac 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

Localized Display Name

Figure 13  The result of using the CICircularScreen filter

Availability

• Available in Mac 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

Localized Display Name

Figure 14  The result of using the CICircularWrap filter

Availability

• Available in Mac 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

Localized Display Name

Figure 15  The result of using the CICMYKHalftone filter

Availability

• Available in Mac 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 Blend Modes: Addendum.

Member of

Localized Display Name

Figure 16  The result of using the CIColorBlendMode filter

Availability

• Available in Mac 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 Blend Modes: Addendum.

Member of

Localized Display Name

Figure 17  The result of using the CIColorBurnBlendMode filter

Availability

• Available in Mac 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: 0.00 Slider minimum: 0.00 Slider maximum: 2.00 Identity: 1.00

inputBrightness

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

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

inputContrast

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

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

Discussion

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

To calculate contrast, this filter uses the following formula:

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

This filter calculates brightness by adding a bias value:

color.rgb + vec3(brightness)

Member of

Localized Display Name

Figure 18  The result of using the CIColorControls filter

Availability

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

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

Member of

Localized Display Name

Figure 19  The result of using the CIColorCube filter

Availability

• Available in Mac 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 Blend Modes: Addendum.

Member of

Localized Display Name

Figure 20  The result of using the CIColorDodgeBlendMode filter

Availability

• Available in Mac 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

Localized Display Name

Figure 21  The result of using the CIColorInvert filter

Availability

• Available in Mac 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

Localized Display Name

Figure 22  The result of using the CIColorMap filter

Availability

• Available in Mac 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

Localized Display Name

Figure 23  The result of using the CIColorMatrix filter

Availability

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

Localized Display Name

Figure 24  The result of using the CIColorMonochrome filter

Availability

• Available in Mac 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

Localized Display Name

Figure 25  The result of using the CIColorPosterize filter

Availability

• Available in Mac 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

Localized Display Name

Availability

• Available in Mac 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

Localized Display Name

Figure 26  The result of using the CIComicEffect filter

Availability

• Available in Mac 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

Localized Display Name

Figure 27  The result of using the CIConstantColorGenerator filter

Availability

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