decode.Class.HDRJPGLoader - MONOGRID/gainmap-js GitHub Wiki

@monogrid/gainmap-js / decode / HDRJPGLoader

Class: HDRJPGLoader

Defined in: src/decode/loaders/HDRJPGLoader.ts:62

A Three.js Loader for a JPEG with embedded gainmap metadata.

Example

import { HDRJPGLoader } from '@monogrid/gainmap-js'
import {
  EquirectangularReflectionMapping,
  LinearFilter,
  Mesh,
  MeshBasicMaterial,
  PerspectiveCamera,
  PlaneGeometry,
  Scene,
  WebGLRenderer
} from 'three'

const renderer = new WebGLRenderer()

const loader = new HDRJPGLoader(renderer)

const result = await loader.loadAsync('gainmap.jpeg')
// `result` can be used to populate a Texture

const scene = new Scene()
const mesh = new Mesh(
  new PlaneGeometry(),
  new MeshBasicMaterial({ map: result.renderTarget.texture })
)
scene.add(mesh)
renderer.render(scene, new PerspectiveCamera())

// Starting from three.js r159
// `result.renderTarget.texture` can
// also be used as Equirectangular scene background
//
// it was previously needed to convert it
// to a DataTexture with `result.toDataTexture()`
scene.background = result.renderTarget.texture
scene.background.mapping = EquirectangularReflectionMapping

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

Extends

  • LoaderBase<string>

Constructors

Constructor

new HDRJPGLoader(renderer?, manager?): HDRJPGLoader

Defined in: src/decode/loaders/LoaderBase.ts:34

Parameters

renderer?

WebGLRenderer

manager?

LoadingManager

Returns

HDRJPGLoader

Inherited from

LoaderBase<string>.constructor

Methods

load()

load(url, onLoad?, onProgress?, onError?): QuadRenderer<1016, GainMapDecoderMaterial>

Defined in: src/decode/loaders/HDRJPGLoader.ts:73

Loads a JPEG containing gain map metadata Renders a normal SDR image if gainmap data is not found

Parameters

url

string

An array in the form of [sdr.jpg, gainmap.jpg, metadata.json]

onLoad?

(data) => void

Load complete callback, will receive the result

onProgress?

(event) => void

Progress callback, will receive a ProgressEvent

onError?

(err) => void

Error callback

Returns

QuadRenderer<1016, GainMapDecoderMaterial>

Overrides

LoaderBase.load


setRenderer()

setRenderer(renderer): HDRJPGLoader

Defined in: src/decode/loaders/LoaderBase.ts:46

Specify the renderer to use when rendering the gain map

Parameters

renderer

WebGLRenderer

Returns

HDRJPGLoader

Inherited from

LoaderBase.setRenderer


setRenderTargetOptions()

setRenderTargetOptions(options): HDRJPGLoader

Defined in: src/decode/loaders/LoaderBase.ts:57

Specify the renderTarget options to use when rendering the gain map

Parameters

options

QuadRendererTextureOptions

Returns

HDRJPGLoader

Inherited from

LoaderBase.setRenderTargetOptions

⚠️ **GitHub.com Fallback** ⚠️