Core Image Filter Reference

最新推荐文章于 2021-12-10 18:17:15 发布
转载 最新推荐文章于 2021-12-10 18:17:15 发布 · 2.9k 阅读 · 1
文章标签：

#image #filter #reference #os #adobe #null

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

CICategoryColorAdjustment

CICategoryColorEffect

CICategoryCompositeOperation

CICategoryDistortionEffect

CICategoryGenerator

CICategoryGeometryAdjustment

CICategoryGradient

CICategoryHalftoneEffect

CICategoryReduction

CICategorySharpen

CICategoryStylize

CICategoryTileEffect

CICategoryTransition

Filters

CIAdditionCompositing

Adds color components to achieve a brightening effect.

Parameters
inputImage

A CIImage class whose display name is Image.

inputBackgroundImage

A CIImage class whose display name is Background Image.

Discussion

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

Member of
CICategoryBuiltIn,  CICategoryHighDynamicRange,  CICategoryNonSquarePixels,  CICategoryInterlaced,  CICategoryStillImage,  CICategoryVideo, CICategoryCompositeOperation
Localized Display Name
Addition
Figure 1  The result of using the CIAdditionCompositing filter The result of using the CIAdditionCompositing filter
Availability
  • 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 The result of using the CIHexagonalPixellate 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 The result of using the CIHueAdjust 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 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 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 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 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 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 The result of using the CIHueAdjust 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 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 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 The result of using the CIZoomBlur filter
Availability
  • Available in OS X v10.4 and later.


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

