Module: Extra-Helpers

Classes

• FSShadowMaterial
• RandomizedDirectionalLight
• ShadowMapBaker
• CanvasSnipper
• ACanvasRecorder
• CanvasMediaRecorder
• CanvasRecorder
• FFMPEGRecorder
• ImageSequenceRecorder
• GyroInputDevice
• MouseInputDevice
• Dropzone
• DiamondMaterial
• BoxSelectionWidget
• SelectionWidget
• SphereSelectionWidget
• TransformControls2
• AWSClientPlugin
• ARTouchInputHelper
• ARPlacementBox
• CubeNormalsCaptureHelper
• NormalCaptureMaterial
• ObjectProcessorMap
• GLTFMeshGpuInstancingExporter
• PresetGroup
• BackgroundPresetGroup
• EnvironmentPresetGroup
• GemEnvironmentPresetGroup
• PluginPresetGroup
• ModelStagePresetGroup
• MaterialLibPresetGroupPresetGroup
• VJSONPresetGroup
• Box3B
• CustomAnimationHelper
• DeviceOrientationControls2
• FirstPersonControls2
• MaterialPreviewGenerator
• OrbitControls2
• PointerLockControls2
• Reflector2
• TubeShapeGeometry
• AddBlendPass
• DepthOfFieldPass
• GenericBlendTexturePass
• SSBevelPass
• AShaderMaterial2
• ShaderMaterial2
• ShaderMaterialEncodingSupport
• ShaderPass2

Interfaces

• RDShadowParams
• RDRandomParams
• IAnimationObject
• SRect
• SnipOptions
• ICanvasRecorder
• CanvasRecorderOptions
• IInputDevice
• DropFile
• DiamondGeometryParameters
• DiamondMaterialParameters
• IDiamondGeometryOffsets
• IObjectProcessor

Type aliases

TUpdaterType

Ƭ TUpdaterType: "scene" | "renderer" | "viewer" | "camera"

Defined in

webgi/src/extras/animationObject.ts:6

---

IAnimSet

Ƭ IAnimSet: IAnimationObject<any>[]

Defined in

webgi/src/extras/animationObject.ts:25

---

TRecorderStates

Ƭ TRecorderStates: "stopped" | "recording" | "paused" | "error" | "starting" | "stopping"

Defined in

webgi/src/extras/canvas_recorder/ACanvasRecorder.ts:3

---

DropEventType

Ƭ DropEventType: "drop" | "dropstart" | "droperror"

Defined in

webgi/src/extras/dropzone.ts:236

---

ListenerCallback

Ƭ ListenerCallback: (data?: { files?: Map<string, DropFile> ; message?: string }) => void

Type declaration

▸ (data?): void

Parameters

Name	Type
data?	Object
data.files?	Map<string, DropFile>
data.message?	string

Returns

void

Defined in

webgi/src/extras/dropzone.ts:237

---

AwsRequestInit

Ƭ AwsRequestInit: RequestInit & { aws?: { accessKeyId?: string ; secretAccessKey?: string ; sessionToken?: string ; service?: string ; region?: string ; cache?: Map<string, ArrayBuffer> ; datetime?: string ; signQuery?: boolean ; appendSessionToken?: boolean ; allHeaders?: boolean ; singleEncode?: boolean } }

Defined in

webgi/src/extras/network/AWSClientPlugin.ts:201

---

EasingFunctionType

Ƭ EasingFunctionType: keyof typeof EasingFunctions

EasingFunctionType: anticipate, backIn, backInOut, backOut, bounceIn, bounceInOut, bounceOut, circIn, circInOut, circOut, easeIn, easeInOut, easeOut, easeInOutSine

Defined in

webgi/src/helpers/animation.ts:51

---

AnimateResult

Ƭ AnimateResult: ReturnType<typeof animate>

Defined in

webgi/src/helpers/animation.ts:53

---

TPreset

Ƭ TPreset: IAsset | string

Defined in

webgi/src/helpers/presetGroups.ts:9

---

TPointerLockEvents

Ƭ TPointerLockEvents: "change" | "lock" | "unlock"

