Skip to content
Library for the creation of HUDs in iPhone applications. My goal is to support all features and bug fixes into a common release. This now ARCified
Objective-C Ruby
Pull request Compare This branch is 48 commits ahead of atomton:master.
Latest commit 01e7ee0 Mar 22, 2016 David Hoerl Update to 7.3 (selectors, ranges, bug fixes)
Failed to load latest commit information.
ATMHud.xcodeproj Blank slate to logged in with client choice working. Mar 17, 2016
Classes Parallax, Circular Progress Indicator Feb 21, 2016
ScreenShots Got one tags to show in the table! Sep 29, 2014
.gitignore Updates Feb 11, 2014
11-x.png Initial commit Mar 1, 2011
19-check.png Initial commit Mar 1, 2011
ATMHud-Info.plist Update the UI to a more modern look Feb 15, 2016
ATMHud.h Update to 7.3 (selectors, ranges, bug fixes) Mar 22, 2016
ATMHud.m Update to 7.3 (selectors, ranges, bug fixes) Mar 22, 2016
ATMHud.podspec Podspec change Feb 20, 2014
ATMHudDelegate.h More tweaks Feb 20, 2014
ATMHudQueueItem.h
ATMHudQueueItem.m Formatting, debugged the blockDelegate Feb 18, 2014
ATMHudView.h Few tweaks, cleanup Feb 15, 2016
ATMHudView.m Parallax, Circular Progress Indicator Feb 21, 2016
ATMHud_Prefix.pch Major tweaking - easier to use start and stop, block delegate etc Feb 13, 2014
ATMProgressLayer.h Parallax, Circular Progress Indicator Feb 21, 2016
ATMProgressLayer.m
ATMSoundFX.h Formatting, debugged the blockDelegate Feb 18, 2014
ATMSoundFX.m Formatting, debugged the blockDelegate Feb 18, 2014
ATMTextLayer.h Load testing with real clients Feb 1, 2016
ATMTextLayer.m
Icon.png Initial commit Mar 1, 2011
Icon@2x.png
LICENSE Formatting, debugged the blockDelegate Feb 18, 2014
MainWindow.xib Initial commit Mar 1, 2011
README.md Parallax, Circular Progress Indicator Feb 21, 2016
copySpec Got one tags to show in the table! Sep 29, 2014
main.m Formatting, debugged the blockDelegate Feb 18, 2014
pop.wav Initial commit Mar 1, 2011

README.md

ATMHud - Library for the creation of HUDs in iPhone applications

I once needed a HUD for one of my iPhone apps, but was unhappy with the currently available libraries on the internet. Therefore, I decided to create my own library. I've released it as a static library last year, but a lot of people wanted to see the source, so here it is.

-- Marcel development@atomcraft.de [original author]

Heavily modified by D. Hoerl

Operation

Create, configure, then show it. See the Demo app for more detail.

// Keep a strong ivar reference to it (ie, "ATMHud *hud")
hud = [[ATMHud alloc] initWithDelegate:self];  
// or  hud = [ATMHud new]; using the block delegate

[hud setCaption:@"Caption and an activity indicator."];
[hud setActivity:YES];
[hud showInView:self.view];
...
[hud hide];
// when the delegate method tells you it's finished, you can nil the ivar out if you want
hud = nil;
// if you use the block delegate, you can release the hud there (see DemoViewController)

**** Original Modifications, David Hoerl 2011-2014 ****

The reason I adopted this HUD is because it looks so nice, and it offered a wide range of customization options as well as the ability to get a slew of delegate messages as the HUD was presented and dismissed. Along with those you can get messages when the user taps within, or outside, the HUD.

I needed needed ARC, so I forked the project. My initial changes:

  • ARCified
  • Modern syntax, default setters (no @synthesize)
  • more of the existing properties exposed along with some new ones
  • blockDelegate along with or for use without the traditional 'delegate' callbacks
  • sound can be compiled out of the framework if you aren't using it (assuming most do not.)
  • converted to build error/warning free on iOS7 (required constant changes, many changes to UIKit extensions to NSString
  • 64 bit clean
  • handles view rotation (was a bug on original repository, unsure if I fixed it or not)

Futures:

iOS7 circular determinate progress indicator (just ask for it!)

History:

4.0.0 - 2/15/2016

  • Adopt more modern look - white with dark objects (text, progress indication, etc)
  • Parallax added as a default
  • Circular Progess Style Option
  • Enums -> NS_ENUM for Swift
  • Nullabilty for Swift

Note: if you used the older code and switch to this version, you may need to do some edits to your project.

3.0.0 - 2/20/2014

  • Added a Podspec to CocoaPods for this version
  • Font now uses UIFont ' preferredFontForTextStyle:UIFontTextStyleSubheadline''
  • Drop shadow removed (code still there, you can enable it if desired) for a more iOS7 look
  • Modified appearance defaults to
    hud.appearScaleFactor = 0.8f;
    hud.disappearScaleFactor = 0.8f;
    hud.gray = 0.2f;
    hud.alpha = 0.8f;
  • Rolled in some of the original issues posted to atomcraft/ATMHud
    14 - Gray property to set background color to a gray (not black), and added a setCenter method
    15 - Screenshots in Readme.md
    17 - Different orientation support? (assume this meant a landscape issue) 18 - use blocks api instead delegate 21 - Pull Request - Small performance update
    22 - Retain Cycle - changed property to "weak"
    23 - removeViewWhenHidden property added (use ATMHud without a delegate)
  • Experiment with various UI option by changing properties in DemoViewController (see pragma)

2.x.x - 2011 - 2013

  • various small tweaks, mostly to address Xcode Analyze errors
  • 64 bit clean

2.0.0 - 2011

  • Forked code
  • ARCified

1.2 - Original

The demo project shows of most of the ways you can display the HUD (but not all the UI customization options):

NOTE: The original author's text follows the screen shots.

ScreenShots

Basic Functions Advanced Functions Simple Caption Caption With Activity Caption With Image Activity Only Caption With Progress Bar Fixed Size Caption With Progress Bar

***** Below is the original README text ******

Requirements

  • iOS 4.0 or above
  • QuartzCore.framework
  • AudioToolbox.framework (only if you want to use sounds)

Features

  • Autorotation support
  • Fixed or dynamic size
  • Multiple accessories
  • Automation
  • Animations
  • Delegation
  • Block user interaction
  • Enable superview interaction
  • Retina display support
  • Selectable accessory position
  • Queueing of multiple HUDs
  • Custom positioning or auto-centering
  • Customizable appearance
  • Sound effects

Installation & Usage

Just have a look at the sample project, everything is included there.

License

ATMHud is licensed under BSD, have a look at the appropriate file for more information.

Contributions

  • Beta testers: @jonsterling @thermogl @GiloTM @phollow @Thyraz @saschalein @EdwinBrett @rbfigueira @abrrow @choise
  • @ChrisNTR for porting this to MonoTouch
  • @C418 for his awesome music as seen in the release video
  • and anyone else I forgot.
Something went wrong with that request. Please try again.