BRSunTracker is a set of classes using Augmented Reality that allow you to track and display the position of the sun on your device screen, based on your current GPS location, the device gyroscope, the time and the date.
The position of the sun in the sky is computed via the PSA Algorithm, and its position on the screen uses the device rotation matrix provided by the gyroscope (See "How does it work?" section below). BRSunTracker also works during the night, just aim at your feet to find to find the sun.
The sample app included displays a marker on a camera preview that follows the sun on the screen and snaps to the middle of the view once the phone is oriented towards it.
BRSunTracker is available through CocoaPods, to install it simply add the following line to your Podfile:
pod "BRSunTracker"
- Import the
BRSunTrackerView
class into your view controller:
#import "BRSunTrackerView.h"
- Instanciate
BRSunTrackerView
and add it as a subview.
BRSunTrackerView *sunTrackerView = [[BRSunTrackerView alloc] initWithFrame:CGRectMake(0, 0, 320, 428)];
[self.view addSubview:sunTrackerView];
Or you can also add a BRSunTrackerView
directly via the Interface Builder.
- By default, the
BRSunTrackerView
will display a camera preview, and a default marker following the sun. You can enable or disable the camera and provide your own UIView as a marker by setting these properties:
// Enable or disable the camera preview
// (The default value is YES)
[sunTrackerView setDisplayCameraPreview:YES];
// Provide your own marker subview
// (otherwise will display the default one)
[sunTrackerView setSunView:myMarkerView];
- (Optional) Set your view controller as the delegate of the
BRSunTrackerView
and make it conform to theBRSunTrackerViewDelegate
protocol. Implement the following methods to detect when the phone is aligned with the sun:
[sunTrackerView setDelegate:self];
- (void)sunTrackerViewGotFocus:(BRSunTrackerView *)sunTrackerView{
NSLog(@"The sun is aligned with the device.");
}
- (void)sunTrackerViewLostFocus:(BRSunTrackerView *)sunTrackerView{
NSLog(@"The sun is not aligned with the device anymore.");
}
- Grab a pair of sunglasses (and a cold drink).
A diagram explaining roughly the process of computing the sun 2D screen coordinates in BRSunTracker is shown below.
All of this happens inside the BRSunTracker
class.
The gyroscope orientation data is currently sampled 60 times per second, the sun spherical coordinates are computed every minute or when the GPS location gets updated.
pARk, Apple code sample showing a basic Augmented Reality implementation
PSA Algorithm, C function that computes the spherical coordinates of the sun based on the GPS coordinates, the time and date.
Stack Overflow, My initial Stack Overflow post about how to compare the device orientation with the sun position.
Thanks to Dan Marson who provided the GIF shown above.
This feature was conceived and built for the "Piano Ombre" album-app concept for Frànçois and the Atlas Mountains, now available on the App Store.
Julien Ducret - [email protected]
Follow me on Twitter @jbrocoo
Check out my app: Spores
BRSunTracker is under Apache licence, see the LICENCE file for more info.