Skip to content

update workflows to use EGL over osMesa #75

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
m-reuter merged 1 commit into from
Mar 9, 2026
Merged

update workflows to use EGL over osMesa #75

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions .github/workflows/build.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,9 +28,10 @@ jobs:
uses: actions/setup-python@v6
with:
python-version: ${{ matrix.python-version }}
- name: Install system OSMesa/OpenGL libraries (Ubuntu)
- name: Install system OpenGL/EGL libraries (Ubuntu)
if: matrix.os == 'ubuntu'
run: sudo apt-get install -y --no-install-recommends libosmesa6 libgl1
# libegl1: EGL headless rendering (no display needed); libgl1: pulled in by PyOpenGL
run: sudo apt-get install -y --no-install-recommends libegl1 libgl1
- name: Install dependencies
run: |
python -m pip install --progress-bar off --upgrade pip setuptools wheel
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/doc.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ jobs:
- name: Install system dependencies
run: |
sudo apt-get update
sudo apt-get -y install libgl1 libosmesa6 libxcb-cursor0 pandoc
sudo apt-get -y install libegl1 libgl1 libxcb-cursor0 pandoc
- name: Install package
run: |
python -m pip install --progress-bar off --upgrade pip setuptools wheel
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/publish.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ jobs:
with:
python-version: '3.13'
- name: Install system dependencies
run: sudo apt-get install -y --no-install-recommends libosmesa6 libgl1
run: sudo apt-get install -y --no-install-recommends libegl1 libgl1
- name: Install python dependencies
run: |
python -m pip install --progress-bar off --upgrade pip setuptools wheel
Expand Down
12 changes: 8 additions & 4 deletions .github/workflows/pytest.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,12 @@ jobs:
uses: actions/setup-python@v6
with:
python-version: ${{ matrix.python-version }}
- name: Install system OSMesa library (Ubuntu)
- name: Install system OpenGL/EGL libraries (Ubuntu)
if: matrix.os == 'ubuntu'
run: sudo apt-get install -y --no-install-recommends libosmesa6 libgl1
# libegl1: EGL headless rendering (preferred, no display needed)
# libgl1: OpenGL implementation pulled in by PyOpenGL
# libfontconfig1: font discovery used by the caption renderer
run: sudo apt-get install -y --no-install-recommends libegl1 libgl1 libfontconfig1
- name: Install Mesa software OpenGL (Windows)
if: matrix.os == 'windows'
# mesa-dist-win (MSVC build) provides software OpenGL 3.3 Core via
Expand All @@ -50,8 +53,9 @@ jobs:
7z e $archive -o"C:\mesa" "x64\*" -y
echo "C:\mesa" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
# Rendering strategy per platform:
# Ubuntu: no display → GLFW fails → EGL skipped (no /dev/dri/renderD*)
# → OSMesa headless (libosmesa6) used as final fallback
# Ubuntu: no display → GLFW fails → EGL
# CI runners have no GPU device so EGL uses CPU software
# rendering (llvmpipe) via EGL_MESA_device_software
# macOS: rendering tests SKIPPED — NSGL requires a real display
# connection even for invisible windows; CI runners have none
# Windows: Mesa opengl32.dll (MSVC build) on PATH → GLFW invisible
Expand Down