glx: drop misleading comment about the file being "generated"
[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 : 'boolean',
180 value : true,
181 description : 'Whether to build a shared or static glapi'
182 )
183 option(
184 'gles1',
185 type : 'combo',
186 value : 'auto',
187 choices : ['auto', 'true', 'false'],
188 description : 'Build support for OpenGL ES 1.x'
189 )
190 option(
191 'gles2',
192 type : 'combo',
193 value : 'auto',
194 choices : ['auto', 'true', 'false'],
195 description : 'Build support for OpenGL ES 2.x and 3.x'
196 )
197 option(
198 'opengl',
199 type : 'boolean',
200 value : true,
201 description : 'Build support for OpenGL (all versions)'
202 )
203 option(
204 'gbm',
205 type : 'combo',
206 value : 'auto',
207 choices : ['auto', 'true', 'false'],
208 description : 'Build support for gbm platform'
209 )
210 option(
211 'glx',
212 type : 'combo',
213 value : 'auto',
214 choices : ['auto', 'disabled', 'dri', 'xlib', 'gallium-xlib'],
215 description : 'Build support for GLX platform'
216 )
217 option(
218 'egl',
219 type : 'combo',
220 value : 'auto',
221 choices : ['auto', 'true', 'false'],
222 description : 'Build support for EGL platform'
223 )
224 option(
225 'glvnd',
226 type : 'boolean',
227 value : false,
228 description : 'Enable GLVND support.'
229 )
230 option(
231 'asm',
232 type : 'boolean',
233 value : true,
234 description : 'Build assembly code if possible'
235 )
236 option(
237 'glx-read-only-text',
238 type : 'boolean',
239 value : false,
240 description : 'Disable writable .text section on x86 (decreases performance)'
241 )
242 option(
243 'llvm',
244 type : 'combo',
245 value : 'auto',
246 choices : ['auto', 'true', 'false'],
247 description : 'Build with LLVM support.'
248 )
249 option(
250 'shared-llvm',
251 type : 'boolean',
252 value : true,
253 description : 'Whether to link llvm shared or statically.'
254 )
255 option(
256 'valgrind',
257 type : 'combo',
258 value : 'auto',
259 choices : ['auto', 'true', 'false'],
260 description : 'Build with valgrind support'
261 )
262 option(
263 'libunwind',
264 type : 'combo',
265 value : 'auto',
266 choices : ['auto', 'true', 'false'],
267 description : 'Use libunwind for stack-traces'
268 )
269 option(
270 'lmsensors',
271 type : 'combo',
272 value : 'auto',
273 choices : ['auto', 'true', 'false'],
274 description : 'Enable HUD lmsensors support.'
275 )
276 option(
277 'build-tests',
278 type : 'boolean',
279 value : false,
280 description : 'Build unit tests. Currently this will build *all* unit tests, which may build more than expected.'
281 )
282 option(
283 'install-intel-gpu-tests',
284 type : 'boolean',
285 value : false,
286 description : 'Build and install Intel unit tests which require the GPU. This option is for developers and the Intel CI system only.'
287 )
288 option(
289 'selinux',
290 type : 'boolean',
291 value : false,
292 description : 'Build an SELinux-aware Mesa'
293 )
294 option(
295 'osmesa',
296 type : 'combo',
297 value : 'none',
298 choices : ['none', 'classic', 'gallium'],
299 description : 'Build OSmesa.'
300 )
301 option(
302 'osmesa-bits',
303 type : 'combo',
304 value : '8',
305 choices : ['8', '16', '32'],
306 description : 'Number of channel bits for OSMesa.'
307 )
308 option(
309 'swr-arches',
310 type : 'array',
311 value : ['avx', 'avx2'],
312 choices : ['avx', 'avx2', 'knl', 'skx'],
313 description : 'Architectures to build SWR support for.',
314 )
315 option(
316 'tools',
317 type : 'array',
318 value : [],
319 choices : ['etnaviv', 'freedreno', 'glsl', 'intel', 'intel-ui', 'nir', 'nouveau', 'xvmc', 'all'],
320 description : 'List of tools to build. (Note: `intel-ui` selects `intel`)',
321 )
322 option(
323 'power8',
324 type : 'combo',
325 value : 'auto',
326 choices : ['auto', 'true', 'false'],
327 description : 'Enable power8 optimizations.',
328 )
329 option(
330 'xlib-lease',
331 type : 'combo',
332 value : 'auto',
333 choices : ['auto', 'true', 'false'],
334 description : 'Enable VK_EXT_acquire_xlib_display.'
335 )
336 option(
337 'glx-direct',
338 type : 'boolean',
339 value : true,
340 description : 'Enable direct rendering in GLX and EGL for DRI',
341 )
342 option(
343 'I-love-half-baked-turnips',
344 type : 'boolean',
345 value : false,
346 description : 'Allow work-in-progress freedreno vulkan driver to be enabled',
347 )
348 option('egl-lib-suffix',
349 type : 'string',
350 value : '',
351 description : 'Suffix to append to EGL library name. Default: none.'
352 )
353 option(
354 'gles-lib-suffix',
355 type : 'string',
356 value : '',
357 description : 'Suffix to append to GLES library names. Default: none.'
358 )
359 option(
360 'platform-sdk-version',
361 type : 'integer',
362 min : 25,
363 max : 28,
364 value : 25,
365 description : 'Android Platform SDK version. Default: Nougat version.'
366 )