Class WebGPUEngine
Hierarchy
-
Engine
- WebGPUEngine
Index
Constructors
Properties
- active
View - canvas
Tab Index - counters
Last Frame - current
Render Pass Id - custom
Animation Frame Requester - disable
Manifest Check - disable
Performance Monitor InBackground - enable
Offline Support - input
Element - is
InVRExclusive Pointer Mode - is
Pointer Lock - num
Max Uncaptured Errors - on
After Shader Compilation Observable - on
Before Shader Compilation Observable - on
Begin Frame Observable - on
Canvas Blur Observable - on
Canvas Focus Observable - on
Canvas Pointer Out Observable - on
End Frame Observable - on
New Scene Added Observable - on
Resize Observable - onVRDisplay
Changed Observable - onVRRequest
Present Complete - onVRRequest
Present Start - post
Processes - scenes
- texture
Format InUse - textures
Supported - views
- vr
Presentation Attributes - ALPHA_
ADD - ALPHA_
COMBINE - ALPHA_
DISABLE - ALPHA_
INTERPOLATE - ALPHA_
MAXIMIZED - ALPHA_
MULTIPLY - ALPHA_
ONEONE - ALPHA_
PREMULTIPLIED - ALPHA_
PREMULTIPLIED_ PORTERDUFF - ALPHA_
SCREENMODE - ALPHA_
SUBTRACT - ALWAYS
- Audio
Engine Factory - DECR
- DECR_
WRAP - DELAYLOADSTATE_
LOADED - DELAYLOADSTATE_
LOADING - DELAYLOADSTATE_
NONE - DELAYLOADSTATE_
NOTLOADED - EQUAL
- GEQUAL
- GREATER
- INCR
- INCR_
WRAP - INVERT
- KEEP
- LEQUAL
- LESS
- NEVER
- NOTEQUAL
- Offline
Provider Factory - REPLACE
- SCALEMODE_
CEILING - SCALEMODE_
FLOOR - SCALEMODE_
NEAREST - TEXTUREFORMAT_
ALPHA - TEXTUREFORMAT_
LUMINANCE - TEXTUREFORMAT_
LUMINANCE_ ALPHA - TEXTUREFORMAT_
R - TEXTUREFORMAT_
RED - TEXTUREFORMAT_
RED_ INTEGER - TEXTUREFORMAT_
RG - TEXTUREFORMAT_
RGB - TEXTUREFORMAT_
RGBA - TEXTUREFORMAT_
RGBA_ INTEGER - TEXTUREFORMAT_
RGB_ INTEGER - TEXTUREFORMAT_
RG_ INTEGER - TEXTUREFORMAT_
R_INTEGER - TEXTURETYPE_
BYTE - TEXTURETYPE_
FLOAT - TEXTURETYPE_
FLOAT_ 32_ UNSIGNED_ INT_ 24_ 8_REV - TEXTURETYPE_
HALF_ FLOAT - TEXTURETYPE_
INT - TEXTURETYPE_
SHORT - TEXTURETYPE_
UNSIGNED_ BYTE - TEXTURETYPE_
UNSIGNED_ INT - TEXTURETYPE_
UNSIGNED_ INTEGER - TEXTURETYPE_
UNSIGNED_ INT_ 10 F_ 11 F_ 11 F_ REV - TEXTURETYPE_
UNSIGNED_ INT_ 24_ 8 - TEXTURETYPE_
UNSIGNED_ INT_ 2_10_ 10_ 10_ REV - TEXTURETYPE_
UNSIGNED_ INT_ 5_9_ 9_9_ REV - TEXTURETYPE_
UNSIGNED_ SHORT - TEXTURETYPE_
UNSIGNED_ SHORT_ 4_4_ 4_4 - TEXTURETYPE_
UNSIGNED_ SHORT_ 5_5_ 5_1 - TEXTURETYPE_
UNSIGNED_ SHORT_ 5_6_ 5 - TEXTURE_
BILINEAR_ SAMPLINGMODE - TEXTURE_
CLAMP_ ADDRESSMODE - TEXTURE_
CUBIC_ MODE - TEXTURE_
EQUIRECTANGULAR_ MODE - TEXTURE_
EXPLICIT_ MODE - TEXTURE_
FIXED_ EQUIRECTANGULAR_ MIRRORED_ MODE - TEXTURE_
FIXED_ EQUIRECTANGULAR_ MODE - TEXTURE_
INVCUBIC_ MODE - TEXTURE_
LINEAR_ LINEAR - TEXTURE_
LINEAR_ LINEAR_ MIPLINEAR - TEXTURE_
LINEAR_ LINEAR_ MIPNEAREST - TEXTURE_
LINEAR_ NEAREST - TEXTURE_
LINEAR_ NEAREST_ MIPLINEAR - TEXTURE_
LINEAR_ NEAREST_ MIPNEAREST - TEXTURE_
MIRROR_ ADDRESSMODE - TEXTURE_
NEAREST_ LINEAR - TEXTURE_
NEAREST_ LINEAR_ MIPLINEAR - TEXTURE_
NEAREST_ LINEAR_ MIPNEAREST - TEXTURE_
NEAREST_ NEAREST - TEXTURE_
NEAREST_ NEAREST_ MIPLINEAR - TEXTURE_
NEAREST_ NEAREST_ MIPNEAREST - TEXTURE_
NEAREST_ SAMPLINGMODE - TEXTURE_
PLANAR_ MODE - TEXTURE_
PROJECTION_ MODE - TEXTURE_
SKYBOX_ MODE - TEXTURE_
SPHERICAL_ MODE - TEXTURE_
TRILINEAR_ SAMPLINGMODE - TEXTURE_
WRAP_ ADDRESSMODE - UseTWGSL
- _
Rescale Post Process Factory - audio
Engine
Accessors
- compatibility
Mode - description
- disable
Cache Bind Groups - disable
Cache Render Pipelines - disable
Cache Samplers - enabled
Extensions - loading
Screen - loadingUIBackground
Color - loadingUIText
- needPOTTextures
- performance
Monitor - snapshot
Rendering - snapshot
Rendering Mode - supported
Extensions - supports
Uniform Buffers - version
- Instances
- Is
Supported - Is
Supported Async - Last
Created Engine - Last
Created Scene - Npm
Package - Version
Methods
- _create
Image Bitmap From Source - _delete
Pipeline Context - _render
Loop - are
All Effects Ready - begin
Frame - begin
Occlusion Query - begin
Transform Feedback - bind
Buffers - bind
Framebuffer - bind
Multiview Framebuffer - bind
Transform Feedback - bind
Transform Feedback Buffer - cache
Stencil State - captureGPUFrame
Time - clear
- create
Draw Context - create
Dynamic Vertex Buffer - create
Effect - create
Effect For Particles - create
Image Bitmap - create
Index Buffer - create
Instances Buffer - create
Material Context - create
Multiview Render Target Texture - create
Pipeline Context - create
Query - create
Render Pass Id - create
Texture - create
Transform Feedback - create
Vertex Buffer - create
Video Element - delete
Instances Buffer - delete
Query - delete
Transform Feedback - disable
Scissor - disableVR
- display
LoadingUI - dispose
- draw
Arrays Type - draw
Elements Type - enable
Effect - enable
Scissor - enableVR
- end
Frame - end
Occlusion Query - end
Time Query - end
Transform Feedback - enter
Fullscreen - enter
Pointerlock - exit
Fullscreen - exit
Pointerlock - flush
Framebuffer - generate
Mip Maps For Cubemap - generate
Mipmaps - get
Alpha Equation - get
Alpha Mode - get
Aspect Ratio - get
Attributes - get
Color Write - get
Current Render Pass Name - get
Delta Time - get
Depth Buffer - get
Depth Function - get
Depth Write - get
Error - get
Font Offset - get
Fps - get
Fragment Shader Source - getGPUFrame
Time Counter - get
Info - get
Input Element - get
Input Element Client Rect - get
Lockstep Max Steps - get
Query Result - get
Render Height - get
Render Pass Names - get
Render Width - get
Rendering Canvas - get
Rendering Canvas Client Rect - get
Screen Aspect Ratio - get
Stencil Buffer - get
Stencil Function - get
Stencil Function Mask - get
Stencil Function Reference - get
Stencil Mask - get
Stencil Operation Depth Fail - get
Stencil Operation Fail - get
Stencil Operation Pass - get
Time Step - getVRDevice
- get
Vertex Shader Source - hide
LoadingUI - init
Async - init
WebVR - init
WebVRAsync - inline
Shader Code - is
Deterministic Lock Step - is
Query Result Available - isVRDevice
Present - isVRPresenting
- read
Pixels - register
View - release
Effects - release
Render Pass Id - resize
- resize
Image Bitmap - restore
Default Framebuffer - restore
Stencil State - scissor
Clear - set
Alpha Constants - set
Alpha Equation - set
Alpha Mode - set
Color Write - set
Compressed Texture Exclusions - set
Depth Buffer - set
Depth Function - set
Depth Function ToGreater - set
Depth Function ToGreater OrEqual - set
Depth Function ToLess - set
Depth Function ToLess OrEqual - set
Depth Stencil Texture - set
Depth Write - set
Direct Viewport - set
Dithering State - set
Rasterizer State - set
Size - set
State - set
Stencil Buffer - set
Stencil Function - set
Stencil Function Mask - set
Stencil Function Reference - set
Stencil Mask - set
Stencil Operation Depth Fail - set
Stencil Operation Fail - set
Stencil Operation Pass - set
Texture - set
Texture Array - set
Texture Format ToUse - set
Texture From Post Process - set
Texture From Post Process Output - set
Tranform Feedback Varyings - snapshot
Rendering Reset - start
Time Query - switch
Fullscreen - un
Bind Framebuffer - un
Register View - update
Texture Comparison Function - update
Texture Data - update
Texture Dimensions - update
Texture Sampling Mode - update
Texture Wrapping Mode - wipe
Caches - wrap
WebGLTexture - wrap
WebGPUTexture - Create
Async - Default
Loading Screen Factory - Mark
All Materials AsDirty - _
Exit Fullscreen - _
Exit Pointerlock - _
Request Fullscreen - _
Request Pointerlock
Constructors
constructor
-
Create a new instance of the gpu engine.
Parameters
-
canvas: HTMLCanvasElement
Defines the canvas to use to display the result
-
Optional options: WebGPUEngineOptions
Defines the options passed to the engine to create the GPU context dependencies
Returns WebGPUEngine
-
Properties
active
Gets the current engine view
canvas
Gets or sets the tab index to set to the rendering canvas. 1 is the minimum value to set to be able to capture keyboard events
Readonly counters
Counters from last frame
Type declaration
-
num
Bundle Creation Non Compat Mode: number -
num
Bundle Reuse Non Compat Mode: number -
num
Enable Draw Wrapper: number -
num
Enable Effects: number
current
Gets or sets the current render pass id
custom
If set, will be used to request the next animation frame for the render loop
disable
Gets or sets a boolean to enable/disable checking manifest if IndexedDB support is enabled (js will always consider the database is up to date)
disable
Turn this value on if you want to pause FPS computation when in background
enable
Gets or sets a boolean to enable/disable IndexedDB support and avoid XHR on .manifest
input
Gets or sets the HTML element to use for attaching events
is
Gets a boolean indicating that the engine is currently in VR exclusive mode for the pointers
is
Gets a boolean indicating if the pointer is currently locked
num
Max number of uncaptured error messages to log
on
Observable raised when the engine has just compiled a shader
on
Observable raised when the engine is about to compile a shader
on
Observable raised when the engine begins a new frame
on
Observable event triggered each time the canvas loses focus
on
Observable event triggered each time the canvas gains focus
on
Observable event triggered each time the canvas receives pointerout event
on
Observable raised when the engine ends the current frame
on
Event raised when a new scene is created
on
Observable event triggered each time the rendering canvas is resized
onVRDisplay
Observable signaled when VR display mode changes
onVRRequest
Observable signaled when VR request present is complete
onVRRequest
Observable signaled when VR request present starts
post
Gets the list of created postprocesses
scenesSearch playground for scenes
Gets the list of created scenes
Readonly texture
Gets the texture format in use
Readonly textures
Gets the list of texture formats supported
viewsSearch playground for views
Gets or sets the list of views
Optional vr
Gets or sets the presentation attributes used to configure VR rendering
Static Readonly ALPHA_
Defines that alpha blending to SRC ALPHA * SRC + DEST
Static Readonly ALPHA_
Defines that alpha blending to SRC ALPHA * SRC + (1 - SRC ALPHA) * DEST
Static Readonly ALPHA_
Defines that alpha blending is disabled
Static Readonly ALPHA_
Defines that alpha blending to CST * SRC + (1 - CST) * DEST
Static Readonly ALPHA_
Defines that alpha blending to SRC ALPHA * SRC + (1 - SRC) * DEST
Static Readonly ALPHA_
Defines that alpha blending to SRC * DEST
Static Readonly ALPHA_
Defines that alpha blending to SRC + DEST
Static Readonly ALPHA_
Defines that alpha blending to SRC + (1 - SRC ALPHA) * DEST
Static Readonly ALPHA_
Defines that alpha blending to SRC + (1 - SRC ALPHA) * DEST Alpha will be set to (1 - SRC ALPHA) * DEST ALPHA
Static Readonly ALPHA_
Defines that alpha blending to SRC + (1 - SRC) * DEST Alpha will be set to SRC ALPHA + (1 - SRC ALPHA) * DEST ALPHA
Static Readonly ALPHA_
Defines that alpha blending to DEST - SRC * DEST
Static Readonly ALWAYSSearch playground for ALWAYS
Passed to depthFunction or stencilFunction to specify depth or stencil tests will always pass. i.e. Pixels will be drawn in the order they are drawn
Static Audio
Default AudioEngine factory responsible of creating the Audio Engine. By default, this will create a BabylonJS Audio Engine if the workload has been embedded.
Type declaration
-
-
Parameters
-
hostElement: Nullable<HTMLElement>
-
audioContext: Nullable<AudioContext>
-
audioDestination: Nullable<AudioDestinationNode | MediaStreamAudioDestinationNode>
Returns IAudioEngine
-
-
Static Readonly DECRSearch playground for DECR
Passed to stencilOperation to specify that stencil value must be decremented
Static Readonly DECR_
Passed to stencilOperation to specify that stencil value must be decremented with wrapping
Static Readonly DELAYLOADSTATE_
Defines that the resource was successfully delay loaded
Static Readonly DELAYLOADSTATE_
Defines that the resource is currently delay loading
Static Readonly DELAYLOADSTATE_
Defines that the resource is not delayed
Static Readonly DELAYLOADSTATE_
Defines that the resource is delayed and has not started loading
Static Readonly EQUALSearch playground for EQUAL
Passed to depthFunction or stencilFunction to specify depth or stencil tests will pass if the new depth value is equals to the stored value
Static Readonly GEQUALSearch playground for GEQUAL
Passed to depthFunction or stencilFunction to specify depth or stencil tests will pass if the new depth value is greater than or equal to the stored value
Static Readonly GREATERSearch playground for GREATER
Passed to depthFunction or stencilFunction to specify depth or stencil tests will pass if the new depth value is greater than the stored value
Static Readonly INCRSearch playground for INCR
Passed to stencilOperation to specify that stencil value must be incremented
Static Readonly INCR_
Passed to stencilOperation to specify that stencil value must be incremented with wrapping
Static Readonly INVERTSearch playground for INVERT
Passed to stencilOperation to specify that stencil value must be inverted
Static Readonly KEEPSearch playground for KEEP
Passed to stencilOperation to specify that stencil value must be kept
Static Readonly LEQUALSearch playground for LEQUAL
Passed to depthFunction or stencilFunction to specify depth or stencil tests will pass if the new depth value is less than or equal to the stored value
Static Readonly LESSSearch playground for LESS
Passed to depthFunction or stencilFunction to specify depth or stencil tests will pass if the new depth value is less than the stored value
Static Readonly NEVERSearch playground for NEVER
Passed to depthFunction or stencilFunction to specify depth or stencil tests will never pass. i.e. Nothing will be drawn
Static Readonly NOTEQUALSearch playground for NOTEQUAL
Passed to depthFunction or stencilFunction to specify depth or stencil tests will pass if the new depth value is not equal to the stored value
Static Offline
Default offline support factory responsible of creating a tool used to store data locally. By default, this will create a Database object if the workload has been embedded.
Type declaration
-
-
Parameters
-
urlToScene: string
-
callbackManifestChecked: (checked: boolean) => any
-
-
Parameters
-
checked: boolean
Returns any
-
-
-
-
disableManifestCheck: boolean
Returns IOfflineProvider
-
-
Static Readonly REPLACESearch playground for REPLACE
Passed to stencilOperation to specify that stencil value must be replaced
Static Readonly SCALEMODE_
Defines that texture rescaling will use a ceil to find the closer power of 2 size
Static Readonly SCALEMODE_
Defines that texture rescaling will use a floor to find the closer power of 2 size
Static Readonly SCALEMODE_
Defines that texture rescaling will look for the nearest power of 2 size
Static Readonly TEXTUREFORMAT_
ALPHA
Static Readonly TEXTUREFORMAT_
LUMINANCE
Static Readonly TEXTUREFORMAT_
LUMINANCE_ALPHA
Static Readonly TEXTUREFORMAT_
RED (2nd reference)
Static Readonly TEXTUREFORMAT_
RED
Static Readonly TEXTUREFORMAT_
RED_INTEGER
Static Readonly TEXTUREFORMAT_
RG
Static Readonly TEXTUREFORMAT_
RGB
Static Readonly TEXTUREFORMAT_
RGBA
Static Readonly TEXTUREFORMAT_
RGBA_INTEGER
Static Readonly TEXTUREFORMAT_
RGB_INTEGER
Static Readonly TEXTUREFORMAT_
RG_INTEGER
Static Readonly TEXTUREFORMAT_
RED_INTEGER (2nd reference)
Static Readonly TEXTURETYPE_
BYTE
Static Readonly TEXTURETYPE_
FLOAT
Static Readonly TEXTURETYPE_
FLOAT_32_UNSIGNED_INT_24_8_REV
Static Readonly TEXTURETYPE_
HALF_FLOAT
Static Readonly TEXTURETYPE_
INT
Static Readonly TEXTURETYPE_
SHORT
Static Readonly TEXTURETYPE_
UNSIGNED_BYTE
Static Readonly TEXTURETYPE_
UNSIGNED_BYTE (2nd reference)
Static Readonly TEXTURETYPE_
UNSIGNED_INT
Static Readonly TEXTURETYPE_
UNSIGNED_INT_10F_11F_11F_REV
Static Readonly TEXTURETYPE_
UNSIGNED_INT_24_8
Static Readonly TEXTURETYPE_
UNSIGNED_INT_2_10_10_10_REV
Static Readonly TEXTURETYPE_
UNSIGNED_INT_5_9_9_9_REV
Static Readonly TEXTURETYPE_
UNSIGNED_SHORT
Static Readonly TEXTURETYPE_
UNSIGNED_SHORT_4_4_4_4
Static Readonly TEXTURETYPE_
UNSIGNED_SHORT_5_5_5_1
Static Readonly TEXTURETYPE_
UNSIGNED_SHORT_5_6_5
Static Readonly TEXTURE_
Bilinear is mag = linear and min = linear and mip = nearest
Static Readonly TEXTURE_
Texture is not repeating outside of 0..1 UVs
Static Readonly TEXTURE_
Cubic coordinates mode
Static Readonly TEXTURE_
Equirectangular coordinates mode
Static Readonly TEXTURE_
Explicit coordinates mode
Static Readonly TEXTURE_
Equirectangular Fixed Mirrored coordinates mode
Static Readonly TEXTURE_
Equirectangular Fixed coordinates mode
Static Readonly TEXTURE_
Inverse Cubic coordinates mode
Static Readonly TEXTURE_
mag = linear and min = linear and mip = none
Static Readonly TEXTURE_
Trilinear is mag = linear and min = linear and mip = linear
Static Readonly TEXTURE_
Bilinear is mag = linear and min = linear and mip = nearest
Static Readonly TEXTURE_
mag = linear and min = nearest and mip = none
Static Readonly TEXTURE_
mag = linear and min = nearest and mip = linear
Static Readonly TEXTURE_
mag = linear and min = nearest and mip = nearest
Static Readonly TEXTURE_
Texture is repeating and mirrored
Static Readonly TEXTURE_
mag = nearest and min = linear and mip = none
Static Readonly TEXTURE_
mag = nearest and min = linear and mip = linear
Static Readonly TEXTURE_
mag = nearest and min = linear and mip = nearest
Static Readonly TEXTURE_
mag = nearest and min = nearest and mip = none
Static Readonly TEXTURE_
nearest is mag = nearest and min = nearest and mip = linear
Static Readonly TEXTURE_
mag = nearest and min = nearest and mip = nearest
Static Readonly TEXTURE_
nearest is mag = nearest and min = nearest and mip = none
Static Readonly TEXTURE_
Planar coordinates mode
Static Readonly TEXTURE_
Projection coordinates mode
Static Readonly TEXTURE_
Skybox coordinates mode
Static Readonly TEXTURE_
Spherical coordinates mode
Static Readonly TEXTURE_
Trilinear is mag = linear and min = linear and mip = linear
Static Readonly TEXTURE_
Texture is repeating outside of 0..1 UVs
Static UseTWGSLSearch playground for UseTWGSL
true to enable using TintWASM to convert Spir-V to WGSL
Static _
Method called to create the default rescale post process on each engine.
Static audio
Gets the audio engine
Accessors
compatibility
-
(WebGPU only) True (default) to be in compatibility mode, meaning rendering all existing scenes without artifacts (same rendering than WebGL). Setting the property to false will improve performances but may not work in some scenes if some precautions are not taken. See https://doc.babylonjs.com/advanced_topics/webGPU/webGPUOptimization/webGPUNonCompatibilityMode for more details
Returns boolean
-
(WebGPU only) True (default) to be in compatibility mode, meaning rendering all existing scenes without artifacts (same rendering than WebGL). Setting the property to false will improve performances but may not work in some scenes if some precautions are not taken. See https://doc.babylonjs.com/advanced_topics/webGPU/webGPUOptimization/webGPUNonCompatibilityMode for more details
Parameters
-
mode: boolean
Returns any
-
description
-
Returns a string describing the current engine
Returns string
disable
-
Sets this to true to disable the cache for the bind groups. You should do it only for testing purpose!
Returns boolean
-
Sets this to true to disable the cache for the bind groups. You should do it only for testing purpose!
Parameters
-
disable: boolean
Returns any
-
disable
-
Sets this to true to disable the cache for the render pipelines. You should do it only for testing purpose!
Returns boolean
-
Sets this to true to disable the cache for the render pipelines. You should do it only for testing purpose!
Parameters
-
disable: boolean
Returns any
-
disable
-
Sets this to true to disable the cache for the samplers. You should do it only for testing purpose!
Returns boolean
-
Sets this to true to disable the cache for the samplers. You should do it only for testing purpose!
Parameters
-
disable: boolean
Returns any
-
enabled
-
Gets the currently enabled extensions on the WebGPU device
Returns Immutable<GPUFeatureName[]>
loading
-
Gets the current loading screen object
Returns ILoadingScreen
-
Sets the current loading screen object
Parameters
-
loadingScreen: ILoadingScreen
Returns any
-
loadingUIBackground
-
Sets the current loading screen background color
Parameters
-
color: string
Returns any
-
loadingUIText
-
Sets the current loading screen text
Parameters
-
text: string
Returns any
-
needPOTTextures
-
Gets a boolean indicating that only power of 2 textures are supported Please note that you can still use non power of 2 textures but in this case the engine will forcefully convert them
Returns boolean
performance
-
Gets the performance monitor attached to this engine
Returns PerformanceMonitor
snapshot
-
Enables or disables the snapshot rendering mode Note that the WebGL engine does not support snapshot rendering so setting the value won't have any effect for this engine
Returns boolean
-
Enables or disables the snapshot rendering mode Note that the WebGL engine does not support snapshot rendering so setting the value won't have any effect for this engine
Parameters
-
activate: boolean
Returns any
-
snapshot
-
Gets or sets the snapshot rendering mode
Returns number
-
Gets or sets the snapshot rendering mode
Parameters
-
mode: number
Returns any
-
supported
-
Gets the supported extensions by the WebGPU adapter
Returns Immutable<GPUFeatureName[]>
supports
-
Gets a boolean indicating that the engine supports uniform buffers
Returns boolean
version
-
Returns the version of the engine
Returns number
Static Instances
-
Gets the list of created engines
Returns Engine[]
Static Is
-
Not supported by WebGPU, you should call IsSupportedAsync instead!
Returns boolean
Static Is
Returns Promise<boolean>
Static Last
Static Last
Static Npm
-
Returns the current npm package of the sdk
Returns string
Static Version
-
Returns the current version of the framework
Returns string
Methods
_create
-
Engine abstraction for loading and creating an image bitmap from a given source string.
Parameters
-
imageSource: string
source to load the image from.
-
Optional options: ImageBitmapOptions
An object that sets options for the image's extraction.
Returns Promise<ImageBitmap>
ImageBitmap.
-
_delete
-
Parameters
-
pipelineContext: IPipelineContext
Returns void
-
_render
-
Returns void
are
-
Gets a boolean indicating if all created effects are ready
Returns boolean
always true - No parallel shader compilation
begin
-
Begin a new frame
Returns void
begin
-
Initiates an occlusion query
Parameters
-
algorithmType: number
defines the algorithm to use
-
query: OcclusionQuery
defines the query to use
Returns boolean
the current engine
-
begin
-
Begins a transform feedback operation
Parameters
-
usePoints: boolean
defines if points or triangles must be used
Returns void
-
bind
-
Bind a list of vertex buffers with the engine
Parameters
-
vertexBuffers: {}
defines the list of vertex buffers to bind
-
[key: string]: Nullable<VertexBuffer>
-
-
indexBuffer: Nullable<DataBuffer>
defines the index buffer to bind
-
effect: Effect
defines the effect associated with the vertex buffers
-
Optional overrideVertexBuffers: {}
defines optional list of avertex buffers that overrides the entries in vertexBuffers
-
[kind: string]: Nullable<VertexBuffer>
-
Returns void
-
bind
-
Binds the frame buffer to the specified texture.
Parameters
-
texture: RenderTargetWrapper
The render target wrapper to render to
-
Optional faceIndex: number
The face of the texture to render to in case of cube texture
-
Optional requiredWidth: number
The width of the target to render to
-
Optional requiredHeight: number
The height of the target to render to
-
Optional forceFullscreenViewport: boolean
Forces the viewport to be the entire texture/screen if true
-
Optional lodLevel: number
defines the lod level to bind to the frame buffer
-
Optional layer: number
defines the 2d array index to bind to frame buffer to
Returns void
-
bind
-
Binds a multiview render target wrapper to be drawn to
Parameters
-
multiviewTexture: RenderTargetWrapper
render target wrapper to bind
Returns void
-
bind
-
Bind a webGL transform feedback object to the webgl context
Parameters
-
value: Nullable<WebGLTransformFeedback>
defines the webGL transform feedback object to bind
Returns void
-
bind
-
Bind a webGL buffer for a transform feedback operation
Parameters
-
value: Nullable<DataBuffer>
defines the webGL buffer to bind
Returns void
-
cache
-
Caches the the state of the stencil buffer
Returns void
captureGPUFrame
-
Enable or disable the GPU frame time capture
Parameters
-
value: boolean
True to enable, false to disable
Returns void
-
clearSearch playground for clear
-
Clear the current render buffer or the current render target (if any is set up)
Parameters
-
color: Nullable<IColor4Like>
defines the color to use
-
backBuffer: boolean
defines if the back buffer must be cleared
-
depth: boolean
defines if the depth buffer must be cleared
-
Optional stencil: boolean
defines if the stencil buffer must be cleared
Returns void
-
create
-
Creates a new draw context
Returns WebGPUDrawContext | undefined
the new context
create
-
Creates a vertex buffer
Parameters
-
data: DataArray
the data for the dynamic vertex buffer
Returns DataBuffer
the new buffer
-
create
-
Create a new effect (used to store vertex/fragment shaders)
Parameters
-
baseName: any
defines the base name of the effect (The name of file without .fragment.fx or .vertex.fx)
-
attributesNamesOrOptions: string[] | IEffectCreationOptions
defines either a list of attribute names or an IEffectCreationOptions object
-
uniformsNamesOrEngine: string[] | Engine
defines either a list of uniform names or the engine to use
-
Optional samplers: string[]
defines an array of string used to represent textures
-
Optional defines: string
defines the string containing the defines to use to compile the shaders
-
Optional fallbacks: EffectFallbacks
defines the list of potential fallbacks to use if shader compilation fails
-
Optional onCompiled: Nullable<(effect: Effect) => void>
defines a function to call when the effect creation is successful
-
Optional onError: Nullable<(effect: Effect, errors: string) => void>
defines a function to call when the effect creation has failed
-
Optional indexParameters: any
defines an object containing the index values to use to compile shaders (like the maximum number of simultaneous lights)
-
Optional shaderLanguage: ShaderLanguage
the language the shader is written in (default: GLSL)
Returns Effect
the new Effect
-
create
-
Create an effect to use with particle systems. Please note that some parameters like animation sheets or not being billboard are not supported in this configuration, except if you pass the particle system for which you want to create a custom effect in the last parameter
Parameters
-
fragmentName: string
defines the base name of the effect (The name of file without .fragment.fx)
-
uniformsNames: string[]
defines a list of attribute names
-
samplers: string[]
defines an array of string used to represent textures
-
defines: string
defines the string containing the defines to use to compile the shaders
-
Optional fallbacks: EffectFallbacks
defines the list of potential fallbacks to use if shader compilation fails
-
Optional onCompiled: (effect: Effect) => void
defines a function to call when the effect creation is successful
-
-
Parameters
-
effect: Effect
Returns void
-
-
-
-
Optional onError: (effect: Effect, errors: string) => void
defines a function to call when the effect creation has failed
-
-
Parameters
-
effect: Effect
-
errors: string
Returns void
-
-
-
-
Optional particleSystem: IParticleSystem
the particle system you want to create the effect for
Returns Effect
the new Effect
-
create
-
Engine abstraction for createImageBitmap
Parameters
-
image: ImageBitmapSource
source for image
-
Optional options: ImageBitmapOptions
An object that sets options for the image's extraction.
Returns Promise<ImageBitmap>
ImageBitmap
-
create
-
Creates a new index buffer
Parameters
-
indices: IndicesArray
defines the content of the index buffer
Returns DataBuffer
a new buffer
-
create
-
Creates a webGL buffer to use with instantiation
Parameters
-
capacity: number
defines the size of the buffer
Returns DataBuffer
the webGL buffer
-
create
-
Creates a new material context
Returns WebGPUMaterialContext | undefined
the new context
create
-
Creates a new multiview render target
Parameters
-
width: number
defines the width of the texture
-
height: number
defines the height of the texture
Returns RenderTargetWrapper
the created multiview render target wrapper
-
create
-
Creates a new pipeline context
Parameters
-
shaderProcessingContext: Nullable<ShaderProcessingContext>
defines the shader processing context used during the processing if available
Returns IPipelineContext
the new pipeline
-
create
-
Create a new webGL query (you must be sure that queries are supported by checking getCaps() function)
Returns OcclusionQuery
the new query
create
-
Creates a render pass id
Parameters
-
Optional name: string
Name of the render pass (for debug purpose only)
Returns number
the id of the new render pass
-
create
-
Usually called from Texture.ts. Passed information to create a hardware texture
Parameters
-
url: Nullable<string>
defines a value which contains one of the following:
- A conventional http URL, e.g. 'http://...' or 'file://...'
- A base64 string of in-line texture data, e.g. 'data:image/jpg;base64,/...'
- An indicator that data being passed using the buffer parameter, e.g. 'data:mytexture.jpg'
-
noMipmap: boolean
defines a boolean indicating that no mipmaps shall be generated. Ignored for compressed textures. They must be in the file
-
invertY: boolean
when true, image is flipped when loaded. You probably want true. Certain compressed textures may invert this if their default is inverted (eg. ktx)
-
scene: Nullable<ISceneLike>
needed for loading to the correct scene
-
Optional samplingMode: number
mode with should be used sample / access the texture (Default: Texture.TRILINEAR_SAMPLINGMODE)
-
Optional onLoad: Nullable<(texture: InternalTexture) => void>
optional callback to be called upon successful completion
-
Optional onError: Nullable<(message: string, exception: any) => void>
optional callback to be called upon failure
-
Optional buffer: Nullable<string | ArrayBuffer | ArrayBufferView | HTMLImageElement | Blob | ImageBitmap>
a source of a file previously fetched as either a base64 string, an ArrayBuffer (compressed or image format), HTMLImageElement (image format), or a Blob
-
Optional fallback: Nullable<InternalTexture>
an internal argument in case the function must be called again, due to etc1 not having alpha capabilities
-
Optional format: Nullable<number>
internal format. Default: RGB when extension is '.jpg' else RGBA. Ignored for compressed textures
-
Optional forcedExtension: Nullable<string>
defines the extension to use to pick the right loader
-
Optional mimeType: string
defines an optional mime type
-
Optional loaderOptions: any
options to be passed to the loader
-
Optional creationFlags: number
specific flags to use when creating the texture (Constants.TEXTURE_CREATIONFLAG_STORAGE for storage textures, for eg)
-
Optional useSRGBBuffer: boolean
defines if the texture must be loaded in a sRGB GPU buffer (if supported by the GPU).
Returns InternalTexture
a InternalTexture for assignment back into BABYLON.Texture
-
create
-
Creates a webGL transform feedback object Please makes sure to check webGLVersion property to check if you are running webGL 2+
Returns WebGLTransformFeedback
the webGL transform feedback object
create
-
Creates a vertex buffer
Parameters
-
data: DataArray
the data for the vertex buffer
Returns DataBuffer
the new buffer
-
create
-
creates and returns a new video element
Parameters
-
constraints: MediaTrackConstraints
video constraints
Returns any
video element
-
delete
-
Delete a webGL buffer used with instantiation
Parameters
-
buffer: WebGLBuffer
defines the webGL buffer to delete
Returns void
-
delete
-
Delete and release a webGL query
Parameters
-
query: OcclusionQuery
defines the query to delete
Returns Engine
the current engine
-
delete
-
Delete a webGL transform feedback object
Parameters
-
value: WebGLTransformFeedback
defines the webGL transform feedback object to delete
Returns void
-
disable
-
Returns void
disableVRSearch playground for disableVR
-
Call this function to leave webVR mode Will do nothing if webVR is not supported or if there is no webVR device
Returns void
display
-
Display the loading screen
Returns void
disposeSearch playground for dispose
-
Dispose and release all associated resources
Returns void
draw
-
Draw a list of unindexed primitives
Parameters
-
fillMode: number
defines the primitive to use
-
verticesStart: number
defines the index of first vertex to draw
-
verticesCount: number
defines the count of vertices to draw
-
Optional instancesCount: number
defines the number of instances to draw (if instantiation is enabled)
Returns void
-
draw
-
Draw a list of indexed primitives
Parameters
-
fillMode: number
defines the primitive to use
-
indexStart: number
defines the starting index
-
indexCount: number
defines the number of index to draw
-
Optional instancesCount: number
defines the number of instances to draw (if instantiation is enabled)
Returns void
-
enable
enable
-
Parameters
-
x: number
-
y: number
-
width: number
-
height: number
Returns void
-
enableVRSearch playground for enableVR
-
Call this function to switch to webVR mode Will do nothing if webVR is not supported or if there is no webVR device
Parameters
-
options: WebVROptions
the webvr options provided to the camera. mainly used for multiview
Returns void
-
end
-
End the current frame
Returns void
end
-
Ends an occlusion query
Parameters
-
algorithmType: number
defines the algorithm to use
Returns Engine
the current engine
-
end
-
Ends a time query
Parameters
-
token: _TimeToken
defines the token used to measure the time span
Returns int
the time spent (in ns)
-
end
-
Ends a transform feedback operation
Returns void
enter
-
Enters full screen mode
Parameters
-
requestPointerLock: boolean
defines if a pointer lock should be requested from the user
Returns void
-
enter
-
Enters Pointerlock mode
Returns void
exit
-
Exits full screen mode
Returns void
exit
-
Exits Pointerlock mode
Returns void
flush
-
Force a WebGPU flush (ie. a flush of all waiting commands)
Parameters
-
Optional reopenPass: boolean
true to reopen at the end of the function the pass that was active when entering the function
Returns void
-
generate
-
Parameters
-
texture: InternalTexture
Returns void
-
generate
-
Generates the mipmaps for a texture
Parameters
-
texture: InternalTexture
texture to generate the mipmaps for
Returns void
-
get
-
Gets the current alpha equation.
Returns number
the current alpha equation
get
-
Gets the current alpha mode
Returns number
the current alpha mode
get
-
Gets current aspect ratio
Parameters
-
viewportOwner: IViewportOwnerLike
defines the camera to use to get the aspect ratio
-
Optional useScreen: boolean
defines if screen size must be used (or the current render target if any)
Returns number
a number defining the aspect ratio
-
get
-
Gets the list of active attributes for a given WebGPU program
Parameters
-
pipelineContext: IPipelineContext
defines the pipeline context to use
-
attributesNames: string[]
defines the list of attribute names to get
Returns number[]
an array of indices indicating the offset of each attribute
-
get
-
Gets a boolean indicating if color writing is enabled
Returns boolean
the current color writing state
get
-
Gets the name of the current render pass
Returns string
name of the current render pass
get
-
Gets the time spent between current and previous frame
Returns number
a number representing the delta time in ms
get
-
Gets a boolean indicating if depth testing is enabled
Returns boolean
the current state
get
-
Gets the current depth function
Returns Nullable<number>
a number defining the depth function
get
-
Gets a boolean indicating if depth writing is enabled
Returns boolean
the current depth writing state
get
-
Get the current error code of the WebGPU context
Returns number
the error code
get
-
Get Font size information
Parameters
-
font: string
font name
Returns { ascent: number; descent: number; height: number }
an object containing ascent, height and descent
-
ascent: number
-
descent: number
-
height: number
-
get
-
Gets the current framerate
Returns number
a number representing the framerate
get
-
Gets the source code of the fragment shader associated with a specific webGL program
Parameters
-
program: WebGLProgram
defines the program to use
Returns Nullable<string>
a string containing the source code of the fragment shader associated with the program
-
getGPUFrame
-
Get the performance counter associated with the frame time computation
Returns PerfCounter
the perf counter
get
-
Gets an object containing information about the current engine context
Returns { renderer: string; vendor: string; version: string }
an object containing the vendor, the renderer and the version of the current engine context
-
renderer: string
-
vendor: string
-
version: string
-
get
-
Gets the HTML element used to attach event listeners
Returns Nullable<HTMLElement>
a HTML element
get
-
Gets the client rect of the HTML element used for events
Returns Nullable<ClientRect>
a client rectangle
get
-
Gets the max steps when engine is running in deterministic lock step
Returns number
the max steps
get
-
Gets the value of a given query
Parameters
-
query: OcclusionQuery
defines the query to check
Returns number
the value of the query
-
get
-
Gets the current render height
Parameters
-
Optional useScreen: boolean
defines if screen size must be used (or the current render target if any)
Returns number
a number defining the current render height
-
get
-
Gets the names of the render passes that are currently created
Returns string[]
list of the render pass names
get
-
Gets the current render width
Parameters
-
Optional useScreen: boolean
defines if screen size must be used (or the current render target if any)
Returns number
a number defining the current render width
-
get
-
Gets the HTML canvas attached with the current WebGPU context
Returns Nullable<HTMLCanvasElement>
a HTML canvas
get
-
Gets the client rect of the HTML canvas attached with the current webGL context
Returns Nullable<ClientRect>
a client rectangle
get
-
Gets current screen aspect ratio
Returns number
a number defining the aspect ratio
get
-
Gets a boolean indicating if stencil buffer is enabled
Returns boolean
the current stencil buffer state
get
-
Gets the current stencil function
Returns number
a number defining the stencil function to use
get
-
Gets the current stencil mask
Returns number
a number defining the stencil mask to use
get
-
Gets the current stencil reference value
Returns number
a number defining the stencil reference value to use
get
-
Gets the current stencil mask
Returns number
a number defining the new stencil mask to use
get
-
Gets the current stencil operation when depth fails
Returns number
a number defining stencil operation to use when depth fails
get
-
Gets the current stencil operation when stencil fails
Returns number
a number defining stencil operation to use when stencil fails
get
-
Gets the current stencil operation when stencil passes
Returns number
a number defining stencil operation to use when stencil passes
get
-
Returns the time in ms between steps when using deterministic lock step.
Returns number
time step in (ms)
getVRDeviceSearch playground for getVRDevice
-
Gets the current webVR device
Returns any
the current webVR device (or null)
get
-
Gets the source code of the vertex shader associated with a specific webGL program
Parameters
-
program: WebGLProgram
defines the program to use
Returns Nullable<string>
a string containing the source code of the vertex shader associated with the program
-
hide
-
Hide the loading screen
Returns void
init
-
Initializes the WebGPU context and dependencies.
Parameters
-
Optional glslangOptions: GlslangOptions
Defines the GLSLang compiler options if necessary
-
Optional twgslOptions: TwgslOptions
Defines the Twgsl compiler options if necessary
Returns Promise<void>
a promise notifying the readiness of the engine.
-
init
-
Initializes a webVR display and starts listening to display change events The onVRDisplayChangedObservable will be notified upon these changes
Returns Observable<IDisplayChangedEventArgs>
The onVRDisplayChangedObservable
init
-
Initializes a webVR display and starts listening to display change events The onVRDisplayChangedObservable will be notified upon these changes
Returns Promise<IDisplayChangedEventArgs>
A promise containing a VRDisplay and if vr is supported
inline
-
Inline functions in shader code that are marked to be inlined
Parameters
-
code: string
code to inline
Returns string
inlined code
-
is
-
Gets a boolean indicating that the engine is running in deterministic lock step mode
Returns boolean
true if engine is in deterministic lock step mode
is
-
Check if a given query has resolved and got its value
Parameters
-
query: OcclusionQuery
defines the query to check
Returns boolean
true if the query got its value
-
isVRDevice
-
Gets a boolean indicating if a webVR device was detected
Returns boolean
true if a webVR device was detected
isVRPresentingSearch playground for isVRPresenting
-
Gets a boolean indicating that the system is in VR mode and is presenting
Returns boolean
true if VR mode is engaged
read
-
Reads pixels from the current frame buffer. Please note that this function can be slow
Parameters
-
x: number
defines the x coordinate of the rectangle where pixels must be read
-
y: number
defines the y coordinate of the rectangle where pixels must be read
-
width: number
defines the width of the rectangle where pixels must be read
-
height: number
defines the height of the rectangle where pixels must be read
-
Optional hasAlpha: boolean
defines whether the output should have alpha or not (defaults to true)
-
Optional flushRenderer: boolean
true to flush the renderer from the pending commands before reading the pixels
Returns Promise<ArrayBufferView>
a ArrayBufferView promise (Uint8Array) containing RGBA colors
-
register
-
Register a new child canvas
Parameters
-
canvas: HTMLCanvasElement
defines the canvas to register
-
Optional camera: Camera
defines an optional camera to use with this canvas (it will overwrite the scene.camera for this view)
-
Optional clearBeforeCopy: boolean
Indicates if the destination view canvas should be cleared before copying the parent canvas. Can help if the scene clear color has alpha < 1
Returns EngineView
the associated view
-
release
-
Force the engine to release all cached effects. This means that next effect compilation will have to be done completely even if a similar effect was already compiled
Returns void
release
-
Releases a render pass id
Parameters
-
id: number
id of the render pass to release
Returns void
-
resizeSearch playground for resize
-
Resize the view according to the canvas' size
Parameters
-
Optional forceSetSize: boolean
true to force setting the sizes of the underlying canvas
Returns void
-
resize
-
Resize an image and returns the image data as an uint8array
Parameters
-
image: HTMLImageElement | ImageBitmap
image to resize
-
bufferWidth: number
destination buffer width
-
bufferHeight: number
destination buffer height
Returns Uint8Array
an uint8array containing RGBA values of bufferWidth * bufferHeight size
-
restore
-
Unbind the current render target and bind the default framebuffer
Returns void
restore
-
Restores the state of the stencil buffer
Returns void
scissor
-
Executes a scissor clear (ie. a clear on a specific portion of the screen)
Parameters
-
x: number
defines the x-coordinate of the bottom left corner of the clear rectangle
-
y: number
defines the y-coordinate of the corner of the clear rectangle
-
width: number
defines the width of the clear rectangle
-
height: number
defines the height of the clear rectangle
-
clearColor: IColor4Like
defines the clear color
Returns void
-
set
-
Sets alpha constants used by some alpha blending modes
Parameters
-
r: number
defines the red component
-
g: number
defines the green component
-
b: number
defines the blue component
-
a: number
defines the alpha component
Returns void
-
set
-
Sets the current alpha equation
Parameters
-
equation: number
defines the equation to use (one of the Engine.ALPHA_EQUATION_XXX)
Returns void
-
set
-
Sets the current alpha mode
Parameters
-
mode: number
defines the mode to use (one of the Engine.ALPHA_XXX)
-
Optional noDepthWriteChange: boolean
defines if depth writing state should remains unchanged (false by default)
Returns void
-
set
-
Enable or disable color writing
Parameters
-
enable: boolean
defines the state to set
Returns void
-
set
-
Set the compressed texture extensions or file names to skip.
Parameters
-
skippedFiles: Array<string>
defines the list of those texture files you want to skip Example: [".dds", ".env", "myfile.png"]
Returns void
-
set
-
Enable or disable depth buffering
Parameters
-
enable: boolean
defines the state to set
Returns void
-
set
-
Sets the current depth function
Parameters
-
depthFunc: number
defines the function to use
Returns void
-
set
-
Sets the current depth function to GREATER
Returns void
set
-
Sets the current depth function to GEQUAL
Returns void
set
-
Sets the current depth function to LESS
Returns void
set
-
Sets the current depth function to LEQUAL
Returns void
set
-
Sets a depth stencil texture from a render target to the according uniform.
Parameters
-
channel: number
The texture channel
-
uniform: Nullable<WebGLUniformLocation>
The uniform to set
-
texture: Nullable<RenderTargetTexture>
The render target texture containing the depth stencil texture to apply
-
Optional name: string
The texture name
Returns void
-
set
-
Enable or disable depth writing
Parameters
-
enable: boolean
defines the state to set
Returns void
-
set
-
Directly set the WebGL Viewport
Parameters
-
x: number
defines the x coordinate of the viewport (in screen space)
-
y: number
defines the y coordinate of the viewport (in screen space)
-
width: number
defines the width of the viewport (in screen space)
-
height: number
defines the height of the viewport (in screen space)
Returns Nullable<IViewportLike>
the current viewport Object (if any) that is being replaced by this call. You can restore this viewport later on to go back to the original state
-
set
-
Returns void
set
-
Returns void
set
-
Force a specific size of the canvas
Parameters
-
width: number
defines the new canvas' width
-
height: number
defines the new canvas' height
-
Optional forceSetSize: boolean
true to force setting the sizes of the underlying canvas
Returns boolean
true if the size was changed
-
set
-
Set various states to the webGL context
Parameters
-
culling: boolean
defines culling state: true to enable culling, false to disable it
-
Optional zOffset: number
defines the value to apply to zOffset (0 by default)
-
Optional force: boolean
defines if states must be applied even if cache is up to date
-
Optional reverseSide: boolean
defines if culling must be reversed (CCW if false, CW if true)
-
Optional cullBackFaces: boolean
true to cull back faces, false to cull front faces (if culling is enabled)
-
Optional stencil: IStencilState
stencil states to set
-
Optional zOffsetUnits: number
defines the value to apply to zOffsetUnits (0 by default)
Returns void
-
set
-
Enable or disable the stencil buffer
Parameters
-
enable: boolean
defines if the stencil buffer must be enabled or disabled
Returns void
-
set
-
Sets the current stencil function
Parameters
-
stencilFunc: number
defines the new stencil function to use
Returns void
-
set
-
Sets the current stencil mask
Parameters
-
mask: number
defines the new stencil mask to use
Returns void
-
set
-
Sets the current stencil reference
Parameters
-
reference: number
defines the new stencil reference to use
Returns void
-
set
-
Sets the current stencil mask
Parameters
-
mask: number
defines the new stencil mask to use
Returns void
-
set
-
Sets the stencil operation to use when depth fails
Parameters
-
operation: number
defines the stencil operation to use when depth fails
Returns void
-
set
-
Sets the stencil operation to use when stencil fails
Parameters
-
operation: number
defines the stencil operation to use when stencil fails
Returns void
-
set
-
Sets the stencil operation to use when stencil passes
Parameters
-
operation: number
defines the stencil operation to use when stencil passes
Returns void
-
set
-
Sets a texture to the according uniform.
Parameters
-
channel: number
The texture channel
-
unused: Nullable<WebGLUniformLocation>
unused parameter
-
texture: Nullable<BaseTexture>
The texture to apply
-
name: string
The name of the uniform in the effect
Returns void
-
set
-
Sets an array of texture to the WebGPU context
Parameters
-
channel: number
defines the channel where the texture array must be set
-
unused: Nullable<WebGLUniformLocation>
unused parameter
-
textures: BaseTexture[]
defines the array of textures to bind
-
name: string
name of the channel
Returns void
-
set
-
Set the compressed texture format to use, based on the formats you have, and the formats supported by the hardware / browser.
Khronos Texture Container (.ktx) files are used to support this. This format has the advantage of being specifically designed for OpenGL. Header elements directly correspond to API arguments needed to compressed textures. This puts the burden on the container generator to house the arcane code for determining these for current & future formats.
for description see https://www.khronos.org/opengles/sdk/tools/KTX/ for file layout see https://www.khronos.org/opengles/sdk/tools/KTX/file_format_spec/
Note: The result of this call is not taken into account when a texture is base64.
Parameters
-
formatsAvailable: Array<string>
defines the list of those format families you have created on your server. Syntax: '-' + format family + '.ktx'. (Case and order do not matter.)
Current families are astc, dxt, pvrtc, etc2, & etc1.
Returns Nullable<string>
The extension selected.
-
set
-
Sets a texture to the webGL context from a postprocess
Parameters
-
channel: number
defines the channel to use
-
postProcess: Nullable<PostProcess>
defines the source postprocess
-
name: string
name of the channel
Returns void
-
set
-
Binds the output of the passed in post process to the texture channel specified
Parameters
-
channel: number
The channel the texture should be bound to
-
postProcess: Nullable<PostProcess>
The post process which's output should be bound
-
name: string
name of the channel
Returns void
-
set
-
Specify the varyings to use with transform feedback
Parameters
-
program: WebGLProgram
defines the associated webGL program
-
value: string[]
defines the list of strings representing the varying names
Returns void
-
snapshot
-
Creates a new snapshot at the next frame using the current snapshotRenderingMode
Returns void
start
-
Starts a time query (used to measure time spent by the GPU on a specific frame) Please note that only one query can be issued at a time
Returns Nullable<_TimeToken>
a time token used to track the time span
switch
-
Toggle full screen mode
Parameters
-
requestPointerLock: boolean
defines if a pointer lock should be requested from the user
Returns void
-
un
-
Unbind the current render target texture from the WebGPU context
Parameters
-
texture: RenderTargetWrapper
defines the render target wrapper to unbind
-
Optional disableGenerateMipMaps: boolean
defines a boolean indicating that mipmaps must not be generated
-
Optional onBeforeUnbind: () => void
defines a function which will be called before the effective unbind
-
-
Returns void
-
-
Returns void
-
un
-
Remove a registered child canvas
Parameters
-
canvas: HTMLCanvasElement
defines the canvas to remove
Returns Engine
the current engine
-
update
-
Parameters
-
texture: InternalTexture
-
comparisonFunction: number
Returns void
-
update
-
Update a portion of an internal texture
Parameters
-
texture: InternalTexture
defines the texture to update
-
imageData: ArrayBufferView
defines the data to store into the texture
-
xOffset: number
defines the x coordinates of the update rectangle
-
yOffset: number
defines the y coordinates of the update rectangle
-
width: number
defines the width of the update rectangle
-
height: number
defines the height of the update rectangle
-
Optional faceIndex: number
defines the face index if texture is a cube (0 by default)
-
Optional lod: number
defines the lod level to update (0 by default)
-
Optional generateMipMaps: boolean
defines whether to generate mipmaps or not
Returns void
-
update
-
Update the dimensions of a texture
Parameters
-
texture: InternalTexture
texture to update
-
width: number
new width of the texture
-
height: number
new height of the texture
-
Optional depth: number
new depth of the texture
Returns void
-
update
-
Update the sampling mode of a given texture
Parameters
-
samplingMode: number
defines the required sampling mode
-
texture: InternalTexture
defines the texture to update
-
Optional generateMipMaps: boolean
defines whether to generate mipmaps for the texture
Returns void
-
update
-
Update the sampling mode of a given texture
Parameters
-
texture: InternalTexture
defines the texture to update
-
wrapU: Nullable<number>
defines the texture wrap mode of the u coordinates
-
Optional wrapV: Nullable<number>
defines the texture wrap mode of the v coordinates
-
Optional wrapR: Nullable<number>
defines the texture wrap mode of the r coordinates
Returns void
-
wipe
-
Force the entire cache to be cleared You should not have to use this function unless your engine needs to share the WebGPU context with another engine
Parameters
-
Optional bruteForce: boolean
defines a boolean to force clearing ALL caches (including stencil, detoh and alpha states)
Returns void
-
wrap
-
Wraps an external web gl texture in a Babylon texture.
Returns InternalTexture
the babylon internal texture
wrap
-
Wraps an external web gpu texture in a Babylon texture.
Parameters
-
texture: GPUTexture
defines the external texture
Returns InternalTexture
the babylon internal texture
-
Static Create
-
Create a new instance of the gpu engine asynchronously
Parameters
-
canvas: HTMLCanvasElement
Defines the canvas to use to display the result
-
Optional options: WebGPUEngineOptions
Defines the options passed to the engine to create the GPU context dependencies
Returns Promise<WebGPUEngine>
a promise that resolves with the created engine
-
Static Default
-
Method called to create the default loading screen. This can be overridden in your own app.
Parameters
-
canvas: HTMLCanvasElement
The rendering canvas element
Returns ILoadingScreen
The loading screen
-
Static Mark
-
Will flag all materials in all scenes in all engines as dirty to trigger new shader compilation
Parameters
-
flag: number
defines which part of the materials must be marked as dirty
-
Optional predicate: (mat: Material) => boolean
defines a predicate used to filter which materials should be affected
-
-
Parameters
-
mat: Material
Returns boolean
-
-
-
Returns void
-
Static _
-
Asks the browser to exit fullscreen mode
Returns void
Static _
-
Asks the browser to exit pointerlock mode
Returns void
Static _
-
Ask the browser to promote the current element to fullscreen rendering mode
Parameters
-
element: HTMLElement
defines the DOM element to promote
Returns void
-
Static _
-
Ask the browser to promote the current element to pointerlock mode
Parameters
-
element: HTMLElement
defines the DOM element to promote
Returns void
-
The web GPU engine class provides support for WebGPU version of babylon.js.
5.0.0