aadf7fd0721b4ee4aeec6bb31c21ad5a534d5184
[mesa.git] / meson_options.txt
1 # Copyright © 2017-2018 Intel Corporation
2
3 # Permission is hereby granted, free of charge, to any person obtaining a copy
4 # of this software and associated documentation files (the "Software"), to deal
5 # in the Software without restriction, including without limitation the rights
6 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7 # copies of the Software, and to permit persons to whom the Software is
8 # furnished to do so, subject to the following conditions:
9
10 # The above copyright notice and this permission notice shall be included in
11 # all copies or substantial portions of the Software.
12
13 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
19 # SOFTWARE.
20
21 option(
22 'platforms',
23 type : 'array',
24 value : ['auto'],
25 choices : [
26 '', 'auto', 'x11', 'wayland', 'drm', 'surfaceless', 'haiku', 'android',
27 ],
28 description : 'window systems to support. If this is set to `auto`, all platforms applicable will be enabled.'
29 )
30 option(
31 'dri3',
32 type : 'combo',
33 value : 'auto',
34 choices : ['auto', 'true', 'false'],
35 description : 'enable support for dri3'
36 )
37 option(
38 'dri-drivers',
39 type : 'array',
40 value : ['auto'],
41 choices : ['', 'auto', 'i915', 'i965', 'r100', 'r200', 'nouveau', 'swrast'],
42 description : 'List of dri drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
43 )
44 option(
45 'dri-drivers-path',
46 type : 'string',
47 value : '',
48 description : 'Location to install dri drivers. Default: $libdir/dri.'
49 )
50 option(
51 'dri-search-path',
52 type : 'string',
53 value : '',
54 description : 'Locations to search for dri drivers, passed as colon separated list. Default: dri-drivers-path.'
55 )
56 option(
57 'gallium-drivers',
58 type : 'array',
59 value : ['auto'],
60 choices : [
61 '', 'auto', 'kmsro', 'radeonsi', 'r300', 'r600', 'nouveau', 'freedreno',
62 'swrast', 'v3d', 'vc4', 'etnaviv', 'tegra', 'i915', 'svga', 'virgl',
63 'swr', 'panfrost', 'iris', 'lima'
64 ],
65 description : 'List of gallium drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
66 )
67 option(
68 'gallium-extra-hud',
69 type : 'boolean',
70 value : false,
71 description : 'Enable HUD block/NIC I/O HUD status support',
72 )
73 option(
74 'gallium-vdpau',
75 type : 'combo',
76 value : 'auto',
77 choices : ['auto', 'true', 'false'],
78 description : 'enable gallium vdpau state tracker.',
79 )
80 option(
81 'vdpau-libs-path',
82 type : 'string',
83 value : '',
84 description : 'path to put vdpau libraries. defaults to $libdir/vdpau.'
85 )
86 option(
87 'gallium-xvmc',
88 type : 'combo',
89 value : 'auto',
90 choices : ['auto', 'true', 'false'],
91 description : 'enable gallium xvmc state tracker.',
92 )
93 option(
94 'xvmc-libs-path',
95 type : 'string',
96 value : '',
97 description : 'path to put xvmc libraries. defaults to $libdir.'
98 )
99 option(
100 'gallium-omx',
101 type : 'combo',
102 value : 'auto',
103 choices : ['auto', 'disabled', 'bellagio', 'tizonia'],
104 description : 'enable gallium omx state tracker.',
105 )
106 option(
107 'omx-libs-path',
108 type : 'string',
109 value : '',
110 description : 'path to put omx libraries. defaults to omx-bellagio pkg-config pluginsdir.'
111 )
112 option(
113 'gallium-va',
114 type : 'combo',
115 value : 'auto',
116 choices : ['auto', 'true', 'false'],
117 description : 'enable gallium va state tracker.',
118 )
119 option(
120 'va-libs-path',
121 type : 'string',
122 value : '',
123 description : 'path to put va libraries. defaults to $libdir/dri.'
124 )
125 option(
126 'gallium-xa',
127 type : 'combo',
128 value : 'auto',
129 choices : ['auto', 'true', 'false'],
130 description : 'enable gallium xa state tracker.',
131 )
132 option(
133 'gallium-nine',
134 type : 'boolean',
135 value : false,
136 description : 'build gallium "nine" Direct3D 9.x state tracker.',
137 )
138 option(
139 'gallium-opencl',
140 type : 'combo',
141 choices : ['icd', 'standalone', 'disabled'],
142 value : 'disabled',
143 description : 'build gallium "clover" OpenCL state tracker.',
144 )
145 option(
146 'd3d-drivers-path',
147 type : 'string',
148 value : '',
149 description : 'Location of D3D drivers. Default: $libdir/d3d',
150 )
151 option(
152 'vulkan-drivers',
153 type : 'array',
154 value : ['auto'],
155 choices : ['', 'auto', 'amd', 'freedreno', 'intel'],
156 description : 'List of vulkan drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
157 )
158 option(
159 'shader-cache',
160 type : 'combo',
161 value : 'auto',
162 choices : ['auto', 'true', 'false'],
163 description : 'Build with on-disk shader cache support'
164 )
165 option(
166 'vulkan-icd-dir',
167 type : 'string',
168 value : '',
169 description : 'Location relative to prefix to put vulkan icds on install. Default: $datadir/vulkan/icd.d'
170 )
171 option(
172 'vulkan-overlay-layer',
173 type : 'boolean',
174 value : false,
175 description : 'Whether to build the vulkan overlay layer'
176 )
177 option(
178 'shared-glapi',
179 type : 'combo',
180 value : 'auto',
181 choices : ['auto', 'true', 'false'],
182 description : 'Whether to build a shared or static glapi. Defaults to false on Windows, true elsewhere'
183 )
184 option(
185 'gles1',
186 type : 'combo',
187 value : 'auto',
188 choices : ['auto', 'true', 'false'],
189 description : 'Build support for OpenGL ES 1.x'
190 )
191 option(
192 'gles2',
193 type : 'combo',
194 value : 'auto',
195 choices : ['auto', 'true', 'false'],
196 description : 'Build support for OpenGL ES 2.x and 3.x'
197 )
198 option(
199 'opengl',
200 type : 'boolean',
201 value : true,
202 description : 'Build support for OpenGL (all versions)'
203 )
204 option(
205 'gbm',
206 type : 'combo',
207 value : 'auto',
208 choices : ['auto', 'true', 'false'],
209 description : 'Build support for gbm platform'
210 )
211 option(
212 'glx',
213 type : 'combo',
214 value : 'auto',
215 choices : ['auto', 'disabled', 'dri', 'xlib', 'gallium-xlib'],
216 description : 'Build support for GLX platform'
217 )
218 option(
219 'egl',
220 type : 'combo',
221 value : 'auto',
222 choices : ['auto', 'true', 'false'],
223 description : 'Build support for EGL platform'
224 )
225 option(
226 'glvnd',
227 type : 'boolean',
228 value : false,
229 description : 'Enable GLVND support.'
230 )
231 option(
232 'glx-read-only-text',
233 type : 'boolean',
234 value : false,
235 description : 'Disable writable .text section on x86 (decreases performance)'
236 )
237 option(
238 'llvm',
239 type : 'combo',
240 value : 'auto',
241 choices : ['auto', 'true', 'false'],
242 description : 'Build with LLVM support.'
243 )
244 option(
245 'shared-llvm',
246 type : 'boolean',
247 value : true,
248 description : 'Whether to link llvm shared or statically.'
249 )
250 option(
251 'valgrind',
252 type : 'combo',
253 value : 'auto',
254 choices : ['auto', 'true', 'false'],
255 description : 'Build with valgrind support'
256 )
257 option(
258 'libunwind',
259 type : 'combo',
260 value : 'auto',
261 choices : ['auto', 'true', 'false'],
262 description : 'Use libunwind for stack-traces'
263 )
264 option(
265 'lmsensors',
266 type : 'combo',
267 value : 'auto',
268 choices : ['auto', 'true', 'false'],
269 description : 'Enable HUD lmsensors support.'
270 )
271 option(
272 'build-tests',
273 type : 'boolean',
274 value : false,
275 description : 'Build unit tests. Currently this will build *all* unit tests, which may build more than expected.'
276 )
277 option(
278 'install-intel-gpu-tests',
279 type : 'boolean',
280 value : false,
281 description : 'Build and install Intel unit tests which require the GPU. This option is for developers and the Intel CI system only.'
282 )
283 option(
284 'selinux',
285 type : 'boolean',
286 value : false,
287 description : 'Build an SELinux-aware Mesa'
288 )
289 option(
290 'osmesa',
291 type : 'combo',
292 value : 'none',
293 choices : ['none', 'classic', 'gallium'],
294 description : 'Build OSmesa.'
295 )
296 option(
297 'osmesa-bits',
298 type : 'combo',
299 value : '8',
300 choices : ['8', '16', '32'],
301 description : 'Number of channel bits for OSMesa.'
302 )
303 option(
304 'swr-arches',
305 type : 'array',
306 value : ['avx', 'avx2'],
307 choices : ['avx', 'avx2', 'knl', 'skx'],
308 description : 'Architectures to build SWR support for.',
309 )
310 option(
311 'tools',
312 type : 'array',
313 value : [],
314 choices : ['drm-shim', 'etnaviv', 'freedreno', 'glsl', 'intel', 'intel-ui', 'nir', 'nouveau', 'xvmc', 'lima', 'all'],
315 description : 'List of tools to build. (Note: `intel-ui` selects `intel`)',
316 )
317 option(
318 'power8',
319 type : 'combo',
320 value : 'auto',
321 choices : ['auto', 'true', 'false'],
322 description : 'Enable power8 optimizations.',
323 )
324 option(
325 'xlib-lease',
326 type : 'combo',
327 value : 'auto',
328 choices : ['auto', 'true', 'false'],
329 description : 'Enable VK_EXT_acquire_xlib_display.'
330 )
331 option(
332 'glx-direct',
333 type : 'boolean',
334 value : true,
335 description : 'Enable direct rendering in GLX and EGL for DRI',
336 )
337 option(
338 'I-love-half-baked-turnips',
339 type : 'boolean',
340 value : false,
341 description : 'Allow work-in-progress freedreno vulkan driver to be enabled',
342 )
343 option('egl-lib-suffix',
344 type : 'string',
345 value : '',
346 description : 'Suffix to append to EGL library name. Default: none.'
347 )
348 option(
349 'gles-lib-suffix',
350 type : 'string',
351 value : '',
352 description : 'Suffix to append to GLES library names. Default: none.'
353 )
354 option(
355 'platform-sdk-version',
356 type : 'integer',
357 min : 25,
358 max : 28,
359 value : 25,
360 description : 'Android Platform SDK version. Default: Nougat version.'
361 )