summaryrefslogtreecommitdiff
path: root/var/spack/repos/builtin/packages/opengl/package.py
blob: 572fc04845af0e4a4a83f0f5f92de11ff2839a9c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
# Copyright 2013-2020 Lawrence Livermore National Security, LLC and other
# Spack Project Developers. See the top-level COPYRIGHT file for details.
#
# SPDX-License-Identifier: (Apache-2.0 OR MIT)

import sys

from spack import *


class Opengl(Package):
    """Placeholder for external OpenGL libraries from hardware vendors"""

    homepage = "https://www.opengl.org/"

    variant('glvnd',
            default=False,
            description="Expose Graphics APIs through libglvnd")

    variant('glx', default=True, description="Enable GLX API.")
    variant('egl', default=False, description="Enable EGL API.")

    provides('gl', when='~glvnd')
    provides('gl@:4.5', when='@4.5:')
    provides('gl@:4.4', when='@4.4:')
    provides('gl@:4.3', when='@4.3:')
    provides('gl@:4.2', when='@4.2:')
    provides('gl@:4.1', when='@4.1:')
    provides('gl@:3.3', when='@3.3:')
    provides('gl@:3.2', when='@3.2:')
    provides('gl@:3.1', when='@3.1:')
    provides('gl@:3.0', when='@3.0:')
    provides('gl@:2.1', when='@2.1:')
    provides('gl@:2.0', when='@2.0:')
    provides('gl@:1.5', when='@1.5:')
    provides('gl@:1.4', when='@1.4:')
    provides('gl@:1.3', when='@1.3:')
    provides('gl@:1.2', when='@1.2:')
    provides('gl@:1.1', when='@1.1:')
    provides('gl@:1.0', when='@1.0:')

    if sys.platform != 'darwin':
        provides('glx@1.4', when='~glvnd +glx')

    # NOTE: This package should have a dependency on libglvnd, but because it
    # is exclusively provided externally the dependency is never traversed.
    # depends_on('libglvnd', when='+glvnd')  # don't uncomment this

    provides('libglvnd-be-gl', when='+glvnd')
    provides('libglvnd-be-glx', when='+glvnd +glx')
    provides('libglvnd-be-egl', when='+glvnd +egl')

    provides('egl@1.5', when='~glvnd +egl')

    depends_on('libglvnd', when='+glvnd')

    # Override the fetcher method to throw a useful error message;
    # fixes GitHub issue (#7061) in which this package threw a
    # generic, uninformative error during the `fetch` step,
    @property
    def fetcher(self):
        msg = """This package is intended to be a placeholder for
        system-provided OpenGL libraries from hardware vendors.  Please
        download and install OpenGL drivers/libraries for your graphics
        hardware separately, and then set that up as an external package.
        An example of a working packages.yaml:

        packages:
          opengl:
            paths:
              opengl@4.5.0: /opt/opengl
            buildable: False

        In that case, /opt/opengl/ should contain these two folders:

        include/GL/       (opengl headers, including "gl.h")
        lib               (opengl libraries, including "libGL.so")

        On Apple Darwin (e.g., OS X, macOS) systems, this package is
        normally installed as part of the XCode Command Line Tools in
        /usr/X11R6, so a working packages.yaml would be

        packages:
          opengl:
            paths:
              opengl@4.1: /usr/X11R6
            buildable: False

        In that case, /usr/X11R6 should contain

        include/GL/      (OpenGL headers, including "gl.h")
        lib              (OpenGL libraries, including "libGL.dylib")

        On OS X/macOS, note that the version of OpenGL provided
        depends on your hardware. Look at
        https://support.apple.com/en-us/HT202823 to see what version
        of OpenGL your Mac uses."""
        raise InstallError(msg)

    @property
    def libs(self):
        result = LibraryList(())

        # "libs" provided by glvnd; this package sets the environment variables
        # so that glvnd, in turn, loads this package's libraries at run-time.
        if '+glvnd' in self.spec:
            return result

        for dir in ['lib64', 'lib']:
            libs = find_libraries('libGL', join_path(self.prefix, dir),
                                  shared=True, recursive=False)
            if libs:
                result.extend(libs)
                break

        if '+egl' in self.spec:
            for dir in ['lib64', 'lib']:
                libs = find_libraries('libEGL', join_path(self.prefix, dir),
                                      shared=True, recursive=False)
                if libs:
                    result.extend(libs)
                    break
        return result