Texture2D
Описание
Класс, представляющий текстуры в коде C#.
С помощью этого класса создаются текстуры или изменяются существующие текстурные ассеты.
ImageConversion класс предоставляет методы расширения к этому классу, отвечающие за кодирование изображений. Подробнее об этих методах см. ImageConversion документация.
Не предполагайте, что текстура будет создана и доступна в Awake. Все загрузки текстур синхронизируются в Главном потоке на Start. Выполнение операций с текстурой в Start.
Статические свойства
| Свойство | Описание |
|---|---|
| blackTexture | Получает небольшую Текстуру со всеми черными пикселями. |
| grayTexture | Получает небольшую текстуру со всеми серыми пикселями. |
| linearGrayTexture | Получает небольшую текстуру со всеми серыми пикселями. |
| normalTexture | Получает небольшую Текстуру с пикселями, представляющими векторы поверхностной нормы в нейтральном положении. |
| redTexture | Получает небольшую текстуру со всеми красными пикселями. |
| whiteTexture | Получает небольшую Текстуру со всеми белыми пикселями. |
Свойства
| Свойство | Описание |
|---|---|
| activeMipmapLimit | Количество уровней mipmap высокого разрешения из текстуры, которые Unity не загружает в GPU. (только для чтения) |
| alphaIsTransparency | Показывает, была ли текстура импортирована с включенным TextureImporter.alphaIsTransparency. Эта настройка доступна только в скриптах Редактора. Обратите внимание, что изменение этой настройки не будет иметь никакого эффекта; она должна быть включена в TextureImporter. |
| calculatedMipmapLevel | Уровень mipmap, рассчитываемый системой потокового вещания, который учитывает потоковые камеры и местоположение объектов, содержащих эту Текстуру. На это не влияют requestedMipmapLevel или minimumMipmapLevel. |
| desiredMipmapLevel | Уровень mipmap, который потоковая система загружает до применения бюджетов памяти. |
| format | Формат пиксельных данных в текстуре (только для чтения). |
| ignoreMipmapLimit | Это свойство заставляет текстуру игнорировать все настройки ограничений mipmap текстуры. |
| loadedMipmapLevel | Уровень mipmap, загруженный в данный момент потоковой системой. |
| loadingMipmapLevel | Уровень mipmap, на котором потоковая система mipmap находится в процессе загрузки. |
| minimumMipmapLevel | Ограничивает потоковую систему mipmap минимальным уровнем mip для данной Текстуры. |
| mipmapLimitGroup | Имя группы ограничений mipmap текстуры, с которой связана данная текстура. (только для чтения) |
| requestedMipmapLevel | Загружаемый уровень mipmap. |
| streamingMipmaps | Определяет, включен ли поток mipmap для данной Текстуры. |
| streamingMipmapsPriority | Устанавливается относительный приоритет текстуры при уменьшении размера памяти для соответствия бюджету памяти. |
| vtOnly | Возвращает true, если при импорте текстуры был установлен флажок VTOnly; в противном случае возвращает false. Дополнительные сведения см. в TextureImporter.vtOnly. |
Конструкторы
| Конструктор | Описание |
|---|---|
| Texture2D | Создать новую пустую текстуру. |
Открытые методы
| Метод | Описание |
|---|---|
| Apply | Копирует изменения, сделанные в текстуре CPU в текстуру GPU. |
| ClearMinimumMipmapLevel | Сброс поля minimumMipmapLevel. |
| ClearRequestedMipmapLevel | Сброс поля requestedMipmapLevel. |
| Compress | Сжатие текстуры во время выполнения в форматы DXT/BCn или ETC. |
| CopyPixels | Копирует пиксельные данные из другой текстуры на CPU. |
| GetPixel | Получает цвет пикселя в координатах (x, y). |
| GetPixelBilinear | Получает фильтрованный цвет в нормализованных координатах (u, v). |
| GetPixelData | Получает необработанные данные из текстуры. |
| GetPixels | Получает данные цвета пикселей для уровня mipmap в качестве структуры Color. |
| GetPixels32 | Получает данные цвета пикселей для уровня mipmap в виде структуры Color32. |
| GetRawTextureData | Получает необработанные данные из текстуры в виде массива, указывающего на память. |
| IsRequestedMipmapLevelLoaded | Проверяет, закончилась ли загрузка уровня mipmap, установленного requestedMipmapLevel. |
| LoadRawTextureData | Устанавливает необработанные данные всей текстуры в память CPU. |
| PackTextures | Упаковка нескольких текстур в атлас текстур. |
| ReadPixels | Читает пиксели из текущего объекта рендеринга и записывает их в текстуру. |
| Reinitialize | Переинициализирует Texture2D, позволяя заменить данные width, height, textureformat и graphicsformat для этой текстуры. |
| SetPixel | Задает цвет пикселя в координатах (x,y). |
| SetPixelData | Устанавливает необработанные данные всего уровня mipmap непосредственно в память CPU. |
| SetPixels | Задает цвета пикселей для всего уровня mipmap. |
| SetPixels32 | Задает цвета пикселей для всего уровня mipmap. |
| UpdateExternalTexture | Обновляет текстуру Unity для использования другого объекта текстуры. |
Статические методы
| Метод | Описание |
|---|---|
| CreateExternalTexture | Создает текстуру Unity из объекта текстуры, созданного извне. |
| GenerateAtlas | Укладывает набор прямоугольников в квадратный атлас, с дополнительной прокладкой между прямоугольниками. |
Унаследованные члены 5
Статические свойства
| Свойство | Описание |
|---|---|
| allowThreadedTextureCreation | Разрешить Unity internals выполнять создание текстуры на любом потоке (вместо выделенного потока рендеринга). |
| currentTextureMemory | Количество памяти, которое используют все текстуры в сцене. |
| desiredTextureMemory | Общее количество памяти текстуры в байтах, которое Unity использовало бы при отсутствии ограничений. |
| GenerateAllMips | Может быть использовано с конструкторами Текстуры, которые принимают число mip для указания, что все mip должны быть созданы. Значение этого поля -1. |
| nonStreamingTextureCount | Количество текстур в сцене, которые не являются потоковыми. Это включает экземпляры текстур Texture2D и CubeMap. Это не включает другие типы текстур или текстуры 2D и CubeMap, которые Unity создает внутри сцены. |
| nonStreamingTextureMemory | Количество памяти, которое Unity выделяет для не потоковых Текстур в сцене. Это включает только экземпляры Текстур Texture2D и CubeMap. Это не включает никакие другие типы Текстур, или Тексты 2D и CubeMap, которые Unity создает внутренне. |
| streamingMipmapUploadCount | Сколько раз текстура была загружена из-за потока Texture mipmap. |
| streamingRendererCount | Число рендереров, зарегистрированных в системе потокового передачи текстур. |
| streamingTextureCount | Количество потоковых текстур. |
| streamingTextureDiscardUnusedMips | Это свойство заставляет потоковую систему Текстур отбрасывать все неиспользуемые mipmaps вместо их кэширования до тех пор, пока бюджет памяти Текстуры не будет превышен. Это полезно при профилировании или написании тестов для сохранения предсказуемого набора Текстур в памяти. |
| streamingTextureForceLoadAll | Принудительная загрузка потоковых текстур на все уровни. |
| streamingTextureLoadingCount | Число потоковых Текстур с загружаемыми в настоящее время mipmaps. |
| streamingTexturePendingLoadCount | Число потоковых текстур с выходящими mipmaps для загрузки. |
| targetTextureMemory | Общее использование памяти текстур в байтах после применения бюджета памяти и загрузки всех текстур. |
| totalTextureMemory | Общая память текстур, в байтах, которую Unity использовала бы, если бы все текстуры были загружены в полном разрешении. |
Свойства
| Свойство | Описание |
|---|---|
| hideFlags | Должен ли объект быть скрытым, сохраняться с Scene или изменяться пользователем? |
| name | Имя объекта. |
| anisoLevel | Определяет уровень анизотропной фильтрации текстуры. |
| dimension | Размерность (тип) Текстуры. |
| filterMode | Режим фильтрации текстуры. |
| graphicsFormat | Возвращает формат GraphicsFormat или цветовой формат объекта Текстура. |
| graphicsTexture | GraphicsTexture, который представляет ресурс текстуры, загруженный на графическое устройство. |
| height | Высота текстуры в пикселях. |
| imageContentsHash | Хеш текстуры. |
| isDataSRGB | Возвращает true, если данные текстуры пикселя находятся в цветовом пространстве sRGB. |
| isReadable | Сохраняет ли Unity дополнительную копию пиксельных данных текстуры в адресуемой памяти CPU. |
| mipMapBias | Отклонение текстуры от mipmap. |
| mipmapCount | Сколько уровней mipmap есть в текстуре. |
| updateCount | Этот счетчик увеличивается при обновлении Текстуры. |
| width | Ширина текстуры в пикселях. |
| wrapMode | Варианты выборки текстуры, если координата текстуры находится вне диапазона [0, 1]. |
| wrapModeU | Варианты выборки текстуры, если координата U текстуры находится вне диапазона [0, 1]. |
| wrapModeV | Варианты выборки текстуры, если координата текстуры V находится вне диапазона [0, 1]. |
| wrapModeW | Варианты выборки текстуры, если координата W находится вне диапазона [0, 1]. |
Открытые методы
| Метод | Описание |
|---|---|
| GetInstanceID | Получает экземпляр ID объекта. |
| ToString | Возвращает имя объекта. |
| GetNativeTexturePtr | Получить собственный (базовый график API) указатель на ресурс Текстура. |
| IncrementUpdateCount | Увеличение счетчика обновлений. |
Статические методы
| Метод | Описание |
|---|---|
| Destroy | Удаляет GameObject, компонент или ресурс. |
| DestroyImmediate | Немедленно уничтожает указанный объект. Используйте с осторожностью и только в режиме редактирования. |
| DontDestroyOnLoad | Не уничтожать целевой Объект при загрузке нового Scene. |
| FindAnyObjectByType | Получает любой активный загруженный объект типа Type. |
| FindFirstObjectByType | Получает первый активный загруженный объект типа Type. |
| FindObjectsByType | Получает список всех загруженных объектов типа Type. |
| Instantiate | Клонирует исходный объект и возвращает клон. |
| InstantiateAsync | Захватывает моментальный снимок первоначального объекта (который должен быть связан с каким-либо GameObject) и возвращает AsyncInstantiateOperation. |
| SetGlobalAnisotropicFilteringLimits | Задает пределы анизотропии. |
| SetStreamingTextureMaterialDebugProperties | Эта функция устанавливает свойства отладки потока mipmap для всех материалов, известных системе потока mipmap. |
Операторы
| Оператор | Описание |
|---|---|
| bool | Существует ли объект? |
| оператор!= | Сравнивает, если два объекта ссылаются на разные объекты. |
| оператор == | Сравнение двух ссылок на объекты для определения того, относятся ли они к одному и тому же объекту. |