Grid

Render an adjustable grid overlay that can be scaled for various visual effects.

The GridEffect effect is part of the postprocessing package. It renders a grid that can be scaled or adjusted to achieve a variety of visual effects.

Usage

The <GridPmndrs> component is easy to use and provides customizable options to suit different visual styles.

<script setup lang="ts">
import { EffectComposerPmndrs, GridPmndrs } from '@tresjs/post-processing'
import { BlendFunction } from 'postprocessing'

const gl = {
  toneMapping: NoToneMapping,
}

const effectProps = {
  blendFunction: BlendFunction.OVERLAY,
  scale: 0.25,
  lineWidth: 0.1,
}
</script>

<template>
  <TresCanvas v-bind="gl">
    <TresPerspectiveCamera />

    <!-- Your scene -->

    <Suspense>
      <EffectComposerPmndrs>
        <GridPmndrs
          :blend-function="effectProps.blendFunction"
          :scale="effectProps.scale"
          :line-width="effectProps.lineWidth"
        />
      </EffectComposerPmndrs>
    </Suspense>
  </TresCanvas>
</template>

Props

PropDescriptionDefault
blendFunctionDefines how the effect blends with the original scene. See the BlendFunction options.BlendFunction.OVERLAY
scaleThe grid scale, which can be used to adjust the spacing effect.1.0
lineWidthThe width of the lines in the grid pattern.1.0

Further Reading

For more details, see the GridEffect documentation.