Defined in

webgi/src/helpers/threejs/PointerLockControls2.ts:12

Functions

extractAnimationKey

▸ extractAnimationKey(o, target, extraGetters?): { key: undefined = undefined; tar: any } | { key: string ; tar: any }

Parameters

Name	Type
o	IAnimationObject<any>
target	any
extraGetters?	Record<string, (acc: string[]) => undefined | { tar: any ; i: number }>

Returns

{ key: undefined = undefined; tar: any } | { key: string ; tar: any }

Defined in

webgi/src/extras/animationObject.ts:49

---

animateObject

▸ animateObject(target, o, updaters): Promise<any>

Parameters

Name	Type
target	any
o	IAnimationObject<any>
updaters	Record<TUpdaterType, () => void>

Returns

Promise<any>

Defined in

webgi/src/extras/animationObject.ts:82

---

animateSet

▸ animateSet(target, anims, updaters, parallel?): Promise<undefined | any[]>

Parameters

Name	Type	Default value
target	any	undefined
anims	IAnimSet	undefined
updaters	Record<TUpdaterType, () => void>	undefined
parallel	boolean	false

Returns

Promise<undefined | any[]>

Defined in

webgi/src/extras/animationObject.ts:112

---

computeOffsetMatrix

▸ computeOffsetMatrix(geometry): Matrix4

Parameters

Name	Type
geometry	BufferGeometry<NormalBufferAttributes, Event, string>

Returns

Matrix4

Defined in

webgi/src/extras/ijewel/utils.ts:44

---

computeEigenVectors

▸ computeEigenVectors(geometry): Matrix4

Parameters

Name	Type
geometry	BufferGeometry<NormalBufferAttributes, Event, string>

Returns

Matrix4

Defined in

webgi/src/extras/ijewel/utils.ts:213

---

sign2

▸ sign2(client, input, init?): Promise<RequestInit & { aws?: { accessKeyId?: string ; secretAccessKey?: string ; sessionToken?: string ; service?: string ; region?: string ; cache?: Map<string, ArrayBuffer> ; datetime?: string ; signQuery?: boolean ; appendSessionToken?: boolean ; allHeaders?: boolean ; singleEncode?: boolean } } & {}>

Parameters

Name	Type
client	AwsClient
input	RequestInfo
init?	AwsRequestInit

Returns

Promise<RequestInit & { aws?: { accessKeyId?: string ; secretAccessKey?: string ; sessionToken?: string ; service?: string ; region?: string ; cache?: Map<string, ArrayBuffer> ; datetime?: string ; signQuery?: boolean ; appendSessionToken?: boolean ; allHeaders?: boolean ; singleEncode?: boolean } } & {}>

Defined in

webgi/src/extras/network/AWSClientPlugin.ts:217

---

makeSetterFor

▸ makeSetterFor<V>(target, key, setDirty?): (a: V) => void

Type parameters

Name
V

Parameters

Name	Type
target	any
key	string
setDirty?	() => void

Returns

fn

▸ (a): void

Parameters

Name	Type
a	V

Returns

void

Defined in

webgi/src/helpers/animation.ts:55

---

isAnimatableType

▸ isAnimatableType(value): boolean

Parameters

Name	Type
value	any

Returns

boolean

Defined in

webgi/src/helpers/animation.ts:78

---

animateTarget

▸ animateTarget<V>(target, key, options, animations?, forceCurrent?): Promise<void>

Type parameters

Name
V

Parameters

Name	Type	Default value
target	any	undefined
key	string	undefined
options	AnimationOptions<V>	undefined
animations?	{}[]	undefined
forceCurrent	boolean	false

Returns

Promise<void>

Defined in

webgi/src/helpers/animation.ts:83

---

animateAsync

▸ animateAsync<V>(options, animations?): Promise<void>

Type parameters

Name	Type
V	number

Parameters

Name	Type
options	PlaybackOptions<V> & DecayOptions & { onEnd?: () => void } & PlaybackOptions<V> & SpringOptions & { onEnd?: () => void } & PlaybackOptions<V> & KeyframeOptions<V> & { onEnd?: () => void }
animations?	{}[]

