Skip to content
On this page

MX_background

Contributors

  • Robert Long, The Matrix.org Foundation

Status

Draft

Dependencies

Written against the glTF 2.0 spec.

Overview

This extension allows for adding equirectangular background textures or skyboxes to glTF scenes

glTF Schema Updates

Usage of the extension must be listed in the extensionsUsed array:

json
"extensionsUsed": [
  "MX_background"
]

The MX_background extension can be added to any scene property.

json
"scenes": [
  {
    "extensions": {
      "MX_background": {
        "backgroundTexture": {
          "index": 0
        }
      }
    }
  }
]

The backgroundTexture property is a TextureInfo object which may include the index and texCoord properties. texCoord is optional and ignored by this extension. The referenced texture is expected to be an RGBM encoded equirectangular cubemap saved as a PNG or BasisU texture.

** NOTE: Third Room doesn't currently implement the backgroundTexture as RGBM. It ignores the alpha channel multiplier and needs to be updated to support it. **

JSON Schema

scene.MX_background.schema.json

Known Implementations