Version: 2017.4
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Texture3D.Apply

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 method Apply(updateMipmaps: bool = true, makeNoLongerReadable: bool = false): void;
public void Apply(bool updateMipmaps = true, bool makeNoLongerReadable = false);

Parameters

updateMipmapsWhen set to true, mipmap levels are recalculated.
makeNoLongerReadableWhen set to true, system memory copy of a texture is released.

Description

Actually apply all previous SetPixels changes.

If updateMipmaps is true, the mipmap levels are recalculated as well, using the base level as a source. Usually you want to use true in all cases except when you've modified the mip levels yourself using SetPixels.

If makeNoLongerReadable is true, texture will be marked as no longer readable and memory will be freed after uploading to GPU. By default makeNoLongerReadable is set to false.

Apply is a potentially expensive operation, so you'll want to change as many pixels as possible between Apply calls.

Alternatively, if you don't need to access the pixels on the CPU, you could use Graphics.CopyTexture for fast GPU-side texture data copies. Note that calling Apply may undo the results of previous calls to Graphics.CopyTexture.

See Also: SetPixels, Graphics.CopyTexture.