Version: 2023.2
LanguageEnglish
  • C#

QualitySettings.streamingMipmapsRenderersPerFrame

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Manual
public static int streamingMipmapsRenderersPerFrame;

Description

The number of renderer instances that are processed each frame when calculating which texture mipmap levels should be streamed.

If the number of renderers exceeds this limit, the mipmap levels of the textures associated with those additional renderers are calculated in subsequent frames.

Lower this value to reduce the CPU cost of calculating the optimal mipmap levels. The tradeoff is that a lower value also reduces the rate of texture mipmap computation and the loading of those desired mipmaps.

By default, the initial value is 512, but this can be set in the Quality section of the Editor Project Settings window, under Rendering > Texture Streaming.

Note: Do not change streamingMipmapsRenderersPerFrame too frequently at runtime. You should allow enough time between changes for all the renderers to be processed. Updating this value more frequently will lead to unused mips remaining loaded. The following example illustrates how to calculate the number of frames to delay between changes:

using System.Collections;
using UnityEngine;
public class Example : MonoBehaviour
{
    int nextUpdateAllowed = 0;
    int _renderersPerFrame;

// Increase this value when frame rate is high, lower when frame rate drops) public int RenderersPerFrame { get { return QualitySettings.streamingMipmapsRenderersPerFrame; } set { _renderersPerFrame = value; StopCoroutine("UpdateRenderCount"); StartCoroutine("UpdateRenderCount"); } }

IEnumerator UpdateRenderCount() { while (Time.frameCount < nextUpdateAllowed) yield return null;

QualitySettings.streamingMipmapsRenderersPerFrame = _renderersPerFrame; int frameDelay = (int)(Texture.streamingRendererCount + (ulong)(_renderersPerFrame - 1)) / _renderersPerFrame; nextUpdateAllowed = Time.frameCount + frameDelay;

yield return null; } }

Additional resources: Texture.streamingRendererCount.