API

Function enableBentNormals

  • Enable bent-normal reflection occlusion (PbrMaterialProps.bentNormalTexture).

    Explicit opt-in so scenes without bent normals carry zero bent-normal bytes: nothing in the always-fetched engine graph references this module. It installs the bent-normal hooks onto the IBL extension (merging into the IBL fragment), so the pre-existing IBL registration in the PBR build picks them up. Idempotent and global.

    Call BEFORE registerScene(scene) (or before any PBR material is first built). Requires an environment (IBL); materials also need an ambient occlusion texture (ormTexture or occlusionTexture), matching Babylon.js.

    Returns void

    mat.bentNormalTexture = await loadTexture2D(engine, url, { invertY: false });
    enableBentNormals();
    await registerScene(scene);