Download glfw on linux

Using CMake

GLFW uses CMake to generate project files or makefiles for your chosen development environment. To compile GLFW, first generate these files with CMake and then use them to compile the GLFW library.

If you are on Windows and macOS you can download CMake from their site.

If you are on a Unix-like system such as Linux, FreeBSD or Cygwin or have a package system like Fink, MacPorts or Homebrew, you can install its CMake package.

CMake is a complex tool and this guide will only show a few of the possible ways to set up and compile GLFW. The CMake project has their own much more detailed CMake user guide that includes everything in this guide not specific to GLFW. It may be a useful companion to this one.

Installing dependencies

The C/C++ development environments in Visual Studio, Xcode and MinGW come with all necessary dependencies for compiling GLFW, but on Unix-like systems like Linux and FreeBSD you will need a few extra packages.

Dependencies for X11 on Unix-like systems

To compile GLFW for X11, you need to have the X11 development packages installed. They are not needed to build or run programs that use GLFW.

On Debian and derivates like Ubuntu and Linux Mint the xorg-dev meta-package pulls in the development packages for all of X11.

On Fedora and derivatives like Red Hat the X11 extension packages libXcursor-devel , libXi-devel , libXinerama-devel and libXrandr-devel required by GLFW pull in all its other dependencies.

On FreeBSD the X11 headers are installed along the end-user X11 packages, so if you have an X server running you should have the headers as well. If not, install the xorgproto package.

On Cygwin the xorgproto package in the Devel section of the GUI installer will install the headers and other development related files for all of X11.

Once you have the required depdendencies, move on to Generating build files with CMake.

Dependencies for Wayland on Unix-like systems

To compile GLFW for Wayland, you need to have the Wayland and xkbcommon development packages installed. They are not needed to build or run programs that use GLFW.

On Debian and derivates like Ubuntu and Linux Mint you will need the libwayland-dev , libxkbcommon-dev , wayland-protocols and extra-cmake-modules packages.

On Fedora and derivatives like Red Hat you will need the wayland-devel , libxkbcommon-devel , wayland-protocols-devel and extra-cmake-modules packages.

On FreeBSD you will need the wayland , libxkbcommon , wayland-protocols and kf5-extra-cmake-modules packages.

Once you have the required depdendencies, move on to Generating build files with CMake.

Generating build files with CMake

Once you have all necessary dependencies it is time to generate the project files or makefiles for your development environment. CMake needs two paths for this:

• the path to the root directory of the GLFW source tree (not its src subdirectory)
• the path to the directory where the generated build files and compiled binaries will be placed

If these are the same, it is called an in-tree build, otherwise it is called an out-of-tree build.

Out-of-tree builds are recommended as they avoid cluttering up the source tree. They also allow you to have several build directories for different configurations all using the same source tree.

A common pattern when building a single configuration is to have a build directory named build in the root of the source tree.

Generating files with the CMake GUI

Start the CMake GUI and set the paths to the source and build directories described above. Then press Configure and Generate.

If you wish change any CMake variables in the list, press Configure and then Generate to have the new values take effect. The variable list will be populated after the first configure step.

By default GLFW will use X11 on Linux and other Unix-like systems other than macOS. To use Wayland instead, set the GLFW_USE_WAYLAND option in the GLFW section of the variable list, then apply the new value as described above.

Once you have generated the project files or makefiles for your chosen development environment, move on to Compiling the library.

Generating files with the CMake command-line tool

To make a build directory, pass the source and build directories to the cmake command. These can be relative or absolute paths. The build directory is created if it doesn’t already exist.

It is common to name the build directory build and place it in the root of the source tree when only planning to build a single configuration.

Without other flags these will generate Visual Studio project files on Windows and makefiles on other platforms. You can choose other targets using the -G flag.

By default GLFW will use X11 on Linux and other Unix-like systems other than macOS. To use Wayland instead, set the GLFW_USE_WAYLAND CMake option.

Once you have generated the project files or makefiles for your chosen development environment, move on to Compiling the library.

Compiling the library

You should now have all required dependencies and the project files or makefiles necessary to compile GLFW. Go ahead and compile the actual GLFW library with these files as you would with any other project.

With Visual Studio open GLFW.sln and use the Build menu. With Xcode open GLFW.xcodeproj and use the Project menu.

With Linux, macOS and other forms of Unix, run make .

With MinGW, it is mingw32-make .

Any CMake build directory can also be built with the cmake command and the —build flag.

This will run the platform specific build tool the directory was generated for.

Once the GLFW library is compiled you are ready to build your application, linking it to the GLFW library. See Building applications for more information.

CMake options

The CMake files for GLFW provide a number of options, although not all are available on all supported platforms. Some of these are de facto standards among projects using CMake and so have no GLFW_ prefix.

If you are using the GUI version of CMake, these are listed and can be changed from there. If you are using the command-line version of CMake you can use the ccmake ncurses GUI to set options. Some package systems like Ubuntu and other distributions based on Debian GNU/Linux have this tool in a separate cmake-curses-gui package.

Finally, if you don’t want to use any GUI, you can set options from the cmake command-line with the -D flag.

