docs: update calendar and link releases notes for 20.1.6
[mesa.git] / meson_options.txt
1 # Copyright © 2017-2019 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 'windows',
28 ],
29 description : 'window systems to support. If this is set to `auto`, all platforms applicable will be enabled.'
30 )
31 option(
32 'android-stub',
33 type : 'boolean',
34 value : false,
35 description : 'Build against android-stub',
36 )
37
38 option(
39 'dri3',
40 type : 'combo',
41 value : 'auto',
42 choices : ['auto', 'true', 'false', 'disabled', 'enabled'],
43 description : 'enable support for dri3'
44 )
45 option(
46 'dri-drivers',
47 type : 'array',
48 value : ['auto'],
49 choices : ['auto', 'i915', 'i965', 'r100', 'r200', 'nouveau', 'swrast'],
50 description : 'List of dri drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
51 )
52 option(
53 'dri-drivers-path',
54 type : 'string',
55 value : '',
56 description : 'Location to install dri drivers. Default: $libdir/dri.'
57 )
58 option(
59 'dri-search-path',
60 type : 'string',
61 value : '',
62 description : 'Locations to search for dri drivers, passed as colon separated list. Default: dri-drivers-path.'
63 )
64 option(
65 'gallium-drivers',
66 type : 'array',
67 value : ['auto'],
68 choices : [
69 'auto', 'kmsro', 'radeonsi', 'r300', 'r600', 'nouveau', 'freedreno',
70 'swrast', 'v3d', 'vc4', 'etnaviv', 'tegra', 'i915', 'svga', 'virgl',
71 'swr', 'panfrost', 'iris', 'lima', 'zink'
72 ],
73 description : 'List of gallium drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
74 )
75 option(
76 'gallium-extra-hud',
77 type : 'boolean',
78 value : false,
79 description : 'Enable HUD block/NIC I/O HUD status support',
80 )
81 option(
82 'gallium-vdpau',
83 type : 'combo',
84 value : 'auto',
85 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
86 description : 'enable gallium vdpau frontend.',
87 )
88 option(
89 'vdpau-libs-path',
90 type : 'string',
91 value : '',
92 description : 'path to put vdpau libraries. defaults to $libdir/vdpau.'
93 )
94 option(
95 'gallium-xvmc',
96 type : 'combo',
97 value : 'auto',
98 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
99 description : 'enable gallium xvmc frontend.',
100 )
101 option(
102 'xvmc-libs-path',
103 type : 'string',
104 value : '',
105 description : 'path to put xvmc libraries. defaults to $libdir.'
106 )
107 option(
108 'gallium-omx',
109 type : 'combo',
110 value : 'auto',
111 choices : ['auto', 'disabled', 'bellagio', 'tizonia'],
112 description : 'enable gallium omx frontend.',
113 )
114 option(
115 'omx-libs-path',
116 type : 'string',
117 value : '',
118 description : 'path to put omx libraries. defaults to omx-bellagio pkg-config pluginsdir.'
119 )
120 option(
121 'gallium-va',
122 type : 'combo',
123 value : 'auto',
124 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
125 description : 'enable gallium va frontend.',
126 )
127 option(
128 'va-libs-path',
129 type : 'string',
130 value : '',
131 description : 'path to put va libraries. defaults to $libdir/dri.'
132 )
133 option(
134 'gallium-xa',
135 type : 'combo',
136 value : 'auto',
137 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
138 description : 'enable gallium xa frontend.',
139 )
140 option(
141 'gallium-nine',
142 type : 'boolean',
143 value : false,
144 description : 'build gallium "nine" Direct3D 9.x frontend.',
145 )
146 option(
147 'gallium-opencl',
148 type : 'combo',
149 choices : ['icd', 'standalone', 'disabled'],
150 value : 'disabled',
151 description : 'build gallium "clover" OpenCL frontend.',
152 )
153 option(
154 'opencl-spirv',
155 type : 'boolean',
156 value : false,
157 description : 'build gallium "clover" OpenCL frontend with SPIR-V binary support.',
158 )
159 option(
160 'd3d-drivers-path',
161 type : 'string',
162 value : '',
163 description : 'Location of D3D drivers. Default: $libdir/d3d',
164 )
165 option(
166 'vulkan-drivers',
167 type : 'array',
168 value : ['auto'],
169 choices : ['auto', 'amd', 'freedreno', 'intel', 'swrast'],
170 description : 'List of vulkan drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
171 )
172 option(
173 'shader-cache',
174 type : 'combo',
175 value : 'auto',
176 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
177 description : 'Build with on-disk shader cache support'
178 )
179 option(
180 'vulkan-icd-dir',
181 type : 'string',
182 value : '',
183 description : 'Location relative to prefix to put vulkan icds on install. Default: $datadir/vulkan/icd.d'
184 )
185 option(
186 'vulkan-overlay-layer',
187 type : 'boolean',
188 value : false,
189 description : 'Whether to build the vulkan overlay layer'
190 )
191 option(
192 'vulkan-device-select-layer',
193 type : 'boolean',
194 value : false,
195 description : 'Whether to build the vulkan device select layer'
196 )
197 option(
198 'shared-glapi',
199 type : 'combo',
200 value : 'auto',
201 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
202 description : 'Whether to build a shared or static glapi. Defaults to false on Windows, true elsewhere'
203 )
204 option(
205 'gles1',
206 type : 'combo',
207 value : 'auto',
208 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
209 description : 'Build support for OpenGL ES 1.x'
210 )
211 option(
212 'gles2',
213 type : 'combo',
214 value : 'auto',
215 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
216 description : 'Build support for OpenGL ES 2.x and 3.x'
217 )
218 option(
219 'opengl',
220 type : 'boolean',
221 value : true,
222 description : 'Build support for OpenGL (all versions)'
223 )
224 option(
225 'gbm',
226 type : 'combo',
227 value : 'auto',
228 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
229 description : 'Build support for gbm platform'
230 )
231 option(
232 'glx',
233 type : 'combo',
234 value : 'auto',
235 choices : ['auto', 'disabled', 'dri', 'xlib', 'gallium-xlib'],
236 description : 'Build support for GLX platform'
237 )
238 option(
239 'egl',
240 type : 'combo',
241 value : 'auto',
242 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
243 description : 'Build support for EGL platform'
244 )
245 option(
246 'glvnd',
247 type : 'boolean',
248 value : false,
249 description : 'Enable GLVND support.'
250 )
251 option(
252 'glx-read-only-text',
253 type : 'boolean',
254 value : false,
255 description : 'Disable writable .text section on x86 (decreases performance)'
256 )
257 option(
258 'llvm',
259 type : 'combo',
260 value : 'auto',
261 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
262 description : 'Build with LLVM support.'
263 )
264 option(
265 'shared-llvm',
266 type : 'combo',
267 value : 'auto',
268 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
269 description : 'Whether to link LLVM shared or statically.'
270 )
271 option(
272 'valgrind',
273 type : 'combo',
274 value : 'auto',
275 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
276 description : 'Build with valgrind support'
277 )
278 option(
279 'libunwind',
280 type : 'combo',
281 value : 'auto',
282 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
283 description : 'Use libunwind for stack-traces'
284 )
285 option(
286 'lmsensors',
287 type : 'combo',
288 value : 'auto',
289 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
290 description : 'Enable HUD lmsensors support.'
291 )
292 option(
293 'build-tests',
294 type : 'boolean',
295 value : false,
296 description : 'Build unit tests. Currently this will build *all* unit tests except the ACO tests, which may build more than expected.'
297 )
298 option(
299 'build-aco-tests',
300 type : 'boolean',
301 value : false,
302 description : 'Build ACO tests. These require RADV and glslang but not an AMD GPU.'
303 )
304 option(
305 'install-intel-gpu-tests',
306 type : 'boolean',
307 value : false,
308 description : 'Build and install Intel unit tests which require the GPU. This option is for developers and the Intel CI system only.'
309 )
310 option(
311 'selinux',
312 type : 'boolean',
313 value : false,
314 description : 'Build an SELinux-aware Mesa'
315 )
316 option(
317 'osmesa',
318 type : 'combo',
319 value : 'none',
320 choices : ['none', 'classic', 'gallium'],
321 description : 'Build OSmesa.'
322 )
323 option(
324 'osmesa-bits',
325 type : 'combo',
326 value : '8',
327 choices : ['8', '16', '32'],
328 description : 'Number of channel bits for OSMesa.'
329 )
330 option(
331 'swr-arches',
332 type : 'array',
333 value : ['avx', 'avx2'],
334 choices : ['avx', 'avx2', 'knl', 'skx'],
335 description : 'Architectures to build SWR support for.',
336 )
337 option(
338 'shared-swr',
339 type : 'boolean',
340 value : true,
341 description : 'Whether to link SWR shared or statically.',
342 )
343
344 option(
345 'tools',
346 type : 'array',
347 value : [],
348 choices : ['drm-shim', 'etnaviv', 'freedreno', 'glsl', 'intel', 'intel-ui', 'nir', 'nouveau', 'xvmc', 'lima', 'panfrost', 'all'],
349 description : 'List of tools to build. (Note: `intel-ui` selects `intel`)',
350 )
351 option(
352 'power8',
353 type : 'combo',
354 value : 'auto',
355 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
356 description : 'Enable power8 optimizations.',
357 )
358 option(
359 'xlib-lease',
360 type : 'combo',
361 value : 'auto',
362 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
363 description : 'Enable VK_EXT_acquire_xlib_display.'
364 )
365 option(
366 'glx-direct',
367 type : 'boolean',
368 value : true,
369 description : 'Enable direct rendering in GLX and EGL for DRI',
370 )
371 option(
372 'prefer-iris',
373 type : 'boolean',
374 value : true,
375 description : 'Prefer new Intel iris driver over older i965 driver'
376 )
377 option('egl-lib-suffix',
378 type : 'string',
379 value : '',
380 description : 'Suffix to append to EGL library name. Default: none.'
381 )
382 option(
383 'gles-lib-suffix',
384 type : 'string',
385 value : '',
386 description : 'Suffix to append to GLES library names. Default: none.'
387 )
388 option(
389 'platform-sdk-version',
390 type : 'integer',
391 min : 25,
392 max : 28,
393 value : 25,
394 description : 'Android Platform SDK version. Default: Nougat version.'
395 )
396 option(
397 'zstd',
398 type : 'combo',
399 choices : ['auto', 'true', 'false', 'enabled', 'disabled'],
400 value : 'auto',
401 description : 'Use ZSTD instead of ZLIB in some cases.'
402 )