anv/clear: Handle ClearImage on 3-D images
[mesa.git] / src / intel / vulkan / anv_private.h
1 /*
2 * Copyright © 2015 Intel Corporation
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 #pragma once
25
26 #include <stdlib.h>
27 #include <stdio.h>
28 #include <stdbool.h>
29 #include <pthread.h>
30 #include <assert.h>
31 #include <stdint.h>
32 #include <i915_drm.h>
33
34 #ifdef HAVE_VALGRIND
35 #include <valgrind.h>
36 #include <memcheck.h>
37 #define VG(x) x
38 #define __gen_validate_value(x) VALGRIND_CHECK_MEM_IS_DEFINED(&(x), sizeof(x))
39 #else
40 #define VG(x)
41 #endif
42
43 #include "brw_device_info.h"
44 #include "brw_compiler.h"
45 #include "util/macros.h"
46 #include "util/list.h"
47
48 /* Pre-declarations needed for WSI entrypoints */
49 struct wl_surface;
50 struct wl_display;
51 typedef struct xcb_connection_t xcb_connection_t;
52 typedef uint32_t xcb_visualid_t;
53 typedef uint32_t xcb_window_t;
54
55 struct anv_l3_config;
56
57 #include <vulkan/vulkan.h>
58 #include <vulkan/vulkan_intel.h>
59 #include <vulkan/vk_icd.h>
60
61 #include "anv_entrypoints.h"
62 #include "brw_context.h"
63 #include "isl/isl.h"
64
65 #ifdef __cplusplus
66 extern "C" {
67 #endif
68
69 #define MAX_VBS 32
70 #define MAX_SETS 8
71 #define MAX_RTS 8
72 #define MAX_VIEWPORTS 16
73 #define MAX_SCISSORS 16
74 #define MAX_PUSH_CONSTANTS_SIZE 128
75 #define MAX_DYNAMIC_BUFFERS 16
76 #define MAX_IMAGES 8
77 #define MAX_SAMPLES_LOG2 4 /* SKL supports 16 samples */
78
79 #define anv_noreturn __attribute__((__noreturn__))
80 #define anv_printflike(a, b) __attribute__((__format__(__printf__, a, b)))
81
82 #define MIN(a, b) ((a) < (b) ? (a) : (b))
83 #define MAX(a, b) ((a) > (b) ? (a) : (b))
84
85 static inline uint32_t
86 align_u32(uint32_t v, uint32_t a)
87 {
88 assert(a != 0 && a == (a & -a));
89 return (v + a - 1) & ~(a - 1);
90 }
91
92 static inline uint64_t
93 align_u64(uint64_t v, uint64_t a)
94 {
95 assert(a != 0 && a == (a & -a));
96 return (v + a - 1) & ~(a - 1);
97 }
98
99 static inline int32_t
100 align_i32(int32_t v, int32_t a)
101 {
102 assert(a != 0 && a == (a & -a));
103 return (v + a - 1) & ~(a - 1);
104 }
105
106 /** Alignment must be a power of 2. */
107 static inline bool
108 anv_is_aligned(uintmax_t n, uintmax_t a)
109 {
110 assert(a == (a & -a));
111 return (n & (a - 1)) == 0;
112 }
113
114 static inline uint32_t
115 anv_minify(uint32_t n, uint32_t levels)
116 {
117 if (unlikely(n == 0))
118 return 0;
119 else
120 return MAX(n >> levels, 1);
121 }
122
123 static inline float
124 anv_clamp_f(float f, float min, float max)
125 {
126 assert(min < max);
127
128 if (f > max)
129 return max;
130 else if (f < min)
131 return min;
132 else
133 return f;
134 }
135
136 static inline bool
137 anv_clear_mask(uint32_t *inout_mask, uint32_t clear_mask)
138 {
139 if (*inout_mask & clear_mask) {
140 *inout_mask &= ~clear_mask;
141 return true;
142 } else {
143 return false;
144 }
145 }
146
147 #define for_each_bit(b, dword) \
148 for (uint32_t __dword = (dword); \
149 (b) = __builtin_ffs(__dword) - 1, __dword; \
150 __dword &= ~(1 << (b)))
151
152 #define typed_memcpy(dest, src, count) ({ \
153 static_assert(sizeof(*src) == sizeof(*dest), ""); \
154 memcpy((dest), (src), (count) * sizeof(*(src))); \
155 })
156
157 #define zero(x) (memset(&(x), 0, sizeof(x)))
158
159 /* Define no kernel as 1, since that's an illegal offset for a kernel */
160 #define NO_KERNEL 1
161
162 struct anv_common {
163 VkStructureType sType;
164 const void* pNext;
165 };
166
167 /* Whenever we generate an error, pass it through this function. Useful for
168 * debugging, where we can break on it. Only call at error site, not when
169 * propagating errors. Might be useful to plug in a stack trace here.
170 */
171
172 VkResult __vk_errorf(VkResult error, const char *file, int line, const char *format, ...);
173
174 #ifdef DEBUG
175 #define vk_error(error) __vk_errorf(error, __FILE__, __LINE__, NULL);
176 #define vk_errorf(error, format, ...) __vk_errorf(error, __FILE__, __LINE__, format, ## __VA_ARGS__);
177 #else
178 #define vk_error(error) error
179 #define vk_errorf(error, format, ...) error
180 #endif
181
182 void __anv_finishme(const char *file, int line, const char *format, ...)
183 anv_printflike(3, 4);
184 void anv_loge(const char *format, ...) anv_printflike(1, 2);
185 void anv_loge_v(const char *format, va_list va);
186
187 /**
188 * Print a FINISHME message, including its source location.
189 */
190 #define anv_finishme(format, ...) \
191 __anv_finishme(__FILE__, __LINE__, format, ##__VA_ARGS__);
192
193 /* A non-fatal assert. Useful for debugging. */
194 #ifdef DEBUG
195 #define anv_assert(x) ({ \
196 if (unlikely(!(x))) \
197 fprintf(stderr, "%s:%d ASSERT: %s\n", __FILE__, __LINE__, #x); \
198 })
199 #else
200 #define anv_assert(x)
201 #endif
202
203 /**
204 * If a block of code is annotated with anv_validate, then the block runs only
205 * in debug builds.
206 */
207 #ifdef DEBUG
208 #define anv_validate if (1)
209 #else
210 #define anv_validate if (0)
211 #endif
212
213 void anv_abortf(const char *format, ...) anv_noreturn anv_printflike(1, 2);
214 void anv_abortfv(const char *format, va_list va) anv_noreturn;
215
216 #define stub_return(v) \
217 do { \
218 anv_finishme("stub %s", __func__); \
219 return (v); \
220 } while (0)
221
222 #define stub() \
223 do { \
224 anv_finishme("stub %s", __func__); \
225 return; \
226 } while (0)
227
228 /**
229 * A dynamically growable, circular buffer. Elements are added at head and
230 * removed from tail. head and tail are free-running uint32_t indices and we
231 * only compute the modulo with size when accessing the array. This way,
232 * number of bytes in the queue is always head - tail, even in case of
233 * wraparound.
234 */
235
236 struct anv_vector {
237 uint32_t head;
238 uint32_t tail;
239 uint32_t element_size;
240 uint32_t size;
241 void *data;
242 };
243
244 int anv_vector_init(struct anv_vector *queue, uint32_t element_size, uint32_t size);
245 void *anv_vector_add(struct anv_vector *queue);
246 void *anv_vector_remove(struct anv_vector *queue);
247
248 static inline int
249 anv_vector_length(struct anv_vector *queue)
250 {
251 return (queue->head - queue->tail) / queue->element_size;
252 }
253
254 static inline void *
255 anv_vector_head(struct anv_vector *vector)
256 {
257 assert(vector->tail < vector->head);
258 return (void *)((char *)vector->data +
259 ((vector->head - vector->element_size) &
260 (vector->size - 1)));
261 }
262
263 static inline void *
264 anv_vector_tail(struct anv_vector *vector)
265 {
266 return (void *)((char *)vector->data + (vector->tail & (vector->size - 1)));
267 }
268
269 static inline void
270 anv_vector_finish(struct anv_vector *queue)
271 {
272 free(queue->data);
273 }
274
275 #define anv_vector_foreach(elem, queue) \
276 static_assert(__builtin_types_compatible_p(__typeof__(queue), struct anv_vector *), ""); \
277 for (uint32_t __anv_vector_offset = (queue)->tail; \
278 elem = (queue)->data + (__anv_vector_offset & ((queue)->size - 1)), __anv_vector_offset < (queue)->head; \
279 __anv_vector_offset += (queue)->element_size)
280
281 struct anv_bo {
282 uint32_t gem_handle;
283
284 /* Index into the current validation list. This is used by the
285 * validation list building alrogithm to track which buffers are already
286 * in the validation list so that we can ensure uniqueness.
287 */
288 uint32_t index;
289
290 /* Last known offset. This value is provided by the kernel when we
291 * execbuf and is used as the presumed offset for the next bunch of
292 * relocations.
293 */
294 uint64_t offset;
295
296 uint64_t size;
297 void *map;
298
299 /* We need to set the WRITE flag on winsys bos so GEM will know we're
300 * writing to them and synchronize uses on other rings (eg if the display
301 * server uses the blitter ring).
302 */
303 bool is_winsys_bo;
304 };
305
306 /* Represents a lock-free linked list of "free" things. This is used by
307 * both the block pool and the state pools. Unfortunately, in order to
308 * solve the ABA problem, we can't use a single uint32_t head.
309 */
310 union anv_free_list {
311 struct {
312 int32_t offset;
313
314 /* A simple count that is incremented every time the head changes. */
315 uint32_t count;
316 };
317 uint64_t u64;
318 };
319
320 #define ANV_FREE_LIST_EMPTY ((union anv_free_list) { { 1, 0 } })
321
322 struct anv_block_state {
323 union {
324 struct {
325 uint32_t next;
326 uint32_t end;
327 };
328 uint64_t u64;
329 };
330 };
331
332 struct anv_block_pool {
333 struct anv_device *device;
334
335 struct anv_bo bo;
336
337 /* The offset from the start of the bo to the "center" of the block
338 * pool. Pointers to allocated blocks are given by
339 * bo.map + center_bo_offset + offsets.
340 */
341 uint32_t center_bo_offset;
342
343 /* Current memory map of the block pool. This pointer may or may not
344 * point to the actual beginning of the block pool memory. If
345 * anv_block_pool_alloc_back has ever been called, then this pointer
346 * will point to the "center" position of the buffer and all offsets
347 * (negative or positive) given out by the block pool alloc functions
348 * will be valid relative to this pointer.
349 *
350 * In particular, map == bo.map + center_offset
351 */
352 void *map;
353 int fd;
354
355 /**
356 * Array of mmaps and gem handles owned by the block pool, reclaimed when
357 * the block pool is destroyed.
358 */
359 struct anv_vector mmap_cleanups;
360
361 uint32_t block_size;
362
363 union anv_free_list free_list;
364 struct anv_block_state state;
365
366 union anv_free_list back_free_list;
367 struct anv_block_state back_state;
368 };
369
370 /* Block pools are backed by a fixed-size 2GB memfd */
371 #define BLOCK_POOL_MEMFD_SIZE (1ull << 32)
372
373 /* The center of the block pool is also the middle of the memfd. This may
374 * change in the future if we decide differently for some reason.
375 */
376 #define BLOCK_POOL_MEMFD_CENTER (BLOCK_POOL_MEMFD_SIZE / 2)
377
378 static inline uint32_t
379 anv_block_pool_size(struct anv_block_pool *pool)
380 {
381 return pool->state.end + pool->back_state.end;
382 }
383
384 struct anv_state {
385 int32_t offset;
386 uint32_t alloc_size;
387 void *map;
388 };
389
390 struct anv_fixed_size_state_pool {
391 size_t state_size;
392 union anv_free_list free_list;
393 struct anv_block_state block;
394 };
395
396 #define ANV_MIN_STATE_SIZE_LOG2 6
397 #define ANV_MAX_STATE_SIZE_LOG2 10
398
399 #define ANV_STATE_BUCKETS (ANV_MAX_STATE_SIZE_LOG2 - ANV_MIN_STATE_SIZE_LOG2)
400
401 struct anv_state_pool {
402 struct anv_block_pool *block_pool;
403 struct anv_fixed_size_state_pool buckets[ANV_STATE_BUCKETS];
404 };
405
406 struct anv_state_stream_block;
407
408 struct anv_state_stream {
409 struct anv_block_pool *block_pool;
410
411 /* The current working block */
412 struct anv_state_stream_block *block;
413
414 /* Offset at which the current block starts */
415 uint32_t start;
416 /* Offset at which to allocate the next state */
417 uint32_t next;
418 /* Offset at which the current block ends */
419 uint32_t end;
420 };
421
422 #define CACHELINE_SIZE 64
423 #define CACHELINE_MASK 63
424
425 static inline void
426 anv_clflush_range(void *start, size_t size)
427 {
428 void *p = (void *) (((uintptr_t) start) & ~CACHELINE_MASK);
429 void *end = start + size;
430
431 __builtin_ia32_mfence();
432 while (p < end) {
433 __builtin_ia32_clflush(p);
434 p += CACHELINE_SIZE;
435 }
436 }
437
438 static void inline
439 anv_state_clflush(struct anv_state state)
440 {
441 anv_clflush_range(state.map, state.alloc_size);
442 }
443
444 void anv_block_pool_init(struct anv_block_pool *pool,
445 struct anv_device *device, uint32_t block_size);
446 void anv_block_pool_finish(struct anv_block_pool *pool);
447 int32_t anv_block_pool_alloc(struct anv_block_pool *pool);
448 int32_t anv_block_pool_alloc_back(struct anv_block_pool *pool);
449 void anv_block_pool_free(struct anv_block_pool *pool, int32_t offset);
450 void anv_state_pool_init(struct anv_state_pool *pool,
451 struct anv_block_pool *block_pool);
452 void anv_state_pool_finish(struct anv_state_pool *pool);
453 struct anv_state anv_state_pool_alloc(struct anv_state_pool *pool,
454 size_t state_size, size_t alignment);
455 void anv_state_pool_free(struct anv_state_pool *pool, struct anv_state state);
456 void anv_state_stream_init(struct anv_state_stream *stream,
457 struct anv_block_pool *block_pool);
458 void anv_state_stream_finish(struct anv_state_stream *stream);
459 struct anv_state anv_state_stream_alloc(struct anv_state_stream *stream,
460 uint32_t size, uint32_t alignment);
461
462 /**
463 * Implements a pool of re-usable BOs. The interface is identical to that
464 * of block_pool except that each block is its own BO.
465 */
466 struct anv_bo_pool {
467 struct anv_device *device;
468
469 void *free_list[16];
470 };
471
472 void anv_bo_pool_init(struct anv_bo_pool *pool, struct anv_device *device);
473 void anv_bo_pool_finish(struct anv_bo_pool *pool);
474 VkResult anv_bo_pool_alloc(struct anv_bo_pool *pool, struct anv_bo *bo,
475 uint32_t size);
476 void anv_bo_pool_free(struct anv_bo_pool *pool, const struct anv_bo *bo);
477
478
479 void *anv_resolve_entrypoint(uint32_t index);
480
481 extern struct anv_dispatch_table dtable;
482
483 #define ANV_CALL(func) ({ \
484 if (dtable.func == NULL) { \
485 size_t idx = offsetof(struct anv_dispatch_table, func) / sizeof(void *); \
486 dtable.entrypoints[idx] = anv_resolve_entrypoint(idx); \
487 } \
488 dtable.func; \
489 })
490
491 static inline void *
492 anv_alloc(const VkAllocationCallbacks *alloc,
493 size_t size, size_t align,
494 VkSystemAllocationScope scope)
495 {
496 return alloc->pfnAllocation(alloc->pUserData, size, align, scope);
497 }
498
499 static inline void *
500 anv_realloc(const VkAllocationCallbacks *alloc,
501 void *ptr, size_t size, size_t align,
502 VkSystemAllocationScope scope)
503 {
504 return alloc->pfnReallocation(alloc->pUserData, ptr, size, align, scope);
505 }
506
507 static inline void
508 anv_free(const VkAllocationCallbacks *alloc, void *data)
509 {
510 alloc->pfnFree(alloc->pUserData, data);
511 }
512
513 static inline void *
514 anv_alloc2(const VkAllocationCallbacks *parent_alloc,
515 const VkAllocationCallbacks *alloc,
516 size_t size, size_t align,
517 VkSystemAllocationScope scope)
518 {
519 if (alloc)
520 return anv_alloc(alloc, size, align, scope);
521 else
522 return anv_alloc(parent_alloc, size, align, scope);
523 }
524
525 static inline void
526 anv_free2(const VkAllocationCallbacks *parent_alloc,
527 const VkAllocationCallbacks *alloc,
528 void *data)
529 {
530 if (alloc)
531 anv_free(alloc, data);
532 else
533 anv_free(parent_alloc, data);
534 }
535
536 struct anv_wsi_interaface;
537
538 #define VK_ICD_WSI_PLATFORM_MAX 5
539
540 struct anv_physical_device {
541 VK_LOADER_DATA _loader_data;
542
543 struct anv_instance * instance;
544 uint32_t chipset_id;
545 char path[20];
546 const char * name;
547 const struct brw_device_info * info;
548 uint64_t aperture_size;
549 struct brw_compiler * compiler;
550 struct isl_device isl_dev;
551 int cmd_parser_version;
552
553 struct anv_wsi_interface * wsi[VK_ICD_WSI_PLATFORM_MAX];
554 };
555
556 struct anv_instance {
557 VK_LOADER_DATA _loader_data;
558
559 VkAllocationCallbacks alloc;
560
561 uint32_t apiVersion;
562 int physicalDeviceCount;
563 struct anv_physical_device physicalDevice;
564 };
565
566 VkResult anv_init_wsi(struct anv_physical_device *physical_device);
567 void anv_finish_wsi(struct anv_physical_device *physical_device);
568
569 struct anv_meta_state {
570 VkAllocationCallbacks alloc;
571
572 /**
573 * Use array element `i` for images with `2^i` samples.
574 */
575 struct {
576 /**
577 * Pipeline N is used to clear color attachment N of the current
578 * subpass.
579 *
580 * HACK: We use one pipeline per color attachment to work around the
581 * compiler's inability to dynamically set the render target index of
582 * the render target write message.
583 */
584 struct anv_pipeline *color_pipelines[MAX_RTS];
585
586 struct anv_pipeline *depth_only_pipeline;
587 struct anv_pipeline *stencil_only_pipeline;
588 struct anv_pipeline *depthstencil_pipeline;
589 } clear[1 + MAX_SAMPLES_LOG2];
590
591 struct {
592 VkRenderPass render_pass;
593
594 /** Pipeline that blits from a 1D image. */
595 VkPipeline pipeline_1d_src;
596
597 /** Pipeline that blits from a 2D image. */
598 VkPipeline pipeline_2d_src;
599
600 /** Pipeline that blits from a 3D image. */
601 VkPipeline pipeline_3d_src;
602
603 VkPipelineLayout pipeline_layout;
604 VkDescriptorSetLayout ds_layout;
605 } blit;
606
607 struct {
608 VkRenderPass render_pass;
609
610 VkPipelineLayout img_p_layout;
611 VkDescriptorSetLayout img_ds_layout;
612 VkPipelineLayout buf_p_layout;
613 VkDescriptorSetLayout buf_ds_layout;
614
615 /* Pipelines indexed by source and destination type. See the
616 * blit2d_src_type and blit2d_dst_type enums in anv_meta_blit2d.c to
617 * see what these mean.
618 */
619 VkPipeline pipelines[2][3];
620 } blit2d;
621
622 struct {
623 /** Pipeline [i] resolves an image with 2^(i+1) samples. */
624 VkPipeline pipelines[MAX_SAMPLES_LOG2];
625
626 VkRenderPass pass;
627 VkPipelineLayout pipeline_layout;
628 VkDescriptorSetLayout ds_layout;
629 } resolve;
630 };
631
632 struct anv_queue {
633 VK_LOADER_DATA _loader_data;
634
635 struct anv_device * device;
636
637 struct anv_state_pool * pool;
638 };
639
640 struct anv_pipeline_cache {
641 struct anv_device * device;
642 struct anv_state_stream program_stream;
643 pthread_mutex_t mutex;
644
645 uint32_t total_size;
646 uint32_t table_size;
647 uint32_t kernel_count;
648 uint32_t * hash_table;
649 };
650
651 struct anv_pipeline_bind_map;
652
653 void anv_pipeline_cache_init(struct anv_pipeline_cache *cache,
654 struct anv_device *device);
655 void anv_pipeline_cache_finish(struct anv_pipeline_cache *cache);
656 uint32_t anv_pipeline_cache_search(struct anv_pipeline_cache *cache,
657 const unsigned char *sha1,
658 const struct brw_stage_prog_data **prog_data,
659 struct anv_pipeline_bind_map *map);
660 uint32_t anv_pipeline_cache_upload_kernel(struct anv_pipeline_cache *cache,
661 const unsigned char *sha1,
662 const void *kernel,
663 size_t kernel_size,
664 const struct brw_stage_prog_data **prog_data,
665 size_t prog_data_size,
666 struct anv_pipeline_bind_map *map);
667
668 struct anv_device {
669 VK_LOADER_DATA _loader_data;
670
671 VkAllocationCallbacks alloc;
672
673 struct anv_instance * instance;
674 uint32_t chipset_id;
675 struct brw_device_info info;
676 struct isl_device isl_dev;
677 int context_id;
678 int fd;
679 bool can_chain_batches;
680 bool robust_buffer_access;
681
682 struct anv_bo_pool batch_bo_pool;
683
684 struct anv_block_pool dynamic_state_block_pool;
685 struct anv_state_pool dynamic_state_pool;
686
687 struct anv_block_pool instruction_block_pool;
688 struct anv_pipeline_cache default_pipeline_cache;
689
690 struct anv_block_pool surface_state_block_pool;
691 struct anv_state_pool surface_state_pool;
692
693 struct anv_bo workaround_bo;
694
695 struct anv_meta_state meta_state;
696
697 struct anv_state border_colors;
698
699 struct anv_queue queue;
700
701 struct anv_block_pool scratch_block_pool;
702
703 uint32_t default_mocs;
704
705 pthread_mutex_t mutex;
706 };
707
708 void anv_device_get_cache_uuid(void *uuid);
709
710
711 void* anv_gem_mmap(struct anv_device *device,
712 uint32_t gem_handle, uint64_t offset, uint64_t size, uint32_t flags);
713 void anv_gem_munmap(void *p, uint64_t size);
714 uint32_t anv_gem_create(struct anv_device *device, size_t size);
715 void anv_gem_close(struct anv_device *device, uint32_t gem_handle);
716 uint32_t anv_gem_userptr(struct anv_device *device, void *mem, size_t size);
717 int anv_gem_wait(struct anv_device *device, uint32_t gem_handle, int64_t *timeout_ns);
718 int anv_gem_execbuffer(struct anv_device *device,
719 struct drm_i915_gem_execbuffer2 *execbuf);
720 int anv_gem_set_tiling(struct anv_device *device, uint32_t gem_handle,
721 uint32_t stride, uint32_t tiling);
722 int anv_gem_create_context(struct anv_device *device);
723 int anv_gem_destroy_context(struct anv_device *device, int context);
724 int anv_gem_get_param(int fd, uint32_t param);
725 bool anv_gem_get_bit6_swizzle(int fd, uint32_t tiling);
726 int anv_gem_get_aperture(int fd, uint64_t *size);
727 int anv_gem_handle_to_fd(struct anv_device *device, uint32_t gem_handle);
728 uint32_t anv_gem_fd_to_handle(struct anv_device *device, int fd);
729 int anv_gem_set_caching(struct anv_device *device, uint32_t gem_handle, uint32_t caching);
730 int anv_gem_set_domain(struct anv_device *device, uint32_t gem_handle,
731 uint32_t read_domains, uint32_t write_domain);
732
733 VkResult anv_bo_init_new(struct anv_bo *bo, struct anv_device *device, uint64_t size);
734
735 struct anv_reloc_list {
736 size_t num_relocs;
737 size_t array_length;
738 struct drm_i915_gem_relocation_entry * relocs;
739 struct anv_bo ** reloc_bos;
740 };
741
742 VkResult anv_reloc_list_init(struct anv_reloc_list *list,
743 const VkAllocationCallbacks *alloc);
744 void anv_reloc_list_finish(struct anv_reloc_list *list,
745 const VkAllocationCallbacks *alloc);
746
747 uint64_t anv_reloc_list_add(struct anv_reloc_list *list,
748 const VkAllocationCallbacks *alloc,
749 uint32_t offset, struct anv_bo *target_bo,
750 uint32_t delta);
751
752 struct anv_batch_bo {
753 /* Link in the anv_cmd_buffer.owned_batch_bos list */
754 struct list_head link;
755
756 struct anv_bo bo;
757
758 /* Bytes actually consumed in this batch BO */
759 size_t length;
760
761 /* Last seen surface state block pool bo offset */
762 uint32_t last_ss_pool_bo_offset;
763
764 struct anv_reloc_list relocs;
765 };
766
767 struct anv_batch {
768 const VkAllocationCallbacks * alloc;
769
770 void * start;
771 void * end;
772 void * next;
773
774 struct anv_reloc_list * relocs;
775
776 /* This callback is called (with the associated user data) in the event
777 * that the batch runs out of space.
778 */
779 VkResult (*extend_cb)(struct anv_batch *, void *);
780 void * user_data;
781 };
782
783 void *anv_batch_emit_dwords(struct anv_batch *batch, int num_dwords);
784 void anv_batch_emit_batch(struct anv_batch *batch, struct anv_batch *other);
785 uint64_t anv_batch_emit_reloc(struct anv_batch *batch,
786 void *location, struct anv_bo *bo, uint32_t offset);
787 VkResult anv_device_submit_simple_batch(struct anv_device *device,
788 struct anv_batch *batch);
789
790 struct anv_address {
791 struct anv_bo *bo;
792 uint32_t offset;
793 };
794
795 #define __gen_address_type struct anv_address
796 #define __gen_user_data struct anv_batch
797
798 static inline uint64_t
799 __gen_combine_address(struct anv_batch *batch, void *location,
800 const struct anv_address address, uint32_t delta)
801 {
802 if (address.bo == NULL) {
803 return address.offset + delta;
804 } else {
805 assert(batch->start <= location && location < batch->end);
806
807 return anv_batch_emit_reloc(batch, location, address.bo, address.offset + delta);
808 }
809 }
810
811 /* Wrapper macros needed to work around preprocessor argument issues. In
812 * particular, arguments don't get pre-evaluated if they are concatenated.
813 * This means that, if you pass GENX(3DSTATE_PS) into the emit macro, the
814 * GENX macro won't get evaluated if the emit macro contains "cmd ## foo".
815 * We can work around this easily enough with these helpers.
816 */
817 #define __anv_cmd_length(cmd) cmd ## _length
818 #define __anv_cmd_length_bias(cmd) cmd ## _length_bias
819 #define __anv_cmd_header(cmd) cmd ## _header
820 #define __anv_cmd_pack(cmd) cmd ## _pack
821 #define __anv_reg_num(reg) reg ## _num
822
823 #define anv_pack_struct(dst, struc, ...) do { \
824 struct struc __template = { \
825 __VA_ARGS__ \
826 }; \
827 __anv_cmd_pack(struc)(NULL, dst, &__template); \
828 VG(VALGRIND_CHECK_MEM_IS_DEFINED(dst, __anv_cmd_length(struc) * 4)); \
829 } while (0)
830
831 #define anv_batch_emitn(batch, n, cmd, ...) ({ \
832 void *__dst = anv_batch_emit_dwords(batch, n); \
833 struct cmd __template = { \
834 __anv_cmd_header(cmd), \
835 .DWordLength = n - __anv_cmd_length_bias(cmd), \
836 __VA_ARGS__ \
837 }; \
838 __anv_cmd_pack(cmd)(batch, __dst, &__template); \
839 __dst; \
840 })
841
842 #define anv_batch_emit_merge(batch, dwords0, dwords1) \
843 do { \
844 uint32_t *dw; \
845 \
846 static_assert(ARRAY_SIZE(dwords0) == ARRAY_SIZE(dwords1), "mismatch merge"); \
847 dw = anv_batch_emit_dwords((batch), ARRAY_SIZE(dwords0)); \
848 for (uint32_t i = 0; i < ARRAY_SIZE(dwords0); i++) \
849 dw[i] = (dwords0)[i] | (dwords1)[i]; \
850 VG(VALGRIND_CHECK_MEM_IS_DEFINED(dw, ARRAY_SIZE(dwords0) * 4));\
851 } while (0)
852
853 #define anv_batch_emit(batch, cmd, name) \
854 for (struct cmd name = { __anv_cmd_header(cmd) }, \
855 *_dst = anv_batch_emit_dwords(batch, __anv_cmd_length(cmd)); \
856 __builtin_expect(_dst != NULL, 1); \
857 ({ __anv_cmd_pack(cmd)(batch, _dst, &name); \
858 VG(VALGRIND_CHECK_MEM_IS_DEFINED(_dst, __anv_cmd_length(cmd) * 4)); \
859 _dst = NULL; \
860 }))
861
862 #define anv_state_pool_emit(pool, cmd, align, ...) ({ \
863 const uint32_t __size = __anv_cmd_length(cmd) * 4; \
864 struct anv_state __state = \
865 anv_state_pool_alloc((pool), __size, align); \
866 struct cmd __template = { \
867 __VA_ARGS__ \
868 }; \
869 __anv_cmd_pack(cmd)(NULL, __state.map, &__template); \
870 VG(VALGRIND_CHECK_MEM_IS_DEFINED(__state.map, __anv_cmd_length(cmd) * 4)); \
871 if (!(pool)->block_pool->device->info.has_llc) \
872 anv_state_clflush(__state); \
873 __state; \
874 })
875
876 #define GEN7_MOCS (struct GEN7_MEMORY_OBJECT_CONTROL_STATE) { \
877 .GraphicsDataTypeGFDT = 0, \
878 .LLCCacheabilityControlLLCCC = 0, \
879 .L3CacheabilityControlL3CC = 1, \
880 }
881
882 #define GEN75_MOCS (struct GEN75_MEMORY_OBJECT_CONTROL_STATE) { \
883 .LLCeLLCCacheabilityControlLLCCC = 0, \
884 .L3CacheabilityControlL3CC = 1, \
885 }
886
887 #define GEN8_MOCS (struct GEN8_MEMORY_OBJECT_CONTROL_STATE) { \
888 .MemoryTypeLLCeLLCCacheabilityControl = WB, \
889 .TargetCache = L3DefertoPATforLLCeLLCselection, \
890 .AgeforQUADLRU = 0 \
891 }
892
893 /* Skylake: MOCS is now an index into an array of 62 different caching
894 * configurations programmed by the kernel.
895 */
896
897 #define GEN9_MOCS (struct GEN9_MEMORY_OBJECT_CONTROL_STATE) { \
898 /* TC=LLC/eLLC, LeCC=WB, LRUM=3, L3CC=WB */ \
899 .IndextoMOCSTables = 2 \
900 }
901
902 #define GEN9_MOCS_PTE { \
903 /* TC=LLC/eLLC, LeCC=WB, LRUM=3, L3CC=WB */ \
904 .IndextoMOCSTables = 1 \
905 }
906
907 struct anv_device_memory {
908 struct anv_bo bo;
909 uint32_t type_index;
910 VkDeviceSize map_size;
911 void * map;
912 };
913
914 /**
915 * Header for Vertex URB Entry (VUE)
916 */
917 struct anv_vue_header {
918 uint32_t Reserved;
919 uint32_t RTAIndex; /* RenderTargetArrayIndex */
920 uint32_t ViewportIndex;
921 float PointWidth;
922 };
923
924 struct anv_descriptor_set_binding_layout {
925 /* Number of array elements in this binding */
926 uint16_t array_size;
927
928 /* Index into the flattend descriptor set */
929 uint16_t descriptor_index;
930
931 /* Index into the dynamic state array for a dynamic buffer */
932 int16_t dynamic_offset_index;
933
934 /* Index into the descriptor set buffer views */
935 int16_t buffer_index;
936
937 struct {
938 /* Index into the binding table for the associated surface */
939 int16_t surface_index;
940
941 /* Index into the sampler table for the associated sampler */
942 int16_t sampler_index;
943
944 /* Index into the image table for the associated image */
945 int16_t image_index;
946 } stage[MESA_SHADER_STAGES];
947
948 /* Immutable samplers (or NULL if no immutable samplers) */
949 struct anv_sampler **immutable_samplers;
950 };
951
952 struct anv_descriptor_set_layout {
953 /* Number of bindings in this descriptor set */
954 uint16_t binding_count;
955
956 /* Total size of the descriptor set with room for all array entries */
957 uint16_t size;
958
959 /* Shader stages affected by this descriptor set */
960 uint16_t shader_stages;
961
962 /* Number of buffers in this descriptor set */
963 uint16_t buffer_count;
964
965 /* Number of dynamic offsets used by this descriptor set */
966 uint16_t dynamic_offset_count;
967
968 /* Bindings in this descriptor set */
969 struct anv_descriptor_set_binding_layout binding[0];
970 };
971
972 struct anv_descriptor {
973 VkDescriptorType type;
974
975 union {
976 struct {
977 struct anv_image_view *image_view;
978 struct anv_sampler *sampler;
979 };
980
981 struct anv_buffer_view *buffer_view;
982 };
983 };
984
985 struct anv_descriptor_set {
986 const struct anv_descriptor_set_layout *layout;
987 uint32_t size;
988 uint32_t buffer_count;
989 struct anv_buffer_view *buffer_views;
990 struct anv_descriptor descriptors[0];
991 };
992
993 struct anv_descriptor_pool {
994 uint32_t size;
995 uint32_t next;
996 uint32_t free_list;
997
998 struct anv_state_stream surface_state_stream;
999 void *surface_state_free_list;
1000
1001 char data[0];
1002 };
1003
1004 VkResult
1005 anv_descriptor_set_create(struct anv_device *device,
1006 struct anv_descriptor_pool *pool,
1007 const struct anv_descriptor_set_layout *layout,
1008 struct anv_descriptor_set **out_set);
1009
1010 void
1011 anv_descriptor_set_destroy(struct anv_device *device,
1012 struct anv_descriptor_pool *pool,
1013 struct anv_descriptor_set *set);
1014
1015 #define ANV_DESCRIPTOR_SET_COLOR_ATTACHMENTS UINT16_MAX
1016
1017 struct anv_pipeline_binding {
1018 /* The descriptor set this surface corresponds to. The special value of
1019 * ANV_DESCRIPTOR_SET_COLOR_ATTACHMENTS indicates that the offset refers
1020 * to a color attachment and not a regular descriptor.
1021 */
1022 uint16_t set;
1023
1024 /* Offset into the descriptor set or attachment list. */
1025 uint16_t offset;
1026 };
1027
1028 struct anv_pipeline_layout {
1029 struct {
1030 struct anv_descriptor_set_layout *layout;
1031 uint32_t dynamic_offset_start;
1032 } set[MAX_SETS];
1033
1034 uint32_t num_sets;
1035
1036 struct {
1037 bool has_dynamic_offsets;
1038 } stage[MESA_SHADER_STAGES];
1039 };
1040
1041 struct anv_buffer {
1042 struct anv_device * device;
1043 VkDeviceSize size;
1044
1045 VkBufferUsageFlags usage;
1046
1047 /* Set when bound */
1048 struct anv_bo * bo;
1049 VkDeviceSize offset;
1050 };
1051
1052 enum anv_cmd_dirty_bits {
1053 ANV_CMD_DIRTY_DYNAMIC_VIEWPORT = 1 << 0, /* VK_DYNAMIC_STATE_VIEWPORT */
1054 ANV_CMD_DIRTY_DYNAMIC_SCISSOR = 1 << 1, /* VK_DYNAMIC_STATE_SCISSOR */
1055 ANV_CMD_DIRTY_DYNAMIC_LINE_WIDTH = 1 << 2, /* VK_DYNAMIC_STATE_LINE_WIDTH */
1056 ANV_CMD_DIRTY_DYNAMIC_DEPTH_BIAS = 1 << 3, /* VK_DYNAMIC_STATE_DEPTH_BIAS */
1057 ANV_CMD_DIRTY_DYNAMIC_BLEND_CONSTANTS = 1 << 4, /* VK_DYNAMIC_STATE_BLEND_CONSTANTS */
1058 ANV_CMD_DIRTY_DYNAMIC_DEPTH_BOUNDS = 1 << 5, /* VK_DYNAMIC_STATE_DEPTH_BOUNDS */
1059 ANV_CMD_DIRTY_DYNAMIC_STENCIL_COMPARE_MASK = 1 << 6, /* VK_DYNAMIC_STATE_STENCIL_COMPARE_MASK */
1060 ANV_CMD_DIRTY_DYNAMIC_STENCIL_WRITE_MASK = 1 << 7, /* VK_DYNAMIC_STATE_STENCIL_WRITE_MASK */
1061 ANV_CMD_DIRTY_DYNAMIC_STENCIL_REFERENCE = 1 << 8, /* VK_DYNAMIC_STATE_STENCIL_REFERENCE */
1062 ANV_CMD_DIRTY_DYNAMIC_ALL = (1 << 9) - 1,
1063 ANV_CMD_DIRTY_PIPELINE = 1 << 9,
1064 ANV_CMD_DIRTY_INDEX_BUFFER = 1 << 10,
1065 ANV_CMD_DIRTY_RENDER_TARGETS = 1 << 11,
1066 };
1067 typedef uint32_t anv_cmd_dirty_mask_t;
1068
1069 enum anv_pipe_bits {
1070 ANV_PIPE_DEPTH_CACHE_FLUSH_BIT = (1 << 0),
1071 ANV_PIPE_STALL_AT_SCOREBOARD_BIT = (1 << 1),
1072 ANV_PIPE_STATE_CACHE_INVALIDATE_BIT = (1 << 2),
1073 ANV_PIPE_CONSTANT_CACHE_INVALIDATE_BIT = (1 << 3),
1074 ANV_PIPE_VF_CACHE_INVALIDATE_BIT = (1 << 4),
1075 ANV_PIPE_DATA_CACHE_FLUSH_BIT = (1 << 5),
1076 ANV_PIPE_TEXTURE_CACHE_INVALIDATE_BIT = (1 << 10),
1077 ANV_PIPE_INSTRUCTION_CACHE_INVALIDATE_BIT = (1 << 11),
1078 ANV_PIPE_RENDER_TARGET_CACHE_FLUSH_BIT = (1 << 12),
1079 ANV_PIPE_DEPTH_STALL_BIT = (1 << 13),
1080 ANV_PIPE_CS_STALL_BIT = (1 << 20),
1081
1082 /* This bit does not exist directly in PIPE_CONTROL. Instead it means that
1083 * a flush has happened but not a CS stall. The next time we do any sort
1084 * of invalidation we need to insert a CS stall at that time. Otherwise,
1085 * we would have to CS stall on every flush which could be bad.
1086 */
1087 ANV_PIPE_NEEDS_CS_STALL_BIT = (1 << 21),
1088 };
1089
1090 #define ANV_PIPE_FLUSH_BITS ( \
1091 ANV_PIPE_DEPTH_CACHE_FLUSH_BIT | \
1092 ANV_PIPE_DATA_CACHE_FLUSH_BIT | \
1093 ANV_PIPE_RENDER_TARGET_CACHE_FLUSH_BIT)
1094
1095 #define ANV_PIPE_STALL_BITS ( \
1096 ANV_PIPE_STALL_AT_SCOREBOARD_BIT | \
1097 ANV_PIPE_DEPTH_STALL_BIT | \
1098 ANV_PIPE_CS_STALL_BIT)
1099
1100 #define ANV_PIPE_INVALIDATE_BITS ( \
1101 ANV_PIPE_STATE_CACHE_INVALIDATE_BIT | \
1102 ANV_PIPE_CONSTANT_CACHE_INVALIDATE_BIT | \
1103 ANV_PIPE_VF_CACHE_INVALIDATE_BIT | \
1104 ANV_PIPE_DATA_CACHE_FLUSH_BIT | \
1105 ANV_PIPE_TEXTURE_CACHE_INVALIDATE_BIT | \
1106 ANV_PIPE_INSTRUCTION_CACHE_INVALIDATE_BIT)
1107
1108 struct anv_vertex_binding {
1109 struct anv_buffer * buffer;
1110 VkDeviceSize offset;
1111 };
1112
1113 struct anv_push_constants {
1114 /* Current allocated size of this push constants data structure.
1115 * Because a decent chunk of it may not be used (images on SKL, for
1116 * instance), we won't actually allocate the entire structure up-front.
1117 */
1118 uint32_t size;
1119
1120 /* Push constant data provided by the client through vkPushConstants */
1121 uint8_t client_data[MAX_PUSH_CONSTANTS_SIZE];
1122
1123 /* Our hardware only provides zero-based vertex and instance id so, in
1124 * order to satisfy the vulkan requirements, we may have to push one or
1125 * both of these into the shader.
1126 */
1127 uint32_t base_vertex;
1128 uint32_t base_instance;
1129
1130 /* Offsets and ranges for dynamically bound buffers */
1131 struct {
1132 uint32_t offset;
1133 uint32_t range;
1134 } dynamic[MAX_DYNAMIC_BUFFERS];
1135
1136 /* Image data for image_load_store on pre-SKL */
1137 struct brw_image_param images[MAX_IMAGES];
1138 };
1139
1140 struct anv_dynamic_state {
1141 struct {
1142 uint32_t count;
1143 VkViewport viewports[MAX_VIEWPORTS];
1144 } viewport;
1145
1146 struct {
1147 uint32_t count;
1148 VkRect2D scissors[MAX_SCISSORS];
1149 } scissor;
1150
1151 float line_width;
1152
1153 struct {
1154 float bias;
1155 float clamp;
1156 float slope;
1157 } depth_bias;
1158
1159 float blend_constants[4];
1160
1161 struct {
1162 float min;
1163 float max;
1164 } depth_bounds;
1165
1166 struct {
1167 uint32_t front;
1168 uint32_t back;
1169 } stencil_compare_mask;
1170
1171 struct {
1172 uint32_t front;
1173 uint32_t back;
1174 } stencil_write_mask;
1175
1176 struct {
1177 uint32_t front;
1178 uint32_t back;
1179 } stencil_reference;
1180 };
1181
1182 extern const struct anv_dynamic_state default_dynamic_state;
1183
1184 void anv_dynamic_state_copy(struct anv_dynamic_state *dest,
1185 const struct anv_dynamic_state *src,
1186 uint32_t copy_mask);
1187
1188 /**
1189 * Attachment state when recording a renderpass instance.
1190 *
1191 * The clear value is valid only if there exists a pending clear.
1192 */
1193 struct anv_attachment_state {
1194 VkImageAspectFlags pending_clear_aspects;
1195 VkClearValue clear_value;
1196 };
1197
1198 /** State required while building cmd buffer */
1199 struct anv_cmd_state {
1200 /* PIPELINE_SELECT.PipelineSelection */
1201 uint32_t current_pipeline;
1202 const struct anv_l3_config * current_l3_config;
1203 uint32_t vb_dirty;
1204 anv_cmd_dirty_mask_t dirty;
1205 anv_cmd_dirty_mask_t compute_dirty;
1206 enum anv_pipe_bits pending_pipe_bits;
1207 uint32_t num_workgroups_offset;
1208 struct anv_bo *num_workgroups_bo;
1209 VkShaderStageFlags descriptors_dirty;
1210 VkShaderStageFlags push_constants_dirty;
1211 uint32_t scratch_size;
1212 struct anv_pipeline * pipeline;
1213 struct anv_pipeline * compute_pipeline;
1214 struct anv_framebuffer * framebuffer;
1215 struct anv_render_pass * pass;
1216 struct anv_subpass * subpass;
1217 VkRect2D render_area;
1218 uint32_t restart_index;
1219 struct anv_vertex_binding vertex_bindings[MAX_VBS];
1220 struct anv_descriptor_set * descriptors[MAX_SETS];
1221 VkShaderStageFlags push_constant_stages;
1222 struct anv_push_constants * push_constants[MESA_SHADER_STAGES];
1223 struct anv_state binding_tables[MESA_SHADER_STAGES];
1224 struct anv_state samplers[MESA_SHADER_STAGES];
1225 struct anv_dynamic_state dynamic;
1226 bool need_query_wa;
1227
1228 /**
1229 * Array length is anv_cmd_state::pass::attachment_count. Array content is
1230 * valid only when recording a render pass instance.
1231 */
1232 struct anv_attachment_state * attachments;
1233
1234 struct {
1235 struct anv_buffer * index_buffer;
1236 uint32_t index_type; /**< 3DSTATE_INDEX_BUFFER.IndexFormat */
1237 uint32_t index_offset;
1238 } gen7;
1239 };
1240
1241 struct anv_cmd_pool {
1242 VkAllocationCallbacks alloc;
1243 struct list_head cmd_buffers;
1244 };
1245
1246 #define ANV_CMD_BUFFER_BATCH_SIZE 8192
1247
1248 enum anv_cmd_buffer_exec_mode {
1249 ANV_CMD_BUFFER_EXEC_MODE_PRIMARY,
1250 ANV_CMD_BUFFER_EXEC_MODE_EMIT,
1251 ANV_CMD_BUFFER_EXEC_MODE_GROW_AND_EMIT,
1252 ANV_CMD_BUFFER_EXEC_MODE_CHAIN,
1253 ANV_CMD_BUFFER_EXEC_MODE_COPY_AND_CHAIN,
1254 };
1255
1256 struct anv_cmd_buffer {
1257 VK_LOADER_DATA _loader_data;
1258
1259 struct anv_device * device;
1260
1261 struct anv_cmd_pool * pool;
1262 struct list_head pool_link;
1263
1264 struct anv_batch batch;
1265
1266 /* Fields required for the actual chain of anv_batch_bo's.
1267 *
1268 * These fields are initialized by anv_cmd_buffer_init_batch_bo_chain().
1269 */
1270 struct list_head batch_bos;
1271 enum anv_cmd_buffer_exec_mode exec_mode;
1272
1273 /* A vector of anv_batch_bo pointers for every batch or surface buffer
1274 * referenced by this command buffer
1275 *
1276 * initialized by anv_cmd_buffer_init_batch_bo_chain()
1277 */
1278 struct anv_vector seen_bbos;
1279
1280 /* A vector of int32_t's for every block of binding tables.
1281 *
1282 * initialized by anv_cmd_buffer_init_batch_bo_chain()
1283 */
1284 struct anv_vector bt_blocks;
1285 uint32_t bt_next;
1286 struct anv_reloc_list surface_relocs;
1287
1288 /* Information needed for execbuf
1289 *
1290 * These fields are generated by anv_cmd_buffer_prepare_execbuf().
1291 */
1292 struct {
1293 struct drm_i915_gem_execbuffer2 execbuf;
1294
1295 struct drm_i915_gem_exec_object2 * objects;
1296 uint32_t bo_count;
1297 struct anv_bo ** bos;
1298
1299 /* Allocated length of the 'objects' and 'bos' arrays */
1300 uint32_t array_length;
1301
1302 bool need_reloc;
1303 } execbuf2;
1304
1305 /* Serial for tracking buffer completion */
1306 uint32_t serial;
1307
1308 /* Stream objects for storing temporary data */
1309 struct anv_state_stream surface_state_stream;
1310 struct anv_state_stream dynamic_state_stream;
1311
1312 VkCommandBufferUsageFlags usage_flags;
1313 VkCommandBufferLevel level;
1314
1315 struct anv_cmd_state state;
1316 };
1317
1318 VkResult anv_cmd_buffer_init_batch_bo_chain(struct anv_cmd_buffer *cmd_buffer);
1319 void anv_cmd_buffer_fini_batch_bo_chain(struct anv_cmd_buffer *cmd_buffer);
1320 void anv_cmd_buffer_reset_batch_bo_chain(struct anv_cmd_buffer *cmd_buffer);
1321 void anv_cmd_buffer_end_batch_buffer(struct anv_cmd_buffer *cmd_buffer);
1322 void anv_cmd_buffer_add_secondary(struct anv_cmd_buffer *primary,
1323 struct anv_cmd_buffer *secondary);
1324 void anv_cmd_buffer_prepare_execbuf(struct anv_cmd_buffer *cmd_buffer);
1325
1326 VkResult anv_cmd_buffer_emit_binding_table(struct anv_cmd_buffer *cmd_buffer,
1327 unsigned stage, struct anv_state *bt_state);
1328 VkResult anv_cmd_buffer_emit_samplers(struct anv_cmd_buffer *cmd_buffer,
1329 unsigned stage, struct anv_state *state);
1330 uint32_t gen7_cmd_buffer_flush_descriptor_sets(struct anv_cmd_buffer *cmd_buffer);
1331 void gen7_cmd_buffer_emit_descriptor_pointers(struct anv_cmd_buffer *cmd_buffer,
1332 uint32_t stages);
1333
1334 struct anv_state anv_cmd_buffer_emit_dynamic(struct anv_cmd_buffer *cmd_buffer,
1335 const void *data, uint32_t size, uint32_t alignment);
1336 struct anv_state anv_cmd_buffer_merge_dynamic(struct anv_cmd_buffer *cmd_buffer,
1337 uint32_t *a, uint32_t *b,
1338 uint32_t dwords, uint32_t alignment);
1339
1340 struct anv_address
1341 anv_cmd_buffer_surface_base_address(struct anv_cmd_buffer *cmd_buffer);
1342 struct anv_state
1343 anv_cmd_buffer_alloc_binding_table(struct anv_cmd_buffer *cmd_buffer,
1344 uint32_t entries, uint32_t *state_offset);
1345 struct anv_state
1346 anv_cmd_buffer_alloc_surface_state(struct anv_cmd_buffer *cmd_buffer);
1347 struct anv_state
1348 anv_cmd_buffer_alloc_dynamic_state(struct anv_cmd_buffer *cmd_buffer,
1349 uint32_t size, uint32_t alignment);
1350
1351 VkResult
1352 anv_cmd_buffer_new_binding_table_block(struct anv_cmd_buffer *cmd_buffer);
1353
1354 void gen8_cmd_buffer_emit_viewport(struct anv_cmd_buffer *cmd_buffer);
1355 void gen7_cmd_buffer_emit_scissor(struct anv_cmd_buffer *cmd_buffer);
1356
1357 void anv_cmd_buffer_emit_state_base_address(struct anv_cmd_buffer *cmd_buffer);
1358
1359 void anv_cmd_state_setup_attachments(struct anv_cmd_buffer *cmd_buffer,
1360 const VkRenderPassBeginInfo *info);
1361
1362 void anv_cmd_buffer_set_subpass(struct anv_cmd_buffer *cmd_buffer,
1363 struct anv_subpass *subpass);
1364
1365 struct anv_state
1366 anv_cmd_buffer_push_constants(struct anv_cmd_buffer *cmd_buffer,
1367 gl_shader_stage stage);
1368 struct anv_state
1369 anv_cmd_buffer_cs_push_constants(struct anv_cmd_buffer *cmd_buffer);
1370
1371 void anv_cmd_buffer_clear_subpass(struct anv_cmd_buffer *cmd_buffer);
1372 void anv_cmd_buffer_resolve_subpass(struct anv_cmd_buffer *cmd_buffer);
1373
1374 const struct anv_image_view *
1375 anv_cmd_buffer_get_depth_stencil_view(const struct anv_cmd_buffer *cmd_buffer);
1376
1377 void anv_cmd_buffer_dump(struct anv_cmd_buffer *cmd_buffer);
1378
1379 struct anv_fence {
1380 struct anv_bo bo;
1381 struct drm_i915_gem_execbuffer2 execbuf;
1382 struct drm_i915_gem_exec_object2 exec2_objects[1];
1383 bool ready;
1384 };
1385
1386 struct anv_event {
1387 uint64_t semaphore;
1388 struct anv_state state;
1389 };
1390
1391 struct nir_shader;
1392
1393 struct anv_shader_module {
1394 struct nir_shader * nir;
1395
1396 unsigned char sha1[20];
1397 uint32_t size;
1398 char data[0];
1399 };
1400
1401 void anv_hash_shader(unsigned char *hash, const void *key, size_t key_size,
1402 struct anv_shader_module *module,
1403 const char *entrypoint,
1404 const VkSpecializationInfo *spec_info);
1405
1406 static inline gl_shader_stage
1407 vk_to_mesa_shader_stage(VkShaderStageFlagBits vk_stage)
1408 {
1409 assert(__builtin_popcount(vk_stage) == 1);
1410 return ffs(vk_stage) - 1;
1411 }
1412
1413 static inline VkShaderStageFlagBits
1414 mesa_to_vk_shader_stage(gl_shader_stage mesa_stage)
1415 {
1416 return (1 << mesa_stage);
1417 }
1418
1419 #define ANV_STAGE_MASK ((1 << MESA_SHADER_STAGES) - 1)
1420
1421 #define anv_foreach_stage(stage, stage_bits) \
1422 for (gl_shader_stage stage, \
1423 __tmp = (gl_shader_stage)((stage_bits) & ANV_STAGE_MASK); \
1424 stage = __builtin_ffs(__tmp) - 1, __tmp; \
1425 __tmp &= ~(1 << (stage)))
1426
1427 struct anv_pipeline_bind_map {
1428 uint32_t surface_count;
1429 uint32_t sampler_count;
1430 uint32_t image_count;
1431 uint32_t attachment_count;
1432
1433 struct anv_pipeline_binding * surface_to_descriptor;
1434 struct anv_pipeline_binding * sampler_to_descriptor;
1435 uint32_t * surface_to_attachment;
1436 };
1437
1438 struct anv_pipeline {
1439 struct anv_device * device;
1440 struct anv_batch batch;
1441 uint32_t batch_data[512];
1442 struct anv_reloc_list batch_relocs;
1443 uint32_t dynamic_state_mask;
1444 struct anv_dynamic_state dynamic_state;
1445
1446 struct anv_pipeline_layout * layout;
1447 struct anv_pipeline_bind_map bindings[MESA_SHADER_STAGES];
1448
1449 bool use_repclear;
1450 bool needs_data_cache;
1451
1452 const struct brw_stage_prog_data * prog_data[MESA_SHADER_STAGES];
1453 uint32_t scratch_start[MESA_SHADER_STAGES];
1454 uint32_t total_scratch;
1455 struct {
1456 uint32_t start[MESA_SHADER_GEOMETRY + 1];
1457 uint32_t size[MESA_SHADER_GEOMETRY + 1];
1458 uint32_t entries[MESA_SHADER_GEOMETRY + 1];
1459 const struct anv_l3_config * l3_config;
1460 uint32_t total_size;
1461 } urb;
1462
1463 VkShaderStageFlags active_stages;
1464 struct anv_state blend_state;
1465 uint32_t vs_simd8;
1466 uint32_t vs_vec4;
1467 uint32_t ps_ksp0;
1468 uint32_t gs_kernel;
1469 uint32_t cs_simd;
1470
1471 uint32_t vb_used;
1472 uint32_t binding_stride[MAX_VBS];
1473 bool instancing_enable[MAX_VBS];
1474 bool primitive_restart;
1475 uint32_t topology;
1476
1477 uint32_t cs_right_mask;
1478
1479 struct {
1480 uint32_t sf[7];
1481 uint32_t depth_stencil_state[3];
1482 } gen7;
1483
1484 struct {
1485 uint32_t sf[4];
1486 uint32_t raster[5];
1487 uint32_t wm_depth_stencil[3];
1488 } gen8;
1489
1490 struct {
1491 uint32_t wm_depth_stencil[4];
1492 } gen9;
1493 };
1494
1495 static inline const struct brw_vs_prog_data *
1496 get_vs_prog_data(struct anv_pipeline *pipeline)
1497 {
1498 return (const struct brw_vs_prog_data *) pipeline->prog_data[MESA_SHADER_VERTEX];
1499 }
1500
1501 static inline const struct brw_gs_prog_data *
1502 get_gs_prog_data(struct anv_pipeline *pipeline)
1503 {
1504 return (const struct brw_gs_prog_data *) pipeline->prog_data[MESA_SHADER_GEOMETRY];
1505 }
1506
1507 static inline const struct brw_wm_prog_data *
1508 get_wm_prog_data(struct anv_pipeline *pipeline)
1509 {
1510 return (const struct brw_wm_prog_data *) pipeline->prog_data[MESA_SHADER_FRAGMENT];
1511 }
1512
1513 static inline const struct brw_cs_prog_data *
1514 get_cs_prog_data(struct anv_pipeline *pipeline)
1515 {
1516 return (const struct brw_cs_prog_data *) pipeline->prog_data[MESA_SHADER_COMPUTE];
1517 }
1518
1519 struct anv_graphics_pipeline_create_info {
1520 /**
1521 * If non-negative, overrides the color attachment count of the pipeline's
1522 * subpass.
1523 */
1524 int8_t color_attachment_count;
1525
1526 bool use_repclear;
1527 bool disable_vs;
1528 bool use_rectlist;
1529 };
1530
1531 VkResult
1532 anv_pipeline_init(struct anv_pipeline *pipeline, struct anv_device *device,
1533 struct anv_pipeline_cache *cache,
1534 const VkGraphicsPipelineCreateInfo *pCreateInfo,
1535 const struct anv_graphics_pipeline_create_info *extra,
1536 const VkAllocationCallbacks *alloc);
1537
1538 VkResult
1539 anv_pipeline_compile_cs(struct anv_pipeline *pipeline,
1540 struct anv_pipeline_cache *cache,
1541 const VkComputePipelineCreateInfo *info,
1542 struct anv_shader_module *module,
1543 const char *entrypoint,
1544 const VkSpecializationInfo *spec_info);
1545
1546 VkResult
1547 anv_graphics_pipeline_create(VkDevice device,
1548 VkPipelineCache cache,
1549 const VkGraphicsPipelineCreateInfo *pCreateInfo,
1550 const struct anv_graphics_pipeline_create_info *extra,
1551 const VkAllocationCallbacks *alloc,
1552 VkPipeline *pPipeline);
1553
1554 struct anv_format_swizzle {
1555 enum isl_channel_select r:4;
1556 enum isl_channel_select g:4;
1557 enum isl_channel_select b:4;
1558 enum isl_channel_select a:4;
1559 };
1560
1561 struct anv_format {
1562 enum isl_format isl_format:16;
1563 struct anv_format_swizzle swizzle;
1564 };
1565
1566 struct anv_format
1567 anv_get_format(const struct brw_device_info *devinfo, VkFormat format,
1568 VkImageAspectFlags aspect, VkImageTiling tiling);
1569
1570 static inline enum isl_format
1571 anv_get_isl_format(const struct brw_device_info *devinfo, VkFormat vk_format,
1572 VkImageAspectFlags aspect, VkImageTiling tiling)
1573 {
1574 return anv_get_format(devinfo, vk_format, aspect, tiling).isl_format;
1575 }
1576
1577 void
1578 anv_compute_urb_partition(struct anv_pipeline *pipeline);
1579
1580 void
1581 anv_setup_pipeline_l3_config(struct anv_pipeline *pipeline);
1582
1583 /**
1584 * Subsurface of an anv_image.
1585 */
1586 struct anv_surface {
1587 struct isl_surf isl;
1588
1589 /**
1590 * Offset from VkImage's base address, as bound by vkBindImageMemory().
1591 */
1592 uint32_t offset;
1593 };
1594
1595 struct anv_image {
1596 VkImageType type;
1597 /* The original VkFormat provided by the client. This may not match any
1598 * of the actual surface formats.
1599 */
1600 VkFormat vk_format;
1601 VkImageAspectFlags aspects;
1602 VkExtent3D extent;
1603 uint32_t levels;
1604 uint32_t array_size;
1605 uint32_t samples; /**< VkImageCreateInfo::samples */
1606 VkImageUsageFlags usage; /**< Superset of VkImageCreateInfo::usage. */
1607 VkImageTiling tiling; /** VkImageCreateInfo::tiling */
1608
1609 VkDeviceSize size;
1610 uint32_t alignment;
1611
1612 /* Set when bound */
1613 struct anv_bo *bo;
1614 VkDeviceSize offset;
1615
1616 /**
1617 * Image subsurfaces
1618 *
1619 * For each foo, anv_image::foo_surface is valid if and only if
1620 * anv_image::aspects has a foo aspect.
1621 *
1622 * The hardware requires that the depth buffer and stencil buffer be
1623 * separate surfaces. From Vulkan's perspective, though, depth and stencil
1624 * reside in the same VkImage. To satisfy both the hardware and Vulkan, we
1625 * allocate the depth and stencil buffers as separate surfaces in the same
1626 * bo.
1627 */
1628 union {
1629 struct anv_surface color_surface;
1630
1631 struct {
1632 struct anv_surface depth_surface;
1633 struct anv_surface stencil_surface;
1634 };
1635 };
1636 };
1637
1638 static inline uint32_t
1639 anv_get_layerCount(const struct anv_image *image,
1640 const VkImageSubresourceRange *range)
1641 {
1642 return range->layerCount == VK_REMAINING_ARRAY_LAYERS ?
1643 image->array_size - range->baseArrayLayer : range->layerCount;
1644 }
1645
1646 static inline uint32_t
1647 anv_get_levelCount(const struct anv_image *image,
1648 const VkImageSubresourceRange *range)
1649 {
1650 return range->levelCount == VK_REMAINING_MIP_LEVELS ?
1651 image->levels - range->baseMipLevel : range->levelCount;
1652 }
1653
1654
1655 struct anv_image_view {
1656 const struct anv_image *image; /**< VkImageViewCreateInfo::image */
1657 struct anv_bo *bo;
1658 uint32_t offset; /**< Offset into bo. */
1659
1660 VkImageAspectFlags aspect_mask;
1661 VkFormat vk_format;
1662 uint32_t base_layer;
1663 uint32_t base_mip;
1664 VkExtent3D extent; /**< Extent of VkImageViewCreateInfo::baseMipLevel. */
1665
1666 /** RENDER_SURFACE_STATE when using image as a color render target. */
1667 struct anv_state color_rt_surface_state;
1668
1669 /** RENDER_SURFACE_STATE when using image as a sampler surface. */
1670 struct anv_state sampler_surface_state;
1671
1672 /** RENDER_SURFACE_STATE when using image as a storage image. */
1673 struct anv_state storage_surface_state;
1674
1675 struct brw_image_param storage_image_param;
1676 };
1677
1678 struct anv_image_create_info {
1679 const VkImageCreateInfo *vk_info;
1680 isl_tiling_flags_t isl_tiling_flags;
1681 uint32_t stride;
1682 };
1683
1684 VkResult anv_image_create(VkDevice _device,
1685 const struct anv_image_create_info *info,
1686 const VkAllocationCallbacks* alloc,
1687 VkImage *pImage);
1688
1689 struct anv_surface *
1690 anv_image_get_surface_for_aspect_mask(struct anv_image *image,
1691 VkImageAspectFlags aspect_mask);
1692
1693 void anv_image_view_init(struct anv_image_view *view,
1694 struct anv_device *device,
1695 const VkImageViewCreateInfo* pCreateInfo,
1696 struct anv_cmd_buffer *cmd_buffer,
1697 VkImageUsageFlags usage_mask);
1698
1699 struct anv_buffer_view {
1700 enum isl_format format; /**< VkBufferViewCreateInfo::format */
1701 struct anv_bo *bo;
1702 uint32_t offset; /**< Offset into bo. */
1703 uint64_t range; /**< VkBufferViewCreateInfo::range */
1704
1705 struct anv_state surface_state;
1706 struct anv_state storage_surface_state;
1707
1708 struct brw_image_param storage_image_param;
1709 };
1710
1711 void anv_buffer_view_init(struct anv_buffer_view *view,
1712 struct anv_device *device,
1713 const VkBufferViewCreateInfo* pCreateInfo,
1714 struct anv_cmd_buffer *cmd_buffer);
1715
1716 enum isl_format
1717 anv_isl_format_for_descriptor_type(VkDescriptorType type);
1718
1719 static inline struct VkExtent3D
1720 anv_sanitize_image_extent(const VkImageType imageType,
1721 const struct VkExtent3D imageExtent)
1722 {
1723 switch (imageType) {
1724 case VK_IMAGE_TYPE_1D:
1725 return (VkExtent3D) { imageExtent.width, 1, 1 };
1726 case VK_IMAGE_TYPE_2D:
1727 return (VkExtent3D) { imageExtent.width, imageExtent.height, 1 };
1728 case VK_IMAGE_TYPE_3D:
1729 return imageExtent;
1730 default:
1731 unreachable("invalid image type");
1732 }
1733 }
1734
1735 static inline struct VkOffset3D
1736 anv_sanitize_image_offset(const VkImageType imageType,
1737 const struct VkOffset3D imageOffset)
1738 {
1739 switch (imageType) {
1740 case VK_IMAGE_TYPE_1D:
1741 return (VkOffset3D) { imageOffset.x, 0, 0 };
1742 case VK_IMAGE_TYPE_2D:
1743 return (VkOffset3D) { imageOffset.x, imageOffset.y, 0 };
1744 case VK_IMAGE_TYPE_3D:
1745 return imageOffset;
1746 default:
1747 unreachable("invalid image type");
1748 }
1749 }
1750
1751
1752 void anv_fill_buffer_surface_state(struct anv_device *device,
1753 struct anv_state state,
1754 enum isl_format format,
1755 uint32_t offset, uint32_t range,
1756 uint32_t stride);
1757
1758 void anv_image_view_fill_image_param(struct anv_device *device,
1759 struct anv_image_view *view,
1760 struct brw_image_param *param);
1761 void anv_buffer_view_fill_image_param(struct anv_device *device,
1762 struct anv_buffer_view *view,
1763 struct brw_image_param *param);
1764
1765 struct anv_sampler {
1766 uint32_t state[4];
1767 };
1768
1769 struct anv_framebuffer {
1770 uint32_t width;
1771 uint32_t height;
1772 uint32_t layers;
1773
1774 uint32_t attachment_count;
1775 struct anv_image_view * attachments[0];
1776 };
1777
1778 struct anv_subpass {
1779 uint32_t input_count;
1780 uint32_t * input_attachments;
1781 uint32_t color_count;
1782 uint32_t * color_attachments;
1783 uint32_t * resolve_attachments;
1784 uint32_t depth_stencil_attachment;
1785
1786 /** Subpass has at least one resolve attachment */
1787 bool has_resolve;
1788 };
1789
1790 struct anv_render_pass_attachment {
1791 VkFormat format;
1792 uint32_t samples;
1793 VkAttachmentLoadOp load_op;
1794 VkAttachmentLoadOp stencil_load_op;
1795 };
1796
1797 struct anv_render_pass {
1798 uint32_t attachment_count;
1799 uint32_t subpass_count;
1800 uint32_t * subpass_attachments;
1801 struct anv_render_pass_attachment * attachments;
1802 struct anv_subpass subpasses[0];
1803 };
1804
1805 extern struct anv_render_pass anv_meta_dummy_renderpass;
1806
1807 struct anv_query_pool_slot {
1808 uint64_t begin;
1809 uint64_t end;
1810 uint64_t available;
1811 };
1812
1813 struct anv_query_pool {
1814 VkQueryType type;
1815 uint32_t slots;
1816 struct anv_bo bo;
1817 };
1818
1819 VkResult anv_device_init_meta(struct anv_device *device);
1820 void anv_device_finish_meta(struct anv_device *device);
1821
1822 void *anv_lookup_entrypoint(const char *name);
1823
1824 void anv_dump_image_to_ppm(struct anv_device *device,
1825 struct anv_image *image, unsigned miplevel,
1826 unsigned array_layer, const char *filename);
1827
1828 #define ANV_DEFINE_HANDLE_CASTS(__anv_type, __VkType) \
1829 \
1830 static inline struct __anv_type * \
1831 __anv_type ## _from_handle(__VkType _handle) \
1832 { \
1833 return (struct __anv_type *) _handle; \
1834 } \
1835 \
1836 static inline __VkType \
1837 __anv_type ## _to_handle(struct __anv_type *_obj) \
1838 { \
1839 return (__VkType) _obj; \
1840 }
1841
1842 #define ANV_DEFINE_NONDISP_HANDLE_CASTS(__anv_type, __VkType) \
1843 \
1844 static inline struct __anv_type * \
1845 __anv_type ## _from_handle(__VkType _handle) \
1846 { \
1847 return (struct __anv_type *)(uintptr_t) _handle; \
1848 } \
1849 \
1850 static inline __VkType \
1851 __anv_type ## _to_handle(struct __anv_type *_obj) \
1852 { \
1853 return (__VkType)(uintptr_t) _obj; \
1854 }
1855
1856 #define ANV_FROM_HANDLE(__anv_type, __name, __handle) \
1857 struct __anv_type *__name = __anv_type ## _from_handle(__handle)
1858
1859 ANV_DEFINE_HANDLE_CASTS(anv_cmd_buffer, VkCommandBuffer)
1860 ANV_DEFINE_HANDLE_CASTS(anv_device, VkDevice)
1861 ANV_DEFINE_HANDLE_CASTS(anv_instance, VkInstance)
1862 ANV_DEFINE_HANDLE_CASTS(anv_physical_device, VkPhysicalDevice)
1863 ANV_DEFINE_HANDLE_CASTS(anv_queue, VkQueue)
1864
1865 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_cmd_pool, VkCommandPool)
1866 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_buffer, VkBuffer)
1867 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_buffer_view, VkBufferView)
1868 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_descriptor_pool, VkDescriptorPool)
1869 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_descriptor_set, VkDescriptorSet)
1870 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_descriptor_set_layout, VkDescriptorSetLayout)
1871 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_device_memory, VkDeviceMemory)
1872 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_fence, VkFence)
1873 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_event, VkEvent)
1874 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_framebuffer, VkFramebuffer)
1875 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_image, VkImage)
1876 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_image_view, VkImageView);
1877 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_pipeline_cache, VkPipelineCache)
1878 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_pipeline, VkPipeline)
1879 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_pipeline_layout, VkPipelineLayout)
1880 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_query_pool, VkQueryPool)
1881 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_render_pass, VkRenderPass)
1882 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_sampler, VkSampler)
1883 ANV_DEFINE_NONDISP_HANDLE_CASTS(anv_shader_module, VkShaderModule)
1884
1885 #define ANV_DEFINE_STRUCT_CASTS(__anv_type, __VkType) \
1886 \
1887 static inline const __VkType * \
1888 __anv_type ## _to_ ## __VkType(const struct __anv_type *__anv_obj) \
1889 { \
1890 return (const __VkType *) __anv_obj; \
1891 }
1892
1893 #define ANV_COMMON_TO_STRUCT(__VkType, __vk_name, __common_name) \
1894 const __VkType *__vk_name = anv_common_to_ ## __VkType(__common_name)
1895
1896 ANV_DEFINE_STRUCT_CASTS(anv_common, VkMemoryBarrier)
1897 ANV_DEFINE_STRUCT_CASTS(anv_common, VkBufferMemoryBarrier)
1898 ANV_DEFINE_STRUCT_CASTS(anv_common, VkImageMemoryBarrier)
1899
1900 /* Gen-specific function declarations */
1901 #ifdef genX
1902 # include "anv_genX.h"
1903 #else
1904 # define genX(x) gen7_##x
1905 # include "anv_genX.h"
1906 # undef genX
1907 # define genX(x) gen75_##x
1908 # include "anv_genX.h"
1909 # undef genX
1910 # define genX(x) gen8_##x
1911 # include "anv_genX.h"
1912 # undef genX
1913 # define genX(x) gen9_##x
1914 # include "anv_genX.h"
1915 # undef genX
1916 #endif
1917
1918 #ifdef __cplusplus
1919 }
1920 #endif