Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

EMHint is an iOS class group that easily adds a spotlight-like effect to a view highlighting or hinting at something that may be important on the screen.The protocols of EMHintDelegate allow users to override many of the default actions and views. Tapping the black overlay fades it away. Great for quick "how to" or tutorials in your app.

branch: passthrough

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 HintMakerExample.xcodeproj
Octocat-spinner-32 HintMakerExample
Octocat-spinner-32 LICENSE.txt
Octocat-spinner-32 README.md
README.md

EMHint

Overview

EMHint is an iOS class group that easily adds multiple spotlight-like effects to a view highlighting or hinting at some things that may be important on the screen.The protocols of EMHintDelegate allow users to override many of the default actions and views. Tapping the black overlay fades it away.

Great for quick "how to" or tutorials in your app.

Installation

  1. Drop in EMHint (.h/.m) & EMHintsView (.h/.m)
  2. Pick a logical place to manage EMHintDelegate protocol implementation and conform to <EMHintDelegate> .
  3. #import "EMHint.h"
  4. Call a new hint using the instance method presentModalMessage:(NSString*)message where:(UIView*)presentationPlace
  5. You must implement (CGRect)hintStateRectToHint:(id)hintState OR -(UIView*)hintStateViewToHint:(id)hintState - without one, you will throw an exception. By doing so, EMHint can understand the radius of the spotlight to draw, and where-abouts.

See the example app (HintMakerExample)in this build for more.

Tips

  1. It's possible to "daisy chain" hints. See the HintHelper.m class for a quick overview of using enums and protocol methods
  2. Custom views can be added inplace of the default white text. Useful if you need to add a view or label not at center, or any custom graphics, etc
  3. return CGRectMake(0,0,1,1) for an all black bg without spotlight….CGRectZero will fail.
  4. Not ARC compliant….later.

Todo's (limitations)

  1. add rectangular spotlight (and other shapes)
  2. different background colors/alpha/etc
  3. support rotation (currently only label and background do so)
Something went wrong with that request. Please try again.