opengl-starting-point

Starting point for modern OpenGL (v3.0+) projects in C++ (Visual Studio Code project).

Works on MacOS, Ubuntu, and Windows 10.

Uses glew, glfw3, and glm.

Instructions

Designed to be edited and run with Visual Studio Code.

Install Visual Studio Code, then follow the per-platform instructions below.

(Recommended) Install these plugins for VS Code:

• C/C++ Intellisense/debugging by Microsoft
• Shader languages support by slevesque

Afterwards, download this repository and follow the per-platform instructions below.

Then, unzip open this repository's root folder in Visual Studio Code and press Ctrl+Shift+B (Cmd+Shift+B on MacOS) to build. Then, to run (any platform), in VS Code click Task -> Run Task -> 'run opengl-app'

./build/opengl-app

MacOS

Install XCode from the App Store. Install brew.

Brew has up-to-date versions of all three dependencies.

brew update
brew install glfw glew glm

Ubuntu Linux 17.10 x64

The Ubuntu software repos have up-to-date versions of all three dependencies.

sudo apt-get update
sudo apt-get install build-essential libglfw3-dev libglew-dev libglm-dev

Windows 10 x64

Unfortunately, no handy software repositories exist in the Windows world like they do in the *nix world. Fortunately, it's not too painful to set up.

First, either install the Visual C++ 2015 Tools or just Visual Studio 2015.

If you used just the tools, change .vscode/build_windows line 6 from:

call "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" x64

to

call “C:\Program Files (x86)\Microsoft Visual C++ Build Tools\vcbuildtools.bat” x64

Add dependencies

Create a lib folder in the root of the repo.

Add glfw3

Download glfw3 pre-compiled binaries (64-bit) from here.

• From within the .zip, extract the contents of the lib-vc2015 folder to your newly-created lib folder.
• From within the .zip, Copy the include/GLFW folder to your include folder.

Add glew

Download glew binaries (Windows 32 and 64) from here.

• From within the .zip, extract the contents of the /lib/Release/x64 folder to your newly-created lib folder.
• From within the .zip, extract glew32.dll from the /bin/Release/x64 folder to the same lib folder.
• Copy the include/GL folder to your include folder.

Add glm

Download the latest release from here.

• From within the .zip, extract the glm folder to your include folder.

Building should now work 😄

Note: If you receive an error about a missing 'vcvarsall.bat' you need to modify your Visual Studio 2015 installation.