JMTimerBeam enables you to show a decent beam on your OSX screen for visualizing a timing event. The beam will be attached to the top, right, bottom or left side of your screen and decreases/increases steadily depending on the amount of time already elapsed.
To create a new timer beam on your screen simply crete a new instance of JMTimerBeam with one of the following two methods:
/// Init new timer beam with given duration, orientation, thickness, color and
/// reversed (empty to full) or not (full to empty)
- (id) initWithDuration:(NSTimeInterval) duration
orientation:(JMTimerBeamOrientation) orientation
thickness:(NSInteger) thickness
reverse:(BOOL)revserve
color:(NSColor*) color;
/// Initialize a new JMTimerBeam positioned on the left of the screen
/// with decent thickness and green color, non reversed (full to empty)
- (id) initWithDuration:(NSTimeInterval) duration;
After that use the start and stop method to start/stop the beam respectively. For positioning the beam on the screen use one of the following orientations:
typedef enum JMTimerBeamOrientations {
JMTimerBeamOrientationTop,
JMTimerBeamOrientationLeft,
JMTimerBeamOrientationRight,
JMTimerBeamOrientationBottom
} JMTimerBeamOrientation;
To get notified after the given duration elapsed and the beam ended implement the JMTimerBeamDelegate protocol with the method didFinishTimerBeam:.
To run the example project; clone the repo, and run pod install from the Project directory first.
JMTimerBeam is available through CocoaPods, to install it simply add the following line to your Podfile:
pod "JMTimerBeam"
Andreas Katzian, JadeMind
Dominik Pich, Daij-Djan
JMTimerBeam is available under the MIT license. See the LICENSE file for more info.