GLFW3

Ontem à noite eu estava trabalhando até tarde tentando construir os pacotes GLFW 3 para Linux a partir do código-fonte. Esse processo me levou muito tempo, cerca de 3 horas no total, em parte porque não estou familiarizado com o CMake e em parte porque não estava familiarizado com o GLFW.

Espero que este post te livre da dificuldade que tive ontem! Achei que deveria fazer um pequeno artigo e, espero, poupar várias horas de sua vida ...

Graças a "urraka", "b6" e "niklas" no canal IRC #glfw, consegui fazer o glfw versão 3.0.1 funcionar.

Acontece que este não é um processo trivial (certamente não para mim, eu não sou especialista), pois não há muita documentação na web sobre glfw3, particularmente sobre como configurá-lo com o CMake.

Pediram-me para dividir isso em uma seção de perguntas e respostas e, portanto, fiz isso, e as partes das respostas estão agora abaixo.

Você é mantenedor do GLFW ou membro da equipe do GLFW?

Se algum dos mantenedores do GLFW3 vir isso, minha mensagem para eles é: adicione uma seção "Configurando o GLFW3 no Windows, Mac OS X e Linux" ao seu site! É muito fácil escrever programas com GLFW, já que a documentação online é muito boa, uma varredura rápida de todas as classes e módulos disponíveis e você estará pronto para começar. O exemplo de um projeto de teste apresentado aqui também é muito bom. Os dois principais problemas que encontrei foram, primeiro como faço para configurar o GLFW3 no meu sistema e, segundo, como construir um projeto GLFW3? Essas duas coisas talvez não sejam claras o suficiente para um não especialista.

Editar

Dando uma olhada rápida hoje (Data: 2014-01-14), parece que o site do GLFW passou por grandes mudanças desde a última vez que olhei e agora há uma seção sobre compilar o GLFW e construir programas com o GLFW, que eu acho que são novos.

Etapa 1: Instalando o GLFW 3 em seu sistema com CMAKE

Para esta instalação, usei o KUbuntu 13.04, 64bit.

O primeiro passo é fazer o download da versão mais recente (presumindo que as versões futuras funcionem de maneira semelhante) de www.glfw.org , provavelmente usando este link .

A próxima etapa é extrair o arquivo e abrir um terminal. cdno diretório glfw-3.XX e execute cmake -G "Unix Makefiles"você pode precisar de privilégios elevados, e você também pode precisar instalar dependências de compilação primeiro . Para fazer isso, tente sudo apt-get build-dep glfw ou sudo apt-get build-dep glfw3 ou faça manualmente , como fiz usando sudo apt-get install cmake xorg-dev libglu1-mesa-dev... Pode haver outras libs que você precise, como as bibliotecas pthread ... Aparentemente, eu já as tinha. (Consulte as opções -l fornecidas para o estágio do vinculador g ++, abaixo.)

Agora você pode digitar makee então make install, o que provavelmente exigirá que você sudoprimeiro.

Ok, você deve obter alguma saída detalhada nos últimos três estágios do CMake, informando o que foi construído ou onde foi colocado. (Em /usr/include, por exemplo.)

Etapa 2: criar um programa de teste e compilar

O próximo passo é iniciar o vim ("o quê ?! vim ?!" você diz) ou seu IDE / editor de texto preferido ... Eu não usei o vim, usei o Kate, porque estou no KUbuntu 13.04 ... De qualquer forma, baixe ou copie o programa de teste daqui (no rodapé da página) e salve, saia.

Agora compile usando g++ -std=c++11 -c main.cpp- não tenho certeza se c ++ 11 é necessário, mas eu usei nullptr, eu precisava ... Você pode precisar atualizar seu gcc para a versão 4.7 ou a próxima versão 4.8 ... Informações sobre isso aqui .

Então corrija seus erros se você digitou o programa manualmente ou tentou ser "muito inteligente" e algo não funcionou ... Então faça um link usando este monstro! g++ main.o -o main.exec -lGL -lGLU -lglfw3 -lX11 -lXxf86vm -lXrandr -lpthread -lXiEntão você vê, na parte "instalar dependências de compilação", você também pode querer verificar se tem as bibliotecas de desenvolvimento GL, GLU, X11 Xxf86vm (seja lá o que for) Xrandr posix-thread e Xi (seja lá o que for) instaladas também. Talvez atualize seus drivers gráficos também, eu acho que GLFW 3 pode exigir OpenGL versão 3 ou superior? Talvez alguém possa confirmar isso? Você também pode precisar adicionar as opções de vinculador -ldl -lXinerama -lXcursorpara fazê-lo funcionar corretamente se você estiver recebendo referências indefinidas para dlclose(crédito para @ user2255242).

