RenderTexture

класс в UnityEngine / Наследует от: Texture / Реализовано в: UnityEngine.CoreModule

Описание

Текстуры рендеринга — это текстуры, в которые можно рендерить.

Их можно использовать для реализации эффектов рендеринга на основе изображений, динамических теней, проекторов, отражений или камер наблюдения.

Одно из типичных применений текстур рендеринга – установка их в качестве свойства "целевой текстуры" камеры (Camera.targetTexture). текстуру вместо рендеринга на экран.

Имейте в виду, что содержимое текстуры рендеринга может «потеряться» при определенных событиях, таких как загрузка нового уровня, переход системы в режим заставки, выход из полноэкранного режима и т. д. Когда это произойдет, ваши существующие текстуры рендеринга снова станут «еще не созданными», вы можете проверить это с помощью функции IsCreated.

Как и в случае с другими типами "собственных объектов движка", важно обращать внимание на время жизни любых текстур рендеринга и освобождать их, когда вы закончите их использовать с помощью Release, так как они не будут собирать мусор, как обычные управляемые типы.

Смотрите так же: Camera.targetTexture.

Статические Свойства

active

Текущая активная текстура рендеринга.

Свойства

antiAliasing	Уровень сглаживания для RenderTexture.
autoGenerateMips	Уровни Mipmap генерируются автоматически при установке этого флага.
bindTextureMS	Если значение true и сглаживание больше 1, текстура рендеринга не будет обрабатываться по умолчанию. Используйте это, если текстуру рендеринга необходимо связать в шейдере как мультисэмплированную текстуру.
colorBuffer	Цветовой буфер текстуры рендеринга (только для чтения).
depth	Точность буфера глубины текстуры рендеринга в битах (поддерживается 0, 16, 24/32).
depthBuffer	Буфер глубины/трафарета текстуры рендеринга (только для чтения).
descriptor	Эта структура содержит всю информацию, необходимую для создания RenderTexture. Его можно копировать, кэшировать и повторно использовать для простого создания RenderTexture с одинаковыми свойствами.
dimension	Размерность (тип) текстуры рендера.
enableRandomWrite	Включить произвольную запись в эту визуализированную текстуру для шейдеров уровня Shader Model 5.0.
graphicsFormat	Цветовой формат визуализируемой текстуры.
height	Высота визуализируемой текстуры в пикселях.
memorylessMode	Свойство режима без памяти текстуры рендеринга.
sRGB	Использует ли эта визуализированная текстура преобразования чтения/записи sRGB? (Только чтение).
stencilFormat	Формат данных трафарета, которые вы можете инкапсулировать в RenderTexture. Указание этого свойства создает элемент трафарета для RenderTexture и задает его формат. Это позволяет привязывать данные трафарета как текстуру ко всем типам шейдеров для платформ, которые его поддерживают. Это свойство не указывает формат буфера трафарета, который ограничен форматом буфера глубины, указанным в RenderTexture.depth. В настоящее время большинство платформ поддерживают только R8_UInt (DirectX11, DirectX12), а PS4 также поддерживает R8_UNorm.
useDynamicScale	Текстура рендеринга помечена для масштабирования системой динамического разрешения.
useMipMap	Текстура рендеринга имеет MIP-карты, когда этот флаг установлен.
volumeDepth	Объемный экстент текстуры 3D-рендеринга или количество фрагментов текстуры массива.
vrUsage	Если RenderTexture представляет собой текстуру глаза виртуальной реальности, используемую в стереоскопическом рендеринге, это свойство определяет, какой специальный рендеринг будет выполняться, если таковой имеется.
width	Ширина визуализируемой текстуры в пикселях.

Конструкторы

RenderTexture

Создает новый объект RenderTexture.

Публичные Методы

ConvertToEquirect	Преобразует визуализированную текстуру в равнопрямоугольный формат (как стереоскопический, так и моноскопический равнопрямоугольный). Левый глаз будет занимать верхнюю половину, а правый глаз — нижнюю. Моноскопическая версия займет всю текстуру. Размер текстуры должен иметь тип TextureDimension.Cube.
Create	Фактически создает RenderTexture.
DiscardContents	Подскажите драйверу графического процессора, что содержимое RenderTexture не будет использоваться.
GenerateMips	Создание уровней MIP-карты текстуры рендеринга.
GetNativeDepthBufferPtr	Получить собственный (основной графический API) указатель на ресурс буфера глубины.
IsCreated	Текстура рендеринга действительно создана?
MarkRestoreExpected	Указывает, что ожидается операция восстановления RenderTexture.
Release	Выпускает RenderTexture.
ResolveAntiAliasedSurface	Принудительное разрешение сглаженной текстуры рендеринга.
SetGlobalShaderProperty	Назначает эту RenderTexture в качестве глобального свойства шейдера с именем propertyName.

Статические Методы

GetTemporary	Выделить временную текстуру рендеринга.
ReleaseTemporary	Освободить временную текстуру, выделенную с помощью GetTemporary.
SupportsStencil	Есть ли у RenderTexture буфер трафарета?

Унаследованные члены

Статические Свойства

