decode.webgpu.Function.decode

@monogrid/gainmap-js / decode/webgpu / decode

Function: decode()

decode(params): Promise<QuadRenderer<1016, GainMapDecoderMaterial>>

Defined in: src/decode/webgpu/decode.ts:71

Decodes a gain map using WebGPU RenderTarget

Parameters

params

DecodeParametersWithRenderer<WebGPURenderer>

Returns

Promise<QuadRenderer<1016, GainMapDecoderMaterial>>

Example

import { decode } from '@monogrid/gainmap-js/webgpu'
import {
  Mesh,
  MeshBasicMaterial,
  PerspectiveCamera,
  PlaneGeometry,
  Scene,
  TextureLoader,
  WebGPURenderer
} from 'three/webgpu'

const renderer = new WebGPURenderer()

const textureLoader = new TextureLoader()

// load SDR Representation
const sdr = await textureLoader.loadAsync('sdr.jpg')
// load Gain map recovery image
const gainMap = await textureLoader.loadAsync('gainmap.jpg')
// load metadata
const metadata = await (await fetch('metadata.json')).json()

const result = await decode({
  sdr,
  gainMap,
  // this allows to use `result.renderTarget.texture` directly
  renderer,
  // this will restore the full HDR range
  maxDisplayBoost: Math.pow(2, metadata.hdrCapacityMax),
  ...metadata
})

const scene = new Scene()
// `result` can be used to populate a Texture
const mesh = new Mesh(
  new PlaneGeometry(),
  new MeshBasicMaterial({ map: result.renderTarget.texture })
)
scene.add(mesh)
renderer.render(scene, new PerspectiveCamera())

// result must be manually disposed
// when you are done using it
result.dispose()

Throws

if the WebGPURenderer fails to render the gain map