Did this document help you?  Yes  It's good, but...  Not helpful...
Core Image Filter Reference （name都在）
majiakun1的专栏
12-07 868
https://developer.apple.com/library/ios/documentation/GraphicsImaging/Reference/CoreImageFilterReference/Reference/reference.html#//apple_ref/doc/uid/TP40004346
使用CoreImage教程
weixin_33910759的博客
05-09 206
使用CoreImage教程 CoreImage包含有很多实用的滤镜,专业处理图片的库,为了能看到各种渲染效果,请使用如下图片素材.   现在可以开始教程了: #define FIX_IMAGE(image) fixImageWidth(image, 320.f) // 固定图片的宽度 UIImage * fixImageWidth(UIImage *image...
guided image filter
yjccao123的专栏
05-20 3147
1、Gauss filter 高斯滤波核函数： 式中，为常数，使得满足 为均方差，越小，灰度动态范围压缩的越多，越大，图像锐化的越厉害。 2、bilateral filter 双边滤波核函数： 其中k(x)为： 式中，c()表示临近点e与中心点x之间的距离相似度，s()表示临近点e与中心点x之间的亮度相似度 3、guided imag
iOS开发之滤镜的使用技巧（CoreImage）
weixin_30697239的博客
06-15 275
一、滤镜的内容和效果是比较多并且复杂的 ，学习滤镜需要技巧 如下： 两个输出语句解决滤镜的属性选择问题： 1.查询效果分类中包含什么效果按住command 点击CIFilter 进入接口文件 找到第128行-148行全部都是 效果分类 2.选择其中某一个分类拷贝NSLog -> [CIFilter filterNamesInCategory:刚才拷贝的分类]; -> 打印出来...
Core Image详解
逢个场，作个戏
05-11 4035
一.使用图像         UIImage是UIKIt框架中定义的图像类，其中封装了高层次图像类，可以通过多种方式创建这些对象。在Core Graphics框架（Quartz 2D）中也定义了CGImage，它表示位图图像，因为CGImage被封装起来了所以通常通过CGImageRef来使用CGImage。在Core Image框架中也有一个图像类CIImage，CIImage封装的图
iOS Core Image - 入门导读
LOLITA0164的博客
01-24 4712
简介 Core Image 是一种图像处理和分析技术，可为静态和视频图像提供高性能处理。 使用许多内置图像过滤器来处理图像并通过链接过滤器来构建复杂效果。 关于过滤器种类和效果可以查看官方文档：Core Image Filter Reference 系统内置了多种滤镜效果，你可以将多种滤镜组合使用，一般情况下的需求都可以满足。当然，你也可以自定义滤镜效果。 关于自定义了滤镜可以查看官方文档：Co...
iOS 滤镜效果的实现：CoreImage
王颜华的博客
11-30 1641
语言永远是苍白无力，不如拿出效果给大家看看。 原图 处理过得图片 下面带领大家实现这个功能 来 脖子扭扭 手指动动 跟我一起做 新建一个工程  在main.storyboard设计成如下图一样（可以根据自己喜好设计） 提供原图（我自己P的）可以下载使用~ 接下来就是在ViewController里把空间拉成属性 其中
iOS CoreImage专题（一）—— 概述
DH's Den
12-01 3026
CoreImage专题
Processing Images（处理图像）
season
06-11 6542
Processing Images（处理图像） Core Image has three classes thatsupport image processing on iOS and OS X:（在IOS和OS X上 Core Image 有三个类支持图像的处理）
SwiftUI———如何使用Core Image官方滤镜（CIFilter）来处理照片
ZhongUncle的博客
12-10 5201
苹果在Core Image API中提供了14个大类、共174个图像处理方式以及一些常见滤镜，其中一些滤镜还能处理视频甚至是实时视频， 首先是如何看这个网页，也就是说这个网页提供了哪些信息，这对我们使用时非常有帮助的。以下面这个截图为例，来讲一下如何看。
CIFilter的种类
ph496124577的专栏
08-02 1967
//Iphone中目前可用的      CIAdditionCompositing     //影像合成     CIAffineTransform           //仿射变换     CICheckerboardGenerator       //棋盘发生器     CIColorBlendMode              //CIColor混合模式     CIColorBu
iOS 图片添加滤镜
wwOok
07-10 769
对目标图片添加滤镜 使用CoreImage框架为图片添加滤镜 创建UIImage的category，这样想要添加滤镜的图片直接调用下面的方法就可以了。 - (UIImage *)addFilterWithName:(NSString *)filterName { UIImageView *theImageViewBack = [[UIImageView alloc]init]; theImageViewBack.image = self; CIImage * inputI
opencv(c++)图像处理（imgproc模块）
风吴痕的博客
11-06 1万+
参考： 1、https://docs.opencv.org/3.2.0/ 2、https://github.com/opencv/opencv/Image Processing (imgproc module)图像平滑在本教程中，您将学习如何使用OpenCV函数应用各种线性滤镜来平滑图像，例如： cv::blur cv::GaussianBlur cv::medianBlur cv::bilat
关于iOS开发中图片处理的一些积累（CoreGraphic、CoreImage、GPUImage、OpenGL）
u014604106的博客
01-15 6759
Core ImageCore Image 前言 Core Graphics CoreImage GPUImage前言貌似公司最近的项目都是和图片处理有关，拍拍项目中需要将图片处理成buffer传到图像匹配拼接算法中，需要从原图中抠出一定范围的图像再贴到新的背景图中，需要对静态图片进行滤镜操作等等，所以对这方面接触的相对多一些。 抛开各种各样的图像编解码知识，其实图像数据本身就是一个Byte
Guided Image Filtering
热门推荐
巫山云的专栏
01-13 1万+
1，定义 引导滤波：即需要引导图的滤波器，引导图可以是单独的图像或者是输入图像，当引导图为输入图像时，引导滤波就成为一个保持边缘的滤波操作，可以用于图像重建的滤波。 引导滤波的流程见下图： 假设输入图像为p，输出图像为q，引导图为I，q与I在以像素k为中心的窗口中存在局部线性关系： 窗口半径为r，a，b为线性系数，且在局部窗口k中为常数。这个模型保证了只有在I存在边缘的情况下，q才
cifilter 可视化
weixin_30664615的博客
06-15 358
//Iphone中目前可用的 CIAdditionCompositing //影像合成 CIAffineTransform //仿射变换 CICheckerboardGenerator //棋盘发生器 CIColorBlendMode //CIColor混合模式 CIColorBu...
iOS中滤镜的使用（二）滤镜组合
zaijianbali的专栏
07-09 2465
iOS中滤镜的使用（二）滤镜组合首先 要加载图片并转化为CIImageCIImage *ciImage = [[CIImage alloc] initWithImage:[UIImage imageNamed:@"IMG_0160"]];其次，创建filter滤镜 CIFilter *filterOne = [CIFilter filterWithName:@"CIPixellate"];//马
【CV系列】图像算法之十一：双边滤波
优快云明星博主，认证博客专家，视频、Matlab领域优质创作者。
01-20 3970
双边滤波器的原理及实现 标签：filterimageinputdistancematlabfunction 双边滤波器是什么？ 双边滤波（Bilateral filter）是一种可以保边去噪的滤波器。之所以可以达到此去噪效果，是因为滤波器是由两个函数构成。一个函数是由几何空间距离决定滤波器系数。另一个由像素差值决定滤波器系数。可以与其相比较的两个filter
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值