An OpenGL renderer for Mapbox vector tiles, implemented in C++11, targeting iOS & OS X.

Depends

• Modern C++ compiler that supports -std=c++11
• libpng
• glfw3
• Python (for build only)
• Node.js (for build only)

Build instructions

OS X

Install libpng and glfw3:

brew install libpng
brew install homebrew/versions/glfw3

Then configure the project:

./configure --glfw3=`brew --prefix` --png=`brew --prefix`

See all the options by calling ./configure --help

$ ./configure --help
Usage: configure [options]

Options:
  -h, --help            show this help message and exit
  --debug               Also build debug build
  --glfw3=GLFW3         Path to gflw3 (defaults to using pkg-config)
  --png=PNG             Path to png (defaults to using pkg-config)
  --png-includes=PNG_INCLUDES
                        Path to png includes
  --png-libpath=PNG_LIBPATH
                        Path to png libs

Then you can build the OS X app with make:

make app

Or generate a dual iOS/OS X-compatible Xcode project for libllmr to include as a subproject:

make xcode # then open llmr.xcodeproj

iOS

Because libpng isn't included in the iOS SDK, you will need to build a cross-architecture version yourself. Run ./ios/setup_libpng.sh, which is derived from Mapnik's cross-architecture build scripts. This will also run ./configure.

Then you can build the iOS app with make:

make iapp

Consider sudo npm install -g ios-sim for auto-launching the simulator, but it can be tricky and it's better to run on an ARM-based device anyway. To do this, open ./ios/llmr-app.xcodeproj in Xcode, then build and run on the simulator or a device yourself.

Target devices: iPhone 4 and above (4S, 5, 5c, 5s) and iPad 2 and above (3, 4, mini and/or retina).

Ubuntu

Ensure you have git and other build essentials:

sudo apt-get install git cmake make pkg-config

Install a -std=c++11 capable compiler

sudo add-apt-repository --yes ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-4.8 g++-4.8

Install libpng-dev:

sudo apt-get install libpng-dev

Install glfw3 dependencies:

sudo apt-get install libxi-dev libglu1-mesa-dev x11proto-randr-dev x11proto-xext-dev libxrandr-dev x11proto-xf86vidmode-dev libxxf86vm-dev

Install glfw3:

git clone https://github.com/glfw/glfw.git
cd glfw
mkdir build
cd build
cmake ../ -DCMAKE_C_COMPILER_ENV_VAR=gcc-4.8
make
sudo make install
cd ../../

Build libllmr:

git clone git@github.com:mapbox/llmr-native.git
cd llmr-native
export CXX="g++-4.8"
./configure
make

Style

We're currently embedding the stylesheet JSON in the binary. To create the C++ file and the associated header, run

bin/build-style.js

This is automatically taken care of as a build phase if you are using the Xcode projects.

Usage

Desktop

• Press 'X' to reset the transform
• Press 'N' to reset north
• Press 'R' to toggle raster
• Press Tab to toggle debug information
• Press Esc to quit

Mobile

• Pan to move
• Pinch to zoom
• Use two fingers to rotate
• Double-tap to zoom in one level
• Two-finger single-tap to zoom out one level
• Long-press to reset north
• Two-finger long press to reset the transform
• Three-finger long press to toggle debug information
• Four-finger long press to toggle raster