allowThreadedTextureCreation	Разрешает внутренним компонентам Unity создавать текстуры в любом потоке (а не в выделенном потоке рендеринга).
currentTextureMemory	Объем памяти, который используют все текстуры в сцене.
desiredTextureMemory	Общий размер текстур в байтах, загружаемых Unity при отсутствии других ограничений. Прежде чем Unity загрузит какие-либо текстуры, он применяет бюджет памяти, который уменьшает загруженное разрешение текстуры, если размеры текстуры превышают его значение. Значение `desiredTextureMemory` учитывает уровни MIP-карт, которые Unity запросила или которые вы установили вручную. Например, если Unity не загружает текстуру с полным разрешением, потому что она находится далеко или запрошенный уровень MIP-карт больше 0, Unity уменьшает значение `desiredTextureMemory`, чтобы оно соответствовало общему объему необходимой памяти. Значение `desiredTextureMemory` может быть больше, чем значение `targetTextureMemory`.
GenerateAllMips	Может использоваться с конструкторами текстур, которые используют счетчик MIP, чтобы указать, что должны быть сгенерированы все MIP. Значение этого поля равно -1.
nonStreamingTextureCount	Количество непотоковых текстур в сцене. Сюда входят экземпляры текстур Texture2D и CubeMap. Сюда не входят любые другие типы текстур, а также 2D-текстуры и текстуры CubeMap, создаваемые внутри Unity.
nonStreamingTextureMemory	Объем памяти, который Unity выделяет для непотоковых текстур в сцене. Сюда входят только экземпляры текстур Texture2D и CubeMap. Сюда не входят любые другие типы текстур, а также 2D-текстуры и текстуры CubeMap, создаваемые внутри Unity.
streamingMipmapUploadCount	Сколько раз была загружена текстура из-за потоковой передачи MIP-карт текстуры.
streamingRendererCount	Количество средств визуализации, зарегистрированных в системе потоковой передачи текстур.
streamingTextureCount	Количество потоковых текстур.
streamingTextureDiscardUnusedMips	Это свойство заставляет систему потоковой передачи текстур отбрасывать все неиспользуемые MIP-карты вместо их кэширования до тех пор, пока не будет превышен бюджет памяти текстуры. Это полезно, когда вы профилируете или пишете тесты, чтобы сохранить предсказуемый набор текстур в памяти.
streamingTextureForceLoadAll	Заставить потоковые текстуры загружать все уровни MIP-карт.
streamingTextureLoadingCount	Количество потоковых текстур с загруженными в данный момент мип-картами.
streamingTexturePendingLoadCount	Количество потоковых текстур с ожидающими загрузки мип-картами.
targetTextureMemory	Общий объем памяти текстур, который Unity выделяет текстурам в сцене после применения бюджета памяти и завершения загрузки текстур. `targetTextureMemory` также принимает во внимание настройки потоковой передачи mipmap. Это значение включает только экземпляры текстур Texture2D и CubeMap. Он не включает какие-либо другие типы текстур, а также 2D-текстуры и текстуры CubeMap, создаваемые внутри Unity.
totalTextureMemory	Общий объем памяти текстур, который Unity будет использовать, если он загрузит все текстуры на уровне mipmap 0. Это теоретическое значение, которое не принимает во внимание какие-либо входные данные из системы потоковой передачи или любые другие входные данные. например, когда вы устанавливаете «Texture2D.requestedMipmapLevel» вручную. Чтобы увидеть значение памяти текстуры, которое учитывает входные данные, используйте «desiredTextureMemory». «totalTextureMemory» включает только экземпляры текстур Texture2D и CubeMap. Он не включает какие-либо другие типы текстур, а также 2D-текстуры и текстуры CubeMap, создаваемые внутри Unity.

Свойства

hideFlags	Должен ли объект быть скрыт, сохранен вместе со сценой или изменен пользователем?
name	Имя объекта.
anisoLevel	Определяет уровень анизотропной фильтрации Текстуры.
dimension	Размерность (тип) текстуры (только для чтения).
filterMode	Режим фильтрации Текстуры.
graphicsFormat	Возвращает формат GraphicsFormat или формат цвета объекта текстуры.
height	Высота текстуры в пикселях. (Только чтение)
imageContentsHash	Хеш-значение текстуры.
isReadable	Сохраняет ли Unity дополнительную копию пиксельных данных этой текстуры в адресуемой ЦП памяти.
mipMapBias	Смещение MIP-карты Текстуры.
mipmapCount	Сколько уровней MIP-карт в этой текстуре (только для чтения).
updateCount	Этот счетчик увеличивается при обновлении текстуры.
width	Ширина текстуры в пикселях. (Только чтение)
wrapMode	Режим переноса координат текстуры.
wrapModeU	Режим переноса координат текстуры U.
wrapModeV	Режим переноса координат текстуры V.
wrapModeW	Режим переноса координат текстуры W для Texture3D.

Публичные Методы

GetInstanceID	Возвращает идентификатор экземпляра объекта.
ToString	Возвращает имя объекта.
GetNativeTexturePtr	Получает собственный (основной графический API) указатель на ресурс текстуры.
IncrementUpdateCount	Увеличивает счетчик обновлений.

Статические Методы

Destroy	Удаляет игровой объект, компонент или ресурс.
DestroyImmediate	Немедленно уничтожает объект obj. Вместо этого вам настоятельно рекомендуется использовать Destroy.
DontDestroyOnLoad	Не уничтожает целевой объект при загрузке новой сцены.
FindObjectOfType	Возвращает первый активный загруженный объект типа Type.
FindObjectsOfType	Получает список всех загруженных объектов типа Type.
Instantiate	Клонирует исходный объект и возвращает клон.
SetGlobalAnisotropicFilteringLimits	Устанавливает пределы анизотропии.
SetStreamingTextureMaterialDebugProperties	Эта функция устанавливает свойства отладки потоковой передачи MIP-карт для любых материалов, которые используют эту Текстуру через систему потоковой передачи MIP-карт.

Операторы

bool	Объект существует?
operator !=	Сравнивает, ссылаются ли два объекта на другой объект.
operator ==	Сравнивает две ссылки на объекты, чтобы определить, ссылаются ли они на один и тот же объект..

Вы можете отблагодарить автора, за перевод документации на русский язык. ₽ Спасибо