CDFInitialsAvatar

KO | EN

gitlite — search

#javascript #react #typescript #golang #android #machine-learning #nodejs #awesome #kubernetes #vue #pytorch #mcp #ios #open-source

CDFInitialsAvatar

(★ 87)

Simple to use initials avatar generator for iOS. Highly customizable, but with sane defaults. Works great as a avatar placeholder and such.

파일 탐색기

최종 버전 다운로드 (.zip)

- - LaunchScreen.xib
  - Main.storyboard
- AppDelegate.h
- AppDelegate.m
- Info.plist
- main.m
- ViewController.h
- ViewController.m
- - contents.xcworkspacedata
- project.pbxproj
.gitignore
CDFInitialsAvatar.h
CDFInitialsAvatar.m
CDFInitialsAvatar.podspec
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CDFInitialsAvatar

Simple to use initials avatar generator for iOS. Highly customizable, but with sane defaults. Works great as a avatar placeholder till network image is loaded or as an actual image if user has no avatar at all.

![Sample Image](http://totocaster.s3.amazonaws.com/public/cdfinitialsavatar_sample_screen.png)

## Usage

Defaults mimic look of Apple's own implementation of initial avatars, found in  Contact.app and Messages.app on iPhone or OS X. Usage can be as simple those two lines:

```objc
CDFInitialsAvatar *initialsAvatar = [[CDFInitialsAvatar alloc] initWithRect: imageView.bounds fullName:@"Toto Tvalavadze"];
imageView.image = initialsAvatar.imageRepresentation; // actual drawing happens here
```

### Further Customizations

You can change `backgroundColor`, `initialsFont` and `initialsColor`. This should cover everything. For details, refer to header file. It's well documented.

Example project also contains usage samples.

### What About Circle Avatars?

I believe generator should be responsible for content only, thus in case you want to mask content with circle (or pretty much any shape), please consider `mask` layer of your `UIImageView`.

See example project to view actual sample.

## Caching

`CDFInitialsAvatar` **does not** cache images it generates. Consider implementing your choice of image caching strategy when using it inside a cell views or in similar cases. In short, treat `imageView.image = initialsAvatar.imageRepresentation` as a very expensive call (which it is).

## Rendering

Actual drawing happens when `imageRepresentation` is called and obviously, is expensive. Consider using it wisely and wrapping it with your choice of caching strategy if needed.

No drawing or/and calculations happen on `initWith...`.

## License

MIT. Included in source files.

CDFInitialsAvatar

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

CDFInitialsAvatar

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README