colors | The array of pixel colours to assign (a 2D image flattened to a 1D array). |
miplevel | The mip level of the texture to write to. |
Set a block of pixel colors.
This function takes a color array and changes the pixel colors of the whole
mip level of the texture. Call Apply to actually upload the changed
pixels to the graphics card.
The colors
array is a flattened 2D array, where pixels are laid out left to right,
bottom to top (i.e. row after row). Array size must be at least width by height of the mip level used.
The default mip level is zero (the base texture) in which case the size is just the size of the texture.
In general case, mip level size is mipWidth=max(1,width>>miplevel)
and similarly for height.
This function works only on (most) uncompressed texture formats. For other formats SetPixels
fails.
Texture.isReadable must be true
.
Using SetPixels
can be much faster than calling SetPixel repeatedly, especially
for large textures. In addition, SetPixels
can access individual mipmap levels. For an even faster pixel data
access, use GetRawTextureData that returns a NativeArray
.SetPixels
throws an exception when it fails.
See Also: GetPixels, SetPixels32, SetPixelData, Apply, GetRawTextureData, LoadRawTextureData, mipmapCount.
using UnityEngine; using System.Collections;
public class ExampleClass : MonoBehaviour { void Start() { Renderer rend = GetComponent<Renderer>();
// duplicate the original texture and assign to the material Texture2D texture = Instantiate(rend.material.mainTexture) as Texture2D; rend.material.mainTexture = texture;
// colors used to tint the first 3 mip levels Color[] colors = new Color[3]; colors[0] = Color.red; colors[1] = Color.green; colors[2] = Color.blue; int mipCount = Mathf.Min(3, texture.mipmapCount);
// tint each mip level for (int mip = 0; mip < mipCount; ++mip) { Color[] cols = texture.GetPixels(mip); for (int i = 0; i < cols.Length; ++i) { cols[i] = Color.Lerp(cols[i], colors[mip], 0.33f); } texture.SetPixels(cols, mip); } // actually apply all SetPixels, don't recalculate mip levels texture.Apply(false); } }
miplevel | The mip level of the texture to write to. |
Set a block of pixel colors.
This function is an extended version of SetPixels
above; it does not modify the whole
mip level but modifies only blockWidth
by blockHeight
region starting at x,y.
The colors
array must be blockWidth*blockHeight size, and the modified block
must fit into the used mip level.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.