xref: /aosp_15_r20/external/mesa3d/docs/macos.rst (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1Notes for macOS
2================
3
4Mesa builds on macOS without modifications. However, there are some details to
5be aware of.
6
7-  Mesa has a number of build-time dependencies. Most dependencies, including
8   Meson itself, are available in `homebrew <https://brew.sh>`__, which has a
9   Mesa package for reference. The exception seems to be Mako, a Python module
10   used for templating, which you can install as ``pip3 install mako``.
11-  macOS is picky about its build-time environment. Type ``brew sh`` before
12   building to get the Homebrew dependencies in your path.
13
14Mesa's default builds with the Apple GLX uses Mesa as a front for the
15hardware-accelerated system OpenGL framework, to provide hardware acceleration
16to X11 applications on macOS running via XQuartz.
17
18Mesa's software rasterizers also work on macOS. To build, set the build options
19``-Dosmesa=true -Dglx=xlib``.
20
21Mesa's Gallium drivers can be used on macOS by using the ``-Dgallium-drivers=<drivers>`` build option. Do not use with the previous software rasterizers options, instead add ``swrast`` to the ``<drivers>`` list. Only software renderers and drivers that forward to other APIs can work, any linux hardware drivers will not work. For details on each driver's macOS support see their specific documentation.
22