# GetPixels

> Gets the pixel color data for a mipmap level as Color structs.

## Definition

* **Type:** Method
* **Namespace:** [UnityEngine](/engine/6000.6/script-reference/unityengine.md)
* **Assembly:** UnityEngine.AudioModule

## GetPixels()

Gets the pixel color data for a mipmap level as [Color](/engine/6000.6/script-reference/unityengine/color.md) structs.

```csharp
public Color[] GetPixels()
```

### Returns

| Type                                                              | Description                              |
| ----------------------------------------------------------------- | ---------------------------------------- |
| [Color\[\]](/engine/6000.6/script-reference/unityengine/color.md) | An array that contains the pixel colors. |

### Remarks

This method gets pixel data from the texture in CPU memory. [Texture.isReadable](/engine/6000.6/script-reference/unityengine/texture/isreadable.md) must be `true`.

The array contains the pixels row by row, starting at the bottom left of the texture. The size of the array is the width × height of the texture.

Each pixel is a [Color](/engine/6000.6/script-reference/unityengine/color.md) struct.

A single call to `GetPixels` is usually faster than multiple calls to [WebCamTexture.GetPixel](/engine/6000.6/script-reference/unityengine/webcamtexture/getpixel.md), especially for large textures. If a lower-precision representation is acceptable, [WebCamTexture.GetPixels32](/engine/6000.6/script-reference/unityengine/webcamtexture/getpixels32.md) is faster and uses less memory because it does not perform integer-to-float conversions.

If `GetPixels` fails, Unity throws an exception. `GetPixels` might fail if the array contains too much data.

**Note:** For depth data based WebCamTexture instances, this method returns an array of the depth values via [Color.r](/engine/6000.6/script-reference/unityengine/color/r.md) property. Additional Resources: [WebCamTexture.isDepth](/engine/6000.6/script-reference/unityengine/webcamtexture/isdepth.md).

## GetPixels(int, int, int, int)

Gets the pixel color data for part of the texture as [Color](/engine/6000.6/script-reference/unityengine/color.md) structs.

```csharp
public Color[] GetPixels(int x, int y, int blockWidth, int blockHeight)
```

### Parameters

**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The starting x position of the section to fetch.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The starting y position of the section to fetch.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The width of the section to fetch.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The height of the section to fetch.

### Returns

| Type                                                              | Description                              |
| ----------------------------------------------------------------- | ---------------------------------------- |
| [Color\[\]](/engine/6000.6/script-reference/unityengine/color.md) | An array that contains the pixel colors. |

### Remarks

This version of `GetPixels` returns part of the texture instead of the whole texture.

**Note:** For depth data based WebCamTexture instances, this method returns an array of the depth values via [Color.r](/engine/6000.6/script-reference/unityengine/color/r.md) property. Additional Resources: [WebCamTexture.isDepth](/engine/6000.6/script-reference/unityengine/webcamtexture/isdepth.md).