Returns

Promise<void>

Defined in

webgi/src/helpers/animation.ts:108

---

autoGPUInstanceMeshes

▸ autoGPUInstanceMeshes(matOrGeom): void

Parameters

Name	Type
matOrGeom	any

Returns

void

Defined in

webgi/src/helpers/gpuInstancing.ts:7

---

shaderReplaceString

▸ shaderReplaceString(shader, str, newStr, __namedParameters?): string

Parameters

Name	Type
shader	string
str	string
newStr	string
__namedParameters	Object
__namedParameters.replaceAll	undefined | boolean
__namedParameters.prepend	undefined | boolean
__namedParameters.append	undefined | boolean

Returns

string

Defined in

webgi/src/helpers/material.ts:4

---

textureDataToImageData

▸ textureDataToImageData(imgData, colorSpace?, outData?): ImageData

Parameters

Name	Type
imgData	TextureImageData | ImageData | { data: Uint8Array | Uint16Array | Float32Array ; width: number ; height: number }
colorSpace?	ColorSpace
outData?	ImageData

Returns

ImageData

Defined in

webgi/src/helpers/refl.ts:67

---

textureToCanvas

▸ textureToCanvas(texture, maxWidth, flipY?): HTMLCanvasElement

Parameters

Name	Type	Default value
texture	Texture | DataTexture	undefined
maxWidth	number	undefined
flipY	boolean	false

Returns

HTMLCanvasElement

Defined in

webgi/src/helpers/refl.ts:98

---

texImageToCanvas

▸ texImageToCanvas(image, maxWidth, flipY?): HTMLCanvasElement

Parameters

Name	Type	Default value
image	TexImageSource	undefined
maxWidth	number	undefined
flipY	boolean	false

Returns

HTMLCanvasElement

Defined in

webgi/src/helpers/refl.ts:105

---

textureToDataUrl

▸ textureToDataUrl(texture, maxWidth, flipY, mimeType?, quality?): string

Parameters

Name	Type
texture	Texture | DataTexture
maxWidth	number
flipY	boolean
mimeType?	string
quality?	number

Returns

string

Defined in

webgi/src/helpers/refl.ts:151

---

removeDuplicateGeometries

▸ removeDuplicateGeometries(obj): void

Parameters

Name	Type
obj	Object3D<Event, string>

Returns

void

Defined in

webgi/src/helpers/removeDuplicateGeometries.ts:4

---

serialize

▸ serialize(key?): PropertyDecorator

Parameters

Name	Type
key?	string

Returns

PropertyDecorator

Defined in

webgi/src/helpers/serialize.ts:8

---

serializeObject

▸ serializeObject(obj, isThis, meta?): any

Parameters

Name	Type	Description
obj	any
isThis	boolean	does not work for Texture, Material, Vector, Color
meta?	any

Returns

any

Defined in

webgi/src/helpers/serialize.ts:177

---

deserializeObject

▸ deserializeObject<T>(data, object, isThis, meta?): T

todo: fix problem when deserializing twice. deserializeObject(deserializeObject(obj))

Type parameters

Name
T

Parameters

Name	Type	Description
data	any
object	T	current object that's set. If possible the data is deserialized into that instead of creating new objects.
isThis	boolean	set it to true if called from the object itself like from fromJSON()
meta	Record<string, any>

Returns

T

Defined in

webgi/src/helpers/serialize.ts:243

---

serializable

▸ serializable(id): <T>(constructor: T) => T

Parameters

Name	Type
id	string

Returns

fn

▸ <T>(constructor): T

Type parameters

Name	Type
T	extends (...args: any[]) => any

Parameters

Name	Type
constructor	T

Returns

T

Defined in

webgi/src/helpers/serialize.ts:340

---

serializeTextureInExtras

▸ serializeTextureInExtras(texture, meta, name?, mime?): { uuid: string = texture.uuid; url: any ; userData: any ; type: string = texture.type; name: undefined | string } | { uuid: string = texture.uuid; resource: string = 'extras' }

Used in LUTCubeTextureWrapper and KTX2LoadPlugin and imported in importConfigResources

