src/gallium/auxiliary/tgsi/tgsi_util.c

   1 /**************************************************************************
   2  *
   3  * Copyright 2007 VMware, Inc.
   4  * All Rights Reserved.
   5  *
   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:
  13  *
  14  * The above copyright notice and this permission notice (including the
  15  * next paragraph) shall be included in all copies or substantial portions
  16  * of the Software.
  17  *
  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 VMWARE 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.
  25  *
  26  **************************************************************************/
  27
  28 #include "util/u_debug.h"
  29 #include "pipe/p_shader_tokens.h"
  30 #include "tgsi_parse.h"
  31 #include "tgsi_util.h"
  32 #include "tgsi_exec.h"
  33
  34 union pointer_hack
  35 {
  36    void *pointer;
  37    uint64_t uint64;
  38 };
  39
  40 void *
  41 tgsi_align_128bit(
  42    void *unaligned )
  43 {
  44    union pointer_hack ph;
  45
  46    ph.uint64 = 0;
  47    ph.pointer = unaligned;
  48    ph.uint64 = (ph.uint64 + 15) & ~15;
  49    return ph.pointer;
  50 }
  51
  52 unsigned
  53 tgsi_util_get_src_register_swizzle(
  54    const struct tgsi_src_register *reg,
  55    unsigned component )
  56 {
  57    switch (component) {
  58    case TGSI_CHAN_X:
  59       return reg->SwizzleX;
  60    case TGSI_CHAN_Y:
  61       return reg->SwizzleY;
  62    case TGSI_CHAN_Z:
  63       return reg->SwizzleZ;
  64    case TGSI_CHAN_W:
  65       return reg->SwizzleW;
  66    default:
  67       assert(0);
  68    }
  69    return 0;
  70 }
  71
  72
  73 unsigned
  74 tgsi_util_get_full_src_register_swizzle(
  75    const struct tgsi_full_src_register  *reg,
  76    unsigned component )
  77 {
  78    return tgsi_util_get_src_register_swizzle(
  79       &reg->Register,
  80       component );
  81 }
  82
  83 void
  84 tgsi_util_set_src_register_swizzle(
  85    struct tgsi_src_register *reg,
  86    unsigned swizzle,
  87    unsigned component )
  88 {
  89    switch( component ) {
  90    case 0:
  91       reg->SwizzleX = swizzle;
  92       break;
  93    case 1:
  94       reg->SwizzleY = swizzle;
  95       break;
  96    case 2:
  97       reg->SwizzleZ = swizzle;
  98       break;
  99    case 3:
 100       reg->SwizzleW = swizzle;
 101       break;
 102    default:
 103       assert( 0 );
 104    }
 105 }
 106
 107 unsigned
 108 tgsi_util_get_full_src_register_sign_mode(
 109    const struct  tgsi_full_src_register *reg,
 110    unsigned component )
 111 {
 112    unsigned sign_mode;
 113
 114    if( reg->Register.Absolute ) {
 115       /* Consider only the post-abs negation. */
 116
 117       if( reg->Register.Negate ) {
 118          sign_mode = TGSI_UTIL_SIGN_SET;
 119       }
 120       else {
 121          sign_mode = TGSI_UTIL_SIGN_CLEAR;
 122       }
 123    }
 124    else {
 125       if( reg->Register.Negate ) {
 126          sign_mode = TGSI_UTIL_SIGN_TOGGLE;
 127       }
 128       else {
 129          sign_mode = TGSI_UTIL_SIGN_KEEP;
 130       }
 131    }
 132
 133    return sign_mode;
 134 }
 135
 136 void
 137 tgsi_util_set_full_src_register_sign_mode(
 138    struct tgsi_full_src_register *reg,
 139    unsigned sign_mode )
 140 {
 141    switch (sign_mode)
 142    {
 143    case TGSI_UTIL_SIGN_CLEAR:
 144       reg->Register.Negate = 0;
 145       reg->Register.Absolute = 1;
 146       break;
 147
 148    case TGSI_UTIL_SIGN_SET:
 149       reg->Register.Absolute = 1;
 150       reg->Register.Negate = 1;
 151       break;
 152
 153    case TGSI_UTIL_SIGN_TOGGLE:
 154       reg->Register.Negate = 1;
 155       reg->Register.Absolute = 0;
 156       break;
 157
 158    case TGSI_UTIL_SIGN_KEEP:
 159       reg->Register.Negate = 0;
 160       reg->Register.Absolute = 0;
 161       break;
 162
 163    default:
 164       assert( 0 );
 165    }
 166 }
 167
 168 /**
 169  * Determine which channels of the specificed src register are effectively
 170  * used by this instruction.
 171  */
 172 unsigned
 173 tgsi_util_get_inst_usage_mask(const struct tgsi_full_instruction *inst,
 174                               unsigned src_idx)
 175 {
 176    const struct tgsi_full_src_register *src = &inst->Src[src_idx];
 177    unsigned write_mask = inst->Dst[0].Register.WriteMask;
 178    unsigned read_mask;
 179    unsigned usage_mask;
 180    unsigned chan;
 181
 182    switch (inst->Instruction.Opcode) {
 183    case TGSI_OPCODE_MOV:
 184    case TGSI_OPCODE_ARL:
 185    case TGSI_OPCODE_ARR:
 186    case TGSI_OPCODE_RCP:
 187    case TGSI_OPCODE_MUL:
 188    case TGSI_OPCODE_DIV:
 189    case TGSI_OPCODE_ADD:
 190    case TGSI_OPCODE_MIN:
 191    case TGSI_OPCODE_MAX:
 192    case TGSI_OPCODE_SLT:
 193    case TGSI_OPCODE_SGE:
 194    case TGSI_OPCODE_MAD:
 195    case TGSI_OPCODE_LRP:
 196    case TGSI_OPCODE_FMA:
 197    case TGSI_OPCODE_FRC:
 198    case TGSI_OPCODE_CEIL:
 199    case TGSI_OPCODE_FLR:
 200    case TGSI_OPCODE_ROUND:
 201    case TGSI_OPCODE_POW:
 202    case TGSI_OPCODE_COS:
 203    case TGSI_OPCODE_SIN:
 204    case TGSI_OPCODE_DDX:
 205    case TGSI_OPCODE_DDY:
 206    case TGSI_OPCODE_SEQ:
 207    case TGSI_OPCODE_SGT:
 208    case TGSI_OPCODE_SLE:
 209    case TGSI_OPCODE_SNE:
 210    case TGSI_OPCODE_SSG:
 211    case TGSI_OPCODE_CMP:
 212    case TGSI_OPCODE_TRUNC:
 213    case TGSI_OPCODE_NOT:
 214    case TGSI_OPCODE_AND:
 215    case TGSI_OPCODE_OR:
 216    case TGSI_OPCODE_XOR:
 217    case TGSI_OPCODE_FSEQ:
 218    case TGSI_OPCODE_FSGE:
 219    case TGSI_OPCODE_FSLT:
 220    case TGSI_OPCODE_FSNE:
 221    case TGSI_OPCODE_F2I:
 222    case TGSI_OPCODE_IDIV:
 223    case TGSI_OPCODE_IMAX:
 224    case TGSI_OPCODE_IMIN:
 225    case TGSI_OPCODE_INEG:
 226    case TGSI_OPCODE_ISGE:
 227    case TGSI_OPCODE_ISHR:
 228    case TGSI_OPCODE_ISLT:
 229    case TGSI_OPCODE_F2U:
 230    case TGSI_OPCODE_U2F:
 231    case TGSI_OPCODE_UADD:
 232    case TGSI_OPCODE_UDIV:
 233    case TGSI_OPCODE_UMAD:
 234    case TGSI_OPCODE_UMAX:
 235    case TGSI_OPCODE_UMIN:
 236    case TGSI_OPCODE_UMOD:
 237    case TGSI_OPCODE_UMUL:
 238    case TGSI_OPCODE_USEQ:
 239    case TGSI_OPCODE_USGE:
 240    case TGSI_OPCODE_USHR:
 241    case TGSI_OPCODE_USLT:
 242    case TGSI_OPCODE_USNE:
 243    case TGSI_OPCODE_IMUL_HI:
 244    case TGSI_OPCODE_UMUL_HI:
 245    case TGSI_OPCODE_DDX_FINE:
 246    case TGSI_OPCODE_DDY_FINE:
 247       /* Channel-wise operations */
 248       read_mask = write_mask;
 249       break;
 250
 251    case TGSI_OPCODE_EX2:
 252    case TGSI_OPCODE_LG2:
 253       read_mask = TGSI_WRITEMASK_X;
 254       break;
 255
 256    case TGSI_OPCODE_SCS:
 257       read_mask = write_mask & TGSI_WRITEMASK_XY ? TGSI_WRITEMASK_X : 0;
 258       break;
 259
 260    case TGSI_OPCODE_EXP:
 261    case TGSI_OPCODE_LOG:
 262       read_mask = write_mask & TGSI_WRITEMASK_XYZ ? TGSI_WRITEMASK_X : 0;
 263       break;
 264
 265    case TGSI_OPCODE_DP2A:
 266       read_mask = src_idx == 2 ? TGSI_WRITEMASK_X : TGSI_WRITEMASK_XY;
 267       break;
 268
 269    case TGSI_OPCODE_DP2:
 270       read_mask = TGSI_WRITEMASK_XY;
 271       break;
 272
 273    case TGSI_OPCODE_DP3:
 274       read_mask = TGSI_WRITEMASK_XYZ;
 275       break;
 276
 277    case TGSI_OPCODE_DP4:
 278       read_mask = TGSI_WRITEMASK_XYZW;
 279       break;
 280
 281    case TGSI_OPCODE_DPH:
 282       read_mask = src_idx == 0 ? TGSI_WRITEMASK_XYZ : TGSI_WRITEMASK_XYZW;
 283       break;
 284
 285    case TGSI_OPCODE_TEX:
 286    case TGSI_OPCODE_TXD:
 287    case TGSI_OPCODE_TXB:
 288    case TGSI_OPCODE_TXL:
 289    case TGSI_OPCODE_TXP:
 290       if (src_idx == 0) {
 291          /* Note that the SHADOW variants use the Z component too */
 292          switch (inst->Texture.Texture) {
 293          case TGSI_TEXTURE_1D:
 294             read_mask = TGSI_WRITEMASK_X;
 295             break;
 296          case TGSI_TEXTURE_SHADOW1D:
 297             read_mask = TGSI_WRITEMASK_XZ;
 298             break;
 299          case TGSI_TEXTURE_1D_ARRAY:
 300          case TGSI_TEXTURE_2D:
 301          case TGSI_TEXTURE_RECT:
 302             read_mask = TGSI_WRITEMASK_XY;
 303             break;
 304          case TGSI_TEXTURE_SHADOW1D_ARRAY:
 305          case TGSI_TEXTURE_SHADOW2D:
 306          case TGSI_TEXTURE_SHADOWRECT:
 307          case TGSI_TEXTURE_2D_ARRAY:
 308          case TGSI_TEXTURE_3D:
 309          case TGSI_TEXTURE_CUBE:
 310          case TGSI_TEXTURE_2D_MSAA:
 311             read_mask = TGSI_WRITEMASK_XYZ;
 312             break;
 313          case TGSI_TEXTURE_SHADOW2D_ARRAY:
 314          case TGSI_TEXTURE_CUBE_ARRAY:
 315          case TGSI_TEXTURE_SHADOWCUBE:
 316          case TGSI_TEXTURE_2D_ARRAY_MSAA:
 317          case TGSI_TEXTURE_SHADOWCUBE_ARRAY:
 318             read_mask = TGSI_WRITEMASK_XYZW;
 319             break;
 320          default:
 321             assert(0);
 322             read_mask = 0;
 323          }
 324
 325          if (inst->Instruction.Opcode != TGSI_OPCODE_TEX) {
 326             read_mask |= TGSI_WRITEMASK_W;
 327          }
 328       } else {
 329          /* A safe approximation */
 330          read_mask = TGSI_WRITEMASK_XYZW;
 331       }
 332       break;
 333
 334    default:
 335       /* Assume all channels are read */
 336       read_mask = TGSI_WRITEMASK_XYZW;
 337       break;
 338    }
 339
 340    usage_mask = 0;
 341    for (chan = 0; chan < 4; ++chan) {
 342       if (read_mask & (1 << chan)) {
 343          usage_mask |= 1 << tgsi_util_get_full_src_register_swizzle(src, chan);
 344       }
 345    }
 346
 347    return usage_mask;
 348 }
 349
 350 /**
 351  * Convert a tgsi_ind_register into a tgsi_src_register
 352  */
 353 struct tgsi_src_register
 354 tgsi_util_get_src_from_ind(const struct tgsi_ind_register *reg)
 355 {
 356    struct tgsi_src_register src = { 0 };
 357
 358    src.File = reg->File;
 359    src.Index = reg->Index;
 360    src.SwizzleX = reg->Swizzle;
 361    src.SwizzleY = reg->Swizzle;
 362    src.SwizzleZ = reg->Swizzle;
 363    src.SwizzleW = reg->Swizzle;
 364
 365    return src;
 366 }
 367
 368 /**
 369  * Return the dimension of the texture coordinates (layer included for array
 370  * textures), as well as the location of the shadow reference value or the
 371  * sample index.
 372  */
 373 int
 374 tgsi_util_get_texture_coord_dim(unsigned tgsi_tex)
 375 {
 376    /*
 377     * Depending on the texture target, (src0.xyzw, src1.x) is interpreted
 378     * differently:
 379     *
 380     *   (s, X, X, X, X),               for BUFFER
 381     *   (s, X, X, X, X),               for 1D
 382     *   (s, t, X, X, X),               for 2D, RECT
 383     *   (s, t, r, X, X),               for 3D, CUBE
 384     *
 385     *   (s, layer, X, X, X),           for 1D_ARRAY
 386     *   (s, t, layer, X, X),           for 2D_ARRAY
 387     *   (s, t, r, layer, X),           for CUBE_ARRAY
 388     *
 389     *   (s, X, shadow, X, X),          for SHADOW1D
 390     *   (s, t, shadow, X, X),          for SHADOW2D, SHADOWRECT
 391     *   (s, t, r, shadow, X),          for SHADOWCUBE
 392     *
 393     *   (s, layer, shadow, X, X),      for SHADOW1D_ARRAY
 394     *   (s, t, layer, shadow, X),      for SHADOW2D_ARRAY
 395     *   (s, t, r, layer, shadow),      for SHADOWCUBE_ARRAY
 396     *
 397     *   (s, t, sample, X, X),          for 2D_MSAA
 398     *   (s, t, layer, sample, X),      for 2D_ARRAY_MSAA
 399     */
 400    switch (tgsi_tex) {
 401    case TGSI_TEXTURE_BUFFER:
 402    case TGSI_TEXTURE_1D:
 403    case TGSI_TEXTURE_SHADOW1D:
 404       return 1;
 405    case TGSI_TEXTURE_2D:
 406    case TGSI_TEXTURE_RECT:
 407    case TGSI_TEXTURE_1D_ARRAY:
 408    case TGSI_TEXTURE_SHADOW2D:
 409    case TGSI_TEXTURE_SHADOWRECT:
 410    case TGSI_TEXTURE_SHADOW1D_ARRAY:
 411    case TGSI_TEXTURE_2D_MSAA:
 412       return 2;
 413    case TGSI_TEXTURE_3D:
 414    case TGSI_TEXTURE_CUBE:
 415    case TGSI_TEXTURE_2D_ARRAY:
 416    case TGSI_TEXTURE_SHADOWCUBE:
 417    case TGSI_TEXTURE_SHADOW2D_ARRAY:
 418    case TGSI_TEXTURE_2D_ARRAY_MSAA:
 419       return 3;
 420    case TGSI_TEXTURE_CUBE_ARRAY:
 421    case TGSI_TEXTURE_SHADOWCUBE_ARRAY:
 422       return 4;
 423    default:
 424       assert(!"unknown texture target");
 425       return 0;
 426    }
 427 }
 428
 429
 430 /**
 431  * Given a TGSI_TEXTURE_x target, return the src register index for the
 432  * shadow reference coordinate.
 433  */
 434 int
 435 tgsi_util_get_shadow_ref_src_index(unsigned tgsi_tex)
 436 {
 437    switch (tgsi_tex) {
 438    case TGSI_TEXTURE_SHADOW1D:
 439    case TGSI_TEXTURE_SHADOW2D:
 440    case TGSI_TEXTURE_SHADOWRECT:
 441    case TGSI_TEXTURE_SHADOW1D_ARRAY:
 442       return 2;
 443    case TGSI_TEXTURE_SHADOWCUBE:
 444    case TGSI_TEXTURE_SHADOW2D_ARRAY:
 445    case TGSI_TEXTURE_2D_MSAA:
 446    case TGSI_TEXTURE_2D_ARRAY_MSAA:
 447       return 3;
 448    case TGSI_TEXTURE_SHADOWCUBE_ARRAY:
 449       return 4;
 450    default:
 451       /* no shadow nor sample */
 452       return -1;
 453    }
 454 }
 455
 456
 457 boolean
 458 tgsi_is_shadow_target(unsigned target)
 459 {
 460    switch (target) {
 461    case TGSI_TEXTURE_SHADOW1D:
 462    case TGSI_TEXTURE_SHADOW2D:
 463    case TGSI_TEXTURE_SHADOWRECT:
 464    case TGSI_TEXTURE_SHADOW1D_ARRAY:
 465    case TGSI_TEXTURE_SHADOW2D_ARRAY:
 466    case TGSI_TEXTURE_SHADOWCUBE:
 467    case TGSI_TEXTURE_SHADOWCUBE_ARRAY:
 468       return TRUE;
 469    default:
 470       return FALSE;
 471    }
 472 }