Skip to content

core.Class.QuadRenderer

github-actions[bot] edited this page Apr 2, 2025 · 17 revisions

@monogrid/gainmap-js / core / QuadRenderer

Class: QuadRenderer<TType, TMaterial>

Defined in: src/core/QuadRenderer.ts:147

Utility class used for rendering a texture with a material

Type Parameters

TType

TType extends TextureDataType

TMaterial

TMaterial extends Material

Constructors

Constructor

new QuadRenderer<TType, TMaterial>(options): QuadRenderer<TType, TMaterial>

Defined in: src/core/QuadRenderer.ts:165

Constructs a new QuadRenderer

Parameters

options

QuadRendererOptions<TType, TMaterial>

Parameters for this QuadRenderer

Returns

QuadRenderer<TType, TMaterial>

Accessors

colorSpace

Get Signature

get colorSpace(): ColorSpace

Defined in: src/core/QuadRenderer.ts:408

Returns

ColorSpace


height

Get Signature

get height(): number

Defined in: src/core/QuadRenderer.ts:378

Height of the texture

Returns

number

Set Signature

set height(value): void

Defined in: src/core/QuadRenderer.ts:379

Parameters
value

number

Returns

void


material

Get Signature

get material(): TMaterial

Defined in: src/core/QuadRenderer.ts:403

The Material used.

Returns

TMaterial


renderer

Get Signature

get renderer(): WebGLRenderer

Defined in: src/core/QuadRenderer.ts:387

The renderer used

Returns

WebGLRenderer


renderTarget

Get Signature

get renderTarget(): WebGLRenderTarget<Texture>

Defined in: src/core/QuadRenderer.ts:392

The WebGLRenderTarget used.

Returns

WebGLRenderTarget<Texture>

Set Signature

set renderTarget(value): void

Defined in: src/core/QuadRenderer.ts:393

Parameters
value

WebGLRenderTarget

Returns

void


type

Get Signature

get type(): TType

Defined in: src/core/QuadRenderer.ts:407

Returns

TType


width

Get Signature

get width(): number

Defined in: src/core/QuadRenderer.ts:369

Width of the texture

Returns

number

Set Signature

set width(value): void

Defined in: src/core/QuadRenderer.ts:370

Parameters
value

number

Returns

void

Methods

dispose()

dispose(disposeRenderTarget?): void

Defined in: src/core/QuadRenderer.ts:344

Will dispose of all assets used by this renderer.

Parameters

disposeRenderTarget?

boolean

will dispose of the renderTarget which will not be usable later set this to true if you passed the renderTarget.texture to a PMREMGenerator or are otherwise done with it.

Returns

void

Examples

const loader = new HDRJPGLoader(renderer)
const result = await loader.loadAsync('gainmap.jpeg')
const mesh = new Mesh(geometry, new MeshBasicMaterial({ map: result.renderTarget.texture }) )
// DO NOT dispose the renderTarget here,
// it is used directly in the material
result.dispose()
const loader = new HDRJPGLoader(renderer)
const pmremGenerator = new PMREMGenerator( renderer );
const result = await loader.loadAsync('gainmap.jpeg')
const envMap = pmremGenerator.fromEquirectangular(result.renderTarget.texture)
const mesh = new Mesh(geometry, new MeshStandardMaterial({ envMap }) )
// renderTarget can be disposed here
// because it was used to generate a PMREM texture
result.dispose(true)

disposeOnDemandRenderer()

disposeOnDemandRenderer(): void

Defined in: src/core/QuadRenderer.ts:306

If using a disposable renderer, it will dispose it.

Returns

void


render()

render(): void

Defined in: src/core/QuadRenderer.ts:248

Renders the input texture using the specified material

Returns

void


toArray()

toArray(): TextureDataTypeToBufferType<TType>

Defined in: src/core/QuadRenderer.ts:265

Obtains a Buffer containing the rendered texture.

Returns

TextureDataTypeToBufferType<TType>

a TypedArray containing RGBA values from this renderer

Throws

Error if the browser cannot read pixels from this RenderTarget type.


toDataTexture()

toDataTexture(options?): DataTexture

Defined in: src/core/QuadRenderer.ts:279

Performs a readPixel operation in the renderTarget and returns a DataTexture containing the read data

Parameters

options?

QuadRendererTextureOptions

options

Returns

DataTexture


instantiateRenderer()

static instantiateRenderer(): WebGLRenderer

Defined in: src/core/QuadRenderer.ts:235

Instantiates a temporary renderer

Returns

WebGLRenderer

Clone this wiki locally