Create an environment

Entity.create(
        listOf(
            Mesh(Uri.parse("mesh://skybox")),
            Material().apply {
              baseTextureAndroidResourceId = R.drawable.skydome
              unlit = true
            },
        ))

• Using a solid color
  Here’s an example of applying a yellow color to the skybox with the following RGBA values: rgba(1.0f, 1.0f, 0, 1.0f). Each float value ranges from 0 to 1.

    import com.meta.spatial.core.Color4
  
    Entity.create(
        listOf(
            Mesh(Uri.parse("mesh://skybox")),
            Material().apply {
                baseColor = Color4(1.0f, 1.0f, 0.0f, 1.0f)
            })
  
• Using an image
  The skybox material can also be an equirectangular⁠ image. You can apply a material with the image texture like this:

    Entity.create(
            listOf(
                Mesh(Uri.parse("mesh://skybox")),
                Material().apply {
                    baseTextureAndroidResourceId = R.drawable.skydome
                    unlit = true
                },
            ))
  
  R.drawable.skydome refers to the local file of res/drawable/skydome.jpg, and unlit = true prevents scene lighting from affecting the skybox

1. Obtain an HDR file. Various sources provide these files, but PolyHaven⁠ is a recommended source and free for commercial use. In the download options, select 4K HDR.
2. Convert the HDR file to an .env file using the Babylon js texture tool⁠. Drag and drop your file into the tool, and it will generate an .env file for download.
3. Add the .env file to your app assets in the /<appname>/assets/ folder.
4. Enable the .env file in your app by adding the following code to your main activity’s onSceneReady() method:

    scene.updateIBLEnvironment("filename.env")
   
5. Optional: Turn off your ambient light source in your scene, as IBL generally provides ample ambient light.

    scene.setLightingEnvironment(
        Vector3(0.0f, 0.0f, 0.0f),  // ambient light color (none in this case)
        Vector3(0.6f, 0.6f, 0.3f),  // directional light color
        -Vector3(1.0f, 3.0f, 2.0f), // directional light direction
    )
   
6. Optional: Ensure your skybox is unlit. Otherwise, it may look strange.
7. Optional: You can adjust the intensity of your IBL using the environment intensity multiplier:

    scene.setLightingEnvironment(
        Vector3(...),
        Vector3(...),
        Vector3(...),
        0.8f // lower number means darker, default is 1.0f
    )
   

• Lighting and effects
• Art direction for immersive experiences
• Balancing art and performance