Method setUniform

src/webgl/p5.Shader.js:1098–1140

* Sets the shader’s uniform (global) variables. * * Shader programs run on the computer’s graphics processing unit (GPU). * They live in part of the computer’s memory that’s completely separate * from the sketch that runs them. Uniforms are global variables within a * shader program.

(uniformName, data)

   * }
   */
  setUniform(uniformName, data) {
    this.init();

    const uniform = this.uniforms[uniformName];
    if (!uniform) {
      return;
    }

    // In p5.strands-related code, where some of the code may be in
    // p5.webgpu.js instead of the main p5.js build, we generally use
    // duck typing instead of instanceof to avoid accidentally importing
    // and comparing against a separate copy of p5 classes
    if (data?.isVector) {
      data = data.values.length !== data.dimensions ? data.values.slice(0, data.dimensions) : data.values;
    } else if (data?.isColor) {
      data = data._getRGBA([1, 1, 1, 1]);
    }

    if (uniform.isArray) {
      if (
        uniform._cachedData &&
        this._renderer._arraysEqual(uniform._cachedData, data)
      ) {
        return;
      } else {
        uniform._cachedData = data.slice(0);
      }
    } else if (uniform._cachedData && uniform._cachedData === data) {
      return;
    } else {
      if (Array.isArray(data) || data instanceof TypedArray) {
        if (uniform._cachedData && this._renderer._arraysEqual(uniform._cachedData, data)) {
          return;
        }
        uniform._cachedData = data.slice(0);
      } else {
        if (uniform._cachedData === data) return;
        uniform._cachedData = data;
      }
    }

    this._renderer.updateUniformValue(this, uniform, data);
  }

  /**
   * @chainable