1 /**************************************************************************
3 * Copyright 2007-2008 Tungsten Graphics, Inc., Cedar Park, Texas.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
28 #include "util/u_debug.h"
29 #include "util/u_string.h"
30 #include "util/u_math.h"
31 #include "util/u_memory.h"
32 #include "tgsi_dump.h"
33 #include "tgsi_info.h"
34 #include "tgsi_iterate.h"
38 struct tgsi_iterate_context iter
;
42 void (*printf
)(struct dump_ctx
*ctx
, const char *format
, ...);
46 dump_ctx_printf(struct dump_ctx
*ctx
, const char *format
, ...)
51 debug_vprintf(format
, ap
);
63 ctx
->printf( ctx
, "%u", e
);
65 ctx
->printf( ctx
, "%s", enums
[e
] );
68 #define EOL() ctx->printf( ctx, "\n" )
69 #define TXT(S) ctx->printf( ctx, "%s", S )
70 #define CHR(C) ctx->printf( ctx, "%c", C )
71 #define UIX(I) ctx->printf( ctx, "0x%x", I )
72 #define UID(I) ctx->printf( ctx, "%u", I )
73 #define INSTID(I) ctx->printf( ctx, "% 3u", I )
74 #define SID(I) ctx->printf( ctx, "%d", I )
75 #define FLT(F) ctx->printf( ctx, "%10.4f", F )
76 #define ENM(E,ENUMS) dump_enum( ctx, E, ENUMS, sizeof( ENUMS ) / sizeof( *ENUMS ) )
78 static const char *processor_type_names
[] =
85 static const char *file_names
[TGSI_FILE_COUNT
] =
98 static const char *interpolate_names
[] =
105 static const char *semantic_names
[] =
117 static const char *immediate_type_names
[] =
122 static const char *swizzle_names
[] =
130 static const char *texture_names
[] =
143 static const char *extswizzle_names
[] =
153 static const char *modulate_names
[TGSI_MODULATE_COUNT
] =
166 struct dump_ctx
*ctx
,
171 ENM( file
, file_names
);
183 struct dump_ctx
*ctx
,
190 ENM( file
, file_names
);
192 ENM( ind_file
, file_names
);
196 ENM( ind_swizzle
, swizzle_names
);
207 struct dump_ctx
*ctx
,
210 if (writemask
!= TGSI_WRITEMASK_XYZW
) {
212 if (writemask
& TGSI_WRITEMASK_X
)
214 if (writemask
& TGSI_WRITEMASK_Y
)
216 if (writemask
& TGSI_WRITEMASK_Z
)
218 if (writemask
& TGSI_WRITEMASK_W
)
225 struct tgsi_iterate_context
*iter
,
226 struct tgsi_full_declaration
*decl
)
228 struct dump_ctx
*ctx
= (struct dump_ctx
*)iter
;
230 assert(Elements(semantic_names
) == TGSI_SEMANTIC_COUNT
);
231 assert(Elements(interpolate_names
) == TGSI_INTERPOLATE_COUNT
);
237 decl
->Declaration
.File
,
238 decl
->DeclarationRange
.First
,
239 decl
->DeclarationRange
.Last
);
242 decl
->Declaration
.UsageMask
);
244 if (decl
->Declaration
.Semantic
) {
246 ENM( decl
->Semantic
.SemanticName
, semantic_names
);
247 if (decl
->Semantic
.SemanticIndex
!= 0 ||
248 decl
->Semantic
.SemanticName
== TGSI_SEMANTIC_GENERIC
) {
250 UID( decl
->Semantic
.SemanticIndex
);
255 if (iter
->processor
.Processor
== TGSI_PROCESSOR_FRAGMENT
&&
256 decl
->Declaration
.File
== TGSI_FILE_INPUT
)
259 ENM( decl
->Declaration
.Interpolate
, interpolate_names
);
262 if (decl
->Declaration
.Centroid
) {
266 if (decl
->Declaration
.Invariant
) {
267 TXT( ", INVARIANT" );
276 tgsi_dump_declaration(
277 const struct tgsi_full_declaration
*decl
)
281 ctx
.printf
= dump_ctx_printf
;
283 iter_declaration( &ctx
.iter
, (struct tgsi_full_declaration
*)decl
);
288 struct tgsi_iterate_context
*iter
,
289 struct tgsi_full_immediate
*imm
)
291 struct dump_ctx
*ctx
= (struct dump_ctx
*) iter
;
296 ENM( imm
->Immediate
.DataType
, immediate_type_names
);
300 assert( imm
->Immediate
.NrTokens
<= 4 + 1 );
301 for (i
= 0; i
< imm
->Immediate
.NrTokens
- 1; i
++) {
302 switch (imm
->Immediate
.DataType
) {
303 case TGSI_IMM_FLOAT32
:
304 FLT( imm
->u
[i
].Float
);
310 if (i
< imm
->Immediate
.NrTokens
- 2)
322 const struct tgsi_full_immediate
*imm
)
326 ctx
.printf
= dump_ctx_printf
;
328 iter_immediate( &ctx
.iter
, (struct tgsi_full_immediate
*)imm
);
333 struct tgsi_iterate_context
*iter
,
334 struct tgsi_full_instruction
*inst
)
336 struct dump_ctx
*ctx
= (struct dump_ctx
*) iter
;
337 uint instno
= ctx
->instno
++;
340 boolean first_reg
= TRUE
;
344 TXT( tgsi_get_opcode_info( inst
->Instruction
.Opcode
)->mnemonic
);
346 switch (inst
->Instruction
.Saturate
) {
349 case TGSI_SAT_ZERO_ONE
:
352 case TGSI_SAT_MINUS_PLUS_ONE
:
359 for (i
= 0; i
< inst
->Instruction
.NumDstRegs
; i
++) {
360 const struct tgsi_full_dst_register
*dst
= &inst
->FullDstRegisters
[i
];
366 if (dst
->DstRegister
.Indirect
) {
369 dst
->DstRegister
.File
,
370 dst
->DstRegister
.Index
,
371 dst
->DstRegisterInd
.File
,
372 dst
->DstRegisterInd
.Index
,
373 dst
->DstRegisterInd
.SwizzleX
);
378 dst
->DstRegister
.File
,
379 dst
->DstRegister
.Index
,
380 dst
->DstRegister
.Index
);
382 ENM( dst
->DstRegisterExtModulate
.Modulate
, modulate_names
);
383 _dump_writemask( ctx
, dst
->DstRegister
.WriteMask
);
388 for (i
= 0; i
< inst
->Instruction
.NumSrcRegs
; i
++) {
389 const struct tgsi_full_src_register
*src
= &inst
->FullSrcRegisters
[i
];
395 if (src
->SrcRegisterExtMod
.Negate
)
397 if (src
->SrcRegisterExtMod
.Absolute
)
399 if (src
->SrcRegisterExtMod
.Scale2X
)
401 if (src
->SrcRegisterExtMod
.Bias
)
403 if (src
->SrcRegisterExtMod
.Complement
)
405 if (src
->SrcRegister
.Negate
)
408 if (src
->SrcRegister
.Indirect
) {
411 src
->SrcRegister
.File
,
412 src
->SrcRegister
.Index
,
413 src
->SrcRegisterInd
.File
,
414 src
->SrcRegisterInd
.Index
,
415 src
->SrcRegisterInd
.SwizzleX
);
420 src
->SrcRegister
.File
,
421 src
->SrcRegister
.Index
,
422 src
->SrcRegister
.Index
);
425 if (src
->SrcRegister
.SwizzleX
!= TGSI_SWIZZLE_X
||
426 src
->SrcRegister
.SwizzleY
!= TGSI_SWIZZLE_Y
||
427 src
->SrcRegister
.SwizzleZ
!= TGSI_SWIZZLE_Z
||
428 src
->SrcRegister
.SwizzleW
!= TGSI_SWIZZLE_W
) {
430 ENM( src
->SrcRegister
.SwizzleX
, swizzle_names
);
431 ENM( src
->SrcRegister
.SwizzleY
, swizzle_names
);
432 ENM( src
->SrcRegister
.SwizzleZ
, swizzle_names
);
433 ENM( src
->SrcRegister
.SwizzleW
, swizzle_names
);
435 if (src
->SrcRegisterExtSwz
.ExtSwizzleX
!= TGSI_EXTSWIZZLE_X
||
436 src
->SrcRegisterExtSwz
.ExtSwizzleY
!= TGSI_EXTSWIZZLE_Y
||
437 src
->SrcRegisterExtSwz
.ExtSwizzleZ
!= TGSI_EXTSWIZZLE_Z
||
438 src
->SrcRegisterExtSwz
.ExtSwizzleW
!= TGSI_EXTSWIZZLE_W
) {
440 if (src
->SrcRegisterExtSwz
.NegateX
)
442 ENM( src
->SrcRegisterExtSwz
.ExtSwizzleX
, extswizzle_names
);
443 if (src
->SrcRegisterExtSwz
.NegateY
)
445 ENM( src
->SrcRegisterExtSwz
.ExtSwizzleY
, extswizzle_names
);
446 if (src
->SrcRegisterExtSwz
.NegateZ
)
448 ENM( src
->SrcRegisterExtSwz
.ExtSwizzleZ
, extswizzle_names
);
449 if (src
->SrcRegisterExtSwz
.NegateW
)
451 ENM( src
->SrcRegisterExtSwz
.ExtSwizzleW
, extswizzle_names
);
454 if (src
->SrcRegisterExtMod
.Complement
)
456 if (src
->SrcRegisterExtMod
.Bias
)
458 if (src
->SrcRegisterExtMod
.Scale2X
)
460 if (src
->SrcRegisterExtMod
.Absolute
)
462 if (src
->SrcRegisterExtMod
.Negate
)
468 if (inst
->InstructionExtTexture
.Texture
!= TGSI_TEXTURE_UNKNOWN
) {
470 ENM( inst
->InstructionExtTexture
.Texture
, texture_names
);
473 switch (inst
->Instruction
.Opcode
) {
475 case TGSI_OPCODE_ELSE
:
476 case TGSI_OPCODE_BGNLOOP
:
477 case TGSI_OPCODE_ENDLOOP
:
478 case TGSI_OPCODE_CAL
:
480 UID( inst
->InstructionExtLabel
.Label
);
490 tgsi_dump_instruction(
491 const struct tgsi_full_instruction
*inst
,
497 ctx
.printf
= dump_ctx_printf
;
499 iter_instruction( &ctx
.iter
, (struct tgsi_full_instruction
*)inst
);
504 struct tgsi_iterate_context
*iter
)
506 struct dump_ctx
*ctx
= (struct dump_ctx
*) iter
;
507 ENM( iter
->processor
.Processor
, processor_type_names
);
508 UID( iter
->version
.MajorVersion
);
510 UID( iter
->version
.MinorVersion
);
517 const struct tgsi_token
*tokens
,
522 ctx
.iter
.prolog
= prolog
;
523 ctx
.iter
.iterate_instruction
= iter_instruction
;
524 ctx
.iter
.iterate_declaration
= iter_declaration
;
525 ctx
.iter
.iterate_immediate
= iter_immediate
;
526 ctx
.iter
.epilog
= NULL
;
529 ctx
.printf
= dump_ctx_printf
;
531 tgsi_iterate_shader( tokens
, &ctx
.iter
);
536 struct dump_ctx base
;
543 str_dump_ctx_printf(struct dump_ctx
*ctx
, const char *format
, ...)
545 struct str_dump_ctx
*sctx
= (struct str_dump_ctx
*)ctx
;
550 va_start(ap
, format
);
551 written
= util_vsnprintf(sctx
->ptr
, sctx
->left
, format
, ap
);
554 /* Some complicated logic needed to handle the return value of
558 written
= MIN2(sctx
->left
, written
);
559 sctx
->ptr
+= written
;
560 sctx
->left
-= written
;
567 const struct tgsi_token
*tokens
,
572 struct str_dump_ctx ctx
;
574 ctx
.base
.iter
.prolog
= prolog
;
575 ctx
.base
.iter
.iterate_instruction
= iter_instruction
;
576 ctx
.base
.iter
.iterate_declaration
= iter_declaration
;
577 ctx
.base
.iter
.iterate_immediate
= iter_immediate
;
578 ctx
.base
.iter
.epilog
= NULL
;
581 ctx
.base
.printf
= &str_dump_ctx_printf
;
586 ctx
.left
= (int)size
;
588 tgsi_iterate_shader( tokens
, &ctx
.base
.iter
);