Parameters

Name	Type
texture	Object
texture.uuid	string
texture.userData	any
texture.type	string
texture.source?	any
texture.name?	string
meta	any
name?	string
mime?	string

Returns

{ uuid: string = texture.uuid; url: any ; userData: any ; type: string = texture.type; name: undefined | string } | { uuid: string = texture.uuid; resource: string = 'extras' }

Defined in

webgi/src/helpers/serialize.ts:357

---

vRGBMToLinear

▸ vRGBMToLinear(value, maxRange): Vector4

Parameters

Name	Type
value	Vector4
maxRange	number

Returns

Vector4

Defined in

webgi/src/helpers/threejs/colorEncodings.ts:4

---

cRGBMToLinear

▸ cRGBMToLinear(value, maxRange): Color

Parameters

Name	Type
value	Vector4
maxRange	number

Returns

Color

Defined in

webgi/src/helpers/threejs/colorEncodings.ts:10

---

vLinearToRGBM

▸ vLinearToRGBM(value, maxRange): Vector4

Parameters

Name	Type
value	Vector4
maxRange	number

Returns

Vector4

Defined in

webgi/src/helpers/threejs/colorEncodings.ts:15

---

cLinearToRGBM

▸ cLinearToRGBM(value, maxRange): Vector4

Parameters

Name	Type
value	Color
maxRange	number

Returns

Vector4

Defined in

webgi/src/helpers/threejs/colorEncodings.ts:23

---

rotateDuplicatedMesh

▸ rotateDuplicatedMesh<T>(obj, rotations, skips, axis?): T | undefined

Type parameters

Name	Type
T	extends Object3D<Event, string, T>

Parameters

Name	Type	Default value
obj	T	undefined
rotations	number	undefined
skips	undefined | number[]	undefined
axis	"x" | "y" | "z"	'x'

Returns

T | undefined

Defined in

webgi/src/helpers/threejs/geometryUtils.ts:30

---

snapObject

▸ snapObject(viewer, object?, root?, channel?, camOffset?): string

Parameters

Name	Type	Default value
viewer	ViewerApp	undefined
object?	Object3D<Event, string>	undefined
root?	Scene<Event, string>	undefined
channel	number	7
camOffset	Vector3	undefined

Returns

string

Defined in

webgi/src/helpers/threejs/snapObject.ts:7

---

computeScreenSpaceBoundingBox

▸ computeScreenSpaceBoundingBox(obj, camera): Box2

Parameters

Name	Type
obj	Object3D<Event, string>
camera	Camera<Event, string>

Returns

Box2

Defined in

webgi/src/helpers/threejs/threeUtils.ts:30

---

getEncodingComponents

▸ getEncodingComponents(colorSpace): string[]

Parameters

Name	Type
colorSpace	ColorSpace

Returns

string[]

Defined in

webgi/src/helpers/threejs/threeUtils.ts:111

---

getTextureColorSpaceFromMap

▸ getTextureColorSpaceFromMap(map, isWebGL2): ColorSpace

Parameters

Name	Type
map	any
isWebGL2	boolean

Returns

ColorSpace

Defined in

webgi/src/helpers/threejs/threeUtils.ts:140

---

getTexelDecodingFunction

▸ getTexelDecodingFunction(functionName, colorSpace): string

Parameters

Name	Type
functionName	string
colorSpace	ColorSpace

Returns

string

Defined in

webgi/src/helpers/threejs/threeUtils.ts:173

---

getTexelDecoding

▸ getTexelDecoding(mapName, map, isWebGL2): string

Parameters

Name	Type
mapName	string
map	undefined | ITexture<any>
isWebGL2	boolean

Returns

string

Defined in

webgi/src/helpers/threejs/threeUtils.ts:180

---

getTexelDecoding2

▸ getTexelDecoding2(mapName, colorSpace): string

Parameters

Name	Type
mapName	string
colorSpace	ColorSpace

Returns

string

Defined in

webgi/src/helpers/threejs/threeUtils.ts:186

---

getTexelEncodingFunction

