Version: 5.3 (switch to 5.4b)
ЯзыкEnglish
  • C#
  • JS

Язык программирования

Выберите подходящий для вас язык программирования. Все примеры кода будут представлены на выбранном языке.

Texture2D.GetPixels

Предложить изменения

Успех!

Благодарим вас за то, что вы помогаете нам улучшить качество документации по Unity. Однако, мы не можем принять любой перевод. Мы проверяем каждый предложенный вами вариант перевода и принимаем его только если он соответствует оригиналу.

Закрыть

Ошибка внесения изменений

По определённым причинам предложенный вами перевод не может быть принят. Пожалуйста <a>попробуйте снова</a> через пару минут. И выражаем вам свою благодарность за то, что вы уделяете время, чтобы улучшить документацию по Unity.

Закрыть

Отменить

Руководство
public function GetPixels(miplevel: int = 0): Color[];
public Color[] GetPixels(int miplevel = 0);

Параметры

Описание

Get a block of pixel colors.

Данная функция возвращает массив цветов пикселей mip level of the texture.

The returned array is a flattened 2D array, where pixels are laid out left to right, bottom to top (i.e. row after row). Array size is width by height of the mip level used. MIP-уровень по умолчанию это нулевой уровень (основная текстура). В этом случае размером уровня будет просто размер текстуры. In general case, mip level size is mipWidth=max(1,width>>miplevel) and similarly for height.

The texture must have the Read/Write Enabled flag set in the import settings, otherwise this function will fail.

Вызов функции GetPixels может быть быстрее многократных вызовов функции GetPixel, особенно для больших текстур. Помимо прочего, GetPixels может получить доступ к отдельным MIP-уровням. even faster is to use GetPixels32 which returns low precision color data without costly integer-to-float conversions.

See Also: GetPixels32.

// Get a rectangular area of a texture and place it into a new
// texture the size of the rectangle.

// Source texture and the rectangular area we want to extract. var sourceTex: Texture2D; var sourceRect: Rect;

function Start () { // The values in the Rect structure are floats, so round them // down to the nearest integer. var x = Mathf.FloorToInt(sourceRect.x); var y = Mathf.FloorToInt(sourceRect.x); var width = Mathf.FloorToInt(sourceRect.width); var height = Mathf.FloorToInt(sourceRect.height);

// Get the pixel block and place it into a new texture. var pix = sourceTex.GetPixels(x, y, width, height); var destTex = new Texture2D(width, height); destTex.SetPixels(pix); destTex.Apply();

// Set the current object's texture to show the // extracted rectangle. GetComponent.<Renderer>().material.mainTexture = destTex; }
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { public Texture2D sourceTex; public Rect sourceRect; void Start() { int x = Mathf.FloorToInt(sourceRect.x); int y = Mathf.FloorToInt(sourceRect.x); int width = Mathf.FloorToInt(sourceRect.width); int height = Mathf.FloorToInt(sourceRect.height); Color[] pix = sourceTex.GetPixels(x, y, width, height); Texture2D destTex = new Texture2D(width, height); destTex.SetPixels(pix); destTex.Apply(); GetComponent<Renderer>().material.mainTexture = destTex; } }

See Also: SetPixels, mipmapCount.


public function GetPixels(x: int, y: int, blockWidth: int, blockHeight: int, miplevel: int = 0): Color[];
public Color[] GetPixels(int x, int y, int blockWidth, int blockHeight, int miplevel = 0);

Параметры

Описание

Get a block of pixel colors.

Данная функция возвращает массив цветов пикселей mip level but only blockWidth by blockHeight region starting at x,y. The block must fit into the used mip level. The returned array is blockWidth*blockHeight size.