Function mapSamples

  • mapSamples(maps?, to?): any

  • Maps the minimal set of texture reads to derive the next state of values from a past state of values they depend upon.

    Parameters

    • maps: {
          derives: any;
          passes: array<array<number>>;
          textures: array<array<number>>;
          valueToTexture: array<number>;
      } = {}

      How values are grouped per-texture per-pass per-step. See mapGroups.

      • derives: any

        How the next output state values derive from any past input values. If given no derives, or a falsey-non-integer, no samples are mapped, to is returned unchanged.

      • passes: array<array<number>>

        Textures grouped into passes. See mapGroups.

      • textures: array<array<number>>

        Values grouped into textures. See mapGroups.

      • valueToTexture: array<number>

        Inverse map from each value index to the data texture index containing it.

    • Optionalto: any = maps

      The object to store the result in; maps if not given.

    Returns any

    to The given to object, with resulting maps added for any given maps.derives.

    See

    mapGroups

    Example: ``` const maps = mapGroups({ // See `mapGroups` examples for resulting maps. values: [2, 4, 1], channelsMax: 4, buffersMax: 1, packed: false, // Derived step/value indexes, per-value; sample entries include: derives: [ // Single... 2, // Empty... , // Multiple... [ // Defined step... { value: 1, step: 0 }, // All values at any given level/step... true ] ] }); mapSamples(maps); // => { ...maps, // Minimum texture samples for values; nested per-pass, per-value. // Deepest arrays are step/texture index pairs into `maps.textures`. samples: [ [[0, 2]], null, [[1, 0], [0, 0], [0, 1], [0, 2]] ], // Value indexes into `to.samples`; nested per-pass, per-value. // Map from a value index to data it needs in the minimal samples. reads: [ [[0]], null, [null, null, [0, 1, 2, 3]] ] }; ```

Settings

Member Visibility