▸ getTexelEncodingFunction(functionName, colorSpace): string

Parameters

Name	Type
functionName	string
colorSpace	ColorSpace

Returns

string

Defined in

webgi/src/helpers/threejs/threeUtils.ts:192

---

getTexelEncoding

▸ getTexelEncoding(functionName, map, isWebGL2): string

Parameters

Name	Type
functionName	string
map	ITexture<any>
isWebGL2	boolean

Returns

string

Defined in

webgi/src/helpers/threejs/threeUtils.ts:199

---

uniform

▸ uniform(__namedParameters?): PropertyDecorator

Parameters

Name	Type
__namedParameters	Object
__namedParameters.uniforms?	any
__namedParameters.propKey?	string | symbol
__namedParameters.thisTarget?	boolean

Returns

PropertyDecorator

Defined in

webgi/src/helpers/threejs/threeUtils.ts:211

---

matDefine

▸ matDefine(key?, customDefines?, thisMat?, onChange?): PropertyDecorator

Parameters

Name	Type	Default value	Description
key?	string | symbol	undefined	define name
customDefines?	any	undefined	object for setting define value (like ShaderMaterial.defines), otherwise this.material.defines is taken
thisMat	boolean	false	access this.defines instead of this.material.defines
onChange?	(...args: any[]) => any	undefined	-

Returns

PropertyDecorator

Defined in

webgi/src/helpers/threejs/threeUtils.ts:249

---

dataTextureFromColor

▸ dataTextureFromColor(color): DataTexture

Parameters

Name	Type
color	Color

Returns

DataTexture

Defined in

webgi/src/helpers/threejs/threeUtils.ts:291

---

dataTextureFromVec4

▸ dataTextureFromVec4(color): DataTexture

Parameters

Name	Type
color	Vector4

Returns

DataTexture

Defined in

webgi/src/helpers/threejs/threeUtils.ts:298

---

setThreeRendererMode

▸ setThreeRendererMode(renderer, ud, render): void

Parameters

Name	Type
renderer	WebGLRenderer
ud	Object
ud.shadowMapRender?	boolean
ud.backgroundRender?	boolean
ud.sceneRender?	boolean
ud.opaqueRender?	boolean
ud.transparentRender?	boolean
ud.transmissionRender?	boolean
ud.mainRenderPass?	boolean
ud.screenSpaceRendering?	boolean
render	() => void

Returns

void

Defined in

webgi/src/helpers/threejs/threeUtils.ts:304

---

autoCenterObject3D

▸ autoCenterObject3D(obj, undo?): Object3D<Event, string>

Parameters

Name	Type	Default value
obj	Object3D<Event, string>	undefined
undo	boolean	false

Returns

Object3D<Event, string>

Defined in

webgi/src/helpers/threejs/threeUtils.ts:339

---

autoScaleObject3D

▸ autoScaleObject3D(obj, autoScaleRadius?, isCentered?, undo?): Object3D<Event, string>

Parameters

Name	Type	Default value
obj	Object3D<Event, string>	undefined
autoScaleRadius?	number	undefined
isCentered?	boolean	undefined
undo	boolean	false

Returns

Object3D<Event, string>

Defined in

webgi/src/helpers/threejs/threeUtils.ts:358

---

toIndexedGeometry

▸ toIndexedGeometry(geometry, tolerance?): BufferGeometry<NormalBufferAttributes, Event, string>

Convert geometry to BufferGeometry with indexed attributes.

Parameters

Name	Type	Default value
geometry	BufferGeometry<NormalBufferAttributes, Event, string>	undefined
tolerance	number	-1

Returns

BufferGeometry<NormalBufferAttributes, Event, string>

Defined in

webgi/src/helpers/threejs/threeUtils.ts:409

---

addSSBevel

▸ addSSBevel(material): boolean

Parameters

Name	Type
material	Material<Event, string>

Returns

boolean

Defined in

webgi/src/passes/threejs/SSBevelPass.ts:21

---

patchShaderEncodingSupport

▸ patchShaderEncodingSupport(shader, ...textureIds): ShaderMaterialEncodingSupport

Parameters

