CIImage Auto Adjustment Additions Reference

Inherits from
NSObject
Framework
Library/Frameworks/CoreImage.framework
Availability
Available in OS X v10.8 and later.
Declared in
CIImage.h

Overview

Auto adjustment methods cause Core Image to analyze an image for common deficiencies and return a set of filters to correct those deficiencies. The filters are preset with values that will improve image quality by altering values for skin tones, saturation, contrast, and shadows and by removing red-eye or other artifacts caused by flash.

Tasks

Getting Auto Adjustment Filters

Instance Methods

autoAdjustmentFilters

Returns all filters that perform auto adjustment.

- (NSArray *)autoAdjustmentFilters
Return Value

An array of auto adjustment filters to apply to the image. The filters are preset with values for correcting deficiencies in the supplied image.

Availability
  • Available in OS X v10.8 and later.
Declared In
CIImage.h

autoAdjustmentFiltersWithOptions:

Returns a subset of the filters that perform auto adjustment.

- (NSArray *)autoAdjustmentFiltersWithOptions:(NSDictionary *)dict
Parameters
options

You can control which filters are returned by supplying one or more of the keys described in “Auto Adjustment Keys.”

The options dictionary can also contain a CIDetectorImageOrientation key. This key is an NSNumber object with the same value as defined by the TIFF and EXIF specifications; values can range from 1 through 8. The value specifies where the origin (0,0) of the image is located. If not present, the default value is 1, which means the origin of the image is top, left. For details on the image origin specified by each value, see kCGImagePropertyOrientation.

Return Value

An array of auto adjustment filters, filtered by the supplied options, to apply to the image. The filters are preset with values for correcting deficiencies in the supplied image.

Availability
  • Available in OS X v10.8 and later.
Declared In
CIImage.h

Constants

Auto Adjustment Keys

Keys used in the options dictionary to control which filters Core Image returns.

NSString *kCIImageAutoAdjustEnhance;
NSString *kCIImageAutoAdjustRedEye;
NSString *kCIImageAutoAdjustFeatures;
Constants
kCIImageAutoAdjustEnhance

A key used to specify whether to return enhancement filters.

The value associated with this key is a CFBoolean value. Supply false to indicate not to return enhancement filters. If you don’t specify this option, Core Image assumes its value is true.

kCIImageAutoAdjustRedEye

A key used to specify whether to return a red eye filter.

The value associated with this key is a CFBoolean value. Supply false to indicate not to return a red eye filter. If you don’t specify this option, Core Image assumes its value is true.

kCIImageAutoAdjustFeatures

A key used to specify an array of features to which to apply enhancement and red eye filter.

The associated value is an array of CIFeature objects. If you don’t supply an array, the receiver will search for features using the CIDetector class.



© 2012 Apple Inc. All Rights Reserved. (Last updated: 2012-09-19)

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