Home

Lab Negative One — Setting up the development environment

IMPORTANT! In this course, your project must be cross-platform. Follow these guidelines.

• Always use CMake to perform an “out-of-source” build, which means that the binary files will not be in the same directory as the source files.
• When adding new .cpp and .h files, always add them manually to the src folder and rerun CMake. Do not use the “add” feature of your IDE to add files to your project.
• Do not use system-specific headers and libraries (e.g., windows.h).
• In your code, use forward slashes instead of back slashes for paths (/ instead of \).

Once you set up your environment properly, you should be able to run the lab code and see the following in the console:

Welcome to Computer Graphics!

First, download the lab here, and then extract the zip file to a suitable folder. Then go to the section corresponding to your development environment.

• Windows
  • Install prerequisite software on Windows
  • Option A: Run the lab with Visual Studio
  • Option B: Run the lab with Makefile
  • Option C: Run the lab with WSL
• macOS
  • Install prerequisite software on macOS
  • Option A: Run the lab with Xcode
  • Option B: Run the lab with Makefile
• Linux
  • Install prerequisite software on Linux
  • Run the lab with Makefile

Miscellaneous tips:

1. Depending on the environment, things may not go smoothly if the path contains special characters. Therefore, I recommend against using SPACE, &, etc. in your path.
2. Whenever you change your environment variables, you need to restart CMake and your IDE.
3. Because CMake caches your last-used settings, it must be cleared before running again. Run the command rm -r * from the build folder to delete the cache.

Setting up Windows

Download and install these programs.

• Visual Studio (https://www.visualstudio.com/downloads/). Any recent version should work.
  • Make sure to download Visual C++, not just Visual Studio.
  • You may have to run Visual C++ at least once, before running CMake. Try creating a simple “Hello World” program within Visual Studio program running it.
  • Some people have reported that they needed to also install “Build Tools For Visual Studio,” under “Other Tools and Frameworks” on the visual studio download page.
  • Some people have needed to follow the top answer here to get CMake to recognize Visual Studio: https://stackoverflow.com/questions/51668676/cmake-visual-studio-15-2017-could-not-find-any-instance-of-visual-studio.
• CMake (https://cmake.org/download/): get the Windows Installer.

Setting up macOS

Download and install the following. You can use homebrew/macports or install these manually.

• Xcode developer tools. You’ll need to log in with your Apple ID.
  • You may have to run Xcode at least once, before running CMake.
  • According to this post, some people may need to run this command: sudo xcode-select --reset
  • According to the same post, Some people may need to run this command: sudo xcodebuild -license accept
• CMake (http://cmake.org/download/). Once installed, run the application and follow one of the three options listed under “Tools -> How to Install for Command Line Use”.

Make sure the commands g++ and cmake work from the command prompt.

Setting up Linux

This is for Ubuntu Linux 16.04.1 LTS. Setting up other distributions will be similar but may be slightly different.

You’ll need the following if you don’t have them already.

> sudo apt-get update
> sudo apt-get install g++
> sudo apt-get install cmake

Run with Visual Studio

0. Extract L-1.zip into a folder of your choice.

1. Run CMake (GUI).

   1. Click on “Browse Source…” and point to the folder you extracted, containing the CMakeLists.txt file.
   2. Copy and paste the path from above to “Where to build the binaries.” Append “build” to it.
   3. Click on “Configure.” Click on “Yes” if it asks if you want to create a directory. Select the Visual Studio version that is installed on your machine (e.g., “Visual Studio 16.2.5 2019”) and click on “Finish.” You should see “Configuring done” in the scroll panel.
   4. Click on “Generate.” You should see “Generating done” in the scroll panel. Close CMake.
      

2. There should now be a file called L-1.sln in the build folder. Double click it to open it with Visual Studio.

   1. Right-click on L-1 and select “Set as StartUp Project.”
      
   2. Right-click again on L-1 and select “Properties.” Go to “Debugging” then “Command Arguments” and then type in the command line arguments (e.g., ../resources). Click “OK.”
      
   3. Go to the “Build” menu and click “Build Solution [F7].”
   4. Go to the “Debug” menu and click “Start Debugging [F5].”
   5. To run in Release mode, change the solution configuration by clicking on “Debug” in the drop-down menu.
      

Run with Windows Subsystem for Linux

Advanced users only: This is not officially supported, but it is possible to get WSL to work with OpenGL. Here is a nice writeup by Ben Lopez.

Run with Xcode

0. Extract L-1.zip into a folder of your choice.

1. In the folder that contains CMakeLists.txt, run the following.

    > mkdir build
    > cd build

   Then run the following from the build folder.

    > cmake -G Xcode ..

   This will generate L-1.xcodeproj project that you can open with Xcode.

2. Open L-1.xcodeproj with Xcode.

   1. Change the target by clicking on “ALL_BUILD” and selecting L-1.
      
   2. Edit the scheme by going to “Product” -> “Scheme” -> “Edit Scheme” to add command-line arguments (e.g., ../../resources).
      
      
   3. Press Command+B to build.
   4. Press Command+R to run.
   5. To run in release mode, edit the scheme again and go to the “info” tab.
      

Run with Makefile

0. Extract L-1.zip into a folder of your choice.

1. In the folder that contains CMakeLists.txt, run the following.

    > mkdir build
    > cd build

   Then run the following from the build folder.

    > cmake ..

   This will generate a Makefile that you can use to compile your code.

2. To compile the code, run the generated Makefile.

    > make -j4

   The -j argument speeds up the compilation by multithreading the compiler. This will generate an executable, which you can run by typing

    > ./L-1

   You can add arguments to the line above as needed.

   To build in release mode, use ccmake .. and change CMAKE_BUILD_TYPE to Release. Press ‘c’ to configure then ‘g’ to generate. Now make -j4 will build in release mode.