Name	Type
shader	any
...textureIds	string[]

Returns

ShaderMaterialEncodingSupport

Defined in

webgi/src/passes/threejs/ShaderPass2.ts:165

Variables

diamondMaterialPropList

• Const diamondMaterialPropList: Partial<DiamondMaterial> | Record<string, any>

Defined in

webgi/src/extras/ijewel/utils.ts:321

---

supportsRequestStreams

• Const supportsRequestStreams: boolean

Defined in

webgi/src/extras/network/AWSClientPlugin.ts:244

---

defaultPresets

• Const defaultPresets: Object

Type declaration

Name	Type
Background	IAsset[]
Environment	IAsset[]
GemEnvironment	IAsset[]
GemEnvironment2	IAsset[]
GemEnvironment3	IAsset[]
Ground	IAsset[]
CameraViews	IAsset[]
MaterialConfiguration	IAsset[]
MaterialLibraries	IAsset[]

Defined in

webgi/src/extras/presets/simple.ts:4

---

EasingFunctions

• Const EasingFunctions: Object

Type declaration

Name	Type
linear	Easing
easeIn	Easing
easeOut	Easing
easeInOut	Easing
circIn	Easing
circOut	Easing
circInOut	Easing
backIn	Easing
backOut	Easing
backInOut	Easing
anticipate	Easing
bounceOut	(p: number) => number
bounceIn	Easing
bounceInOut	(p: number) => number
easeInOutSine	(x: number) => number

Defined in

webgi/src/helpers/animation.ts:30

---

serializers

• Const serializers: Object

Type declaration

Name	Type
obj	(obj: any, meta: any) => { [k: string]: T; }
vec4	(v: Vector4) => { x: number = v.x; y: number = v.y; z: number = v.z; w: number = v.w; isVector4: boolean = true }
vec3	(v: Vector3) => { x: number = v.x; y: number = v.y; z: number = v.z; isVector3: boolean = true }
vec2	(v: Vector2) => { x: number = v.x; y: number = v.y; isVector2: boolean = true }
color	(c: Color) => { r: number = c.r; g: number = c.g; b: number = c.b; isColor: boolean = true }
quat	(v: Quaternion) => { x: number = v.x; y: number = v.y; z: number = v.z; w: number = v.w; isQuaternion: boolean = true }
texture	(obj: any, meta?: any) => any
material	(obj: any, meta?: any) => any

Defined in

webgi/src/helpers/serialize.ts:18

---

deserializers

• Const deserializers: Object

Type declaration

Name	Type
obj	(data: any, obj: any, meta: any) => any
vec4	(v: any, o: any) => any
vec3	(v: any, o: any) => any
vec2	(v: any, o: any) => any
color	(v: any, o: any) => any
quat	(v: any, o: any) => any

Defined in

webgi/src/helpers/serialize.ts:154

---

RGBM16ColorSpace_

• Const RGBM16ColorSpace_: ColorSpace | "rgbm-16" = 'rgbm-16'

Defined in

webgi/src/helpers/threejs/threeUtils.ts:108

---

combineDofShader

• Const combineDofShader: Object

Type declaration

Name	Type
uniforms	{ colorTexture: { value: null = null } ; tNormalDepth: { value: null = null } ; blurTexture: { value: null = null } ; cocTexture: { value: null = null } ; cocTextureSize: { value: Vector2 } ; cameraNearFar: { value: Vector2 } }
uniforms.colorTexture	{ value: null = null }
uniforms.colorTexture.value	null
uniforms.tNormalDepth	{ value: null = null }
uniforms.tNormalDepth.value	null
uniforms.blurTexture	{ value: null = null }
uniforms.blurTexture.value	null
uniforms.cocTexture	{ value: null = null }
uniforms.cocTexture.value	null
uniforms.cocTextureSize	{ value: Vector2 }
uniforms.cocTextureSize.value	Vector2
uniforms.cameraNearFar	{ value: Vector2 }
uniforms.cameraNearFar.value	Vector2
vertexShader	any
fragmentShader	string

Defined in

webgi/src/passes/threejs/DepthOfFieldPass.ts:27