gallium: change comments to remove 'state tracker'
[mesa.git] / src / gallium / auxiliary / util / u_screen.c
1 /*
2 * Copyright © 2018 Broadcom
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
13 * Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21 * IN THE SOFTWARE.
22 */
23
24 #include "pipe/p_screen.h"
25 #include "util/u_screen.h"
26
27 /**
28 * Helper to use from a pipe_screen->get_param() implementation to return
29 * default values for unsupported PIPE_CAPs.
30 *
31 * Call this function from your pipe_screen->get_param() implementation's
32 * default case, so that implementors of new pipe caps don't need to
33 */
34 int
35 u_pipe_screen_get_param_defaults(struct pipe_screen *pscreen,
36 enum pipe_cap param)
37 {
38 /* Let's keep these sorted by position in p_defines.h. */
39 switch (param) {
40 case PIPE_CAP_NPOT_TEXTURES:
41 case PIPE_CAP_MAX_DUAL_SOURCE_RENDER_TARGETS:
42 case PIPE_CAP_ANISOTROPIC_FILTER:
43 case PIPE_CAP_POINT_SPRITE:
44 return 0;
45
46 case PIPE_CAP_GRAPHICS:
47 case PIPE_CAP_MAX_RENDER_TARGETS:
48 return 1;
49
50 case PIPE_CAP_OCCLUSION_QUERY:
51 case PIPE_CAP_QUERY_TIME_ELAPSED:
52 case PIPE_CAP_TEXTURE_SWIZZLE:
53 return 0;
54
55 case PIPE_CAP_MAX_TEXTURE_2D_SIZE:
56 case PIPE_CAP_MAX_TEXTURE_3D_LEVELS:
57 case PIPE_CAP_MAX_TEXTURE_CUBE_LEVELS:
58 unreachable("driver must implement these.");
59
60 case PIPE_CAP_TEXTURE_MIRROR_CLAMP:
61 case PIPE_CAP_BLEND_EQUATION_SEPARATE:
62 case PIPE_CAP_FRAGMENT_SHADER_TEXTURE_LOD:
63 case PIPE_CAP_FRAGMENT_SHADER_DERIVATIVES:
64 case PIPE_CAP_VERTEX_SHADER_SATURATE:
65 case PIPE_CAP_MAX_STREAM_OUTPUT_BUFFERS: /* enables EXT_transform_feedback */
66 case PIPE_CAP_PRIMITIVE_RESTART:
67 case PIPE_CAP_INDEP_BLEND_ENABLE:
68 case PIPE_CAP_INDEP_BLEND_FUNC:
69 case PIPE_CAP_MAX_TEXTURE_ARRAY_LAYERS: /* Enables GL_EXT_texture_array */
70 case PIPE_CAP_TGSI_FS_COORD_ORIGIN_UPPER_LEFT:
71 case PIPE_CAP_TGSI_FS_COORD_ORIGIN_LOWER_LEFT:
72 case PIPE_CAP_TGSI_FS_COORD_PIXEL_CENTER_HALF_INTEGER:
73 case PIPE_CAP_TGSI_FS_COORD_PIXEL_CENTER_INTEGER:
74 case PIPE_CAP_DEPTH_CLIP_DISABLE:
75 case PIPE_CAP_DEPTH_CLIP_DISABLE_SEPARATE:
76 case PIPE_CAP_SHADER_STENCIL_EXPORT:
77 case PIPE_CAP_TGSI_INSTANCEID:
78 case PIPE_CAP_VERTEX_ELEMENT_INSTANCE_DIVISOR:
79 case PIPE_CAP_FRAGMENT_COLOR_CLAMPED:
80 case PIPE_CAP_MIXED_COLORBUFFER_FORMATS:
81 case PIPE_CAP_SEAMLESS_CUBE_MAP:
82 case PIPE_CAP_SEAMLESS_CUBE_MAP_PER_TEXTURE:
83 case PIPE_CAP_RGB_OVERRIDE_DST_ALPHA_BLEND:
84 return 0;
85
86 case PIPE_CAP_MIN_TEXEL_OFFSET:
87 /* GL 3.x minimum value. */
88 return -8;
89 case PIPE_CAP_MAX_TEXEL_OFFSET:
90 return 7;
91
92 case PIPE_CAP_CONDITIONAL_RENDER:
93 case PIPE_CAP_TEXTURE_BARRIER:
94 return 0;
95
96 case PIPE_CAP_MAX_STREAM_OUTPUT_SEPARATE_COMPONENTS:
97 /* GL_EXT_transform_feedback minimum value. */
98 return 4;
99 case PIPE_CAP_MAX_STREAM_OUTPUT_INTERLEAVED_COMPONENTS:
100 return 64;
101
102 case PIPE_CAP_STREAM_OUTPUT_PAUSE_RESUME:
103 case PIPE_CAP_TGSI_CAN_COMPACT_CONSTANTS:
104 case PIPE_CAP_VERTEX_COLOR_UNCLAMPED:
105 case PIPE_CAP_VERTEX_COLOR_CLAMPED:
106 return 0;
107
108 case PIPE_CAP_GLSL_FEATURE_LEVEL:
109 case PIPE_CAP_GLSL_FEATURE_LEVEL_COMPATIBILITY:
110 /* Minimum GLSL level implemented by gallium drivers. */
111 return 120;
112
113 case PIPE_CAP_ESSL_FEATURE_LEVEL:
114 /* Tell gallium frontend to fallback to PIPE_CAP_GLSL_FEATURE_LEVEL */
115 return 0;
116
117 case PIPE_CAP_QUADS_FOLLOW_PROVOKING_VERTEX_CONVENTION:
118 case PIPE_CAP_USER_VERTEX_BUFFERS:
119 case PIPE_CAP_VERTEX_BUFFER_OFFSET_4BYTE_ALIGNED_ONLY:
120 case PIPE_CAP_VERTEX_BUFFER_STRIDE_4BYTE_ALIGNED_ONLY:
121 case PIPE_CAP_VERTEX_ELEMENT_SRC_OFFSET_4BYTE_ALIGNED_ONLY:
122 case PIPE_CAP_COMPUTE:
123 return 0;
124
125 case PIPE_CAP_CONSTANT_BUFFER_OFFSET_ALIGNMENT:
126 /* GL_UNIFORM_BUFFER_OFFSET_ALIGNMENT default value. */
127 return 1;
128
129 case PIPE_CAP_START_INSTANCE:
130 case PIPE_CAP_QUERY_TIMESTAMP:
131 case PIPE_CAP_TEXTURE_MULTISAMPLE:
132 return 0;
133
134 case PIPE_CAP_MIN_MAP_BUFFER_ALIGNMENT:
135 /* GL_ARB_map_buffer_alignment minimum value. All drivers expose the
136 * extension.
137 */
138 return 64;
139
140 case PIPE_CAP_CUBE_MAP_ARRAY:
141 case PIPE_CAP_TEXTURE_BUFFER_OBJECTS:
142 return 0;
143
144 case PIPE_CAP_TEXTURE_BUFFER_OFFSET_ALIGNMENT:
145 /* GL_EXT_texture_buffer minimum value. */
146 return 256;
147
148 case PIPE_CAP_BUFFER_SAMPLER_VIEW_RGBA_ONLY:
149 case PIPE_CAP_TGSI_TEXCOORD:
150 return 0;
151
152 case PIPE_CAP_PREFER_BLIT_BASED_TEXTURE_TRANSFER:
153 return 1;
154
155 case PIPE_CAP_QUERY_PIPELINE_STATISTICS:
156 case PIPE_CAP_QUERY_PIPELINE_STATISTICS_SINGLE:
157 case PIPE_CAP_TEXTURE_BORDER_COLOR_QUIRK:
158 return 0;
159
160 case PIPE_CAP_MAX_TEXTURE_BUFFER_SIZE:
161 /* GL_EXT_texture_buffer minimum value. */
162 return 65536;
163
164 case PIPE_CAP_MAX_VIEWPORTS:
165 return 1;
166
167 case PIPE_CAP_ENDIANNESS:
168 return PIPE_ENDIAN_LITTLE;
169
170 case PIPE_CAP_MIXED_FRAMEBUFFER_SIZES:
171 case PIPE_CAP_TGSI_VS_LAYER_VIEWPORT:
172 case PIPE_CAP_MAX_GEOMETRY_OUTPUT_VERTICES:
173 case PIPE_CAP_MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS:
174 case PIPE_CAP_MAX_TEXTURE_GATHER_COMPONENTS: /* Enables ARB_texture_gather */
175 case PIPE_CAP_TEXTURE_GATHER_SM5:
176 case PIPE_CAP_BUFFER_MAP_PERSISTENT_COHERENT:
177 case PIPE_CAP_FAKE_SW_MSAA:
178 case PIPE_CAP_TEXTURE_QUERY_LOD:
179 return 0;
180
181 case PIPE_CAP_MIN_TEXTURE_GATHER_OFFSET:
182 return -8;
183 case PIPE_CAP_MAX_TEXTURE_GATHER_OFFSET:
184 return 7;
185
186 case PIPE_CAP_SAMPLE_SHADING:
187 case PIPE_CAP_TEXTURE_GATHER_OFFSETS:
188 case PIPE_CAP_TGSI_VS_WINDOW_SPACE_POSITION:
189 case PIPE_CAP_MAX_VERTEX_STREAMS:
190 case PIPE_CAP_DRAW_INDIRECT:
191 case PIPE_CAP_TGSI_FS_FINE_DERIVATIVE:
192 return 0;
193
194 case PIPE_CAP_VENDOR_ID:
195 case PIPE_CAP_DEVICE_ID:
196 return 0xffffffff;
197
198 case PIPE_CAP_ACCELERATED:
199 case PIPE_CAP_VIDEO_MEMORY:
200 case PIPE_CAP_UMA:
201 unreachable("driver must implement these.");
202
203 case PIPE_CAP_CONDITIONAL_RENDER_INVERTED:
204 return 0;
205
206 case PIPE_CAP_MAX_VERTEX_ATTRIB_STRIDE:
207 /* GL minimum value */
208 return 2048;
209
210 case PIPE_CAP_SAMPLER_VIEW_TARGET:
211 case PIPE_CAP_CLIP_HALFZ:
212 case PIPE_CAP_VERTEXID_NOBASE:
213 case PIPE_CAP_POLYGON_OFFSET_CLAMP:
214 case PIPE_CAP_MULTISAMPLE_Z_RESOLVE:
215 case PIPE_CAP_RESOURCE_FROM_USER_MEMORY:
216 case PIPE_CAP_DEVICE_RESET_STATUS_QUERY:
217 case PIPE_CAP_MAX_SHADER_PATCH_VARYINGS:
218 case PIPE_CAP_TEXTURE_FLOAT_LINEAR:
219 case PIPE_CAP_TEXTURE_HALF_FLOAT_LINEAR:
220 case PIPE_CAP_DEPTH_BOUNDS_TEST:
221 case PIPE_CAP_TGSI_TXQS:
222 case PIPE_CAP_FORCE_PERSAMPLE_INTERP:
223 case PIPE_CAP_SHAREABLE_SHADERS:
224 case PIPE_CAP_COPY_BETWEEN_COMPRESSED_AND_PLAIN_FORMATS:
225 case PIPE_CAP_CLEAR_TEXTURE:
226 case PIPE_CAP_CLEAR_SCISSORED:
227 case PIPE_CAP_DRAW_PARAMETERS:
228 case PIPE_CAP_TGSI_PACK_HALF_FLOAT:
229 case PIPE_CAP_MULTI_DRAW_INDIRECT:
230 case PIPE_CAP_MULTI_DRAW_INDIRECT_PARAMS:
231 case PIPE_CAP_TGSI_FS_POSITION_IS_SYSVAL:
232 case PIPE_CAP_TGSI_FS_POINT_IS_SYSVAL:
233 case PIPE_CAP_TGSI_FS_FACE_IS_INTEGER_SYSVAL:
234 return 0;
235
236 case PIPE_CAP_SHADER_BUFFER_OFFSET_ALIGNMENT:
237 /* Enables GL_ARB_shader_storage_buffer_object */
238 return 0;
239
240 case PIPE_CAP_INVALIDATE_BUFFER:
241 case PIPE_CAP_GENERATE_MIPMAP:
242 case PIPE_CAP_STRING_MARKER:
243 case PIPE_CAP_SURFACE_REINTERPRET_BLOCKS:
244 case PIPE_CAP_QUERY_BUFFER_OBJECT:
245 case PIPE_CAP_QUERY_MEMORY_INFO: /* Enables GL_ATI_meminfo */
246 return 0;
247
248 case PIPE_CAP_PCI_GROUP:
249 case PIPE_CAP_PCI_BUS:
250 case PIPE_CAP_PCI_DEVICE:
251 case PIPE_CAP_PCI_FUNCTION:
252 unreachable("driver must implement these.");
253
254 case PIPE_CAP_FRAMEBUFFER_NO_ATTACHMENT:
255 case PIPE_CAP_ROBUST_BUFFER_ACCESS_BEHAVIOR:
256 case PIPE_CAP_CULL_DISTANCE:
257 case PIPE_CAP_PRIMITIVE_RESTART_FOR_PATCHES:
258 case PIPE_CAP_TGSI_VOTE:
259 case PIPE_CAP_MAX_WINDOW_RECTANGLES: /* Enables EXT_window_rectangles */
260 case PIPE_CAP_POLYGON_OFFSET_UNITS_UNSCALED:
261 case PIPE_CAP_VIEWPORT_SUBPIXEL_BITS:
262 case PIPE_CAP_VIEWPORT_SWIZZLE:
263 case PIPE_CAP_VIEWPORT_MASK:
264 case PIPE_CAP_MIXED_COLOR_DEPTH_BITS:
265 case PIPE_CAP_TGSI_ARRAY_COMPONENTS:
266 case PIPE_CAP_STREAM_OUTPUT_INTERLEAVE_BUFFERS:
267 case PIPE_CAP_TGSI_CAN_READ_OUTPUTS:
268 case PIPE_CAP_NATIVE_FENCE_FD:
269 return 0;
270
271 case PIPE_CAP_RASTERIZER_SUBPIXEL_BITS:
272 return 4; /* GLES 2.0 minimum value */
273
274 case PIPE_CAP_GLSL_OPTIMIZE_CONSERVATIVELY:
275 return 1;
276
277 case PIPE_CAP_GLSL_TESS_LEVELS_AS_INPUTS:
278 return 0;
279
280 case PIPE_CAP_FBFETCH:
281 case PIPE_CAP_FBFETCH_COHERENT:
282 case PIPE_CAP_TGSI_MUL_ZERO_WINS:
283 case PIPE_CAP_DOUBLES:
284 case PIPE_CAP_INT64:
285 case PIPE_CAP_INT64_DIVMOD:
286 case PIPE_CAP_TGSI_TEX_TXF_LZ:
287 case PIPE_CAP_TGSI_CLOCK:
288 case PIPE_CAP_POLYGON_MODE_FILL_RECTANGLE:
289 case PIPE_CAP_SPARSE_BUFFER_PAGE_SIZE:
290 case PIPE_CAP_TGSI_BALLOT:
291 case PIPE_CAP_TGSI_TES_LAYER_VIEWPORT:
292 case PIPE_CAP_CAN_BIND_CONST_BUFFER_AS_VERTEX:
293 case PIPE_CAP_TGSI_DIV:
294 return 0;
295
296 case PIPE_CAP_ALLOW_MAPPED_BUFFERS_DURING_EXECUTION:
297 /* Drivers generally support this, and it reduces GL overhead just to
298 * throw an error when buffers are mapped.
299 */
300 return 1;
301
302 case PIPE_CAP_PREFER_IMM_ARRAYS_AS_CONSTBUF:
303 /* Don't unset this unless your driver can do better */
304 return 1;
305
306 case PIPE_CAP_POST_DEPTH_COVERAGE:
307 case PIPE_CAP_BINDLESS_TEXTURE:
308 case PIPE_CAP_NIR_SAMPLERS_AS_DEREF:
309 case PIPE_CAP_NIR_COMPACT_ARRAYS:
310 case PIPE_CAP_QUERY_SO_OVERFLOW:
311 case PIPE_CAP_MEMOBJ:
312 case PIPE_CAP_LOAD_CONSTBUF:
313 case PIPE_CAP_TGSI_ANY_REG_AS_ADDRESS:
314 case PIPE_CAP_TILE_RASTER_ORDER:
315 return 0;
316
317 case PIPE_CAP_MAX_COMBINED_SHADER_OUTPUT_RESOURCES:
318 /* nonzero overrides defaults */
319 return 0;
320
321 case PIPE_CAP_FRAMEBUFFER_MSAA_CONSTRAINTS:
322 case PIPE_CAP_SIGNED_VERTEX_BUFFER_OFFSET:
323 case PIPE_CAP_CONTEXT_PRIORITY_MASK:
324 case PIPE_CAP_FENCE_SIGNAL:
325 case PIPE_CAP_CONSTBUF0_FLAGS:
326 case PIPE_CAP_PACKED_UNIFORMS:
327 case PIPE_CAP_CONSERVATIVE_RASTER_POST_SNAP_TRIANGLES:
328 case PIPE_CAP_CONSERVATIVE_RASTER_POST_SNAP_POINTS_LINES:
329 case PIPE_CAP_CONSERVATIVE_RASTER_PRE_SNAP_TRIANGLES:
330 case PIPE_CAP_CONSERVATIVE_RASTER_PRE_SNAP_POINTS_LINES:
331 case PIPE_CAP_MAX_CONSERVATIVE_RASTER_SUBPIXEL_PRECISION_BIAS:
332 case PIPE_CAP_CONSERVATIVE_RASTER_POST_DEPTH_COVERAGE:
333 case PIPE_CAP_CONSERVATIVE_RASTER_INNER_COVERAGE:
334 case PIPE_CAP_PROGRAMMABLE_SAMPLE_LOCATIONS:
335 case PIPE_CAP_MAX_COMBINED_SHADER_BUFFERS:
336 case PIPE_CAP_MAX_COMBINED_HW_ATOMIC_COUNTERS:
337 case PIPE_CAP_MAX_COMBINED_HW_ATOMIC_COUNTER_BUFFERS:
338 case PIPE_CAP_TGSI_ATOMFADD:
339 case PIPE_CAP_TGSI_SKIP_SHRINK_IO_ARRAYS:
340 case PIPE_CAP_IMAGE_LOAD_FORMATTED:
341 case PIPE_CAP_PREFER_COMPUTE_FOR_MULTIMEDIA:
342 case PIPE_CAP_FRAGMENT_SHADER_INTERLOCK:
343 case PIPE_CAP_CS_DERIVED_SYSTEM_VALUES_SUPPORTED:
344 case PIPE_CAP_ATOMIC_FLOAT_MINMAX:
345 case PIPE_CAP_SHADER_SAMPLES_IDENTICAL:
346 case PIPE_CAP_TGSI_ATOMINC_WRAP:
347 case PIPE_CAP_TGSI_TG4_COMPONENT_IN_SWIZZLE:
348 case PIPE_CAP_GLSL_ZERO_INIT:
349 return 0;
350
351 case PIPE_CAP_MAX_GS_INVOCATIONS:
352 return 32;
353
354 case PIPE_CAP_MAX_SHADER_BUFFER_SIZE:
355 return 1 << 27;
356
357 case PIPE_CAP_TEXTURE_MIRROR_CLAMP_TO_EDGE:
358 case PIPE_CAP_MAX_TEXTURE_UPLOAD_MEMORY_BUDGET:
359 return 0;
360
361 case PIPE_CAP_MAX_VERTEX_ELEMENT_SRC_OFFSET:
362 return 2047;
363
364 case PIPE_CAP_SURFACE_SAMPLE_COUNT:
365 return 0;
366 case PIPE_CAP_DEST_SURFACE_SRGB_CONTROL:
367 return 1;
368
369 case PIPE_CAP_MAX_VARYINGS:
370 return 8;
371
372 case PIPE_CAP_COMPUTE_GRID_INFO_LAST_BLOCK:
373 return 0;
374
375 case PIPE_CAP_COMPUTE_SHADER_DERIVATIVES:
376 return 0;
377
378 case PIPE_CAP_THROTTLE:
379 return 1;
380
381 case PIPE_CAP_TEXTURE_SHADOW_LOD:
382 return 0;
383
384 case PIPE_CAP_GL_SPIRV:
385 case PIPE_CAP_GL_SPIRV_VARIABLE_POINTERS:
386 return 0;
387
388 case PIPE_CAP_DEMOTE_TO_HELPER_INVOCATION:
389 return 0;
390
391 case PIPE_CAP_DMABUF:
392 #if defined(PIPE_OS_LINUX) || defined(PIPE_OS_BSD)
393 return 1;
394 #else
395 return 0;
396 #endif
397
398 case PIPE_CAP_TEXTURE_SHADOW_MAP: /* Enables ARB_shadow */
399 return 1;
400
401 case PIPE_CAP_FLATSHADE:
402 case PIPE_CAP_ALPHA_TEST:
403 case PIPE_CAP_POINT_SIZE_FIXED:
404 case PIPE_CAP_TWO_SIDED_COLOR:
405 case PIPE_CAP_CLIP_PLANES:
406 return 1;
407
408 case PIPE_CAP_MAX_VERTEX_BUFFERS:
409 return 16;
410
411 case PIPE_CAP_OPENCL_INTEGER_FUNCTIONS:
412 case PIPE_CAP_INTEGER_MULTIPLY_32X16:
413 case PIPE_CAP_DRAW_INFO_START_WITH_USER_INDICES:
414 return 0;
415 case PIPE_CAP_NIR_IMAGES_AS_DEREF:
416 return 1;
417
418 case PIPE_CAP_FRONTEND_NOOP:
419 /* Enables INTEL_blackhole_render */
420 return 0;
421
422 case PIPE_CAP_PACKED_STREAM_OUTPUT:
423 return 1;
424
425 case PIPE_CAP_VIEWPORT_TRANSFORM_LOWERED:
426 case PIPE_CAP_PSIZ_CLAMPED:
427 case PIPE_CAP_MAP_UNSYNCHRONIZED_THREAD_SAFE:
428 return 0;
429
430 case PIPE_CAP_GL_BEGIN_END_BUFFER_SIZE:
431 return 512 * 1024;
432
433 case PIPE_CAP_SYSTEM_SVM:
434 case PIPE_CAP_ALPHA_TO_COVERAGE_DITHER_CONTROL:
435 return 0;
436
437 default:
438 unreachable("bad PIPE_CAP_*");
439 }
440 }