https://github.com/samvermette/SVStatusHUD

a copycat of the HUD shown on orientation and volume change in iOS.
https://github.com/samvermette/SVStatusHUD

Last synced: about 1 month ago
JSON representation

a copycat of the HUD shown on orientation and volume change in iOS.

• Host: GitHub
• URL: https://github.com/samvermette/SVStatusHUD
• Owner: samvermette
• License: mit
• Created: 2011-11-19T05:00:04.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2012-11-05T01:43:26.000Z (about 12 years ago)
• Last Synced: 2024-10-28T11:50:53.875Z (about 1 month ago)
• Language: Objective-C
• Homepage: http://samvermette.com/309
• Size: 146 KB
• Stars: 283
• Watchers: 9
• Forks: 43
• Open Issues: 3
• Metadata Files:
  • Readme: README.textile
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome - SVStatusHUD - a copycat of the HUD shown on orientation and volume change in iOS. (etc)
• awesome - SVStatusHUD - a copycat of the HUD shown on orientation and volume change in iOS. (etc)

README

        
h1. SVStatusHUD

SVStatusHUD mimics the HUD shown on orientation lock, mute and volume change on iOS. *It should only be used in response to hardware or other important notifications* (for instance when an accessory is detected by your app). If you're just looking to show the progress or success of an operation, you should have a look at "SVProgressHUD":https://github.com/samvermette/SVProgressHUD.

!http://f.cl.ly/items/1p1d1x3b2b1V2y1Q3p0C/screenshots.png!

__Glyph icons kindly provided by "@jpmartineau":http://twitter.com/jpmartineau for the sake of showing appropriate use cases.__

*SVStatusHUD features:*

* simple singleton convenience methods (@[SVStatus method]@)

* automatic styling of the image it's provided

* optional status string and showing duration

* automatic positioning based on device type and orientation

h2. Installation

* Drag the @SVStatusHUD/SVStatusHUD@ folder into your project. 

* Add the *QuartzCore* framework to your project. 

__If you plan on using SVStatusHUD in a lot of places inside your app, I recommend importing it directly inside your prefix file.__

h2. Usage

(see sample Xcode project in @/Demo@)

SVStatusHUD is created as a singleton (i.e. it doesn't need to be explicitly allocated and instantiated; you directly call @[SVStatusHUD method]@) and can be shown using one of the following convenience/class methods:


+ (void)showWithImage:(UIImage*)image;

+ (void)showWithImage:(UIImage*)image status:(NSString*)string;

+ (void)showWithImage:(UIImage*)image status:(NSString*)string duration:(NSTimeInterval)duration;



*Important*: for crispier rendering, provided image should precisely be 86x86 pixels (retina: 172x172).

h2. Automatic Reference Counting (ARC) support

Maintaining an official ARC branch has proven to be too much work, often leading to confusion since the ARC branch is always a few commits behind. If you'd like to use SVStatusHUD in your ARC-enabled project, you'll have to "add the @-fno-objc-arc@ compiler flag":http://stackoverflow.com/questions/6646052/how-can-i-disable-arc-for-a-single-file-in-a-project to all of SVStatusHUD's files.

h2. Credits

SVStatusHUD is brought to you by "Sam Vermette":http://samvermette.com and "contributors to the project":https://github.com/samvermette/SVStatusHUD/contributors. If you have feature suggestions or bug reports, feel free to help out by sending pull requests or by "creating new issues":https://github.com/samvermette/SVStatusHUD/issues/new. If you're using SVStatusHUD in your project, attribution would be nice.