| 1 | Notes for macOS
|
|---|
| 2 | ================
|
|---|
| 3 |
|
|---|
| 4 | .. image:: https://github.com/mesa3d/mesa/actions/workflows/macos.yml/badge.svg
|
|---|
| 5 | :target: https://github.com/mesa3d/mesa/actions/workflows/macos.yml
|
|---|
| 6 | :alt: macOS CI
|
|---|
| 7 |
|
|---|
| 8 | Mesa builds on macOS without modifications. However, there are some details to
|
|---|
| 9 | be aware of.
|
|---|
| 10 |
|
|---|
| 11 | - Mesa has a number of build-time dependencies. Most dependencies, including
|
|---|
| 12 | Meson itself, are available in `homebrew <https://brew.sh>`__, which has a
|
|---|
| 13 | Mesa package for reference. The exception seems to be Mako, a Python module
|
|---|
| 14 | used for templating, which you can install as ``pip3 install mako``.
|
|---|
| 15 | - macOS is picky about its build-time environment. Type ``brew sh`` before
|
|---|
| 16 | building to get the Homebrew dependencies in your path.
|
|---|
| 17 |
|
|---|
| 18 | Mesa's default builds with the Apple GLX uses Mesa as a front for the
|
|---|
| 19 | hardware-accelerated system OpenGL framework, to provide hardware acceleration
|
|---|
| 20 | to X11 applications on macOS running via XQuartz.
|
|---|
| 21 |
|
|---|
| 22 | Mesa's software rasterizers also work on macOS. To build, set the build options
|
|---|
| 23 | ``-Dosmesa=true -Dglx=xlib`` and select an appropriate Gallium software
|
|---|
| 24 | rasterizer.
|
|---|
