2 * Copyright © 2014 Intel Corporation
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:
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
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
24 * Connor Abbott (cwabbott0@gmail.com)
29 #include "compiler/shader_enums.h"
30 #include "util/half_float.h"
31 #include "vulkan/vulkan_core.h"
34 #include <inttypes.h> /* for PRIx64 macro */
37 print_tabs(unsigned num_tabs
, FILE *fp
)
39 for (unsigned i
= 0; i
< num_tabs
; i
++)
46 /** map from nir_variable -> printable name */
47 struct hash_table
*ht
;
49 /** set of names used so far for nir_variables */
52 /* an index used to make new non-conflicting names */
56 * Optional table of annotations mapping nir object
57 * (such as instr or var) to message to print.
59 struct hash_table
*annotations
;
63 print_annotation(print_state
*state
, void *obj
)
67 if (!state
->annotations
)
70 struct hash_entry
*entry
= _mesa_hash_table_search(state
->annotations
, obj
);
74 const char *note
= entry
->data
;
75 _mesa_hash_table_remove(state
->annotations
, entry
);
77 fprintf(fp
, "%s\n\n", note
);
81 print_register(nir_register
*reg
, print_state
*state
)
84 if (reg
->name
!= NULL
)
85 fprintf(fp
, "/* %s */ ", reg
->name
);
86 fprintf(fp
, "r%u", reg
->index
);
89 static const char *sizes
[] = { "error", "vec1", "vec2", "vec3", "vec4",
90 "error", "error", "error", "vec8",
91 "error", "error", "error", "error",
92 "error", "error", "error", "vec16"};
95 print_register_decl(nir_register
*reg
, print_state
*state
)
98 fprintf(fp
, "decl_reg %s %u ", sizes
[reg
->num_components
], reg
->bit_size
);
99 print_register(reg
, state
);
100 if (reg
->num_array_elems
!= 0)
101 fprintf(fp
, "[%u]", reg
->num_array_elems
);
106 print_ssa_def(nir_ssa_def
*def
, print_state
*state
)
108 FILE *fp
= state
->fp
;
109 if (def
->name
!= NULL
)
110 fprintf(fp
, "/* %s */ ", def
->name
);
111 fprintf(fp
, "%s %u ssa_%u", sizes
[def
->num_components
], def
->bit_size
,
116 print_ssa_use(nir_ssa_def
*def
, print_state
*state
)
118 FILE *fp
= state
->fp
;
119 if (def
->name
!= NULL
)
120 fprintf(fp
, "/* %s */ ", def
->name
);
121 fprintf(fp
, "ssa_%u", def
->index
);
124 static void print_src(const nir_src
*src
, print_state
*state
);
127 print_reg_src(const nir_reg_src
*src
, print_state
*state
)
129 FILE *fp
= state
->fp
;
130 print_register(src
->reg
, state
);
131 if (src
->reg
->num_array_elems
!= 0) {
132 fprintf(fp
, "[%u", src
->base_offset
);
133 if (src
->indirect
!= NULL
) {
135 print_src(src
->indirect
, state
);
142 print_reg_dest(nir_reg_dest
*dest
, print_state
*state
)
144 FILE *fp
= state
->fp
;
145 print_register(dest
->reg
, state
);
146 if (dest
->reg
->num_array_elems
!= 0) {
147 fprintf(fp
, "[%u", dest
->base_offset
);
148 if (dest
->indirect
!= NULL
) {
150 print_src(dest
->indirect
, state
);
157 print_src(const nir_src
*src
, print_state
*state
)
160 print_ssa_use(src
->ssa
, state
);
162 print_reg_src(&src
->reg
, state
);
166 print_dest(nir_dest
*dest
, print_state
*state
)
169 print_ssa_def(&dest
->ssa
, state
);
171 print_reg_dest(&dest
->reg
, state
);
175 print_alu_src(nir_alu_instr
*instr
, unsigned src
, print_state
*state
)
177 FILE *fp
= state
->fp
;
179 if (instr
->src
[src
].negate
)
181 if (instr
->src
[src
].abs
)
184 print_src(&instr
->src
[src
].src
, state
);
186 bool print_swizzle
= false;
187 nir_component_mask_t used_channels
= 0;
189 for (unsigned i
= 0; i
< NIR_MAX_VEC_COMPONENTS
; i
++) {
190 if (!nir_alu_instr_channel_used(instr
, src
, i
))
195 if (instr
->src
[src
].swizzle
[i
] != i
) {
196 print_swizzle
= true;
201 unsigned live_channels
= nir_src_num_components(instr
->src
[src
].src
);
203 if (print_swizzle
|| used_channels
!= live_channels
) {
205 for (unsigned i
= 0; i
< NIR_MAX_VEC_COMPONENTS
; i
++) {
206 if (!nir_alu_instr_channel_used(instr
, src
, i
))
209 fprintf(fp
, "%c", "xyzw"[instr
->src
[src
].swizzle
[i
]]);
213 if (instr
->src
[src
].abs
)
218 print_alu_dest(nir_alu_dest
*dest
, print_state
*state
)
220 FILE *fp
= state
->fp
;
221 /* we're going to print the saturate modifier later, after the opcode */
223 print_dest(&dest
->dest
, state
);
225 if (!dest
->dest
.is_ssa
&&
226 dest
->write_mask
!= (1 << dest
->dest
.reg
.reg
->num_components
) - 1) {
228 for (unsigned i
= 0; i
< NIR_MAX_VEC_COMPONENTS
; i
++)
229 if ((dest
->write_mask
>> i
) & 1)
230 fprintf(fp
, "%c", "xyzw"[i
]);
235 print_alu_instr(nir_alu_instr
*instr
, print_state
*state
)
237 FILE *fp
= state
->fp
;
239 print_alu_dest(&instr
->dest
, state
);
241 fprintf(fp
, " = %s", nir_op_infos
[instr
->op
].name
);
244 if (instr
->dest
.saturate
)
246 if (instr
->no_signed_wrap
)
248 if (instr
->no_unsigned_wrap
)
252 for (unsigned i
= 0; i
< nir_op_infos
[instr
->op
].num_inputs
; i
++) {
256 print_alu_src(instr
, i
, state
);
261 get_var_name(nir_variable
*var
, print_state
*state
)
263 if (state
->ht
== NULL
)
264 return var
->name
? var
->name
: "unnamed";
268 struct hash_entry
*entry
= _mesa_hash_table_search(state
->ht
, var
);
273 if (var
->name
== NULL
) {
274 name
= ralloc_asprintf(state
->syms
, "@%u", state
->index
++);
276 struct set_entry
*set_entry
= _mesa_set_search(state
->syms
, var
->name
);
277 if (set_entry
!= NULL
) {
278 /* we have a collision with another name, append an @ + a unique
280 name
= ralloc_asprintf(state
->syms
, "%s@%u", var
->name
,
283 /* Mark this one as seen */
284 _mesa_set_add(state
->syms
, var
->name
);
289 _mesa_hash_table_insert(state
->ht
, var
, name
);
295 print_constant(nir_constant
*c
, const struct glsl_type
*type
, print_state
*state
)
297 FILE *fp
= state
->fp
;
298 const unsigned rows
= glsl_get_vector_elements(type
);
299 const unsigned cols
= glsl_get_matrix_columns(type
);
302 switch (glsl_get_base_type(type
)) {
304 /* Only float base types can be matrices. */
307 for (i
= 0; i
< rows
; i
++) {
308 if (i
> 0) fprintf(fp
, ", ");
309 fprintf(fp
, "%s", c
->values
[i
].b
? "true" : "false");
313 case GLSL_TYPE_UINT8
:
315 /* Only float base types can be matrices. */
318 for (i
= 0; i
< rows
; i
++) {
319 if (i
> 0) fprintf(fp
, ", ");
320 fprintf(fp
, "0x%02x", c
->values
[i
].u8
);
324 case GLSL_TYPE_UINT16
:
325 case GLSL_TYPE_INT16
:
326 /* Only float base types can be matrices. */
329 for (i
= 0; i
< rows
; i
++) {
330 if (i
> 0) fprintf(fp
, ", ");
331 fprintf(fp
, "0x%04x", c
->values
[i
].u16
);
337 /* Only float base types can be matrices. */
340 for (i
= 0; i
< rows
; i
++) {
341 if (i
> 0) fprintf(fp
, ", ");
342 fprintf(fp
, "0x%08x", c
->values
[i
].u32
);
346 case GLSL_TYPE_FLOAT16
:
347 case GLSL_TYPE_FLOAT
:
348 case GLSL_TYPE_DOUBLE
:
350 for (i
= 0; i
< cols
; i
++) {
351 if (i
> 0) fprintf(fp
, ", ");
352 print_constant(c
->elements
[i
], glsl_get_column_type(type
), state
);
355 switch (glsl_get_base_type(type
)) {
356 case GLSL_TYPE_FLOAT16
:
357 for (i
= 0; i
< rows
; i
++) {
358 if (i
> 0) fprintf(fp
, ", ");
359 fprintf(fp
, "%f", _mesa_half_to_float(c
->values
[i
].u16
));
363 case GLSL_TYPE_FLOAT
:
364 for (i
= 0; i
< rows
; i
++) {
365 if (i
> 0) fprintf(fp
, ", ");
366 fprintf(fp
, "%f", c
->values
[i
].f32
);
370 case GLSL_TYPE_DOUBLE
:
371 for (i
= 0; i
< rows
; i
++) {
372 if (i
> 0) fprintf(fp
, ", ");
373 fprintf(fp
, "%f", c
->values
[i
].f64
);
378 unreachable("Cannot get here from the first level switch");
383 case GLSL_TYPE_UINT64
:
384 case GLSL_TYPE_INT64
:
385 /* Only float base types can be matrices. */
388 for (i
= 0; i
< cols
; i
++) {
389 if (i
> 0) fprintf(fp
, ", ");
390 fprintf(fp
, "0x%08" PRIx64
, c
->values
[i
].u64
);
394 case GLSL_TYPE_STRUCT
:
395 for (i
= 0; i
< c
->num_elements
; i
++) {
396 if (i
> 0) fprintf(fp
, ", ");
398 print_constant(c
->elements
[i
], glsl_get_struct_field(type
, i
), state
);
403 case GLSL_TYPE_ARRAY
:
404 for (i
= 0; i
< c
->num_elements
; i
++) {
405 if (i
> 0) fprintf(fp
, ", ");
407 print_constant(c
->elements
[i
], glsl_get_array_element(type
), state
);
413 unreachable("not reached");
418 get_variable_mode_str(nir_variable_mode mode
, bool want_local_global_mode
)
421 case nir_var_shader_in
:
423 case nir_var_shader_out
:
425 case nir_var_uniform
:
427 case nir_var_mem_ubo
:
429 case nir_var_system_value
:
431 case nir_var_mem_ssbo
:
433 case nir_var_mem_shared
:
435 case nir_var_mem_global
:
437 case nir_var_shader_temp
:
438 return want_local_global_mode
? "shader_temp" : "";
439 case nir_var_function_temp
:
440 return want_local_global_mode
? "function_temp" : "";
447 print_var_decl(nir_variable
*var
, print_state
*state
)
449 FILE *fp
= state
->fp
;
451 fprintf(fp
, "decl_var ");
453 const char *const cent
= (var
->data
.centroid
) ? "centroid " : "";
454 const char *const samp
= (var
->data
.sample
) ? "sample " : "";
455 const char *const patch
= (var
->data
.patch
) ? "patch " : "";
456 const char *const inv
= (var
->data
.invariant
) ? "invariant " : "";
457 fprintf(fp
, "%s%s%s%s%s %s ",
458 cent
, samp
, patch
, inv
, get_variable_mode_str(var
->data
.mode
, false),
459 glsl_interp_mode_name(var
->data
.interpolation
));
461 enum gl_access_qualifier access
= var
->data
.image
.access
;
462 const char *const coher
= (access
& ACCESS_COHERENT
) ? "coherent " : "";
463 const char *const volat
= (access
& ACCESS_VOLATILE
) ? "volatile " : "";
464 const char *const restr
= (access
& ACCESS_RESTRICT
) ? "restrict " : "";
465 const char *const ronly
= (access
& ACCESS_NON_WRITEABLE
) ? "readonly " : "";
466 const char *const wonly
= (access
& ACCESS_NON_READABLE
) ? "writeonly " : "";
467 const char *const reorder
= (access
& ACCESS_CAN_REORDER
) ? "reorderable " : "";
468 fprintf(fp
, "%s%s%s%s%s%s", coher
, volat
, restr
, ronly
, wonly
, reorder
);
470 #define FORMAT_CASE(x) case x: fprintf(fp, #x " "); break
471 switch (var
->data
.image
.format
) {
472 FORMAT_CASE(GL_RGBA32F
);
473 FORMAT_CASE(GL_RGBA32UI
);
474 FORMAT_CASE(GL_RGBA32I
);
475 FORMAT_CASE(GL_R32F
);
476 FORMAT_CASE(GL_R32UI
);
477 FORMAT_CASE(GL_R32I
);
478 FORMAT_CASE(GL_RG32F
);
479 FORMAT_CASE(GL_RG32UI
);
480 FORMAT_CASE(GL_RG32I
);
483 FORMAT_CASE(GL_RGBA8
);
484 FORMAT_CASE(GL_R8_SNORM
);
485 FORMAT_CASE(GL_RG8_SNORM
);
486 FORMAT_CASE(GL_RGBA8_SNORM
);
488 FORMAT_CASE(GL_RG16
);
489 FORMAT_CASE(GL_RGBA16
);
490 FORMAT_CASE(GL_R16_SNORM
);
491 FORMAT_CASE(GL_RG16_SNORM
);
492 FORMAT_CASE(GL_RGBA16_SNORM
);
493 FORMAT_CASE(GL_R16F
);
494 FORMAT_CASE(GL_RG16F
);
495 FORMAT_CASE(GL_RGBA16F
);
496 FORMAT_CASE(GL_R8UI
);
498 FORMAT_CASE(GL_RG8UI
);
499 FORMAT_CASE(GL_RG8I
);
500 FORMAT_CASE(GL_RGBA8UI
);
501 FORMAT_CASE(GL_RGBA8I
);
502 FORMAT_CASE(GL_R16UI
);
503 FORMAT_CASE(GL_R16I
);
504 FORMAT_CASE(GL_RG16UI
);
505 FORMAT_CASE(GL_RG16I
);
506 FORMAT_CASE(GL_RGBA16UI
);
507 FORMAT_CASE(GL_RGBA16I
);
508 FORMAT_CASE(GL_R11F_G11F_B10F
);
509 FORMAT_CASE(GL_RGB9_E5
);
510 FORMAT_CASE(GL_RGB10_A2
);
511 FORMAT_CASE(GL_RGB10_A2UI
);
512 default: /* Including the normal GL_NONE */
517 fprintf(fp
, "%s %s", glsl_get_type_name(var
->type
),
518 get_var_name(var
, state
));
520 if (var
->data
.mode
== nir_var_shader_in
||
521 var
->data
.mode
== nir_var_shader_out
||
522 var
->data
.mode
== nir_var_uniform
||
523 var
->data
.mode
== nir_var_mem_ubo
||
524 var
->data
.mode
== nir_var_mem_ssbo
) {
525 const char *loc
= NULL
;
528 switch (state
->shader
->info
.stage
) {
529 case MESA_SHADER_VERTEX
:
530 if (var
->data
.mode
== nir_var_shader_in
)
531 loc
= gl_vert_attrib_name(var
->data
.location
);
532 else if (var
->data
.mode
== nir_var_shader_out
)
533 loc
= gl_varying_slot_name(var
->data
.location
);
535 case MESA_SHADER_GEOMETRY
:
536 if ((var
->data
.mode
== nir_var_shader_in
) ||
537 (var
->data
.mode
== nir_var_shader_out
))
538 loc
= gl_varying_slot_name(var
->data
.location
);
540 case MESA_SHADER_FRAGMENT
:
541 if (var
->data
.mode
== nir_var_shader_in
)
542 loc
= gl_varying_slot_name(var
->data
.location
);
543 else if (var
->data
.mode
== nir_var_shader_out
)
544 loc
= gl_frag_result_name(var
->data
.location
);
546 case MESA_SHADER_TESS_CTRL
:
547 case MESA_SHADER_TESS_EVAL
:
548 case MESA_SHADER_COMPUTE
:
549 case MESA_SHADER_KERNEL
:
556 snprintf(buf
, sizeof(buf
), "%u", var
->data
.location
);
560 /* For shader I/O vars that have been split to components or packed,
561 * print the fractional location within the input/output.
563 unsigned int num_components
=
564 glsl_get_components(glsl_without_array(var
->type
));
565 const char *components
= NULL
;
566 char components_local
[6] = {'.' /* the rest is 0-filled */};
567 switch (var
->data
.mode
) {
568 case nir_var_shader_in
:
569 case nir_var_shader_out
:
570 if (num_components
< 4 && num_components
!= 0) {
571 const char *xyzw
= "xyzw";
572 for (int i
= 0; i
< num_components
; i
++)
573 components_local
[i
+ 1] = xyzw
[i
+ var
->data
.location_frac
];
575 components
= components_local
;
582 fprintf(fp
, " (%s%s, %u, %u)%s", loc
,
583 components
? components
: "",
584 var
->data
.driver_location
, var
->data
.binding
,
585 var
->data
.compact
? " compact" : "");
588 if (var
->constant_initializer
) {
589 fprintf(fp
, " = { ");
590 print_constant(var
->constant_initializer
, var
->type
, state
);
595 print_annotation(state
, var
);
599 print_deref_link(const nir_deref_instr
*instr
, bool whole_chain
, print_state
*state
)
601 FILE *fp
= state
->fp
;
603 if (instr
->deref_type
== nir_deref_type_var
) {
604 fprintf(fp
, "%s", get_var_name(instr
->var
, state
));
606 } else if (instr
->deref_type
== nir_deref_type_cast
) {
607 fprintf(fp
, "(%s *)", glsl_get_type_name(instr
->type
));
608 print_src(&instr
->parent
, state
);
612 assert(instr
->parent
.is_ssa
);
613 nir_deref_instr
*parent
=
614 nir_instr_as_deref(instr
->parent
.ssa
->parent_instr
);
616 /* Is the parent we're going to print a bare cast? */
617 const bool is_parent_cast
=
618 whole_chain
&& parent
->deref_type
== nir_deref_type_cast
;
620 /* If we're not printing the whole chain, the parent we print will be a SSA
621 * value that represents a pointer. The only deref type that naturally
622 * gives a pointer is a cast.
624 const bool is_parent_pointer
=
625 !whole_chain
|| parent
->deref_type
== nir_deref_type_cast
;
627 /* Struct derefs have a nice syntax that works on pointers, arrays derefs
630 const bool need_deref
=
631 is_parent_pointer
&& instr
->deref_type
!= nir_deref_type_struct
;
633 /* Cast need extra parens and so * dereferences */
634 if (is_parent_cast
|| need_deref
)
641 print_deref_link(parent
, whole_chain
, state
);
643 print_src(&instr
->parent
, state
);
646 if (is_parent_cast
|| need_deref
)
649 switch (instr
->deref_type
) {
650 case nir_deref_type_struct
:
651 fprintf(fp
, "%s%s", is_parent_pointer
? "->" : ".",
652 glsl_get_struct_elem_name(parent
->type
, instr
->strct
.index
));
655 case nir_deref_type_array
:
656 case nir_deref_type_ptr_as_array
: {
657 if (nir_src_is_const(instr
->arr
.index
)) {
658 fprintf(fp
, "[%"PRId64
"]", nir_src_as_int(instr
->arr
.index
));
661 print_src(&instr
->arr
.index
, state
);
667 case nir_deref_type_array_wildcard
:
672 unreachable("Invalid deref instruction type");
677 print_deref_instr(nir_deref_instr
*instr
, print_state
*state
)
679 FILE *fp
= state
->fp
;
681 print_dest(&instr
->dest
, state
);
683 switch (instr
->deref_type
) {
684 case nir_deref_type_var
:
685 fprintf(fp
, " = deref_var ");
687 case nir_deref_type_array
:
688 case nir_deref_type_array_wildcard
:
689 fprintf(fp
, " = deref_array ");
691 case nir_deref_type_struct
:
692 fprintf(fp
, " = deref_struct ");
694 case nir_deref_type_cast
:
695 fprintf(fp
, " = deref_cast ");
697 case nir_deref_type_ptr_as_array
:
698 fprintf(fp
, " = deref_ptr_as_array ");
701 unreachable("Invalid deref instruction type");
704 /* Only casts naturally return a pointer type */
705 if (instr
->deref_type
!= nir_deref_type_cast
)
708 print_deref_link(instr
, false, state
);
710 fprintf(fp
, " (%s %s) ",
711 get_variable_mode_str(instr
->mode
, true),
712 glsl_get_type_name(instr
->type
));
714 if (instr
->deref_type
!= nir_deref_type_var
&&
715 instr
->deref_type
!= nir_deref_type_cast
) {
716 /* Print the entire chain as a comment */
718 print_deref_link(instr
, true, state
);
722 if (instr
->deref_type
== nir_deref_type_cast
) {
723 fprintf(fp
, " /* ptr_stride=%u */", instr
->cast
.ptr_stride
);
728 vulkan_descriptor_type_name(VkDescriptorType type
)
731 case VK_DESCRIPTOR_TYPE_SAMPLER
: return "sampler";
732 case VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER
: return "texture+sampler";
733 case VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE
: return "texture";
734 case VK_DESCRIPTOR_TYPE_STORAGE_IMAGE
: return "image";
735 case VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER
: return "texture-buffer";
736 case VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER
: return "image-buffer";
737 case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER
: return "UBO";
738 case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER
: return "SSBO";
739 case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC
: return "UBO";
740 case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC
: return "SSBO";
741 case VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT
: return "input-att";
742 case VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK_EXT
: return "inline-UBO";
743 default: return "unknown";
748 print_intrinsic_instr(nir_intrinsic_instr
*instr
, print_state
*state
)
750 const nir_intrinsic_info
*info
= &nir_intrinsic_infos
[instr
->intrinsic
];
751 unsigned num_srcs
= info
->num_srcs
;
752 FILE *fp
= state
->fp
;
754 if (info
->has_dest
) {
755 print_dest(&instr
->dest
, state
);
759 fprintf(fp
, "intrinsic %s (", info
->name
);
761 for (unsigned i
= 0; i
< num_srcs
; i
++) {
765 print_src(&instr
->src
[i
], state
);
770 for (unsigned i
= 0; i
< info
->num_indices
; i
++) {
774 fprintf(fp
, "%d", instr
->const_index
[i
]);
779 static const char *index_name
[NIR_INTRINSIC_NUM_INDEX_FLAGS
] = {
780 [NIR_INTRINSIC_BASE
] = "base",
781 [NIR_INTRINSIC_WRMASK
] = "wrmask",
782 [NIR_INTRINSIC_STREAM_ID
] = "stream-id",
783 [NIR_INTRINSIC_UCP_ID
] = "ucp-id",
784 [NIR_INTRINSIC_RANGE
] = "range",
785 [NIR_INTRINSIC_DESC_SET
] = "desc-set",
786 [NIR_INTRINSIC_BINDING
] = "binding",
787 [NIR_INTRINSIC_COMPONENT
] = "component",
788 [NIR_INTRINSIC_INTERP_MODE
] = "interp_mode",
789 [NIR_INTRINSIC_REDUCTION_OP
] = "reduction_op",
790 [NIR_INTRINSIC_CLUSTER_SIZE
] = "cluster_size",
791 [NIR_INTRINSIC_PARAM_IDX
] = "param_idx",
792 [NIR_INTRINSIC_IMAGE_DIM
] = "image_dim",
793 [NIR_INTRINSIC_IMAGE_ARRAY
] = "image_array",
794 [NIR_INTRINSIC_ACCESS
] = "access",
795 [NIR_INTRINSIC_SRC_ACCESS
] = "src-access",
796 [NIR_INTRINSIC_DST_ACCESS
] = "dst-access",
797 [NIR_INTRINSIC_FORMAT
] = "format",
798 [NIR_INTRINSIC_ALIGN_MUL
] = "align_mul",
799 [NIR_INTRINSIC_ALIGN_OFFSET
] = "align_offset",
800 [NIR_INTRINSIC_DESC_TYPE
] = "desc_type",
801 [NIR_INTRINSIC_TYPE
] = "type",
802 [NIR_INTRINSIC_SWIZZLE_MASK
] = "swizzle_mask",
803 [NIR_INTRINSIC_DRIVER_LOCATION
] = "driver_location",
805 for (unsigned idx
= 1; idx
< NIR_INTRINSIC_NUM_INDEX_FLAGS
; idx
++) {
806 if (!info
->index_map
[idx
])
810 case NIR_INTRINSIC_WRMASK
: {
811 /* special case wrmask to show it as a writemask.. */
812 unsigned wrmask
= nir_intrinsic_write_mask(instr
);
813 fprintf(fp
, " wrmask=");
814 for (unsigned i
= 0; i
< 4; i
++)
815 if ((wrmask
>> i
) & 1)
816 fprintf(fp
, "%c", "xyzw"[i
]);
820 case NIR_INTRINSIC_REDUCTION_OP
: {
821 nir_op reduction_op
= nir_intrinsic_reduction_op(instr
);
822 fprintf(fp
, " reduction_op=%s", nir_op_infos
[reduction_op
].name
);
826 case NIR_INTRINSIC_IMAGE_DIM
: {
827 static const char *dim_name
[] = {
828 [GLSL_SAMPLER_DIM_1D
] = "1D",
829 [GLSL_SAMPLER_DIM_2D
] = "2D",
830 [GLSL_SAMPLER_DIM_3D
] = "3D",
831 [GLSL_SAMPLER_DIM_CUBE
] = "Cube",
832 [GLSL_SAMPLER_DIM_RECT
] = "Rect",
833 [GLSL_SAMPLER_DIM_BUF
] = "Buf",
834 [GLSL_SAMPLER_DIM_MS
] = "2D-MSAA",
835 [GLSL_SAMPLER_DIM_SUBPASS
] = "Subpass",
836 [GLSL_SAMPLER_DIM_SUBPASS_MS
] = "Subpass-MSAA",
838 enum glsl_sampler_dim dim
= nir_intrinsic_image_dim(instr
);
839 assert(dim
< ARRAY_SIZE(dim_name
) && dim_name
[dim
]);
840 fprintf(fp
, " image_dim=%s", dim_name
[dim
]);
844 case NIR_INTRINSIC_IMAGE_ARRAY
: {
845 bool array
= nir_intrinsic_image_array(instr
);
846 fprintf(fp
, " image_array=%s", array
? "true" : "false");
850 case NIR_INTRINSIC_DESC_TYPE
: {
851 VkDescriptorType desc_type
= nir_intrinsic_desc_type(instr
);
852 fprintf(fp
, " desc_type=%s", vulkan_descriptor_type_name(desc_type
));
856 case NIR_INTRINSIC_TYPE
: {
857 nir_alu_type type
= nir_intrinsic_type(instr
);
858 unsigned size
= nir_alu_type_get_type_size(type
);
860 switch (nir_alu_type_get_base_type(type
)) {
861 case nir_type_int
: name
= "int"; break;
862 case nir_type_uint
: name
= "uint"; break;
863 case nir_type_bool
: name
= "bool"; break;
864 case nir_type_float
: name
= "float"; break;
865 default: name
= "invalid";
868 fprintf(fp
, " type=%s%u", name
, size
);
870 fprintf(fp
, " type=%s", name
);
874 case NIR_INTRINSIC_SWIZZLE_MASK
: {
875 fprintf(fp
, " swizzle_mask=");
876 unsigned mask
= nir_intrinsic_swizzle_mask(instr
);
877 if (instr
->intrinsic
== nir_intrinsic_quad_swizzle_amd
) {
878 for (unsigned i
= 0; i
< 4; i
++)
879 fprintf(fp
, "%d", (mask
>> (i
* 2) & 3));
880 } else if (instr
->intrinsic
== nir_intrinsic_masked_swizzle_amd
) {
881 fprintf(fp
, "((id & %d) | %d) ^ %d", mask
& 0x1F,
883 (mask
>> 10) & 0x1F);
885 fprintf(fp
, "%d", mask
);
891 unsigned off
= info
->index_map
[idx
] - 1;
892 assert(index_name
[idx
]); /* forgot to update index_name table? */
893 fprintf(fp
, " %s=%d", index_name
[idx
], instr
->const_index
[off
]);
903 struct exec_list
*var_list
= NULL
;
905 switch (instr
->intrinsic
) {
906 case nir_intrinsic_load_uniform
:
907 var_list
= &state
->shader
->uniforms
;
909 case nir_intrinsic_load_input
:
910 case nir_intrinsic_load_interpolated_input
:
911 case nir_intrinsic_load_per_vertex_input
:
912 var_list
= &state
->shader
->inputs
;
914 case nir_intrinsic_load_output
:
915 case nir_intrinsic_store_output
:
916 case nir_intrinsic_store_per_vertex_output
:
917 var_list
= &state
->shader
->outputs
;
923 nir_foreach_variable(var
, var_list
) {
924 if ((var
->data
.driver_location
== nir_intrinsic_base(instr
)) &&
925 (instr
->intrinsic
== nir_intrinsic_load_uniform
||
926 (nir_intrinsic_component(instr
) >= var
->data
.location_frac
&&
927 nir_intrinsic_component(instr
) <
928 (var
->data
.location_frac
+ glsl_get_components(var
->type
)))) &&
930 fprintf(fp
, "\t/* %s */", var
->name
);
937 print_tex_instr(nir_tex_instr
*instr
, print_state
*state
)
939 FILE *fp
= state
->fp
;
941 print_dest(&instr
->dest
, state
);
961 case nir_texop_txf_ms
:
962 fprintf(fp
, "txf_ms ");
964 case nir_texop_txf_ms_fb
:
965 fprintf(fp
, "txf_ms_fb ");
967 case nir_texop_txf_ms_mcs
:
968 fprintf(fp
, "txf_ms_mcs ");
979 case nir_texop_query_levels
:
980 fprintf(fp
, "query_levels ");
982 case nir_texop_texture_samples
:
983 fprintf(fp
, "texture_samples ");
985 case nir_texop_samples_identical
:
986 fprintf(fp
, "samples_identical ");
989 unreachable("Invalid texture operation");
993 bool has_texture_deref
= false, has_sampler_deref
= false;
994 for (unsigned i
= 0; i
< instr
->num_srcs
; i
++) {
999 print_src(&instr
->src
[i
].src
, state
);
1002 switch(instr
->src
[i
].src_type
) {
1003 case nir_tex_src_coord
:
1004 fprintf(fp
, "(coord)");
1006 case nir_tex_src_projector
:
1007 fprintf(fp
, "(projector)");
1009 case nir_tex_src_comparator
:
1010 fprintf(fp
, "(comparator)");
1012 case nir_tex_src_offset
:
1013 fprintf(fp
, "(offset)");
1015 case nir_tex_src_bias
:
1016 fprintf(fp
, "(bias)");
1018 case nir_tex_src_lod
:
1019 fprintf(fp
, "(lod)");
1021 case nir_tex_src_min_lod
:
1022 fprintf(fp
, "(min_lod)");
1024 case nir_tex_src_ms_index
:
1025 fprintf(fp
, "(ms_index)");
1027 case nir_tex_src_ms_mcs
:
1028 fprintf(fp
, "(ms_mcs)");
1030 case nir_tex_src_ddx
:
1031 fprintf(fp
, "(ddx)");
1033 case nir_tex_src_ddy
:
1034 fprintf(fp
, "(ddy)");
1036 case nir_tex_src_texture_deref
:
1037 has_texture_deref
= true;
1038 fprintf(fp
, "(texture_deref)");
1040 case nir_tex_src_sampler_deref
:
1041 has_sampler_deref
= true;
1042 fprintf(fp
, "(sampler_deref)");
1044 case nir_tex_src_texture_offset
:
1045 fprintf(fp
, "(texture_offset)");
1047 case nir_tex_src_sampler_offset
:
1048 fprintf(fp
, "(sampler_offset)");
1050 case nir_tex_src_texture_handle
:
1051 fprintf(fp
, "(texture_handle)");
1053 case nir_tex_src_sampler_handle
:
1054 fprintf(fp
, "(sampler_handle)");
1056 case nir_tex_src_plane
:
1057 fprintf(fp
, "(plane)");
1061 unreachable("Invalid texture source type");
1066 if (instr
->op
== nir_texop_tg4
) {
1067 fprintf(fp
, ", %u (gather_component)", instr
->component
);
1070 if (nir_tex_instr_has_explicit_tg4_offsets(instr
)) {
1071 fprintf(fp
, ", { (%i, %i)", instr
->tg4_offsets
[0][0], instr
->tg4_offsets
[0][1]);
1072 for (unsigned i
= 1; i
< 4; ++i
)
1073 fprintf(fp
, ", (%i, %i)", instr
->tg4_offsets
[i
][0],
1074 instr
->tg4_offsets
[i
][1]);
1075 fprintf(fp
, " } (offsets)");
1078 if (instr
->op
!= nir_texop_txf_ms_fb
) {
1079 if (!has_texture_deref
) {
1080 fprintf(fp
, ", %u (texture)", instr
->texture_index
);
1083 if (!has_sampler_deref
) {
1084 fprintf(fp
, ", %u (sampler)", instr
->sampler_index
);
1090 print_call_instr(nir_call_instr
*instr
, print_state
*state
)
1092 FILE *fp
= state
->fp
;
1094 fprintf(fp
, "call %s ", instr
->callee
->name
);
1096 for (unsigned i
= 0; i
< instr
->num_params
; i
++) {
1100 print_src(&instr
->params
[i
], state
);
1105 print_load_const_instr(nir_load_const_instr
*instr
, print_state
*state
)
1107 FILE *fp
= state
->fp
;
1109 print_ssa_def(&instr
->def
, state
);
1111 fprintf(fp
, " = load_const (");
1113 for (unsigned i
= 0; i
< instr
->def
.num_components
; i
++) {
1118 * we don't really know the type of the constant (if it will be used as a
1119 * float or an int), so just print the raw constant in hex for fidelity
1120 * and then print the float in a comment for readability.
1123 switch (instr
->def
.bit_size
) {
1125 fprintf(fp
, "0x%16" PRIx64
" /* %f */", instr
->value
[i
].u64
,
1126 instr
->value
[i
].f64
);
1129 fprintf(fp
, "0x%08x /* %f */", instr
->value
[i
].u32
, instr
->value
[i
].f32
);
1132 fprintf(fp
, "0x%04x /* %f */", instr
->value
[i
].u16
,
1133 _mesa_half_to_float(instr
->value
[i
].u16
));
1136 fprintf(fp
, "0x%02x", instr
->value
[i
].u8
);
1139 fprintf(fp
, "%s", instr
->value
[i
].b
? "true" : "false");
1148 print_jump_instr(nir_jump_instr
*instr
, print_state
*state
)
1150 FILE *fp
= state
->fp
;
1152 switch (instr
->type
) {
1153 case nir_jump_break
:
1154 fprintf(fp
, "break");
1157 case nir_jump_continue
:
1158 fprintf(fp
, "continue");
1161 case nir_jump_return
:
1162 fprintf(fp
, "return");
1168 print_ssa_undef_instr(nir_ssa_undef_instr
* instr
, print_state
*state
)
1170 FILE *fp
= state
->fp
;
1171 print_ssa_def(&instr
->def
, state
);
1172 fprintf(fp
, " = undefined");
1176 print_phi_instr(nir_phi_instr
*instr
, print_state
*state
)
1178 FILE *fp
= state
->fp
;
1179 print_dest(&instr
->dest
, state
);
1180 fprintf(fp
, " = phi ");
1181 nir_foreach_phi_src(src
, instr
) {
1182 if (&src
->node
!= exec_list_get_head(&instr
->srcs
))
1185 fprintf(fp
, "block_%u: ", src
->pred
->index
);
1186 print_src(&src
->src
, state
);
1191 print_parallel_copy_instr(nir_parallel_copy_instr
*instr
, print_state
*state
)
1193 FILE *fp
= state
->fp
;
1194 nir_foreach_parallel_copy_entry(entry
, instr
) {
1195 if (&entry
->node
!= exec_list_get_head(&instr
->entries
))
1198 print_dest(&entry
->dest
, state
);
1200 print_src(&entry
->src
, state
);
1205 print_instr(const nir_instr
*instr
, print_state
*state
, unsigned tabs
)
1207 FILE *fp
= state
->fp
;
1208 print_tabs(tabs
, fp
);
1210 switch (instr
->type
) {
1211 case nir_instr_type_alu
:
1212 print_alu_instr(nir_instr_as_alu(instr
), state
);
1215 case nir_instr_type_deref
:
1216 print_deref_instr(nir_instr_as_deref(instr
), state
);
1219 case nir_instr_type_call
:
1220 print_call_instr(nir_instr_as_call(instr
), state
);
1223 case nir_instr_type_intrinsic
:
1224 print_intrinsic_instr(nir_instr_as_intrinsic(instr
), state
);
1227 case nir_instr_type_tex
:
1228 print_tex_instr(nir_instr_as_tex(instr
), state
);
1231 case nir_instr_type_load_const
:
1232 print_load_const_instr(nir_instr_as_load_const(instr
), state
);
1235 case nir_instr_type_jump
:
1236 print_jump_instr(nir_instr_as_jump(instr
), state
);
1239 case nir_instr_type_ssa_undef
:
1240 print_ssa_undef_instr(nir_instr_as_ssa_undef(instr
), state
);
1243 case nir_instr_type_phi
:
1244 print_phi_instr(nir_instr_as_phi(instr
), state
);
1247 case nir_instr_type_parallel_copy
:
1248 print_parallel_copy_instr(nir_instr_as_parallel_copy(instr
), state
);
1252 unreachable("Invalid instruction type");
1258 compare_block_index(const void *p1
, const void *p2
)
1260 const nir_block
*block1
= *((const nir_block
**) p1
);
1261 const nir_block
*block2
= *((const nir_block
**) p2
);
1263 return (int) block1
->index
- (int) block2
->index
;
1266 static void print_cf_node(nir_cf_node
*node
, print_state
*state
,
1270 print_block(nir_block
*block
, print_state
*state
, unsigned tabs
)
1272 FILE *fp
= state
->fp
;
1274 print_tabs(tabs
, fp
);
1275 fprintf(fp
, "block block_%u:\n", block
->index
);
1277 /* sort the predecessors by index so we consistently print the same thing */
1280 malloc(block
->predecessors
->entries
* sizeof(nir_block
*));
1283 set_foreach(block
->predecessors
, entry
) {
1284 preds
[i
++] = (nir_block
*) entry
->key
;
1287 qsort(preds
, block
->predecessors
->entries
, sizeof(nir_block
*),
1288 compare_block_index
);
1290 print_tabs(tabs
, fp
);
1291 fprintf(fp
, "/* preds: ");
1292 for (unsigned i
= 0; i
< block
->predecessors
->entries
; i
++) {
1293 fprintf(fp
, "block_%u ", preds
[i
]->index
);
1295 fprintf(fp
, "*/\n");
1299 nir_foreach_instr(instr
, block
) {
1300 print_instr(instr
, state
, tabs
);
1302 print_annotation(state
, instr
);
1305 print_tabs(tabs
, fp
);
1306 fprintf(fp
, "/* succs: ");
1307 for (unsigned i
= 0; i
< 2; i
++)
1308 if (block
->successors
[i
]) {
1309 fprintf(fp
, "block_%u ", block
->successors
[i
]->index
);
1311 fprintf(fp
, "*/\n");
1315 print_if(nir_if
*if_stmt
, print_state
*state
, unsigned tabs
)
1317 FILE *fp
= state
->fp
;
1319 print_tabs(tabs
, fp
);
1321 print_src(&if_stmt
->condition
, state
);
1322 fprintf(fp
, " {\n");
1323 foreach_list_typed(nir_cf_node
, node
, node
, &if_stmt
->then_list
) {
1324 print_cf_node(node
, state
, tabs
+ 1);
1326 print_tabs(tabs
, fp
);
1327 fprintf(fp
, "} else {\n");
1328 foreach_list_typed(nir_cf_node
, node
, node
, &if_stmt
->else_list
) {
1329 print_cf_node(node
, state
, tabs
+ 1);
1331 print_tabs(tabs
, fp
);
1336 print_loop(nir_loop
*loop
, print_state
*state
, unsigned tabs
)
1338 FILE *fp
= state
->fp
;
1340 print_tabs(tabs
, fp
);
1341 fprintf(fp
, "loop {\n");
1342 foreach_list_typed(nir_cf_node
, node
, node
, &loop
->body
) {
1343 print_cf_node(node
, state
, tabs
+ 1);
1345 print_tabs(tabs
, fp
);
1350 print_cf_node(nir_cf_node
*node
, print_state
*state
, unsigned int tabs
)
1352 switch (node
->type
) {
1353 case nir_cf_node_block
:
1354 print_block(nir_cf_node_as_block(node
), state
, tabs
);
1357 case nir_cf_node_if
:
1358 print_if(nir_cf_node_as_if(node
), state
, tabs
);
1361 case nir_cf_node_loop
:
1362 print_loop(nir_cf_node_as_loop(node
), state
, tabs
);
1366 unreachable("Invalid CFG node type");
1371 print_function_impl(nir_function_impl
*impl
, print_state
*state
)
1373 FILE *fp
= state
->fp
;
1375 fprintf(fp
, "\nimpl %s ", impl
->function
->name
);
1379 nir_foreach_variable(var
, &impl
->locals
) {
1381 print_var_decl(var
, state
);
1384 foreach_list_typed(nir_register
, reg
, node
, &impl
->registers
) {
1386 print_register_decl(reg
, state
);
1389 nir_index_blocks(impl
);
1391 foreach_list_typed(nir_cf_node
, node
, node
, &impl
->body
) {
1392 print_cf_node(node
, state
, 1);
1395 fprintf(fp
, "\tblock block_%u:\n}\n\n", impl
->end_block
->index
);
1399 print_function(nir_function
*function
, print_state
*state
)
1401 FILE *fp
= state
->fp
;
1403 fprintf(fp
, "decl_function %s (%d params)", function
->name
,
1404 function
->num_params
);
1408 if (function
->impl
!= NULL
) {
1409 print_function_impl(function
->impl
, state
);
1415 init_print_state(print_state
*state
, nir_shader
*shader
, FILE *fp
)
1418 state
->shader
= shader
;
1419 state
->ht
= _mesa_pointer_hash_table_create(NULL
);
1420 state
->syms
= _mesa_set_create(NULL
, _mesa_key_hash_string
,
1421 _mesa_key_string_equal
);
1426 destroy_print_state(print_state
*state
)
1428 _mesa_hash_table_destroy(state
->ht
, NULL
);
1429 _mesa_set_destroy(state
->syms
, NULL
);
1433 nir_print_shader_annotated(nir_shader
*shader
, FILE *fp
,
1434 struct hash_table
*annotations
)
1437 init_print_state(&state
, shader
, fp
);
1439 state
.annotations
= annotations
;
1441 fprintf(fp
, "shader: %s\n", gl_shader_stage_name(shader
->info
.stage
));
1443 if (shader
->info
.name
)
1444 fprintf(fp
, "name: %s\n", shader
->info
.name
);
1446 if (shader
->info
.label
)
1447 fprintf(fp
, "label: %s\n", shader
->info
.label
);
1449 if (gl_shader_stage_is_compute(shader
->info
.stage
)) {
1450 fprintf(fp
, "local-size: %u, %u, %u%s\n",
1451 shader
->info
.cs
.local_size
[0],
1452 shader
->info
.cs
.local_size
[1],
1453 shader
->info
.cs
.local_size
[2],
1454 shader
->info
.cs
.local_size_variable
? " (variable)" : "");
1455 fprintf(fp
, "shared-size: %u\n", shader
->info
.cs
.shared_size
);
1458 fprintf(fp
, "inputs: %u\n", shader
->num_inputs
);
1459 fprintf(fp
, "outputs: %u\n", shader
->num_outputs
);
1460 fprintf(fp
, "uniforms: %u\n", shader
->num_uniforms
);
1461 fprintf(fp
, "shared: %u\n", shader
->num_shared
);
1462 if (shader
->scratch_size
)
1463 fprintf(fp
, "scratch: %u\n", shader
->scratch_size
);
1465 nir_foreach_variable(var
, &shader
->uniforms
) {
1466 print_var_decl(var
, &state
);
1469 nir_foreach_variable(var
, &shader
->inputs
) {
1470 print_var_decl(var
, &state
);
1473 nir_foreach_variable(var
, &shader
->outputs
) {
1474 print_var_decl(var
, &state
);
1477 nir_foreach_variable(var
, &shader
->shared
) {
1478 print_var_decl(var
, &state
);
1481 nir_foreach_variable(var
, &shader
->globals
) {
1482 print_var_decl(var
, &state
);
1485 nir_foreach_variable(var
, &shader
->system_values
) {
1486 print_var_decl(var
, &state
);
1489 foreach_list_typed(nir_function
, func
, node
, &shader
->functions
) {
1490 print_function(func
, &state
);
1493 destroy_print_state(&state
);
1497 nir_print_shader(nir_shader
*shader
, FILE *fp
)
1499 nir_print_shader_annotated(shader
, fp
, NULL
);
1504 nir_print_instr(const nir_instr
*instr
, FILE *fp
)
1506 print_state state
= {
1509 print_instr(instr
, &state
, 0);
1514 nir_print_deref(const nir_deref_instr
*deref
, FILE *fp
)
1516 print_state state
= {
1519 print_deref_link(deref
, true, &state
);