Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Configure mipmap streaming

Enable or disable mipmap streaming on cameras, set which mipmap levels a camera uses, and set a memory budget for textures.
Read time 3 minutesLast updated 21 days ago

Set which cameras use mipmap streaming

By default, all cameras in your scene use mipmap streaming when you enable it.

Disable mipmap streaming on a single camera

Follow these steps:
  1. Select a camera in your scene.
  2. In the
    Inspector

    ?

    window, select Add Component > Streaming Controller.
  3. Disable the Streaming Controller component.

Enable mipmap streaming on a single camera

Follow these steps:
  1. Go to Edit >
    Project Settings

    ?

    > Quality.
  2. In the Textures section, under Mipmap Streaming, disable Add All Cameras.
  3. Add a Streaming Controller component to the camera, and make sure it's enabled.

Set which mipmap levels a camera uses

Use the Mipmap Bias setting in a Streaming Controller component to force Unity to load smaller or larger mipmap levels than the ones mipmap streaming automatically chooses.
Unity adds the Mipmap Bias value to mipmap levels from textures in the camera view. For example, if you set Mipmap Bias to 2 and mipmap streaming chooses mipmap level 1 for a texture, Unity loads mipmap level 3 (1 + 2).
You can also use the StreamingController.streamingMipmapBias API to control this setting.

Set the memory budget for textures

To set the maximum GPU memory that Unity uses for textures, follow these steps:
  1. Go to Edit > Project Settings > Quality.
  2. In the Textures section, set the Memory Budget value in MB.
The memory budget is for both mipmap streaming, and all the mipmap levels of textures that don't use mipmap streaming. For example, if you set Memory Budget to 100 MB, and you have 90 MB of textures that don't use mipmap streaming, the memory budget for mipmap streaming is 10 MB.
To avoid exceeding the memory budget, Unity does the following:
  • Loads lower-resolution mipmap levels for textures. This can cause textures to pop or load slowly.
  • Removes unused mipmap levels from GPU memory, to make room for mipmap levels it needs.
You can use the Max Level Reduction property to stop Unity removing mipmap levels smaller than a certain level. This value is also the mipmap level Unity loads at first startup. For example, if you set Max Level Reduction to 2, Unity loads only mipmap levels at level 2 and larger, and keeps them in memory.
Unity must keep mipmap levels above the Max Level Reduction value in GPU memory. This might mean Unity exceeds the memory budget.

Estimate a memory budget

To estimate a memory budget for your project, follow these steps:
  1. While your project runs, use the Texture.desiredTextureMemory API to get the total size of the textures Unity loads.
  2. Set Memory Budget to slightly higher than that value.
This lets you make sure Unity has enough texture memory available for the most resource-intensive areas of your scene, and prevent textures from dropping to a lower resolution. If you have extra memory available, you can set a larger memory budget so that Unity can keep texture data that's not visible in your scene in a GPU cache.
Note
If you use 
Texture.desiredTextureMemory
in the Editor, the total size might include textures Unity uses to render Editor windows.

Set the memory budget at runtime

You can use the following APIs to set and control the memory budget at runtime: