bachonk/uiimageview-letters

UIImageView category for using initials as a placeholder image, written in Objective-C. For a Swift implementation, see https://github.com/bachonk/InitialsImageView

UIImageView+Letters

An easy, helpful UIImageView category that generates letter initials as a placeholder for user profile images, with a randomized background color

Note: Looking for a Swift 3 compatible version? Check out the new InitialsImageView extension, rewritten entirely in Swift!

Installation

CocoaPods

Add this spec to your podfile:

pod "UIImageView-Letters"

Check out the official guide for getting started with CocoaPods.

Manual

1. Drag the UIImageView+Letters.{h,m} files into your project
2. Enjoy!

Usage

In the file where you want to use the category, be sure to import the file.

#import "UIImageView+Letters.h"

Methods

Call the following methods on any UIImageView instance to set the image:

• - (void)setImageWithString:(NSString *)string
• - (void)setImageWithString:(NSString *)string color:(UIColor *)color
• - (void)setImageWithString:(NSString *)string color:(UIColor *)color circular:(BOOL)isCircular
• - (void)setImageWithString:(NSString *)string color:(UIColor *)color circular:(BOOL)isCircular fontName:(NSString *)fontName
• - (void)setImageWithString:(NSString *)string color:(UIColor *)color circular:(BOOL)isCircular textAttributes:(NSDictionary *)textAttributes

string is the string used to generate the initials. This should be a user's full name if available.

color is an optional parameter that sets the background color of the image. Pass in nil to have a color automatically generated for you.

isCircular is a boolean parameter that will automatically clip the image to a circle if enabled.

fontName is a string that specifies a custom font. Pass in nil to use the system font by default. The list of provided font identifiers can be found here.

textAttributes is an NSDictionary that allows you to specify font, text color, shadow properties, etc., for the letters text, using the keys found in NSAttributedString.h.

Example

NSString *userName = @"Michael Bluth";
UIImageView *myImgView = [[UIImageView alloc] initWithFrame:CGRectMake(10, 10, 50, 50)];
[myImgView setImageWithString:userName color:nil circular:YES];

Saying Thanks

If you like this tool, show your support by downloading the free Turnout app that inspired it!

License

Using the MIT license. See license file for details.

uiimageview-letters's Issues

Add corner radius option as an initializer param

Ruins Circular Image if text is set prior to image

If I set Image after setting the text in my ciruclar imageView. It doesn't make the image circular! Attached are the screenshots (I have drawn the white path around myself):

Invert label color in some colors.

In some light colors like yellow - white label looks bad. What about inverting color to black in such matters?

Swift 3 update

Any plan to support Swift 3.0?

Unable to set UIImage of UITableViewCell

I am trying to use your library to set the image of a UITableViewCell (basic style).

I am using the following method to do so: cell.imageView?.setImageWithString(user.displayName, color: UIColor(hex: MVColor.Primary.Normal))

Unfortunately the image is not set and I am getting the following error:

<Error>: CGContextRestoreGState: invalid context 0x0. This is a serious error. This application, or a library it uses, is using an invalid context and is thereby contributing to an overall degradation of system stability and reliability. This notice is a courtesy: please fix this problem. It will become a fatal error in an upcoming update.

I tried debugging the error. By using this method I found the cause of this problem. The error is produced by this call: CGContextTranslateCTM(context, -self.bounds.origin.x, -self.bounds.origin.y); (line 121 in your latest CocoaPods release) in your - (UIImage *)imageSnapshotFromView:(UIView *)inputView function.

It would be great to resolve this problem or find a workaround!

Thanks

Emoji issue

There is an issue when it is supposed to display emoji

how to stop color reloading every time

is there any methods to stop that

Major Error.

Aug 13 23:57:35 myImac <Error>: CGContextTranslateCTM: invalid context 0x0. This is a serious error. This application, or a library it uses, is using an invalid context and is thereby contributing to an overall degradation of system stability and reliability. This notice is a courtesy: please fix this problem. It will become a fatal error in an upcoming update.

How to use this with swift?

Support for CocoaPods

Add support for CocoaPods please

Swift 5 support

http://prntscr.com/nos67j

UITableView Error

Same order of colors returned

Hi,

Seems like same order of random colors are generated each time the view loads. You need to seed drand48.

srand48(arc4random());

see apple doc as they also suggest initializing it: https://developer.apple.com/library/ios/documentation/System/Conceptual/ManPages_iPhoneOS/man3/srand48.3.html

CGContextFillRects: invalid context 0x0

i'm getting this error on iOS 9 Swift

: CGContextFillRects: invalid context 0x0. If you want to see the backtrace, please set CG_CONTEXT_SHOW_BACKTRACE environmental variable.

Image not upading

Initial I'm setting the image with:
profileImageView.setImageWithString(myProfile.username, color: nil, circular: true, fontName: CustomFont.SF.Regular.rawValue) but later when I try to update that image via ImagePicker in UIImagePickerControllerDelegate method:

  func imagePickerController(picker: UIImagePickerController, didFinishPickingImage image: UIImage, editingInfo: [String : AnyObject]?) {

    if let pickedImage:UIImage = image {
      self.profileImageView.image = pickedImage
    } 
    dismissViewControllerAnimated(true, completion: nil)
  }

It doesn't update the image. It changes only the random color and still have the image with the letter drawn.

Am I doing something wrong?