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 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.

Installation

Usage

1. Import the BRSunTrackerView class into your view controller:

     #import "BRSunTrackerView.h"

2. 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.

3. 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];

4. (Optional) Set your view controller as the delegate of the BRSunTrackerView and make it conform to the BRSunTrackerViewDelegate 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.");
     }

5. Grab a pair of sunglasses (and a cold drink).

How does it work?

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.

Sources

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.

Author

Julien Ducret - [email protected]

Follow me on Twitter @jbrocoo

Check out my app: Spores

Licence

BRFlabbyTable is under Apache licence, see the LICENCE file for more info.