Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Gravity-aware gauge-style meter view with delightful animations
tag: 0.0.1

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
DPMeterView
Example
Screenshots
.gitignore
DPMeterView.podspec
LICENSE
README.md

README.md

DPMeterView

Presents values in a custom gauge-style meter view with delightful animations

It should be easy to fill a shape with a color, to visually reflect a percentage.

There is plenty of examples where it can be useful:

  • simple progress bar view
  • stars rating view
  • emotion view
  • trend value view

CocoaPods

Instead of adding the source files directly to your project, you may want to consider using CocoaPods to manage your dependencies. Follow the instructions on the CocoaPods site to install the gem, and specify DPMeterView as a dependency in your Podfile with

pod 'DPMeterView', '0.0.1'

Demo

Checkout the Example ! It contains everything you need to begin with DPMeterView views.

iPhone portrait

Usage

#import "DPMeterView.h"
#import "UIBezierPath+BasicShapes.h"

DPMeterView *fiveStarsShape = [[DPMeterView alloc] initWithFrame:CGRectMake(0, 0, 200, 40)];
[fiveStarsShape setMeterType:DPMeterTypeLinearHorizontal];
[fiveStarsShape setShape:[UIBezierPath stars:5 shapeInFrame:fiveStarsShape.bounds].CGPath];

setProgress:animated:

[fiveStarsShape setProgress:0.6 animated:YES];

And a nice animation will update the view.

Custom shapes

In the example above I'm just using a UIBezierPath that is included in the category UIBezierPath+BasicShapes. Feel free to fork the project and add other shapes you think it'd be great to have.

You can use any shape you want, the class DPMeterView uses the CGPath as a mask.

Gravity aware

iPhone portrait

to try this feature you need to run the Example project on a device because the simulator doesn't provide CoreMotion acceleration data.

startGravity

[fiveStarsShape startGravity];

stopGravity

[fiveStarsShape stopGravity];

Minor known issues

  • The yaw obtained from the CoreMotion acceleration quaternion is restrained to the interval [-PI/2, PI/2], because of the definition of arcsin used to compute it. It would be even better if we find a way to extend it to the complete interval [-PI, PI], but I'm not a "quaternion master" ^^
  • There will be some boudary issues with gradients that have an oriented angle other that a vertical or an horizontal one. Especially, a DPMeterView shape can be entirely filled whereas it is not at a 100% progression, depends on the shape…

Roadmap / Evolutions

  • Have a progressTintColor that can evolve with the progress value, like in a heat map scale.
  • Use an image for the mask instead of a CGPath, but I don't know how to achieve that.
  • I'd like to add a little utility that enables developers to load shapes from a .svg file into a UIBezierPath directly, avoiding the burden of creating a UIBezierPath by hand. (the current work around is to use the great PaintCode application)

Contact

Pierre Dulac
@dulaccc

License

DPMeterView is available under the MIT license. See the LICENSE file for more info.

Something went wrong with that request. Please try again.