E, sim, eu realmente precisava de tantos -ls!

Passo 3: Você terminou, tenha um bom dia!

Esperançosamente, esta informação estava correta e tudo funcionou para você, e você gostou de escrever o programa de teste GLFW. Também espero que este guia tenha ajudado ou vai ajudar, algumas pessoas no futuro que estavam lutando como eu estava hoje ontem!

A propósito, todas as tags são as coisas que pesquisei no stackoverflow em busca de uma resposta que não existia. (Até agora). Com sorte, eles são o que você procurava se estivesse em uma posição semelhante à minha.

Nota do autor:

Isso pode não ser uma boa ideia. Este método (usando sudo make install) pode ser prejudicial ao seu sistema. (Veja Don't Break Debian)

O ideal é que eu, ou outra pessoa, proponha uma solução que não instale apenas arquivos lib etc nos diretórios padrão do sistema, já que eles devem ser gerenciados por gerenciadores de pacotes como apt, e fazer isso pode causar um conflito e quebrar seu sistema de gerenciamento de pacotes.

Veja a nova "resposta para 2020" para uma solução alternativa.

Eu resolvi dessa forma

Um arquivo pkg-config descreve todos os sinalizadores de tempo de compilação e tempo de link e dependências necessárias para usar uma biblioteca.

pkg-config --static --libs glfw3

me mostra isso

-L/usr/local/lib -lglfw3 -lrt -lXrandr -lXinerama -lXi -lXcursor -lGL -lm -ldl -lXrender -ldrm -lXdamage -lX11-xcb -lxcb-glx -lxcb-dri2 -lxcb-dri3 -lxcb-present -lxcb-sync -lxshmfence -lXxf86vm -lXfixes -lXext -lX11 -lpthread -lxcb -lXau -lXdmcp  

Não sei se todas essas libs são realmente necessárias para compilar, mas para mim funciona ...

Observe que você não precisa de tantos -ls se instalar o glfw com a BUILD_SHARED_LIBSopção. (Você pode habilitar esta opção executando ccmakeprimeiro).

Desta forma, sudo make installirá instalar a biblioteca compartilhada no /usr/local/lib/libglfw.so. Você pode então compilar o arquivo de exemplo com um simples:

g++ main.cpp -L /usr/local/lib/ -lglfw

Então não se esqueça de adicionar / usr / local / lib / ao caminho de busca por bibliotecas compartilhadas antes de executar seu programa. Isso pode ser feito usando:

export LD_LIBRARY_PATH=/usr/local/lib:${LD_LIBRARY_PATH}

E você pode colocar isso no seu ~/.bashrcpara não ter que digitar o tempo todo.

Como a resposta aceita não permite mais edições, vou resumi-la com um único comando de copiar e colar (substitua 3.2.1 pela versão mais recente disponível na primeira linha):

version="3.2.1" && \
wget "https://github.com/glfw/glfw/releases/download/${version}/glfw-${version}.zip" && \
unzip glfw-${version}.zip && \
cd glfw-${version} && \
sudo apt-get install cmake xorg-dev libglu1-mesa-dev && \
sudo cmake -G "Unix Makefiles" && \
sudo make && \
sudo make install

Se você deseja compilar um programa, use os seguintes comandos:

g++ -std=c++11 -c main.cpp && \
g++ main.o -o main.exec -lGL -lGLU -lglfw3 -lX11 -lXxf86vm -lXrandr -lpthread -lXi -ldl -lXinerama -lXcursor

Se você estiver seguindo o tutorial learnopengl.com, pode ser necessário configurar o GLAD também. Nesse caso, clique neste link

http://glad.dav1d.de/#profile=core&specification=gl&api=gl%3D3.3&api=gles1%3Dnone&api=gles2%3Dnone&api=glsc2%3Dnone&language=c&loader=on

e então clique no botão "Gerar" no canto inferior direito do site e baixe o arquivo zip. Extraia-o e compile as fontes com o seguinte comando:

g++ glad/src/glad.c -c -Iglad/include

Agora, os comandos para compilar seu programa ficam assim:

g++ -std=c++11 -c main.cpp -Iglad/include && \
g++ main.o glad.o -o main.exec -lGL -lGLU -lglfw3 -lX11 -lXxf86vm -lXrandr -lpthread -lXi -ldl -lXinerama -lXcursor

Grande guia, obrigado. Com a maioria das instruções aqui, ele quase foi criado para mim, mas ainda havia um erro.

/usr/bin/ld: //usr/local/lib/libglfw3.a(glx_context.c.o): undefined reference to symbol 'dlclose@@GLIBC_2.2.5'
//lib/x86_64-linux-gnu/libdl.so.2: error adding symbols: DSO missing from command line
collect2: error: ld returned 1 exit status

Depois de pesquisar esse erro, tive que adicionar -ldlà linha de comando.

g++ main.cpp -lglfw3 -lX11 -lXrandr -lXinerama -lXi -lXxf86vm -lXcursor -lGL -lpthread -ldl

Em seguida, o aplicativo de amostra "hello GLFW" compilado e vinculado.

Eu sou muito novo no Linux, então não estou completamente certo do que exatamente esta biblioteca extra faz ... além de corrigir meu erro de link. No entanto, vejo essa mudança de linha cmd na postagem acima.

Se alguém está ficando preguiçoso e talvez não saiba como configurar o shell para todas as bibliotecas e -l s, criei um script python (você precisa ter o python3, a maioria dos usuários de linux tem.) Que permite compilar facilmente scripts e executá-los sem me preocupar muito, ele só tem chamadas de sistema regulares, apenas organizadas de forma organizada, eu criei para mim mesmo, mas talvez seja útil: Aqui está

A resposta bem descrita já está aí, mas passei por esta receita MAIS CURTA :

1. Instale Linuxbrew
2. $ brew install glfw
3. cd /home/linuxbrew/.linuxbrew/Cellar/glfw/X.X/include
4. sudo cp -R GLFW /usr/include

Explicação: Conseguimos construir o GLFW pelo CMAKE, que é feito pelo Linuxbrew (porta Linux do amado Homebrew). Em seguida, copie os arquivos de cabeçalho para onde o Linux lê ( /usr/include).

Resposta atualizada de 2020

É 2020 (7 anos depois) e aprendi mais sobre Linux durante esse tempo. Especificamente, pode não ser uma boa ideia executar sudo make installdurante a instalação de bibliotecas, pois elas podem interferir no sistema de gerenciamento de pacotes. (Neste caso, aptcomo estou usando o Debian 10.)

Se isso não estiver correto, corrija-me nos comentários.

Solução alternativa proposta

Essas informações são retiradas dos documentos do GLFW, no entanto, expandi / simplifiquei as informações que são relevantes para os usuários Linux.

• Vá para o diretório inicial e clone o repositório glfw do github

cd ~
git clone https://github.com/glfw/glfw.git
cd glfw

• Você pode, neste ponto, criar um diretório de construção e seguir as instruções aqui ( instruções de construção do glfw ), no entanto, optei por não fazer isso. O comando a seguir ainda parece funcionar em 2020, entretanto, não é explicitamente declarado nas instruções online do glfw.

cmake -G "Unix Makefiles"

• Pode ser necessário executar sudo apt-get build-dep glfw3antes (?). Executei este comando e de sudo apt install xorg-devacordo com as instruções.

• Finalmente corra make

• Agora, no diretório do seu projeto, faça o seguinte. (Vá para o seu projeto que usa as libs glfw)

• Crie um CMakeLists.txt, o meu é assim

CMAKE_MINIMUM_REQUIRED(VERSION 3.7)
PROJECT(project)

SET(CMAKE_CXX_STANDARD 14)
SET(CMAKE_BUILD_TYPE DEBUG)

set(GLFW_BUILD_DOCS OFF CACHE BOOL "" FORCE)
set(GLFW_BUILD_TESTS OFF CACHE BOOL "" FORCE)
set(GLFW_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)

add_subdirectory(/home/<user>/glfw /home/<user>/glfw/src)


FIND_PACKAGE(OpenGL REQUIRED)

SET(SOURCE_FILES main.cpp)

ADD_EXECUTABLE(project ${SOURCE_FILES})
TARGET_LINK_LIBRARIES(project glfw)
TARGET_LINK_LIBRARIES(project OpenGL::GL)

• Se você não gosta do CMake, peço desculpas, mas na minha opinião é a maneira mais fácil de fazer seu projeto funcionar rapidamente. Eu recomendaria aprender a usá-lo, pelo menos em um nível básico. Infelizmente, não conheço nenhum bom tutorial CMake

• Então faça cmake .e make, seu projeto deve ser construído e vinculado à biblioteca compartilhada glfw3

• Existe alguma maneira de criar uma biblioteca vinculada dinâmica. Acredito ter usado o método estático aqui. Por favor, comente / adicione uma seção nesta resposta abaixo se você souber mais do que eu

• Isso deve funcionar em outros sistemas, se não, avise-me e ajudarei se for capaz de