反射探针用于将周围环境捕获为纹理,纹理将传递给着色器并用于反射。
属性与 Inspector 中显示的值完全匹配。
此类是 reflection probe 组件的脚本接口。
通常只在 Editor 中创建反射探针,但有时需要从脚本创建反射探针:
using UnityEngine;
public class Example : MonoBehaviour { void Start() { // Make a game object GameObject probeGameObject = new GameObject("The Reflection Probe");
// Add the reflection probe component ReflectionProbe probeComponent = probeGameObject.AddComponent<ReflectionProbe>() as ReflectionProbe;
// Set texture resolution probeComponent.resolution = 256;
// Reflection will be used for objects in 10 units around the position of the probe probeComponent.size = new Vector3(10, 10, 10);
// Set the position (or any transform property) probeGameObject.transform.position = new Vector3(0, 5, 0); } }
defaultTexture | 用于所有反射探针之外的纹理(只读)。 |
defaultTextureHDRDecodeValues | 默认反射探针纹理的 HDR 解码值。 |
backgroundColor | 用于清除反射探针纹理的颜色。 |
bakedTexture | 引用反射探针周围环境的烘焙纹理。 |
blendDistance | 用于混合的探针周围距离(在延迟探针中使用)。 |
bounds | 反射探针的包围体积(只读)。 |
boxProjection | 此反射探针是否应使用盒体投影。 |
center | 将在其中将反射应用于对象的盒体区域的中心。在探针的本地空间中测量。 |
clearFlags | 反射探针清除背景的方式。 |
cullingMask | 用于选择性地渲染反射探针周围的某些部分。 |
customBakedTexture | 引用反射探针周围环境的烘焙纹理。使用此变量可分配自定义反射纹理。 |
farClipPlane | 渲染探针时的远裁剪面距离。 |
hdr | 此反射探针是否应使用 HDR 渲染? |
importance | 反射探针重要性。 |
intensity | 在着色器中应用于反射探针纹理的强度修改器。 |
mode | 应在 Editor 中生成反射探针纹理 (ReflectionProbeMode.Baked) 还是探针应使用自定义指定纹理 (ReflectionProbeMode.Custom)? |
nearClipPlane | 渲染探针时的近裁剪面距离。 |
realtimeTexture | 引用反射探针周围环境的实时纹理。使用此变量可分配用于实时反射的 RenderTexture。 |
refreshMode | 设置探针的刷新方式。另请参阅:ReflectionProbeRefreshMode。 |
resolution | 底层反射纹理的分辨率(以像素为单位)。 |
shadowDistance | 渲染探针时的阴影绘制距离。 |
size | 将在其中将反射应用于对象的盒体区域的大小。在探针的本地空间中测量。 |
texture | 传递给反射探针邻近对象的着色器的纹理。 |
textureHDRDecodeValues | 反射探针纹理的 HDR 解码值。 |
timeSlicingMode | 将此探针设置为时间切片模式另请参阅:ReflectionProbeTimeSlicingMode。 |
IsFinishedRendering | 检查探针是否已完成时间切片渲染。 |
RenderProbe | 刷新探针的立方体贴图。 |
Reset | 将所有 ReflectionProbe 参数恢复为默认值。 |
BlendCubemap | Utility 方法,将两个立方体贴图混合到一个目标渲染纹理中。 |
defaultReflectionSet | 添加委托以在默认镜面立方体贴图发生变化时收到通知。 |
reflectionProbeChanged | 添加委托以在将反射探针添加到场景或将其从场景中删除时收到通知。 |
enabled | 启用的 Behaviour 可更新,禁用的 Behaviour 不可更新。 |
isActiveAndEnabled | 是否已激活并启用 Behaviour? |
gameObject | 此组件附加到的游戏对象。始终将组件附加到游戏对象。 |
tag | 此游戏对象的标签。 |
transform | 附加到此 GameObject 的 Transform。 |
hideFlags | 该对象应该隐藏、随场景一起保存还是由用户修改? |
name | 对象的名称。 |
BroadcastMessage | 调用此游戏对象或其任何子项中的每个 MonoBehaviour 上名为 methodName 的方法。 |
CompareTag | 此游戏对象是否使用 tag 进行了标记? |
GetComponent | 如果游戏对象附加了类型为 type 的组件,则将其返回,否则返回 null。 |
GetComponentInChildren | 使用深度首次搜索返回 GameObject 或其任何子项中类型为 type 的组件。 |
GetComponentInParent | 返回 GameObject 或其任何父项中类型为 type 的组件。 |
GetComponents | 返回 GameObject 中类型为 type 的所有组件。 |
GetComponentsInChildren | 返回 GameObject 或其任何子项中类型为 type 的所有组件。 |
GetComponentsInParent | 返回 GameObject 或其任何父项中类型为 type 的所有组件。 |
SendMessage | 调用此游戏对象中的每个 MonoBehaviour 上名为 methodName 的方法。 |
SendMessageUpwards | 调用此游戏对象中的每个 MonoBehaviour 上或此行为的每个父级上名为 methodName 的方法。 |
GetInstanceID | 返回对象的实例 ID。 |
ToString | 返回对象的名称。 |
Destroy | 移除 GameObject、组件或资源。 |
DestroyImmediate | 立即销毁对象 /obj/。强烈建议您改用 Destroy。 |
DontDestroyOnLoad | 在加载新的 Scene 时,请勿销毁 Object。 |
FindObjectOfType | 返回第一个类型为 type 的已加载的激活对象。 |
FindObjectsOfType | 返回所有类型为 type 的已加载的激活对象的列表。 |
Instantiate | 克隆 original 对象并返回克隆对象。 |
bool | 该对象是否存在? |
operator != | 比较两个对象是否引用不同的对象。 |
operator == | 比较两个对象引用,判断它们是否引用同一个对象。 |
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.