ReflectionProbe
Описание
Зонд отражения используется для захвата окружающей среды в текстуру, которая передается в шейдеры и используется для отражения.
Свойства точно соответствуют значениям, показанным в Inspector.
Этот класс — программный интерфейс для отражательный зонд компонент.
Зонд отражения обычно просто создается в Редакторе, но иногда вы можете пожелать создать зонд отражения из скрипта:
using UnityEngine; using UnityEditor;
public class ProbeCreator { [MenuItem("ReflectionProbe/CreateRealtimeProbe")] public static void RealtimeProbe() { // Add a GameObject with a ReflectionProbe component GameObject probeGameObject = new GameObject("Realtime Reflection Probe"); ReflectionProbe probeComponent = probeGameObject.AddComponent<ReflectionProbe>(); // The probe will contribute to reflections inside a box of size 10x10x10 centered on the position of the probe probeComponent.size = new Vector3(10, 10, 10);
// Set the type to realtime and refresh the probe every frame probeComponent.mode = UnityEngine.Rendering.ReflectionProbeMode.Realtime; probeComponent.refreshMode = UnityEngine.Rendering.ReflectionProbeRefreshMode.EveryFrame; } }
Статические свойства
| Свойство | Описание |
|---|---|
| defaultTexture | Текстура поверхности отражательного зонда по умолчанию, который захватывает вклад окружающей среды. Только для чтения. |
| defaultTextureHDRDecodeValues | HDR декодирует значения текстуры зонда отражения по умолчанию. |
Свойства
| Свойство | Описание |
|---|---|
| backgroundColor | Цвет, с которым будет очищена текстура зонда отражения. |
| bakedTexture | Ссылка на выпеченную текстуру окружающей зонда отражения. |
| blendDistance | Расстояние вокруг пробоотборника, используемого для смешивания (используется в пробоотборниках с отсрочкой). |
| bounds | Мировой пространственный блок зонда, выравниваемый по оси, в котором зонд может вносить свой вклад в отражения (только для чтения). |
| boxProjection | Должен ли этот отражательный зонд использовать проекцию в виде коробки? |
| center | Центр границы зонда, в которой зонд может вносить свой вклад в отражения. Центр относится к положению зонда. |
| clearFlags | Как отражающий зонд очищает фон. |
| cullingMask | Это используется для выборочного отображения частей окружающей среды рефлекционного зонда. |
| customBakedTexture | Ссылка на выпеченную текстуру окружающего зонда отражения. Используйте это для назначения пользовательской текстуры отражения. |
| farClipPlane | Расстояние до плоскости обрезки при рендеринге зонда. |
| hdr | Должен ли этот отражательный зонд использовать HDR рендирование? |
| importance | Важность отражательного зонда. |
| intensity | Модификатор интенсивности, который применяется к текстуре зонда отражения в шейдере. |
| mode | Следует ли создавать текстуру зонда отражения в редакторе (ReflectionProbeMode.Baked) или использовать текстуру, задаваемую пользователем (ReflectionProbeMode.Custom)? |
| nearClipPlane | Расстояние до плоскости обрезки при отображении зонда. |
| realtimeTexture | Ссылка на текстуру реального времени окружающей зонда отражения среды. Используйте это для назначения RenderTexture для использования для отражения в реальном времени. |
| refreshMode | Задает способ, которым зонд будет использовать ресурсы refresh.Additional: ReflectionProbeRefreshMode. |
| renderDynamicObjects | Указывает, должна ли Unity отрисовывать нестатические GameObject в Reflection Probe. Если задать true, Unity будет отрисовывать нестатические GameObject в Reflection Probe. Если задать false — не будет. Unity учитывает это свойство только в том случае, если у Reflection Probe свойство Type равно Custom. |
| resolution | Разрешение текстуры отражения в пикселях. |
| shadowDistance | Расстояние рисования тени при рендеринге зонда. |
| size | Размер границы зонда, в которой зонд может участвовать в отражении. Размер в мировом пространстве. |
| texture | Текстура, которая передается в шейдер объектов, находящихся вблизи зонда отражения (только для чтения). |
| textureHDRDecodeValues | HDR декодирует значения текстуры отражательного зонда. |
| timeSlicingMode | Устанавливает ресурсы modeAdditional для временного разреза зонда: ReflectionProbeTimeSlicingMode. |
Открытые методы
| Метод | Описание |
|---|---|
| IsFinishedRendering | Проверяет, завершил ли зонд рендеринг с разбивкой по времени. |
| RenderProbe | Обновляет кубическое сопоставление зонда. |
| Reset | Возвращает все параметры ReflectionProbe в исходное состояние. |
Статические методы
| Метод | Описание |
|---|---|
| BlendCubemap | Утилита для объединения двух кубических изображений в одну текстуру. |
| UpdateCachedState | Обновляет систему отсеивания с помощью ReflectionProbeтекущий stateЭто обеспечивает, что Unity правильно убивает ReflectionProbe во время рендеринга, если вы реализуете собственную систему отражения времени выполнения. |
Мероприятия
| Мероприятие | Описание |
|---|---|
| defaultReflectionSet | Добавлен делегат для получения уведомлений при изменении зеркального сопоставления кубов по умолчанию. |
| defaultReflectionTexture | Добавлен делегат для получения уведомлений при изменении зеркального сопоставления кубов по умолчанию. |
| reflectionProbeChanged | Добавление делегата для получения уведомлений при добавлении Reflection Probe в Scene или удалении его из Scene. |
Унаследованные члены 4
Свойства
| Свойство | Описание |
|---|---|
| enabled | True, если это Поведение включено, в противном случае false. |
| isActiveAndEnabled | Проверяет, включён ли компонент, прикреплен ли он к GameObject, который активен в иерархии, и вызван ли OnEnable компонента. |
| gameObject | GameObject, к которому прикреплен данный компонент. Компонент всегда прикрепляется к игровому объекту. |
| tag | Тег этого игрового объекта. |
| transform | Transform прикреплен к этому GameObject. |
| transformHandle | TransformHandle этого GameObject. |
| hideFlags | Должен ли объект быть скрытым, сохраняться с Scene или изменяться пользователем? |
| name | Имя объекта. |
Открытые методы
| Метод | Описание |
|---|---|
| BroadcastMessage | Вызывает метод с именем methodName на каждом MonoBehaviour в этом игровом объекте или любом из его дочерей. |
| CompareTag | Проверяет тег GameObject на соответствие определенному тегу. |
| GetComponent | Получает ссылку на компонент типа T на том же GameObject, что и указанный компонент. |
| GetComponentInChildren | Получает ссылку на компонент типа T на том же GameObject, что и указанный компонент, или на любого ребенка GameObject. |
| GetComponentIndex | Получает индекс компонента на его родительском GameObject. |
| GetComponentInParent | Получает ссылку на компонент типа T на том же GameObject, что и указанный компонент, или на любой родитель GameObject. |
| GetComponents | Получает ссылки на все компоненты типа T на том же GameObject, что и указанный компонент. |
| GetComponentsInChildren | Получает ссылки на все компоненты типа T на том же GameObject, что и указанный компонент, и на любого ребенка GameObject. |
| GetComponentsInParent | Получает ссылки на все компоненты типа T на том же GameObject, что и указанный компонент, и любой родитель GameObject. |
| SendMessage | Вызывает метод с именем methodName на каждом MonoBehaviour в этом игровом объекте. |
| SendMessageUpwards | Вызывает метод с именем methodName на каждом MonoBehaviour в этом игровом объекте и на каждом предшественнике поведения. |
| TryGetComponent | Получает компонент указанного типа, если он существует. |
| GetInstanceID | Получает экземпляр ID объекта. |
| ToString | Возвращает имя объекта. |
Статические методы
| Метод | Описание |
|---|---|
| Destroy | Удаляет GameObject, компонент или ресурс. |
| DestroyImmediate | Немедленно уничтожает указанный объект. Используйте с осторожностью и только в режиме редактирования. |
| DontDestroyOnLoad | Не уничтожать целевой Объект при загрузке нового Scene. |
| FindAnyObjectByType | Получает любой активный загруженный объект типа Type. |
| FindFirstObjectByType | Получает первый активный загруженный объект типа Type. |
| FindObjectsByType | Получает список всех загруженных объектов типа Type. |
| Instantiate | Клонирует исходный объект и возвращает клон. |
| InstantiateAsync | Захватывает моментальный снимок первоначального объекта (который должен быть связан с каким-либо GameObject) и возвращает AsyncInstantiateOperation. |
Операторы
| Оператор | Описание |
|---|---|
| bool | Существует ли объект? |
| оператор!= | Сравнивает, если два объекта ссылаются на разные объекты. |
| оператор == | Сравнение двух ссылок на объекты для определения того, относятся ли они к одному и тому же объекту. |