Shared CMake options

BUILD_SHARED_LIBS determines whether GLFW is built as a static library or as a DLL / shared library / dynamic library. This is disabled by default, producing a static GLFW library.

GLFW_BUILD_EXAMPLES determines whether the GLFW examples are built along with the library.

GLFW_BUILD_TESTS determines whether the GLFW test programs are built along with the library.

GLFW_BUILD_DOCS determines whether the GLFW documentation is built along with the library. This is enabled by default if Doxygen is found by CMake during configuration.

GLFW_VULKAN_STATIC determines whether to use the Vulkan loader linked directly with the application. This is disabled by default.

Windows specific CMake options

USE_MSVC_RUNTIME_LIBRARY_DLL determines whether to use the DLL version or the static library version of the Visual C++ runtime library. When enabled, the DLL version of the Visual C++ library is used. This is enabled by default.

On CMake 3.15 and later you can set the standard CMake CMAKE_MSVC_RUNTIME_LIBRARY variable instead of this GLFW-specific option.

GLFW_USE_HYBRID_HPG determines whether to export the NvOptimusEnablement and AmdPowerXpressRequestHighPerformance symbols, which force the use of the high-performance GPU on Nvidia Optimus and AMD PowerXpress systems. These symbols need to be exported by the EXE to be detected by the driver, so the override will not work if GLFW is built as a DLL. This is disabled by default, letting the operating system and driver decide.

Wayland specific CMake options

GLFW_USE_WAYLAND determines whether to compile the library for Wayland. This option is only available on Linux and other Unix-like systems other than macOS. This is disabled by default.

Cross-compilation with CMake and MinGW

Both Cygwin and many Linux distributions have MinGW or MinGW-w64 packages. For example, Cygwin has the mingw64-i686-gcc and mingw64-x86_64-gcc packages for 32- and 64-bit version of MinGW-w64, while Debian GNU/Linux and derivatives like Ubuntu have the mingw-w64 package for both.

GLFW has CMake toolchain files in the CMake subdirectory that set up cross-compilation of Windows binaries. To use these files you set the CMAKE_TOOLCHAIN_FILE CMake variable with the -D flag add an option when configuring and generating the build files.

The exact toolchain file to use depends on the prefix used by the MinGW or MinGW-w64 binaries on your system. You can usually see this in the /usr directory. For example, both the Ubuntu and Cygwin MinGW-w64 packages have /usr/x86_64-w64-mingw32 for the 64-bit compilers, so the correct invocation would be:

The path to the toolchain file is relative to the path to the GLFW source tree passed to the -S flag, not to the current directory.

For more details see the CMake toolchain guide.

Compiling GLFW manually

If you wish to compile GLFW without its CMake build environment then you will have to do at least some of the platform detection yourself. GLFW needs a configuration macro to be defined in order to know what window system it is being compiled for and also has optional, platform-specific ones for various features.

When building with CMake, the glfw_config.h configuration header is generated based on the current platform and CMake options. The GLFW CMake environment defines GLFW_USE_CONFIG_H, which causes this header to be included by internal.h . Without this macro, GLFW will expect the necessary configuration macros to be defined on the command-line.

The window creation API is used to create windows, handle input, monitors, gamma ramps and clipboard. The options are:

• _GLFW_COCOA to use the Cocoa frameworks
• _GLFW_WIN32 to use the Win32 API
• _GLFW_X11 to use the X Window System
• _GLFW_WAYLAND to use the Wayland API (experimental and incomplete)
• _GLFW_OSMESA to use the OSMesa API (headless and non-interactive)

If you are building GLFW as a shared library / dynamic library / DLL then you must also define _GLFW_BUILD_DLL. Otherwise, you must not define it.

If you are linking the Vulkan loader directly with your application then you must also define _GLFW_VULKAN_STATIC. Otherwise, GLFW will attempt to use the external version.

If you are using a custom name for the Vulkan, EGL, GLX, OSMesa, OpenGL, GLESv1 or GLESv2 library, you can override the default names by defining those you need of _GLFW_VULKAN_LIBRARY, _GLFW_EGL_LIBRARY, _GLFW_GLX_LIBRARY, _GLFW_OSMESA_LIBRARY, _GLFW_OPENGL_LIBRARY, _GLFW_GLESV1_LIBRARY and _GLFW_GLESV2_LIBRARY. Otherwise, GLFW will use the built-in default names.

Note None of the GLFW header option macros may be defined during the compilation of GLFW. If you define any of these in your build files, make sure they are not applied to the GLFW sources.

Last update on Fri Aug 13 2021 for GLFW 3.3.5

Источник

OpenGL и Linux: Установка и настройка Code::Blocks

Обновл. 7 Сен 2021 |

На этом уроке мы рассмотрим установку и настройку Code::Blocks в Linux для работы с OpenGL, а также запустим проект, рассмотренный на предыдущем уроке.

Подготовительные шаги

Установка будет происходить на чистой системе debian-10.3.0-amd64 XFCE под VMware. Я не буду описывать сам процесс установки ОС, ограничусь лишь скриншотом итоговой конфигурации системы:

