C++ — OpenGL — Setting up Visual Studio
The Visual Studio version for this tutorial will be the 2017 (seems to work with the 2015 and 2019 as well).
The glew version will be the 2.2.0.
The freeglut version will be the 3.0.0.
The glew library stands for GL Extension Wrangler.
At the end of this OpenGL tutorial you will be able to display a window with a white square displayed on a black background.
First of all
We are going to use the 32-bit or the 64-bit version.
You have the choice, and it will be specified in the tutorial.
Notice that the version is only based on which platform you want to compile for.
If you plan to create a program to be executed on a 32-bit platform, so use the 32-bit version.
Every platform accept 32-version, so the 64-bit version is only for specific purpose only.
And so the 32-bit version will work on every Windows system.
You’ll need glew headers that could be find on the sourceforge website of the OpenGL Extension Wrangler Library:
freeglut
You’ll also need the freeglut version for Microsoft Visual Studio:
Click the link inside the part freeglut 3.0.0 MSVC Package.
The name of the file you have to download is: freeglut-MSVC-3.0.0-2.mp.zip.
Once you have downloaded it, there is a folder named freeglut inside.
Extract it and rename it to freeglut-3.0.0 in order to have exactly the same name used in this tutorial.
Paths and directories for this setup
The general directory for our setup will be:
- C:\dev
The directory where projects are:
- C:\dev\visual-studio-c++
The directory where libraries are:
- C:\dev\lib
Visual Studio
Open it and create an empty project > File > New > Project > Templates > Visual C++ > Empty Project.
- Name: Shapes2D
- Location: C:\dev\visual-studio-c++\
- Solution: Create a new solution
- Solution name: BadprogTutorial
Your Shapes2D project has been created into your BadprogTutorial solution.
Let’s add a main.cpp > Right click your project > Add > New Item > Visual C++ > C++ File > write the name main.cpp > Add.
Setting all configurations
Right click your Shapes2D project > Properties > On the top left there is a drop down menu > Configuration > Select All Configurations (instead of Debug)
Including header files (includes)
Right click your Shapes2D project > Properties > Configuration Properties > C/C++ > General > Additional Include Directories > Click it.
On the right there is a drop down menu, click <Edit. >.
A new window has appeared: Additional Include Directories.
Click the New Line icon > Click the browse button > Then select the two following folders:
- C:\dev\lib\glew-2.0.0\include
- C:\dev\lib\freeglut-3.0.0\include
Click OK > Apply
Including libraries
Library folders
Right click your Shapes2D project > Properties > Configuration Properties > Linker > General > Additional Library Directories > Click it.
On the right there is a drop down menu, click <Edit. >.
A new window has appeared: Additional Library Directories.
Click the New Line icon > Click the browse button > Then select the two following folders:
For the 64-bit version
- C:\dev\lib\glew-2.0.0\lib\Release\x64
- C:\dev\lib\freeglut-3.0.0\lib\x64
For the 32-bit version
- C:\dev\lib\glew-2.0.0\lib\Release\Win32
- C:\dev\lib\freeglut-3.0.0\lib
Click OK > Apply
Library files
Right click your Shapes2D project > Properties > Configuration Properties > Linker > Input > Additional Dependencies > Click it.
On the right there is a drop down menu, click <Edit. >.
A new window has appeared: Additional Dependencies.
Click the white area and write:
- freeglut.lib (click enter to go the next line)
- glew32.lib
Click OK > Apply > OK.
Your Visual Studio IDE is now ready to play with OpenGL!
Testing the setup
To test the setup, let’s code the most basic code HelloWorld! that you can write with OpenGL.
On the Visual Studio’s top menu there is a dropdown menu with x86 selected.
Click the black tiny triangle on the right of the x86 and select Configuration Manager.
A new window has appeared: Configuration Manager.
On the right select x86 in the dropdown menu and click New.
A new window has appeared: New Solution Platform.
On the right click the the Active solution platform dropdown menu and select:
- Type or select the new platform: x64
- Copy settings from: x86 (or Empty)
You could now close the Configuration Manager and as you can see the platform is now specified as x64.
And you could easily click either x86 or x64 (depending of your libraries version).
freeglut.dll and glew32.dll
Before building it, let’s copy (not move!) the .dll of these two libraries:
For the 64-bit version
- C:\dev\lib\glew-2.0.0\bin\Release\x64\glew32.dll (yes this is the right one)
- and
- C:\dev\lib\freeglut-3.0.0\bin\x64\freeglut.dll
To the following directory:
- C:\dev\visual-studio-c++\BadprogTutorial\x64\Debug
Or if it doesn’t work in: - C:\dev\visual-studio-c++\BadprogTutorial
For the 32-bit version
- C:\dev\lib\glew-2.0.0\bin\Release\Win32\glew32.dll
- and
- C:\dev\lib\freeglut-3.0.0\bin\freeglut.dll
To the following directory:
- C:\dev\visual-studio-c++\BadprogTutorial\Debug
Or if it doesn’t work in: - C:\dev\visual-studio-c++\BadprogTutorial
For both versions (x86 and x64) and to avoid having copy/paste .DLL
If you don’t want to copy/paste your freeglut.dll and glew32.dll from the library directory to your project directory then you have to set their paths directly in your Environment variables.
If you don’t know where to find your Environment variables, open your Windows settings and search for Environment variables.
A system properties window should appear > Advanced tab > Environment variables > In the System variables click New. > Enter, for example for the x64 Freeglut version, the following:
- Variables name: FREEGLUT_LIB
- Variable value: C:\dev\lib\freeglut-3.0.0\bin\x64\
And for the x64 Glew32 version the following:
- Variables name: GLEW32_LIB
- Variable value: C:\dev\lib\glew-2.0.0\bin\Release\x64\
Then click OK > OK.
Do the same for the x86 version except the paths that must, of course, correspond to your x86 versions.
Then close your Visual Studio IDE (yes close it if it still open) in order to get the last Environment variables set.
And you are done, this time you won’t have to copy/paste your .DLL because Windows is now able to find them automatically.
Open Visual Studio again to build and compile your first OpenGL application.
Building the project
On the Visual Studio’s top menu, select either x86 or x64 and build the project.
If there is no error, right click the Shapes2D project > Debug > Start new instance.
If all is OK, you should see a black window with a white square.
Possible Errors
If you had some errors like these ones, it’s because you try to play with a different version from the one specified in the setup configuration.
For example if you have set up the configuration with the 64-bit version, you have to build it with the x64 configuration.
Same thing for the 32-bit version, set up with the 32-bit library version and build it as a x86 configuration.
So double check the paths you’ve just entered in the setup configuration.
Here the errors:
Conclusion
Now that your Visual Studio has been set up, you could start creating OpenGL applications.
Setup OpenGL with Visual Studio 2019
Open Visual Studio , select create a new project , choose Empty Project .
Go to Project -> Properties (Alt + F7) , on the top select All Configurations from Configuration dropdown menu.
Choose Configuration Properties -> C/C++ -> Precompiled Headers , set Precompiled Header ‘s value to Not Using Precompiled Headers .
Choose Configuration Properties -> Linker -> Input , click Additional Dependencies , and then click Edit , and type:
Paste the code I found in Internet to test:
Then Compile and run(x86).
One more thing…
If you upgrade VS, you should re-install OpenGL, since the folder is moved to a higher version one.
Русские Блоги
1. Установите компоненты разработки C ++ и диспетчер пакетов NuGet.
1. Откройте программу установки Visual Studio, чтобы изменить: 
2. Нажмите, чтобы изменить: 
3. Проверьте настольную разработку на C ++:
4. Проверьте диспетчер пакетов NuGet:
Во-вторых, настройте OpenGL
Ссылка для скачивания: https://www.opengl.org/resources/libraries/glut/glutdlls37beta.zip
Ссылка на сетевой диск: https://pan.baidu.com/s/1O0eFXG-EPDR_9PzD0se1qg Код извлечения: 7dmk
После загрузки и распаковки сжатого пакета есть следующие файлы: 
Просто поместите файл в соответствующую папку:
①Поместите glut.h в C: \ Program Files (x86) \ Microsoft Visual Studio \ community \ VC \ Tools \ MSVC \ 14.24.28314 \ include \ gl
②Поместите glut.lib и glut32.lib в . \ Microsoft VisualStudio \ community \ VC \ Tools \ MSVC \ 14.24.28314 \ lib \ x86
③ Поместите glut.dll и glut32.dll в C: \ Windows \ SysWOW64
Примечание:
① Если папки gl нет, создайте новую
②Windows 64-битная, просто выполните описанную выше операцию, если она 32-битная, поместите glut.dll и glut32.dll в C: \ Windows \ System32
3. Новый проект OpenGL
1. Откройте Visual Studio2019 и выберите создание нового проекта: 
2. Выберите Мастер рабочего стола Windows: 
3. Проверьте пустой проект: 
4. Выберите «Инструменты-NuGet Package Management-NuGet Packages for Management Solutions» и найдите «nupengl» в браузере. 
5. Должны быть установлены и nupengl.core, и nupengl.core.redist: 
Он был успешно настроен, и затем вы можете создать новый файл .cpp для тестирования кода в только что созданном проекте.
Урок №2. Подготовка к первому проекту OpenGL: настройка GLFW, CMake и GLAD
Первое, что нам нужно сделать, прежде чем мы начнем программировать графику — это создать контекст OpenGL и окно приложения для рисования. Однако данные операции являются специфичными для каждой операционной системы, поэтому OpenGL целенаправленно пытается абстрагироваться от них. Это означает, что мы самостоятельно должны создать окно, определить контекст и обрабатывать пользовательский ввод.
К счастью, существует довольно много библиотек, которые обеспечивают необходимый нам функционал, при этом некоторые из них специально нацелены на работу с OpenGL. Эти библиотеки избавят нас от всей специфической работы, связанной с особенностями конкретной операционной системы. Наиболее популярными библиотеками являются: GLUT, SDL, SFML и GLFW. На этих уроках мы будем использовать библиотеку GLFW. Вы также можете использовать и любую другую библиотеку из предоставленного списка, т.к. установка и настройка для большинства из них аналогична установке и настройке GLFW.
Библиотека GLFW
GLFW (англ. «Graphics Library FrameWork») — это библиотека, написанная на языке Си, специально предназначенная для работы с OpenGL. Библиотека GLFW предоставит нам все необходимые инструменты, которые потребуются для рендеринга на экран различных объектов. Благодаря этому мы сможем создавать контексты OpenGL, определять параметры окна и обрабатывать пользовательский ввод, что вполне коррелирует с нашими целями.
Основное внимание на этом и следующем уроках уделяется изучению библиотеки GLFW, созданию корректного контекста OpenGL, а также простого окна, в котором мы и будем рисовать наши объекты. На этом уроке мы пошагово рассмотрим установку библиотеки GLFW, а также процесс сборки и компиляции программы в связке с GLFW.
Примечание: На момент написания данной статьи в качестве среды разработки мы будем использовать Microsoft Visual Studio 2019 (обратите внимание, что наши действия будут аналогичными и с более старыми версиями Visual Studio). Если же вы используете более старую версию Visual Studio (или вообще другую среду разработки), то можете быть спокойны, т.к. процесс установки и настройки GLFW аналогичен в большинстве IDE.
Сборка GLFW
Библиотеку GLFW можно скачать с официального сайта. Стоит отметить, что GLFW уже имеет предварительно скомпилированные бинарные и заголовочные файлы для Visual Studio 2010-2019, но для полноты картины их мы использовать не будем, а вместо этого вручную скомпилируем GLFW из исходного кода. Это делается для того, чтобы вы сами прочувствовали процесс компиляции библиотек с открытым исходным кодом, поскольку не каждая подобная библиотека будет предоставлять возможность скачать предварительно скомпилированные бинарные файлы. Итак, давайте загрузим пакет с исходным кодом.
Примечание: Мы будем собирать все библиотеки в формате 64-битных бинарных файлов, поэтому убедитесь, что скачиваете и используете именно 64-битные бинарные файлы.
После загрузки пакета с файлами исходного кода извлеките и откройте его содержимое. Нас интересуют следующие вещи:
библиотека, которая будет получена в результате компиляции;
Компиляция библиотек из исходного кода гарантирует, что полученная нами библиотека идеально подойдет для нашего процессора и операционной системы, в то время как предварительно скомпилированные бинарные файлы не всегда могут этим похвастаться (иногда они вообще недоступны для вашей системы). Однако проблема проектов, распространяющихся под эгидой открытого программного обеспечения, заключается в том, что не все используют одну и ту же IDE или систему сборки для разработки своего приложения, а это значит, что предоставленные файлы проекта/решения могут быть несовместимы с настройками IDE у других людей. Следовательно, каждый конечный пользователь должен настроить свой собственный проект/решение с учетом полученных *.с / *.cpp и *.h / *.hpp файлов, что почти всегда является довольно трудоемким и громоздким процессом. Но не спешите расстраиваться, для решения данной проблемы уже существует удобный инструмент сборки проектов под названием CMake.
CMake
CMake — это инструмент, который с использованием заранее определенных сценариев может из коллекции файлов исходного кода сгенерировать файлы проектов/решений под выбранную пользователем IDE (например, для Visual Studio, Code::Blocks или Eclipse). Он позволит нам из исходного пакета файлов GLFW создать файл проекта под среду разработки Visual Studio 2019, а затем данный файл мы сможем использовать для компиляции библиотеки. Но сначала нам нужно его скачать, а затем установить.
После установки CMake у вас будет 2 варианта:
запустить CMake из командной строки;
запустить CMake через графический интерфейс.
Поскольку мы не стремимся всё усложнять, то остановимся на варианте с использованием графического интерфейса. Для работы с CMake нам потребуется указать папку с файлами исходного кода проекта (в нашем случае glfw-3.3.2 ) и папку назначения для бинарных файлов. Для папки исходного кода мы собираемся выбрать корневую папку загруженного исходного пакета GLFW, а для папки сборки мы создадим новый каталог build :
После того, как мы прописали пути для исходной и целевой папок, нам нужно нажать кнопку Configure , чтобы CMake смог просмотреть исходные файлы GLFW и выбрать необходимые параметры для сборки.
В следующем окне необходимо задать используемую версию Visual Studio. Т.к. работать мы будем в Visual Studio 2019, то выбираем опцию «Visual Studio 16 2019» :
Далее CMake отобразит возможные варианты сборки библиотеки. Можно оставить значения по умолчанию и снова нажать кнопку Configure , чтобы сохранить настройки:
После установки параметров мы нажимаем кнопку «Generate» , в результате чего в папке build будут созданы необходимые файлы проекта.
Компиляция проекта
Теперь, зайдя в папку build , среди всего прочего можно увидеть файл с именем GLFW.sln , открываем его с помощью Visual Studio 2019:
Поскольку CMake сгенерировал файл проекта, который уже содержит соответствующие параметры конфигурации, нам остается лишь реализовать решение. При этом CMake должен был автоматически настроить вариант компилирования решения в виде 64-битной библиотеки. Благодаря этому мы получим скомпилированный файл библиотеки с именем glfw3.lib , который будет находиться в папке build/src/Debug .
После того, как мы создали библиотеку, нужно убедиться, что IDE знает, где найти данный файл, а также другие подключаемые файлы нашей программы OpenGL. Решить этот вопрос можно двумя способами:
Способ №1: Можно скопировать содержимое папки include проекта GLFW в соответствующую папку include вашей IDE или компилятора, а также скопировать полученный файл glfw3.lib в соответствующую папку /lib вашей IDE или компилятора. Данный способ вполне рабочий, но мы его не рекомендуем, так как новая установка IDE или компилятора приведет к тому, что вам заново придется подключать необходимые файлы.
Способ №2: Вы можете создать новую папку, которая будет содержать все заголовочные файлы и файлы из сторонних библиотек. На эту папку вы впоследствии сможете ссылаться из своей IDE или компилятора. Например, можно создать папку, в которой будут находиться папки Lib и Include . В них мы будем хранить все наши библиотечные и подключаемые файлы, которые собираемся использовать для наших OpenGL-проектов. Получается, что все сторонние библиотеки будут организованы в одном месте (и их можно будет совместно использовать на нескольких компьютерах). Однако, каждый раз при создании нового проекта, мы должны будем указывать IDE соответствующие пути к этим папкам.
Как только необходимые файлы будут сохранены в выбранном вами месте, мы сможем приступить к созданию нашего первого OpenGL-GLFW-проекта.
Наш первый проект
Для начала давайте откроем Visual Studio и создадим новый проект. Для этого нужно выбрать тип проекта «C++» , а далее — «Пустой проект» (не забудьте дать проекту подходящее имя):
Теперь у нас есть рабочее пространство для создания нашего самого первого OpenGL-приложения!
Линкинг проекта
Для того, чтобы наш проект мог использовать GLFW, нам нужно связать с ним полученную библиотеку. Это можно сделать, указав в настройках линкера, что мы хотим использовать библиотеку glfw3.lib , но проект пока не знает где её искать, т.к. все подобные файлы мы переместили в другую папку. Таким образом, сначала мы должны добавить эту папку в наш проект.
Для этого нажмите правой кнопкой мышки на имя проекта в «Обозреватель Решений» > «Свойства» . В появившемся окне выберите «Каталоги VC++» > «Каталоги библиотек» :
Здесь вы можете добавить свои собственные каталоги, чтобы проект знал, где искать необходимые файлы. Это можно сделать, вставив вручную путь до каталога или щелкнув по соответствующей строке и выбрав пункт <Изменить…> , в результате чего откроется следующее окно:
Здесь вы можете добавить столько дополнительных каталогов, сколько захотите, и с этого момента IDE при поиске файлов библиотек также будет просматривать и эти директории. Поэтому, как только вы подключите папку Lib из проекта GLFW, вы сможете использовать все файлы библиотек из этой папки. Аналогично обстоят дела и с добавлением папки Include для заголовочных файлов.
Поскольку для VS были указаны все необходимые файлы, то мы, наконец, можем связать GLFW с нашим проектом, перейдя в раздел «Компоновщик» > «Ввод» :
Чтобы связать библиотеку, нам нужно указать для компоновщика её имя. Так как библиотека называется glfw3.lib , то мы добавляем название этого файла в раздел «Дополнительные зависимости» (вручную или же через пункт <Изменить…> ), и с этого момента при запуске процесса компиляции GLFW будет связан с нашим проектом. В дополнение к GLFW мы также должны добавить ссылки на библиотеку OpenGL, но данные действия будут отличаться, в зависимости от (вашей) используемой операционной системы:
Библиотека OpenGL в Windows. Если вы используете операционную систему Windows, то необходимый нам файл библиотеки OpenGL32.Lib , входящий в пакет Microsoft SDK, уже есть в составе Visual Studio и не требует отдельной установки. Поскольку мы используем компилятор VS и работаем в операционной системе Windows, то всё, что вам нужно сделать — это добавить название файла OpenGL32.Lib к общему списку параметров компоновщика.
Примечание: В примечании подраздела «Сборка GLFW» сказано, что мы собираем все библиотеки в формате 64-битных бинарных файлов. В то же время число «32» в названии файла OpenGL32.Lib может вызвать некоторую путаницу, как бы намекая на то, что в данном случае используется именно 32-битная версия библиотеки. На самом деле это не так. Если у вас установлен пакет Microsoft SDK, то достаточно просто зайти в папку C:\Program Files (x86)\Windows Kits\10\Lib\[Номер_версии_SDK]\um\x64\ и убедиться, что в ней среди прочих файлов находится и наша библиотека:
Больше того, если зайти в папку C:\Program Files (x86)\Windows Kits\10\Lib\[Номер_версии_SDK]\um\x86\, то и там можно встретить файл OpenGL32.Lib:
Другими словами, под одним названием файла OpenGL32.Lib существует две различные версии (32-битная и 64-битная) библиотеки. Поэтому просто не обращайте внимание на то, что в её имени есть часть «32». Всё прекрасно работает и в 64-битном окружении.
Библиотека OpenGL в Linux. Если вы работаете в операционной системе Linux, то вам нужно подключить библиотеку libGL.so с помощью ключей –lGL , добавляемых к параметрам вашего компоновщика. Если вы не можете найти данную библиотеку, то вам, вероятно, необходимо установить любой из пакетов: Mesa, NVidia или AMD dev.
Затем, после добавления библиотек GLFW и OpenGL в настройки компоновщика, вы сможете подключить заголовочные файлы GLFW следующей строкой кода: