2.2 KiB
An OpenGL renderer for Mapbox vector tiles, implemented in C++, targeting iOS & OS X.
Build instructions
OS X
Install boost and glfw3:
brew install boost
brew install homebrew/versions/glfw3
Then configure the project:
./configure
Options include:
- --boost=/usr/local
- --glfw3=/usr/local (by default pkg-config will be used)
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
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 boost (we only need headers):
sudo apt-get install libboost-dev
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
Note: build will not compile until https://github.com/mapbox/llmr-native/issues/26 is fixed.
Style protobuf
We're encoding the styling information as a protocol buffer, according to proto/style.proto. The reason for doing so is that we don't have to ship with a JSON/yaml parser. To test the conversion script, run
bin/convert-style.js | protoc --decode=style proto/style.proto
You should see a nicely formatted hierarchical output of the converted style.
To update the included default style, use
bin/convert-style.js > resources/style.pbf && bin/build-style.js
Usage
- Press 'R' to reset the transform
- Press 'N' to reset north
- Press Tab to toggle debug information
- Press Esc to quit