docs/macos.rst

   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.
  25
  26 For native hardware, stay tuned for updates here!