https://github.com/daltoniam/dcavatar

A simple, asynchronous, network based avatar library for iOS and OSX
https://github.com/daltoniam/dcavatar

Last synced: about 2 months ago
JSON representation

A simple, asynchronous, network based avatar library for iOS and OSX

• Host: GitHub
• URL: https://github.com/daltoniam/dcavatar
• Owner: daltoniam
• License: apache-2.0
• Created: 2013-11-05T00:22:17.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2014-10-23T04:45:29.000Z (about 10 years ago)
• Last Synced: 2024-05-08T22:31:03.283Z (8 months ago)
• Language: Objective-C
• Size: 302 KB
• Stars: 6
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
DCAvatar

========

A simple, asynchronous, network based avatar library for iOS and OSX. This makes using network based avatars simple, while still having great performance.

## Examples ##

A subclass for UIImageView and NSImageView is provided to make using DCAvatar very simple.

```objective-c

DCImageView *imageView = [[DCImageView alloc] initWithFrame:CGRectMake(70, 70, 60, 60)];

imageView.avatarValue = @"http://imgs.xkcd.com/comics/password_reuse.png";

[self.view addSubview:imageView];

```

Also supported are domain via meta tag scraping:

```objective-c

DCImageView *imageView = [[DCImageView alloc] initWithFrame:CGRectMake(70, 70, 60, 60)];

imageView.avatarValue = @"http://github.com";

[self.view addSubview:imageView];

```

and what is great avatar support without a little gravatar?

```objective-c

DCImageView *imageView = [[DCImageView alloc] initWithFrame:CGRectMake(70, 70, 60, 60)];

imageView.avatarValue = @"[email protected]";

[self.view addSubview:imageView];

```

Other notable features:

* Completely asynchronous

* Memory and disk caching that is automatically pruned  

* Does not send multiple requests for same url

* Has both iOS and OSX support.

* gravatar support.

* domain meta tag support.

* supports showing a progress view.

## Install ##

The recommended approach for installing DCAvatar is via the CocoaPods package manager, as it provides flexible dependency management and dead simple installation.

via CocoaPods

Install CocoaPods if not already available:

	$ [sudo] gem install cocoapods

	$ pod setup

Change to the directory of your Xcode project, and Create and Edit your Podfile and add DCAvatar:

	$ cd /path/to/MyProject

	$ touch Podfile

	$ edit Podfile

	platform :ios, '5.0' 

	# Or platform :osx, '10.8'

	pod 'DCAvatar'

Install into your project:

	$ pod install

	

Open your project in Xcode from the .xcworkspace file (not the usual project file)

## Requirements ##

DCAvatar requires at least iOS 5/Mac OSX 10.8 or above.

## License ##

DCAvatar is license under the Apache License.

## Contact ##

### Dalton Cherry ###

* https://github.com/daltoniam

* http://twitter.com/daltoniam