src/mesa/program/program.c

   1 /*
   2  * Mesa 3-D graphics library
   3  *
   4  * Copyright (C) 1999-2007  Brian Paul   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 "Software"),
   8  * to deal in the Software without restriction, including without limitation
   9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  10  * and/or sell copies of the Software, and to permit persons to whom the
  11  * Software is furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included
  14  * in all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  22  * OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25 /**
  26  * \file program.c
  27  * Vertex and fragment program support functions.
  28  * \author Brian Paul
  29  */
  30
  31
  32 #include "main/glheader.h"
  33 #include "main/context.h"
  34 #include "main/framebuffer.h"
  35 #include "main/hash.h"
  36 #include "main/macros.h"
  37 #include "program.h"
  38 #include "prog_cache.h"
  39 #include "prog_parameter.h"
  40 #include "prog_instruction.h"
  41 #include "util/ralloc.h"
  42
  43
  44 /**
  45  * A pointer to this dummy program is put into the hash table when
  46  * glGenPrograms is called.
  47  */
  48 struct gl_program _mesa_DummyProgram;
  49
  50
  51 /**
  52  * Init context's vertex/fragment program state
  53  */
  54 void
  55 _mesa_init_program(struct gl_context *ctx)
  56 {
  57    /*
  58     * If this assertion fails, we need to increase the field
  59     * size for register indexes (see INST_INDEX_BITS).
  60     */
  61    assert(ctx->Const.Program[MESA_SHADER_VERTEX].MaxUniformComponents / 4
  62           <= (1 << INST_INDEX_BITS));
  63    assert(ctx->Const.Program[MESA_SHADER_FRAGMENT].MaxUniformComponents / 4
  64           <= (1 << INST_INDEX_BITS));
  65
  66    assert(ctx->Const.Program[MESA_SHADER_VERTEX].MaxTemps <= (1 << INST_INDEX_BITS));
  67    assert(ctx->Const.Program[MESA_SHADER_VERTEX].MaxLocalParams <= (1 << INST_INDEX_BITS));
  68    assert(ctx->Const.Program[MESA_SHADER_FRAGMENT].MaxTemps <= (1 << INST_INDEX_BITS));
  69    assert(ctx->Const.Program[MESA_SHADER_FRAGMENT].MaxLocalParams <= (1 << INST_INDEX_BITS));
  70
  71    assert(ctx->Const.Program[MESA_SHADER_VERTEX].MaxUniformComponents <= 4 * MAX_UNIFORMS);
  72    assert(ctx->Const.Program[MESA_SHADER_FRAGMENT].MaxUniformComponents <= 4 * MAX_UNIFORMS);
  73
  74    assert(ctx->Const.Program[MESA_SHADER_VERTEX].MaxAddressOffset <= (1 << INST_INDEX_BITS));
  75    assert(ctx->Const.Program[MESA_SHADER_FRAGMENT].MaxAddressOffset <= (1 << INST_INDEX_BITS));
  76
  77    /* If this fails, increase prog_instruction::TexSrcUnit size */
  78    STATIC_ASSERT(MAX_TEXTURE_UNITS <= (1 << 5));
  79
  80    /* If this fails, increase prog_instruction::TexSrcTarget size */
  81    STATIC_ASSERT(NUM_TEXTURE_TARGETS <= (1 << 4));
  82
  83    ctx->Program.ErrorPos = -1;
  84    ctx->Program.ErrorString = strdup("");
  85
  86    ctx->VertexProgram.Enabled = GL_FALSE;
  87    ctx->VertexProgram.PointSizeEnabled =
  88       (ctx->API == API_OPENGLES2) ? GL_TRUE : GL_FALSE;
  89    ctx->VertexProgram.TwoSideEnabled = GL_FALSE;
  90    _mesa_reference_vertprog(ctx, &ctx->VertexProgram.Current,
  91                             ctx->Shared->DefaultVertexProgram);
  92    assert(ctx->VertexProgram.Current);
  93    ctx->VertexProgram.Cache = _mesa_new_program_cache();
  94
  95    ctx->FragmentProgram.Enabled = GL_FALSE;
  96    _mesa_reference_fragprog(ctx, &ctx->FragmentProgram.Current,
  97                             ctx->Shared->DefaultFragmentProgram);
  98    assert(ctx->FragmentProgram.Current);
  99    ctx->FragmentProgram.Cache = _mesa_new_program_cache();
 100
 101    /* XXX probably move this stuff */
 102    ctx->ATIFragmentShader.Enabled = GL_FALSE;
 103    ctx->ATIFragmentShader.Current = ctx->Shared->DefaultFragmentShader;
 104    assert(ctx->ATIFragmentShader.Current);
 105    ctx->ATIFragmentShader.Current->RefCount++;
 106 }
 107
 108
 109 /**
 110  * Free a context's vertex/fragment program state
 111  */
 112 void
 113 _mesa_free_program_data(struct gl_context *ctx)
 114 {
 115    _mesa_reference_vertprog(ctx, &ctx->VertexProgram.Current, NULL);
 116    _mesa_delete_program_cache(ctx, ctx->VertexProgram.Cache);
 117    _mesa_reference_fragprog(ctx, &ctx->FragmentProgram.Current, NULL);
 118    _mesa_delete_shader_cache(ctx, ctx->FragmentProgram.Cache);
 119
 120    /* XXX probably move this stuff */
 121    if (ctx->ATIFragmentShader.Current) {
 122       ctx->ATIFragmentShader.Current->RefCount--;
 123       if (ctx->ATIFragmentShader.Current->RefCount <= 0) {
 124          free(ctx->ATIFragmentShader.Current);
 125       }
 126    }
 127
 128    free((void *) ctx->Program.ErrorString);
 129 }
 130
 131
 132 /**
 133  * Update the default program objects in the given context to reference those
 134  * specified in the shared state and release those referencing the old
 135  * shared state.
 136  */
 137 void
 138 _mesa_update_default_objects_program(struct gl_context *ctx)
 139 {
 140    _mesa_reference_vertprog(ctx, &ctx->VertexProgram.Current,
 141                             ctx->Shared->DefaultVertexProgram);
 142    assert(ctx->VertexProgram.Current);
 143
 144    _mesa_reference_fragprog(ctx, &ctx->FragmentProgram.Current,
 145                             ctx->Shared->DefaultFragmentProgram);
 146    assert(ctx->FragmentProgram.Current);
 147
 148    /* XXX probably move this stuff */
 149    if (ctx->ATIFragmentShader.Current) {
 150       ctx->ATIFragmentShader.Current->RefCount--;
 151       if (ctx->ATIFragmentShader.Current->RefCount <= 0) {
 152          free(ctx->ATIFragmentShader.Current);
 153       }
 154    }
 155    ctx->ATIFragmentShader.Current = (struct ati_fragment_shader *) ctx->Shared->DefaultFragmentShader;
 156    assert(ctx->ATIFragmentShader.Current);
 157    ctx->ATIFragmentShader.Current->RefCount++;
 158 }
 159
 160
 161 /**
 162  * Set the vertex/fragment program error state (position and error string).
 163  * This is generally called from within the parsers.
 164  */
 165 void
 166 _mesa_set_program_error(struct gl_context *ctx, GLint pos, const char *string)
 167 {
 168    ctx->Program.ErrorPos = pos;
 169    free((void *) ctx->Program.ErrorString);
 170    if (!string)
 171       string = "";
 172    ctx->Program.ErrorString = strdup(string);
 173 }
 174
 175
 176 /**
 177  * Initialize a new gl_program object.
 178  */
 179 struct gl_program *
 180 _mesa_init_gl_program(struct gl_program *prog, GLenum target, GLuint id)
 181 {
 182    GLuint i;
 183
 184    if (!prog)
 185       return NULL;
 186
 187    memset(prog, 0, sizeof(*prog));
 188    mtx_init(&prog->Mutex, mtx_plain);
 189    prog->Id = id;
 190    prog->Target = target;
 191    prog->RefCount = 1;
 192    prog->Format = GL_PROGRAM_FORMAT_ASCII_ARB;
 193
 194    /* default mapping from samplers to texture units */
 195    for (i = 0; i < MAX_SAMPLERS; i++)
 196       prog->SamplerUnits[i] = i;
 197
 198    return prog;
 199 }
 200
 201
 202 /**
 203  * Allocate and initialize a new fragment/vertex program object but
 204  * don't put it into the program hash table.  Called via
 205  * ctx->Driver.NewProgram.  May be overridden (ie. replaced) by a
 206  * device driver function to implement OO deriviation with additional
 207  * types not understood by this function.
 208  *
 209  * \param ctx  context
 210  * \param id   program id/number
 211  * \param target  program target/type
 212  * \return  pointer to new program object
 213  */
 214 struct gl_program *
 215 _mesa_new_program(struct gl_context *ctx, GLenum target, GLuint id)
 216 {
 217    switch (target) {
 218    case GL_VERTEX_PROGRAM_ARB: { /* == GL_VERTEX_PROGRAM_NV */
 219       struct gl_vertex_program *prog = CALLOC_STRUCT(gl_vertex_program);
 220       return _mesa_init_gl_program(&prog->Base, target, id);
 221    }
 222    case GL_FRAGMENT_PROGRAM_ARB: {
 223       struct gl_fragment_program *prog = CALLOC_STRUCT(gl_fragment_program);
 224       return _mesa_init_gl_program(&prog->Base, target, id);
 225    }
 226    case GL_GEOMETRY_PROGRAM_NV:
 227    case GL_TESS_CONTROL_PROGRAM_NV:
 228    case GL_TESS_EVALUATION_PROGRAM_NV: {
 229       struct gl_program *prog = CALLOC_STRUCT(gl_program);
 230       return _mesa_init_gl_program(prog, target, id);
 231    }
 232    case GL_COMPUTE_PROGRAM_NV: {
 233       struct gl_compute_program *prog = CALLOC_STRUCT(gl_compute_program);
 234       return _mesa_init_gl_program(&prog->Base, target, id);
 235    }
 236    default:
 237       _mesa_problem(ctx, "bad target in _mesa_new_program");
 238       return NULL;
 239    }
 240 }
 241
 242
 243 /**
 244  * Delete a program and remove it from the hash table, ignoring the
 245  * reference count.
 246  * Called via ctx->Driver.DeleteProgram.  May be wrapped (OO deriviation)
 247  * by a device driver function.
 248  */
 249 void
 250 _mesa_delete_program(struct gl_context *ctx, struct gl_program *prog)
 251 {
 252    (void) ctx;
 253    assert(prog);
 254    assert(prog->RefCount==0);
 255
 256    if (prog == &_mesa_DummyProgram)
 257       return;
 258
 259    free(prog->String);
 260    free(prog->LocalParams);
 261
 262    if (prog->Instructions) {
 263       _mesa_free_instructions(prog->Instructions, prog->NumInstructions);
 264    }
 265    if (prog->Parameters) {
 266       _mesa_free_parameter_list(prog->Parameters);
 267    }
 268
 269    if (prog->nir) {
 270       ralloc_free(prog->nir);
 271    }
 272
 273    mtx_destroy(&prog->Mutex);
 274    free(prog);
 275 }
 276
 277
 278 /**
 279  * Return the gl_program object for a given ID.
 280  * Basically just a wrapper for _mesa_HashLookup() to avoid a lot of
 281  * casts elsewhere.
 282  */
 283 struct gl_program *
 284 _mesa_lookup_program(struct gl_context *ctx, GLuint id)
 285 {
 286    if (id)
 287       return (struct gl_program *) _mesa_HashLookup(ctx->Shared->Programs, id);
 288    else
 289       return NULL;
 290 }
 291
 292
 293 /**
 294  * Reference counting for vertex/fragment programs
 295  * This is normally only called from the _mesa_reference_program() macro
 296  * when there's a real pointer change.
 297  */
 298 void
 299 _mesa_reference_program_(struct gl_context *ctx,
 300                          struct gl_program **ptr,
 301                          struct gl_program *prog)
 302 {
 303 #ifndef NDEBUG
 304    assert(ptr);
 305    if (*ptr && prog) {
 306       /* sanity check */
 307       if ((*ptr)->Target == GL_VERTEX_PROGRAM_ARB)
 308          assert(prog->Target == GL_VERTEX_PROGRAM_ARB);
 309       else if ((*ptr)->Target == GL_FRAGMENT_PROGRAM_ARB)
 310          assert(prog->Target == GL_FRAGMENT_PROGRAM_ARB ||
 311                 prog->Target == GL_FRAGMENT_PROGRAM_NV);
 312       else if ((*ptr)->Target == GL_GEOMETRY_PROGRAM_NV)
 313          assert(prog->Target == GL_GEOMETRY_PROGRAM_NV);
 314    }
 315 #endif
 316
 317    if (*ptr) {
 318       GLboolean deleteFlag;
 319       struct gl_program *oldProg = *ptr;
 320
 321       mtx_lock(&oldProg->Mutex);
 322       assert(oldProg->RefCount > 0);
 323       oldProg->RefCount--;
 324
 325       deleteFlag = (oldProg->RefCount == 0);
 326       mtx_unlock(&oldProg->Mutex);
 327
 328       if (deleteFlag) {
 329          assert(ctx);
 330          ctx->Driver.DeleteProgram(ctx, oldProg);
 331       }
 332
 333       *ptr = NULL;
 334    }
 335
 336    assert(!*ptr);
 337    if (prog) {
 338       mtx_lock(&prog->Mutex);
 339       prog->RefCount++;
 340       mtx_unlock(&prog->Mutex);
 341    }
 342
 343    *ptr = prog;
 344 }
 345
 346
 347 /**
 348  * Insert 'count' NOP instructions at 'start' in the given program.
 349  * Adjust branch targets accordingly.
 350  */
 351 GLboolean
 352 _mesa_insert_instructions(struct gl_program *prog, GLuint start, GLuint count)
 353 {
 354    const GLuint origLen = prog->NumInstructions;
 355    const GLuint newLen = origLen + count;
 356    struct prog_instruction *newInst;
 357    GLuint i;
 358
 359    /* adjust branches */
 360    for (i = 0; i < prog->NumInstructions; i++) {
 361       struct prog_instruction *inst = prog->Instructions + i;
 362       if (inst->BranchTarget > 0) {
 363          if ((GLuint)inst->BranchTarget >= start) {
 364             inst->BranchTarget += count;
 365          }
 366       }
 367    }
 368
 369    /* Alloc storage for new instructions */
 370    newInst = _mesa_alloc_instructions(newLen);
 371    if (!newInst) {
 372       return GL_FALSE;
 373    }
 374
 375    /* Copy 'start' instructions into new instruction buffer */
 376    _mesa_copy_instructions(newInst, prog->Instructions, start);
 377
 378    /* init the new instructions */
 379    _mesa_init_instructions(newInst + start, count);
 380
 381    /* Copy the remaining/tail instructions to new inst buffer */
 382    _mesa_copy_instructions(newInst + start + count,
 383                            prog->Instructions + start,
 384                            origLen - start);
 385
 386    /* free old instructions */
 387    _mesa_free_instructions(prog->Instructions, origLen);
 388
 389    /* install new instructions */
 390    prog->Instructions = newInst;
 391    prog->NumInstructions = newLen;
 392
 393    return GL_TRUE;
 394 }
 395
 396 /**
 397  * Delete 'count' instructions at 'start' in the given program.
 398  * Adjust branch targets accordingly.
 399  */
 400 GLboolean
 401 _mesa_delete_instructions(struct gl_program *prog, GLuint start, GLuint count)
 402 {
 403    const GLuint origLen = prog->NumInstructions;
 404    const GLuint newLen = origLen - count;
 405    struct prog_instruction *newInst;
 406    GLuint i;
 407
 408    /* adjust branches */
 409    for (i = 0; i < prog->NumInstructions; i++) {
 410       struct prog_instruction *inst = prog->Instructions + i;
 411       if (inst->BranchTarget > 0) {
 412          if (inst->BranchTarget > (GLint) start) {
 413             inst->BranchTarget -= count;
 414          }
 415       }
 416    }
 417
 418    /* Alloc storage for new instructions */
 419    newInst = _mesa_alloc_instructions(newLen);
 420    if (!newInst) {
 421       return GL_FALSE;
 422    }
 423
 424    /* Copy 'start' instructions into new instruction buffer */
 425    _mesa_copy_instructions(newInst, prog->Instructions, start);
 426
 427    /* Copy the remaining/tail instructions to new inst buffer */
 428    _mesa_copy_instructions(newInst + start,
 429                            prog->Instructions + start + count,
 430                            newLen - start);
 431
 432    /* free old instructions */
 433    _mesa_free_instructions(prog->Instructions, origLen);
 434
 435    /* install new instructions */
 436    prog->Instructions = newInst;
 437    prog->NumInstructions = newLen;
 438
 439    return GL_TRUE;
 440 }
 441
 442
 443 /**
 444  * Populate the 'used' array with flags indicating which registers (TEMPs,
 445  * INPUTs, OUTPUTs, etc, are used by the given program.
 446  * \param file  type of register to scan for
 447  * \param used  returns true/false flags for in use / free
 448  * \param usedSize  size of the 'used' array
 449  */
 450 void
 451 _mesa_find_used_registers(const struct gl_program *prog,
 452                           gl_register_file file,
 453                           GLboolean used[], GLuint usedSize)
 454 {
 455    GLuint i, j;
 456
 457    memset(used, 0, usedSize);
 458
 459    for (i = 0; i < prog->NumInstructions; i++) {
 460       const struct prog_instruction *inst = prog->Instructions + i;
 461       const GLuint n = _mesa_num_inst_src_regs(inst->Opcode);
 462
 463       if (inst->DstReg.File == file) {
 464          assert(inst->DstReg.Index < usedSize);
 465          if(inst->DstReg.Index < usedSize)
 466             used[inst->DstReg.Index] = GL_TRUE;
 467       }
 468
 469       for (j = 0; j < n; j++) {
 470          if (inst->SrcReg[j].File == file) {
 471             assert(inst->SrcReg[j].Index < (GLint) usedSize);
 472             if (inst->SrcReg[j].Index < (GLint) usedSize)
 473                used[inst->SrcReg[j].Index] = GL_TRUE;
 474          }
 475       }
 476    }
 477 }
 478
 479
 480 /**
 481  * Scan the given 'used' register flag array for the first entry
 482  * that's >= firstReg.
 483  * \param used  vector of flags indicating registers in use (as returned
 484  *              by _mesa_find_used_registers())
 485  * \param usedSize  size of the 'used' array
 486  * \param firstReg  first register to start searching at
 487  * \return index of unused register, or -1 if none.
 488  */
 489 GLint
 490 _mesa_find_free_register(const GLboolean used[],
 491                          GLuint usedSize, GLuint firstReg)
 492 {
 493    GLuint i;
 494
 495    assert(firstReg < usedSize);
 496
 497    for (i = firstReg; i < usedSize; i++)
 498       if (!used[i])
 499          return i;
 500
 501    return -1;
 502 }
 503
 504
 505 /* Gets the minimum number of shader invocations per fragment.
 506  * This function is useful to determine if we need to do per
 507  * sample shading or per fragment shading.
 508  */
 509 GLint
 510 _mesa_get_min_invocations_per_fragment(struct gl_context *ctx,
 511                                        const struct gl_fragment_program *prog,
 512                                        bool ignore_sample_qualifier)
 513 {
 514    /* From ARB_sample_shading specification:
 515     * "Using gl_SampleID in a fragment shader causes the entire shader
 516     *  to be evaluated per-sample."
 517     *
 518     * "Using gl_SamplePosition in a fragment shader causes the entire
 519     *  shader to be evaluated per-sample."
 520     *
 521     * "If MULTISAMPLE or SAMPLE_SHADING_ARB is disabled, sample shading
 522     *  has no effect."
 523     */
 524    if (ctx->Multisample.Enabled) {
 525       /* The ARB_gpu_shader5 specification says:
 526        *
 527        * "Use of the "sample" qualifier on a fragment shader input
 528        *  forces per-sample shading"
 529        */
 530       if (prog->IsSample && !ignore_sample_qualifier)
 531          return MAX2(_mesa_geometric_samples(ctx->DrawBuffer), 1);
 532
 533       if (prog->Base.SystemValuesRead & (SYSTEM_BIT_SAMPLE_ID |
 534                                          SYSTEM_BIT_SAMPLE_POS))
 535          return MAX2(_mesa_geometric_samples(ctx->DrawBuffer), 1);
 536       else if (ctx->Multisample.SampleShading)
 537          return MAX2(ceil(ctx->Multisample.MinSampleShadingValue *
 538                           _mesa_geometric_samples(ctx->DrawBuffer)), 1);
 539       else
 540          return 1;
 541    }
 542    return 1;
 543 }