Interface AbstractEngineOptions
adaptToDeviceRatio?: boolean;
antialias?: boolean;
audioEngine?: boolean;
audioEngineOptions?: IAudioEngineOptions;
canvasTabIndex?: number;
deterministicLockstep?: boolean;
doNotHandleContextLost?: boolean;
doNotHandleTouchAction?: boolean;
limitDeviceRatio?: number;
lockstepMaxSteps?: number;
premultipliedAlpha?: boolean;
stencil?: boolean;
timeStep?: number;
useExactSrgbConversions?: boolean;
useHighPrecisionMatrix?: boolean;
useLargeWorldRendering?: boolean;
}
Hierarchy (View Summary)
- AbstractEngineOptions
Properties
Optionaladapt To Device Ratio
Defines whether to adapt to the device's viewport characteristics (default: false)
Optionalantialias
Defines whether MSAA is enabled on the canvas.
Optionalaudio Engine
Defines if webaudio should be initialized as well
Optionalaudio Engine Options
Specifies options for the audio engine
Optionalcanvas Tab Index
Defines the tab index to set on the rendering canvas (default: 1). Any value >= 0 makes the canvas focusable so it can capture keyboard events and places it in the document's sequential tab order (0 follows DOM order, a positive value forces an explicit order). Use -1 to keep the canvas focusable programmatically (via focus()) while excluding it from the tab order.
Optionaldeterministic Lockstep
Defines if animations should run using a deterministic lock step
Optionaldo Not Handle Context Lost
Defines that engine should ignore context lost events If this event happens when this parameter is true, you will have to reload the page to restore rendering
Optionaldo Not Handle Touch Action
Defines that engine should ignore modifying touch action attribute and style If not handle, you might need to set it up on your side for expected touch devices behavior.
Optionallimit Device Ratio
Defines if the engine should no exceed a specified device ratio
Optionallockstep Max Steps
Defines the maximum steps to use with deterministic lock step mode
Optionalpremultiplied Alpha
Defines whether the canvas should be created in "premultiplied" mode (if false, the canvas is created in the "opaque" mode) (true by default)
Optionalstencil
Defines whether the stencil buffer should be enabled.
Optionaltime Step
Defines the seconds between each deterministic lock step
Optionaluse Exact Srgb Conversions
True if the more expensive but exact conversions should be used for transforming colors to and from linear space within shaders. Otherwise, the default is to use a cheaper approximation.
Optionaluse High Precision Matrix
Make the matrix computations to be performed in 64 bits instead of 32 bits. False by default. Note that setting useLargeWorldRendering will also set high precision matrices
Optional Readonlyuse Large World Rendering
LargeWorldRendering helps avoid floating point imprecision of rendering large worlds by
- Forcing highPrecisionMatrices (matrix computations in 64 bits instead of 32)
- Enabling floatingOriginMode in all scenes -- offsetting position-related uniform and attribute values before passing to shader so that active camera is centered at origin and world is offset by active camera position
NOTE that if this mode is set during engineCreation, all scenes will have floatingOrigin offset and you do not need to send floatingOriginMode option to each scene creation. If you'd like to have only specific scenes using the offset logic, you can set the flag on those scenes directly -- however, to achieve proper large world rendering, you must also set the useHighPrecisionMatrix option on engine.
Interface defining initialization parameters for AbstractEngine class