Bordered image view for iOS, with customizable border (color and gradient)
Pull request Compare This branch is 22 commits ahead, 2 commits behind arturgrigor:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
AGMedallionView Demo


cbpowell/AGMedallionView is a bordered image view (that is also a subclass of UIControl) for iOS, with a customizable border and shadow. The border can be a solid color OR a gradient (defined by a CGGradient), and the shadow color, offset, and blur can be specified. The view will be resized to fit any shadow blur and offset setting.

This version is forked from AGMedallionView, which was created as a picture view control just like the one that Apple is using at the login screen in Mac OS X Lion.



Copy over the files from the Classes folder to your project folder.


Wherever you want to use AGMedallionView, import the appropriate header file and initialize as follows:

#import "AGMedallionView.h"


AGMedallionView *medallionView = [[AGMedallionView alloc] init];
medallionView.image = [UIImage imageNamed:@"sample"];
[self.view addSubview:medallionView];
[medallionView release];

To use a rounded rect medallion, initialize as follows:

AGMedallionView *medallionView = [[AGMedallionView alloc] init]; = AGMedallionStyleSquare;
medallionView.cornerRadius = 20.0f;
medallionView.image = [UIImage imageNamed:@"sample"];
[self.view addSubview:medallionView];
[medallionView release];

You can also specify a gradient for the medallion border by specifying a CGGradientRef as shown:

CGFloat colors[8] = {0.925, 0.953, 0.992, 1.000, 0.451, 0.482, 0.522, 1.000};
CGFloat colorStops[2] = {1.f, 0.f};
CGColorSpaceRef rgbColorSpace = CGColorSpaceCreateDeviceRGB();
CGGradientRef newGradient = CGGradientCreateWithColorComponents(rgbColorSpace, colors, colorStops, 2);
medallionView.borderGradient = newGradient;

The shadow color, blur, and offset can be manipulated as follows if the defaults aren't to your liking:

medallionView.shadowColor = [UIColor grayColor];
medallionView.shadowBlur = 3.0f;
medallionView.shadowOffset = CGSizeMake(2.0, 2.0);

The shadow is drawn both inside the border ontop of the image, and outside the border above anything below AGMedallionView. If you don't want the shadow drawn outside the border, set medallionView.clipShadow = YES. The default for clipShadow is NO.

If clipShadow is set to NO, AGMedallionView will resize automatically in order to contain the shadow completely. NOTE: this will result in the contained image being smaller, relative to the frame you specify for the view. The image/border will also no longer be in the absolute center of the frame.


  • Depending on the background color and the image, sometimes the background can bleed through.


Charles Powell

Artur Grigor (original creator of AGMedallionView)

Let me (us) know if you're using or enjoying this code!