CAFilter is an Objective-C wrapper for creating static or transition image filters.
Applying filters to layers
Although the SDK says that the filters property is unused, you can actually apply filter effects with it, for example, to apply a Gaussian blur filter for a window:
CAFilter* filter = [CAFilter filterWithName:@"gaussianBlur"]; [filter setValue:[NSNumber numberWithFloat:5] forKey:@"inputRadius"]; window.layer.filters = [NSArray arrayWithObject:filter];
Builtin static filters
Multiplies color components to the layer. It accepts 1 input parameter:
- inputColor: Array of 4 floats indicating the RGBA components to multiply.
Multiplies a linear gradient to the layer. It accepts 4 input parameters:
- inputColor0: Array of 4 floats indicating the RGBA components of the first point of the gradient.
- inputColor1: Array of 4 floats indicating the RGBA components of the first second of the gradient.
- inputPoint0: CGPoint (in the range (0,0) to (1,1)) for the location of the first point of the gradient.
- inputPoint1: CGPoint (in the range (0,0) to (1,1)) for the location of the second point of the gradient.
Add color components to the layer. It accepts 1 input parameter:
- inputColor: Array of 4 floats indicating the RGBA components to add.
Subtract color components from the layer. It accepts 1 input parameter:
- inputColor: Array of 4 floats indicating the RGBA components to subtract.
Apply monochrome effect to the layer. It accepts 3 input parameters:
- inputColor: Array of 4 floats indicating the RGBA components of the color to apply.
- inputBias: CGFloat between -1 and 1 for how close should the layer bias to the input color. If this value is -1, the whole layer is blackened. If this value is 0, this effect is equivalent to colorMultiply. If this value is 1, the whole layer is filled with the input color.
- inputAmount: CGFloat between 0 and 1 for the strength of this effect. 1 is maximum, 0 is no-op.
Apply a Gaussian blur effect to the layer. It accepts 2 input parameters:
- inputRadius: Strength of blurring, in pixels.
- inputHardEdges: Boolean indicating whether the edge of the layer should be softened too. Default is NO.
Resize the layer using the Lanczos algorithm. It accepts 1 input parameter:
- inputScale: CGFloat for the resize scale.
Gives the layer a page curl effect. It accepts 12 float parameters. 3 of them are expected to be modified:
- inputTime: CGFloat between 0 and 1, referring to the time this snapshot is taken when the a page curl animation is played.
- inputAngle: The angle in radian where the layer is curled up towards there. 0 is the +x direction, π/2 is the +y direction.
- inputRadius: The radius in pixel of the page's curvature.
While changing the other 9 from the default often produce very bad effect:
- inputStartAngle: The initial inclination of the curled page.
- inputEndAngle: The final inclination of the curled page.
- inputBackEnabled: Whether the back of the layer (curled up part) is shown.
- inputBackColor0: Color of the back of the layer.
- inputBackColor1: Color of the just curled up part, i.e. the edge between the back and the front of the layer.
- inputFrontEnabled: Whether the front of the layer (uncurled part) is shown.
- inputFrontColor: Equivalent to applying multiplyColor to the image.
- inputShadowColor: The shadow color that glows around the curled part.
- inputShadowBounds: CGRect in pixel relative to the origin of the layer where the shadow will glow around this rectangle.
The following shows the availability of different CAFilters starting from 2.0
|pageCurl||First 3 arguments: 2.0–;|
Last 9 arguments: 3.2–
inputShadowRadius, inputShadowErosion: 3.2 only
Transition filters also uses CAFilter as the interface, as CATransition also has a filter property. But the transition filters cannot be treated as static filters and applied to layers directly.