Latest 0.1.0
Homepage https://github.com/modocache/MDCFocusView
License MIT
Platforms ios 5.0, requires ARC
Frameworks UIKit
Authors

Bitdeli Badge

Apply a "tutorial screen" overlay to your application window.
MDCFocusView can apply a focus on an arbitrary number of views,
and prevents users from tapping views not currently focused on.

Check out a demo on Vimeo.

How to Use

You can install the project using Cocoapods, by placing pod MDCFocusView
in your Podfile. After installing:

// Initialize MDCFocusView and customize its background color
MDCFocusView *focusView = [MDCFocusView new];
focusView.backgroundColor = [UIColor colorWithRed:0.0f green:0.0f blue:0.0f alpha:0.8f];

// Register a MDCFocalPointView subclass to "wrap" focal points
focusView.focalPointViewClass = [MDCSpotlightView class];

// Add any number of custom views to MDCFocusView
[focusView addSubview:[self buildLabel]];

// Present the focus view
[self.focusView focus:someView, anotherView, nil];

Please see the sample app for an example.

Features

  • Because MDCFocusView uses MDCFocalPointView to wrap focal points,
    it is highly extensible–to create your own focus effect, simply subclass
    MDCFocalPointView and implement any custom drawing behavior in drawRect:.
    Please see MDCSpotlightView for an example.

Limitations (or Ways to Contribute to this Project)

  • Currently MDCFocusView can only be applied to the entire application
    window. Ideally, any arbirary view should be able to add MDCFocusView as
    a subview.
  • Currently only MDCFocalPointView and MDCSpotlightView are available,
    although I would like to make more. It would be nice, for example, if
    a Gaussian blur could be applied everywhere but the focal points.
  • See the GitHub issues for more bugs/feature requests you can help with.

Latest podspec

{
    "name": "MDCFocusView",
    "version": "0.1.0",
    "summary": "Apply a "tutorial screen" overlay to your application window.",
    "homepage": "https://github.com/modocache/MDCFocusView",
    "license": "MIT",
    "authors": {
        "modocache": "[email protected]"
    },
    "source": {
        "git": "https://github.com/modocache/MDCFocusView.git",
        "tag": "v0.1.0"
    },
    "source_files": "MDCFocusView/*.{h,m}",
    "requires_arc": true,
    "platforms": {
        "ios": "5.0"
    },
    "frameworks": "UIKit"
}

Pin It on Pinterest

Share This