psli / mtanimatedlabel

MTAnimatedLabel is a UILabel subclass that supports animated text similar to the iPhone/iPad lock screen.

MTAnimatedLabel

This codebase implements MTAnimatedLabel, a UILabel subclass that supports animation like the iPhone lock screen.

License

Copyright (c) 2012 Michael Turner. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Automatic Reference Counting (ARC)

The source code in this repository uses Automatic Reference Counting.

Required Frameworks

MTAnimatedLabel requires the following frameworks:

CoreText
QuartzCore
UIKit
Foundation
CoreGraphics

Design

MTAnimatedLabel

A UILabel subclass that uses CATextLayer & CAGradientLayer to accomplish an iPhone lock screen like animation.

So how do I use it?

Just as you would use any other UILabel, either from a nib or in code.

/*Example*/
MTAnimatedLabel *label = [[MTAnimatedLabel alloc] initWithFrome:CGRectMake(0,0,100,35)];
label.text = @"slide to unlock";
[self.view addSubview:label];
[label startAnimating]; //begins animation

//call animate again to stop the animation
[label stopAnimating];

It's is also possible to change the gradient tint, animation duration, and gradient width.

Performance Considerations

MTAnimatedLabel uses a CATextLayer to mask a CAGradientLayer which requires off screen rendering. Due to this MTAnimatedLabel should only be used when animation is required.

TODO's

MTAnimatedLabel does not currently respect the following UILabel properties:

1. lineBreakMode
2. shadows on text are not currently working
3. baselineAdjustment
4. highlighting
5. autosizeTextToFit
6. numberOfLines

If you feel like jumping in on some of these please feel free!