Function macroValues

  • macroValues(state, on?): string

  • Defines the values within textures per-step, as GLSL preprocessor macros.

    These macros define mappings from values to their textures and channels. Caches the result if macros generation is enabled, to help reuse shaders.

    Parameters

    • state: any

      Properties used to generate the macros. See toData.

    • Optionalon: string

      Any further macro hooks specifier; if given, both the hook key and this specifier are checked (e.g: key and key_on).

    Returns string

    The GLSL preprocessor macros defining the maps from values to textures and channels.

    See

    Example: ```javascript const state = { pre: '', steps: 2 }; const maps = { values: [2, 4, 1], channelsMax: 4 }; // No optimisations - values not packed, single texture output per pass. state.maps = mapGroups({ ...maps, buffersMax: 1, packed: 0 }); macroValues(state); // => '#define texture_0 0\n'+ '#define channels_0 rg\n'+ '\n'+ '#define texture_1 1\n'+ '#define channels_1 rgba\n'+ '\n'+ '#define texture_2 2\n'+ '#define channels_2 r\n'+ '\n'+ '#define textures 3\n'+ '#define passes 3\n'+ '#define stepsPast 1\n'+ '#define steps 2\n'+ '\n'; // Automatically packed values - values across fewer textures/passes. state.maps = mapGroups({ ...maps, buffersMax: 1 }); state.size = { entries: 2**5 }; macroValues(state); // => '#define texture_1 0\n'+ '#define channels_1 rgba\n'+ '\n'+ '#define texture_0 1\n'+ '#define channels_0 rg\n'+ '\n'+ '#define texture_2 1\n'+ '#define channels_2 b\n'+ '\n'+ '#define entries 32\n'+ '#define textures 2\n'+ '#define passes 2\n'+ '#define stepsPast 1\n'+ '#define steps 2\n'+ '\n'; // Can bind more texture outputs per pass - values across fewer passes. state.maps = mapGroups({ ...maps, buffersMax: 4 }); macroValues(state); // => '#define texture_1 0\n'+ '#define channels_1 rgba\n'+ '\n'+ '#define texture_0 1\n'+ '#define channels_0 rg\n'+ '\n'+ '#define texture_2 1\n'+ '#define channels_2 b\n'+ '\n'+ '#define entries 32\n'+ '#define textures 2\n'+ '#define passes 1\n'+ '#define stepsPast 1\n'+ '#define steps 2\n'+ '\n'; ```

Settings

Member Visibility