X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Finstall.html;h=b6a75baeeb9341664213bf622c8d3609fb2e47ec;hb=64b12520a2848913fa78c12f48eaca39f42584c9;hp=53164973205f9f5fb43972330198db23f72dd38a;hpb=cc4188895be5525fa15c8b64b8338f901eda82fc;p=mesa.git diff --git a/docs/install.html b/docs/install.html index 53164973205..b6a75baeeb9 100644 --- a/docs/install.html +++ b/docs/install.html @@ -7,6 +7,13 @@ +
+

The Mesa 3D Graphics Library

+
+ + +
+

Compiling and Installing

    @@ -15,9 +22,10 @@
  1. General prerequisites
  2. For DRI and hardware acceleration +
  3. Building with meson
  4. Building with autoconf (Linux/Unix/X11)
  5. Building with SCons (Windows/Linux) -
  6. Building for other systems +
  7. Building with AOSP (Android)
  8. Library Information
  9. Building OpenGL programs with pkg-config
@@ -26,55 +34,112 @@

1. Prerequisites for building

1.1 General

+ +

+Build system. +

+ -

1.2 For DRI and hardware acceleration

+

+The following compilers are known to work, if you know of others or you're +willing to maintain support for other compiler get in touch. +

+ + +

-The following are required for DRI-based hardware acceleration with Mesa: +Third party/extra tools. +
+Note: These should not be required, when building from a release tarball. If +you think you've spotted a bug let developers know by filing a +bug report.

+ +

Note: Some versions can be buggy (eg. flex 2.6.2) so do try others if things fail.

+ + +

1.2 Requirements

+ +

+The requirements depends on the features selected at configure stage. +Check/install the respective -devel package as prompted by the configure error +message. +

+

-If you're using a fedora distro the following command should install all -the needed dependencies: +Here are some common ways to retrieve most/all of the dependencies based on +the packaging tool used by your distro.

+ 
-  sudo yum install flex bison imake libtool xorg-x11-proto-devel libdrm-devel \
-  gcc-c++ xorg-x11-server-devel libXi-devel libXmu-devel libXdamage-devel git \
-  expat-devel llvm-devel
+  zypper source-install --build-deps-only Mesa # openSUSE/SLED/SLES
+  yum-builddep mesa # yum Fedora, OpenSuse(?)
+  dnf builddep mesa # dnf Fedora
+  apt-get build-dep mesa # Debian and derivatives
+  ... # others
+

2. Building with meson

+ +

+Meson is the latest build system in mesa, it is currently able to build for +*nix systems like Linux and BSD, and will be able to build for windows as well. +

+

+The general approach is: +

+
+  meson builddir/
+  ninja -C builddir/
+  sudo ninja -C builddir/ install
+
+

+Please read the detailed meson instructions +for more information +

-

2. Building with autoconf (Linux/Unix/X11)

+

3. Building with autoconf (Linux/Unix/X11)

-The primary method to build Mesa on Unix systems is with autoconf. +Although meson is recommended, another supported way to build on *nix systems +is with autoconf.

@@ -92,7 +157,7 @@ for more details. -

3. Building with SCons (Windows/Linux)

+

4. Building with SCons (Windows/Linux)

To build Mesa with SCons on Linux or Windows do @@ -111,36 +176,43 @@ by -debug for debug builds. To build Mesa with SCons for Windows on Linux using the MinGW crosscompiler toolchain do 

-    scons platform=windows toolchain=crossmingw machine=x86 mesagdi libgl-gdi
+    scons platform=windows toolchain=crossmingw machine=x86 libgl-gdi

This will create:

Put them all in the same directory to test them. + +Additional information is available in README.WIN32. +

-

4. Building for other systems

+

5. Building with AOSP (Android)

-Documentation for other environments (some may be very out of date): +Currently one can build Mesa for Android as part of the AOSP project, yet +your experience might vary.

- +

+In order to achieve that one should update their local manifest to point to the +upstream repo, set the appropriate BOARD_GPU_DRIVERS and build the +libGLES_mesa library. +

+

+FINISHME: Improve on the instructions add references to Rob H repos/Jenkins, +Android-x86 and/or other resources. +

-

5. Library Information

+

6. Library Information

When compilation has finished, look in the top-level lib/ @@ -151,9 +223,6 @@ You'll see a set of library files similar to this: lrwxrwxrwx 1 brian users 10 Mar 26 07:53 libGL.so -> libGL.so.1* lrwxrwxrwx 1 brian users 19 Mar 26 07:53 libGL.so.1 -> libGL.so.1.5.060100* -rwxr-xr-x 1 brian users 3375861 Mar 26 07:53 libGL.so.1.5.060100* -lrwxrwxrwx 1 brian users 11 Mar 26 07:53 libGLU.so -> libGLU.so.1* -lrwxrwxrwx 1 brian users 20 Mar 26 07:53 libGLU.so.1 -> libGLU.so.1.3.060100* --rwxr-xr-x 1 brian users 549269 Mar 26 07:53 libGLU.so.1.3.060100* lrwxrwxrwx 1 brian users 14 Mar 26 07:53 libOSMesa.so -> libOSMesa.so.6* lrwxrwxrwx 1 brian users 23 Mar 26 07:53 libOSMesa.so.6 -> libOSMesa.so.6.1.060100* -rwxr-xr-x 1 brian users 23871 Mar 26 07:53 libOSMesa.so.6.1.060100* @@ -162,8 +231,6 @@ lrwxrwxrwx 1 brian users 23 Mar 26 07:53 libOSMesa.so.6 -> libOSM

libGL is the main OpenGL library (i.e. Mesa).
-libGLU is the OpenGL Utility library. -
libOSMesa is the OSMesa (Off-Screen) interface library.

@@ -174,7 +241,6 @@ If you built the DRI hardware drivers, you'll also see the DRI drivers: -rwxr-xr-x 1 brian users 16895413 Jul 21 12:11 i915_dri.so -rwxr-xr-x 1 brian users 16895413 Jul 21 12:11 i965_dri.so -rwxr-xr-x 1 brian users 11849858 Jul 21 12:12 r200_dri.so --rwxr-xr-x 1 brian users 16050488 Jul 21 12:11 r300_dri.so -rwxr-xr-x 1 brian users 11757388 Jul 21 12:12 radeon_dri.so @@ -184,7 +250,7 @@ versions of libGL and device drivers.

-

6. Building OpenGL programs with pkg-config

+

7. Building OpenGL programs with pkg-config

Running make install will install package configuration files @@ -205,6 +271,6 @@ For example, compiling and linking a GLUT application can be done with:
- +