Latest 0.0.1
License MIT
Platforms ios 6.0, requires ARC
Frameworks CoreImage


UPDATE: You shouldn’t use this any more – Apple’s UIImage+ImageEffects code (released alongside iOS 7) achieves this same result – so go find it!

I was frustrated trying to get a CIFilter that’d work to darken an image by 50% (the equivalent, in photoshop, to adding a 0.5-alpha black layer in front of a picture). An hour later, I figured it out. Enjoy!

Here’s the code that does the magic:

-(instancetype)darkened:(CGFloat)alpha andBlurredImage:(CGFloat)radius blendModeFilterName:(NSString *)blendModeFilterName {

    CIImage *inputImage = [[CIImage alloc] initWithImage:self];

    CIContext *context = [CIContext contextWithOptions:nil];

    //First, we'll use CIAffineClamp to prevent black edges on our blurred image
    //CIAffineClamp extends the edges off to infinity (check the docs, yo)
    CGAffineTransform transform = CGAffineTransformIdentity;
    CIFilter *clampFilter = [CIFilter filterWithName:@"CIAffineClamp"];
    [clampFilter setValue:inputImage forKeyPath:kCIInputImageKey];
    [clampFilter setValue:[NSValue valueWithBytes:&transform objCType:@encode(CGAffineTransform)] forKeyPath:@"inputTransform"];
    CIImage *clampedImage = [clampFilter outputImage];

    //Next, create some darkness
    CIFilter* blackGenerator = [CIFilter filterWithName:@"CIConstantColorGenerator"];
    CIColor* black = [CIColor colorWithRed:0.0f green:0.0f blue:0.0f alpha:alpha];
    [blackGenerator setValue:black forKey:@"inputColor"];
    CIImage* blackImage = [blackGenerator valueForKey:@"outputImage"];

    //Apply that black
    CIFilter *compositeFilter = [CIFilter filterWithName:blendModeFilterName];
    [compositeFilter setValue:blackImage forKey:@"inputImage"];
    [compositeFilter setValue:clampedImage forKey:@"inputBackgroundImage"];
    CIImage *darkenedImage = [compositeFilter outputImage];

    //Third, blur the image
    CIFilter *blurFilter = [CIFilter filterWithName:@"CIGaussianBlur"];
    [blurFilter setDefaults];
    [blurFilter setValue:@(radius) forKey:@"inputRadius"];
    [blurFilter setValue:darkenedImage forKey:kCIInputImageKey];
    CIImage *blurredImage = [blurFilter outputImage];

    CGImageRef cgimg = [context createCGImage:blurredImage fromRect:inputImage.extent];
    UIImage *blurredAndDarkenedImage = [UIImage imageWithCGImage:cgimg];

    return blurredAndDarkenedImage;

In a few lines of code, YOU TOO can witness this miracle transformation:
iOS Screenshot

Latest podspec

    "name": "UIImage+BlurAndDarken",
    "version": "0.0.1",
    "summary": "A category on UIImage to return a blurred and/or darkened copy of the receiver.",
    "homepage": "",
    "license": "MIT",
    "authors": {
        "Bryan Clark": "[email protected]"
    "platforms": {
        "ios": "6.0"
    "source": {
        "git": "",
        "commit": "5adb09c843ee987bb6338c78f816a28623347304"
    "source_files": "UIImage+BlurAndDarken.{h,m}",
    "frameworks": "CoreImage",
    "requires_arc": true

Pin It on Pinterest

Share This