Также для данного проекта я в домашней папке своего пользователя создал каталог OpenGL_Project , полный путь к которому выглядит как /home/diego/OpenGL_Project/ , где diego — это имя моего пользователя в системе. У вас оно наверняка будет другим. Учитывайте это!

На всякий случай избегайте кириллицы в путях и именах файлов.

Еще один момент: для установки новых пакетов в Linux я привык пользоваться программой aptitude , а не стандартной apt-get . Поэтому вы можете поступить следующим образом:

Вариант №1: Установить aptitude , для этого в терминале выполните команду sudo apt-get install aptitude .

Вариант №2: Можете пользоваться стандартной программой apt-get . Но учтите, что если по ходу данного туториала встречается установка пакета командой вроде sudo aptitude install НАЗВАНИЕ_ПАКЕТА , то в вашем варианте команда установки пакета должна выглядеть как sudo apt-get install НАЗВАНИЕ_ПАКЕТА .

Установка GLFW в Linux

Распаковываем скачанный архив в папку /home/diego/OpenGL_Project/ , я пользуюсь архиватором Xarchiver:

Указываем необходимую нам папку:

Видим получившуюся распакованную папку glfw-3.3.2 :

Установка CMake в Linux

Теперь необходимо поставить систему сборки проектов CMake. Для этого в окне терминала выполните следующую команду:

sudo aptitude install cmake-gui

Указываем папку с исходниками GLFW и вторую папку, где должен будет появиться результат работы CMake (у себя для этого я создал папку build ), и нажимаем кнопку «Configure» :

В появившемся окне выбираем пункт «CodeBlocks – Unix Makefiles» и нажимаем кнопку «Finish» :

В результате видим… кучу ошибок (добро пожаловать в мир Linux):

Нажимаем «ОК» , снова возвращаемся в терминал и устанавливаем пакет xorg-dev :

sudo aptitude install xorg-dev

Возвращаемся в CMake и выставляем галочки так, как показано ниже:

И снова нажимаем кнопку «Configure» (дважды), а потом кнопку «Generate» . Видим сообщения об успешном конфигурировании и сборке проекта:

В результате, в папке build у нас должен появиться файл проекта GLFW.cbp :

Установка Code::Blocks в Linux

Пришло время установить среду программирования Code::Blocks. Для этого возвращаемся в терминал и вводим следующую команду:

sudo aptitude install codeblocks

После установки иконка файла проекта поменяет свой внешний вид:

Открываем данный файл, в результате чего будет запущен Code::Blocks, и появится окно с выбором компиляторов. В системе должен присутствовать как минимум один компилятор — GNU GCC Compiler . Жмем «ОК» :

Открывается окно проекта, нажимаем на шестеренку и компилируем его:

После этого в папке build/src должен появиться скомпилированный файл библиотеки libglfw3.a :

Установка GLAD в Linux

Заходим на оф. сайт GLAD и указываем следующие настройки, после чего нажимаем кнопку «Generate» :

В результате нам будет предложено скачать архив glad.zip:

Далее, чтобы внести немного порядка и организованности в наш будущий проект, поместите папки include и src , содержащиеся в данном архиве, в папку /home/diego/OpenGL_Project/ .

Затем скопируйте папку /home/diego/OpenGL_Project/glfw-3.3.2/include/GLFW в папку /home/diego/OpenGL_Project/include/ .

Также создайте папку lib в /home/diego/OpenGL_Project/ и скопируйте в нее файл скомпилированной библиотеки libglfw3.a .

В итоге у вас должна получиться примерно следующая картина иерархии папок и файлов:

Создание проекта в Code::Blocks

Запускаем Code::Blocks и создаем новый пустой проект: «File» > «New» > «Project…» , выбираем «Empty Project» и нажимаем кнопку «Go» :

Затем нажимаем кнопку «Next» :

Задаем имя проекту. Я назвал его CodeBlocks и выбрал папку /home/diego/OpenGL_Project/ :

В следующем окне должны быть следующие настройки:

Теперь скопируйте файл glad.c из папки /home/diego/OpenGL_Project/src/ в папку с проектом /home/diego/OpenGL_Project/CodeBlocks/ .

Также создайте файл main.cpp в папке /home/diego/OpenGL_Project/CodeBlocks/ .

Затем эти два файла нужно будет добавить в наш проект. Для этого вернемся обратно в Code::Blocks, нажмем правой кнопкой мыши на название нашего проекта и выберем пункт «Add files…» :

Добавляем в проект файлы glad.c и main.cpp :

Настало время подключить необходимые папки с заголовочными файлами и библиотеки, а также настроить компилятор и линкер. Для этого в Code::Blocks переходим в «Project» > «Build options…» :

Переходим на вкладку «Linker settings» и настраиваем её следующим образом:

Примечание: В правом окошке «Other linker options» необходимо указать следующие параметры:

-lglfw3 -ldl -lX11 -lpthread -lm -lXrandr -lXi

Затем добавим дополнительные пути для поиска заголовочных и библиотечных файлов. Для этого переходим в «Search directories» > «Compiler» :

Затем подобные действия проделываем и для вкладки «Linker» , указывая путь к папке lib :

Источник