Dieses Readme soll helfen, die Umgebung für die Computergrafik Übungen einzurichten. **Merke:** Ich nutze [Meson](https://mesonbuild.com/) statt Make, somit wird `pkgconf` nicht benötigt, und Cross-Platform Entwicklung wird etwas erleichtert. Unter Linux ist das Bearbeiten der Aufgaben am einfachsten. Dieses Readme beschreibt aber auch Möglichkeiten, die Aufgaben unter Windows zu bearbeiten, sowie eine Anleitung für macOS. Für Windows gibt es zwei Möglichkeiten: - [WSL (Windows Subsystem for Linux)](#wsl) - Nutzt die Linux Umgebung unter Windows - [Nativ Windows mit MSYS2 bzw MINGW64](#windows-native) - Nutzt Windows spezifische Tools Der Entwicklungsprozess ist mit beiden Methoden relativ gleich. Nur im Aufsetzen der Umgebung gibt es Unterschiede. Die Performance wird mit dem nativen Windows Ansatz besser sein, jedoch sind auch schwächere Geräte meist problemlos in der Lage, die Aufgaben unter WSL zu bearbeiten. # Ubuntu / WSL Package Datenbank synchronisieren ```bash sudo apt update ``` Grundlegende Tools wie gcc und make installieren ``` sudo apt install build-essential ``` Meson und Ninja (wird für Meson benötigt) installieren ``` sudo apt install meson ninja-build ``` GLFW installieren ``` sudo apt install libglfw3 libglfw3-dev ``` GLEW installieren ``` sudo apt install libglew-dev ``` # WSL **Für grafische Anwendungen wird WSL 2 benötigt.** Ist WSL 2 bereits installiert, können benötigte Pakete installiert werden wie oben beschrieben. ## WSL Installieren [Installieren von Linux unter Windows mit WSL - Microsoft Learn](https://learn.microsoft.com/de-de/windows/wsl/install) ## WSL zu WSL 2 upgraden ### Virtualisierung Aktivieren Virtualisierung kann über die Powershell oder im BIOS aktiviert werden und ist notwendig für WSL 2 ``` dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart ``` Anschließend Windows neustarten ### WSL Updaten ``` # aktuelle Version anzeigen wsl -l -v # Version ändern wsl --set-version 2 # Updaten wsl --update ``` ## Hilfreiche Links (Danke an Rebecca Trautner) - [Using c++ and WSL in VS Code](https://code.visualstudio.com/docs/cpp/config-wsl) - [Diagnosing "cannot open display" type issues in WSLg](https://github.com/microsoft/wslg/wiki/Diagnosing-%22cannot-open-display%22-type-issues-with-WSLg) # Windows Native ## MSYS2 Installation MSYS2 dient als Entwicklungsumgebung und stellt Tools wie Make und gcc zur Verfügung [Download und Installationsanleitung](https://www.msys2.org/) Alle folgenden Schritte sollten im MSYS2 MINGW64 Terminal ausgeführt werden. ## Libraries installieren Package Datenbank synchronisieren ``` pacman -Syu ``` Libraries installieren ``` pacman -S mingw-w64-x86_64-glfw mingw-w64-x86_64-glew ``` ## Meson installieren (Empfehlung) ``` pacman -S mingw-w64-x86_64-meson ``` ## gcc installieren ``` pacman -S mingw-w64-x86_64-gcc ``` ## git installieren (Empfehlung) ``` pacman -S git ``` ## mingw64 Pfad zur "Path" Umgebungsvariable hinzufügen Dieser Schritt ist nur notwendig, wenn das Programm auch ohne MSYS2 gestartet werden soll (also Doppelclick auf die `.exe` Datei) ``` C:\msys64\mingw64\bin ``` - Windows Suche -> "Umgebungsvariablen" eintippen - -> "Umgebungsvariablen..." - -> "Path" -> "Bearbeiten" -> "Neu" -> Pfad einfügen - Neue Umgebungsvariablen werden erst nach Programm Neustart übernommen Der Code dieses Projekts ist außerdem darauf ausgelegt, dass die Datei aus dem Wurzelverzeichnis des Repositories ausgeführt wird. Die Shader Pfade z.B. sind relativ zum Wurzelverzeichnis. Die Datei muss also aus dem `/build` Verzeichnis in das Wurzelverzeichnis des Repositories verschoben werden. Alternativ, um die `.exe` Datei von einem anderen Verzeichnis auszuführen, kann man Mit Rechtsclick -> "Verknüpfung erstellen" eine Verknüpfung erstellen und anschließend in den Eigenschaften das Start-Verzeichnis ändern: `C:/Pfad/Zum/Projekt/build` -> `C:/Pfad/Zum/Projekt` # Kompilieren und Ausführen Nach den oben beschriebenen Schritten sollte das Projekt kompiliert und ausgeführt werden können. ```bash meson setup build meson compile -C build ./build/cg1 # linux ./build/cg1.exe # windows ``` # MacOS **Merke:** Da ich selber kein MacOS kann ich diese Schritte leider nicht replizieren. Diese Anleitung wurde geschrieben von Paul-Christoph Otte (Danke!), welcher 2024 dieses Modul belegt hat. Entsprechend wird hier *nicht* Meson genutzt. --- Eine kleine Anleitung für CG1 mit VSCode und einem MacBook M1: 1. Homebrew installieren 2. Mit Homebrew glew, glfw, pkgconf installieren (brew install glew / brew install glfw / brew install pkgconf) 3. unter /usr/local/ einen neuen Ordner "include" erstellen 4. Dort Ordner reinkopieren (habe welche geschickt bekommen, dürfte aber auch gehen, wenn ihr die Ordner von homebrew reinkopiert. Die liegen unter /opt/homebrew/Cellar/) 5. In VSCode den IntelliSenseMode auf gcc ändern (standardmäßig war bei mir clang, bei M1: macos-gcc-arm64) 6. Include-path in vscode hinzufügen: /usr/local/include (In c_cpp_properties.json date) 7. in main.c includes anpassen: ```c #include #include #include #include #include ``` 8. im Makefile: ```makefile GLEW_LIBS=$(shell pkgconf glew --libs) GLFW_LIBS=$(shell pkgconf glfw3 --libs) cg1: main.c gcc -o cg1 -std=c17 main.c -w $(GLEW_LIBS) $(GLFW_LIBS) -framework OpenGL ``` --- **Weitere Info von Dennis zu macOS:** unter macOS gibt es noch ein interessantes Problem: Die OpenGL-Version unterstützt offenbar nicht die Ausgabevariable `gl_FragColor` im Fragment-Shader. Stattdessen müsst ihr selbst eine Ausgabevariable deklarieren: ```glsl layout (location = 0) out fragColor; ``` Diese kann dann statt `gl_FragColor` verwendet werden. --- Bei weiteren Fragen, meldet euch gerne bei mir oder Dennis per E-Mail oder sprecht uns in einer der Übungen an. |