使用手册 - Revision history

Mr F at 22:12, 3 January 2026

2026-01-03T22:12:18Z

Mr F at 22:12, 3 January 2026

2026-01-03T22:12:13Z

Mr F at 10:59, 7 November 2025

2025-11-07T10:59:28Z

Mr F at 10:58, 7 November 2025

2025-11-07T10:58:57Z

Mr F at 10:58, 7 November 2025

2025-11-07T10:58:35Z

Mr F at 20:49, 5 November 2025

2025-11-05T20:49:51Z

Mr F at 14:50, 5 November 2025

2025-11-05T14:50:37Z

Mr F: /* 脚本 API */

2025-11-05T14:50:14Z

‎脚本 API

Mr F at 14:41, 5 November 2025

2025-11-05T14:41:40Z

Mr F: /* Bakery shaders */

2025-11-05T14:32:10Z

‎Bakery shaders

← Older revision		Revision as of 22:12, 3 January 2026
Line 1:		Line 1:

	[https://geom.io/bakery/wiki/index.php?title=Manual (Click for English version)]		[https://geom.io/bakery/wiki/index.php?title=Manual (Click for English version)]
−

	== 系统要求 ==		== 系统要求 ==

← Older revision		Revision as of 22:12, 3 January 2026
Line 1:		Line 1:
−	~~[[File:fdlm1200x630.png\|1000px]]~~

	[https://geom.io/bakery/wiki/index.php?title=Manual (Click for English version)]		[https://geom.io/bakery/wiki/index.php?title=Manual (Click for English version)]

← Older revision		Revision as of 10:59, 7 November 2025
Line 1:		Line 1:
	[[File:fdlm1200x630.png\|1000px]]		[[File:fdlm1200x630.png\|1000px]]
−

	[https://geom.io/bakery/wiki/index.php?title=Manual (Click for English version)]		[https://geom.io/bakery/wiki/index.php?title=Manual (Click for English version)]

@@ Line 1: / Line 1: @@
 [[File:fdlm1200x630.png|1000px]]
 [https://geom.io/bakery/wiki/index.php?title=Manual (Click for English version)]
 == 系统要求 ==

← Older revision		Revision as of 10:58, 7 November 2025
Line 1:		Line 1:
	[[File:fdlm1200x630.png\|1000px]]		[[File:fdlm1200x630.png\|1000px]]

		+	[https://geom.io/bakery/wiki/index.php?title=Manual (Click for English version)]

	== 系统要求 ==		== 系统要求 ==

← Older revision		Revision as of 20:49, 5 November 2025
Line 1:		Line 1:
		+	[[File:fdlm1200x630.png\|1000px]]
		+
		+
	== 系统要求 ==		== 系统要求 ==

@@ Line 920: / Line 920: @@
 ''finalCutoff = 1 - (1 - cutoff) * alpha''
-对于彩色透明效果，请使用 [[Manual#Bakery_Light_Filter|Light Filter]] 组件。
+对于彩色透明效果，请使用 [[使用手册#Bakery_Light_Filter|Light Filter]] 组件。
 有关漫反射半透明效果，请参考 [[#Backface GI|Backface GI]] 和 [[subsurface scattering]]。
@@ Line 990: / Line 990: @@
 * Texel padding (default atlas packer): 定义在使用默认 atlas 打包器时，在光照贴图 atlas 中对象 UV 布局之间添加多少空白 texel。
 * Texel padding (xatlas packer): 同上，但在使用 xatlas 时。
-* Alpha Meta Pass resolution multiplier: 乘以 [[Manual#Alpha_Meta_Pass|Alpha Meta Pass]] 的分辨率，使在低分辨率光照贴图烘焙时仍能实现精确的基于 Shader 的切割效果。
+* Alpha Meta Pass resolution multiplier: 乘以 [[使用手册#Alpha_Meta_Pass|Alpha Meta Pass]] 的分辨率，使在低分辨率光照贴图烘焙时仍能实现精确的基于 Shader 的切割效果。
-* Volume render mode: 为所有 [[Manual#Bakery_Volume|Volumes]] 使用哪种 [[Manual#Render_mode|渲染模式]]？Auto 使用当前活动的渲染模式（默认）。
+* Volume render mode: 为所有 [[使用手册#Bakery_Volume|Volumes]] 使用哪种 [[使用手册#Render_mode|渲染模式]]？Auto 使用当前活动的渲染模式（默认）。
 * Delete previous lightmaps before bake: 在烘焙新光照贴图之前，实际删除该场景中所有之前渲染的光照贴图文件。
 * Log level: 定义烘焙过程中在控制台输出的信息量。可能的值：
@@ Line 1,005: / Line 1,005: @@
 * Remove ringing in Legacy light probes: 在 Legacy 模式下启用更柔和的光探针卷积，以防止高对比度区域出现伪影。
 * Always render reflection probes: 在每次 Render/Render Light Probes 后自动渲染反射探针。
-* Ringing removal for L2 light probes: 对 [[Manual#Light_probe_mode|L2 光探针]] 应用去振铃处理。值越高，探针光照越平滑；这种平滑可以减少 [[https://docs.unity3d.com/6000.2/Documentation/Manual/light-probes-troubleshooting.html](https://docs.unity3d.com/6000.2/Documentation/Manual/light-probes-troubleshooting.html) 振铃] 伪影（如果存在）。
+* Ringing removal for L2 light probes: 对 [[使用手册#Light_probe_mode|L2 光探针]] 应用去振铃处理。值越高，探针光照越平滑；这种平滑可以减少 [[https://docs.unity3d.com/6000.2/Documentation/Manual/light-probes-troubleshooting.html](https://docs.unity3d.com/6000.2/Documentation/Manual/light-probes-troubleshooting.html) 振铃] 伪影（如果存在）。
 * Put menu under Tools: 将 Bakery 菜单放入 Tools 菜单下。

← Older revision		Revision as of 14:50, 5 November 2025
Line 1,262:		Line 1,262:
	ftLightmapsStorage storage = ftRenderLightmap.FindRenderSettingsStorage();		ftLightmapsStorage storage = ftRenderLightmap.FindRenderSettingsStorage();
	</pre>		</pre>
		+	可以在 ftLightmapsStorage.cs 中查看可用设置的完整列表。
		+
		+	获取 lightmapper 实例并（重新）加载设置：
		+
		+	<pre>ftRenderLightmap bakery = ftRenderLightmap.instance != null ? ftRenderLightmap.instance : new ftRenderLightmap();
		+	bakery.LoadRenderSettings();
		+	</pre>
		+
		+	渲染光照贴图（如果设置为 L1 或 L2 模式，也会渲染探针）：
		+
		+	<pre>bakery.RenderButton(bool showMsgWindows)</pre>
		+
		+	仅渲染光探针：
		+
		+	<pre>bakery.RenderLightProbesButton(bool showMsgWindows)</pre>
		+
		+	仅渲染反射探针：
		+
		+	<pre>bakery.RenderReflectionProbesButton(bool showMsgWindows)</pre>
		+
		+	'''showMsgWindows''' 指示是否可以显示任何对话框/确认框。如果设置为 false，则抑制显示。
		+
		+	检查烘焙是否正在进行：
		+
		+	<pre>ftRenderLightmap.bakeInProgress</pre>
		+
		+	使用示例请参考 [[Community_extensions#Batch_scene_baker\|Batch Scene Baker]] 脚本。
		+
		+	== 额外函数 ==
		+
		+	将一个 ftLightmapsStorage 的所有渲染设置复制到另一个：
		+
		+	<pre>ftLightmapsStorage.CopySettings(ftLightmapsStorage src, ftLightmapsStorage dest)</pre>
		+
		+	获取全局（每项目）存储对象：
		+
		+	<pre>ftGlobalStorage gstorage = ftLightmaps.GetGlobalStorage()</pre>
		+
		+	将 ftLightmapsStorage（每场景）的所有渲染设置复制到 ftGlobalStorage（每项目）：
		+
		+	<pre>ftLightmapsStorage.CopySettings(ftLightmapsStorage src, ftGlobalStorage dest)</pre>
		+
		+	将 ftGlobalStorage（每项目）的所有渲染设置复制到 ftLightmapsStorage（每场景）：
		+
		+	<pre>ftLightmapsStorage.CopySettings(ftGlobalStorage src, ftLightmapsStorage dest)</pre>
		+
		+	获取包含 Bakery 二进制文件的文件夹路径：
		+
		+	<pre>ftLightmaps.GetEditorPath()</pre>
		+
		+	== 额外变量 ==
		+
		+	获取当前临时文件路径（必须先创建 ftRenderLightmap 实例）：
		+
		+	<pre>ftRenderLightmap.scenePath</pre>
		+
		+	获取/设置 UVGBuffer 数据压缩（启用时为 LZ4，否则为 DDS）：
		+
		+	<pre>ftRenderLightmap.compressedGBuffer</pre>
		+
		+	获取/设置输出光照贴图数据压缩（启用时为 LZ4，否则为 DDS）：
		+
		+	<pre>ftRenderLightmap.compressedOutput</pre>
		+
		+	== 事件 ==
		+
		+	脚本可以订阅 ftRenderLightmap 类中的静态事件。
		+
		+	在完整渲染前调用：
		+
		+	<pre>EventHandler OnPreFullRender</pre>
		+
		+	在 Legacy 光探针模式下，每渲染一个光探针前调用。ProbeEventArgs 是一个结构体，包含 '''pos''' 字段表示当前光探针的位置：
		+
		+	<pre>EventHandler<ProbeEventArgs> OnPreRenderProbe</pre>
		+
		+	在 Legacy 光探针渲染完成后调用：
		+
		+	<pre>EventHandler OnFinishedProbes</pre>
		+
		+	在完整渲染完成后调用：
		+
		+	<pre>EventHandler OnFinishedFullRender</pre>
		+
		+	在反射探针渲染前调用：
		+
		+	<pre>EventHandler OnPreReflectionProbeRender</pre>
		+
		+	在反射探针渲染完成后调用：
		+
		+	<pre>EventHandler OnFinishedReflectionProbes</pre>

← Older revision		Revision as of 14:41, 5 November 2025
Line 1,174:		Line 1,174:

	另请参阅：[[Integrating_Bakery_shader_features_to_custom_shaders\| 将 Bakery 着色器特性集成到自定义着色器中]]		另请参阅：[[Integrating_Bakery_shader_features_to_custom_shaders\| 将 Bakery 着色器特性集成到自定义着色器中]]
		+
		+	= 关于 HDRP/URP 的说明 =
		+	将该插件导入到 HDRP 或 URP 项目后，一般即可直接使用，但需要注意以下几点：
		+
		+	* 示例场景中同时使用了普通 Standard 着色器以及部分 “Bakery Standard” 着色器。HDRP 和 URP 提供了将项目着色器从 Standard 升级到 Lit 的机制，但无法从 Bakery Standard 升级。请将 Bakery Standard 材质替换为来自 Bakery_ShaderGraphHDRP.unitypackage 或 Bakery_ShaderGraphURP.unitypackage 中的材质。
		+
		+	* 在 HDRP 中，默认 HDRI 天空亮度较高（11），且天空反射默认不会被遮蔽。再加上默认的自动曝光，可能导致某些示例场景几乎不可见，因为它们使用了更低的亮度进行烘焙。此时可将 HDRI 天空亮度降低到 1。HDRI 设置通常位于 Assets/HDRPDefaultResources/DefaultSettingsVolumeProfile 中。
		+
		+	* 在 HDRP 中，如果示例场景中的灯光过亮，可在 Bakery 灯光组件上点击 “match real-time to lightmapped” 按钮。
		+
		+	* 在 HDRP 中建议使用 OpenImageDenoise 2（最佳）或 OptiX 7 去噪器，因为它们对高亮度值更适合。
		+
		+	* 在 HDRP 中，“distance” 与普通 Shadowmask 的切换可直接在 Light 组件上完成，而不是在全局设置中。
		+
		+	* 不要在 Skylight 上使用 “match” 按钮，因为 HDRP 使用的是非常特定的程序化天空着色器。请改为将其烘焙为 HDRI [[How_do_I...#How_do_I_use_Skylight_with_a_procedural_sky_shader.3F\|这种方式]]。
		+
		+	* 建议在使用 HDRP 时始终将 Light Probe Mode 设置为 L2 或 L1，因为 HDRP 的渲染器并未针对 Legacy 模式进行优化。
		+
		+	* 最新版本的 HDRP/URP 自带自己的 IES 文件导入器。由于资源类型不匹配，Unity 会将旧版本 Bakery IES 灯光断开连接，使其显示为普通点光源。它们可以重新连接并重新保存。
		+
		+	Bakery 的示例场景是为内置渲染管线设计的，因此在 HDRP/URP 中正确渲染它们需要一些步骤。以下是一些提示；假设新建项目使用默认的 HDRP/URP 设置：
		+
		+	=== 在 HDRP 中查看示例场景 ===
		+
		+	* 导入 Bakery 后，将标准材质升级为 HDRP：Edit->Rendering->Materials->Convert All Built-in Materials To HDRP。
		+	* 将 Bakery_ShaderGraphHDRP.unitypackage 导入项目，因为它包含实现高级 Bakery 功能的特殊 Shader Graph（对于经典颜色/方向/遮罩光照贴图不需要）。
		+	* 选择 DefaultSettingsVolumeProfile.asset。在 HDRI Sky 部分，将 Exposure Compensation 设置为 1。否则，与示例场景相比，默认 HDRP 会过亮，因曝光调整而使场景看起来很暗。
		+	* 选择示例场景中的灯光时，HDRP 会初始化其自身的灯光数据。有时会导致灯光立即变得更亮。点击 “Match real-time to lightmapped” 以同步。
		+	* 在渲染光探针前，将 Light Probe Mode 设置为 L2。
		+	* '''example_directional''': 将 Shader 更改为 BakeryDirSpecGraph 以查看烘焙高光（或仅使用常规 HDRP/Lit 用于仅漫反射法线映射）。删除球体，因为当前没有支持逐顶点方向的 Shader Graph。
		+	* '''example_directional_MonoSH''': 将 Shader 更改为 BakerySpecMonoSHGraph（或 BakeryMonoSHGraph，用于没有高光的略微低成本版本）。删除球体，因为当前没有支持逐顶点 MonoSH 的 Shader Graph。
		+	* '''example_RNM''': 将 Shader 更改为 BakeryRNMGraph。
		+	* '''example_SH''': 将 Shader 更改为 BakerySpecSHGraph（或 BakerySHGraph，用于没有高光的略微低成本版本）。删除球体，因为当前没有支持逐顶点 SH 的 Shader Graph。
		+	* '''example_mixed_directional_mode''': 对 MonoSH/RNM/SH 平面，同样需要不同的 Graph。
		+	* '''example_lights''': 将顶点光照球体的 Shader 更改为 BakeryVertexColorGraph。
		+	* '''example_prefabs_bake''': 无需进一步调整。
		+	* '''example_sectors''': 无需进一步调整。
		+	* '''example_shadowmask''': 选择 DirectLight 并点击 “Match real-time to lightmapped” 修正亮度。将所有 HDRP 灯光的 Shadowmask Mode 设置为 Shadowmask。
		+	* '''example_sponza_day''': 将 OpenImageDenoise 2（或 Optix 7，如果不支持）设置为首选去噪器。
		+	* '''example_sponza_evening''': 将 OpenImageDenoise 2（或 Optix 7，如果不支持）设置为首选去噪器。
		+	* '''example_subtractive''': HDRP 不支持减法模式。
		+	* '''example_volumes_simple''': 将火车 Shader 更改为 BakeryVolumeSpecGraph（或 BakeryVolumeGraph，用于没有高光的略微低成本版本）。
		+	* '''example_volumes_simple_shadowmask''': HDRP 当前不支持 Shadowmask Volumes。
		+	* '''example_volumes_advanced''': 与 example_volumes_simple 相同。
		+	* '''example_translucency''': 场景大部分应显示正常。对于 “Dynamic sphere lit by volume”，将 Shader 设置为 BakeryVolumeGraph。
		+
		+	=== 在 URP 中查看示例场景 ===
		+
		+	* 导入 Bakery 后，将标准材质升级为 URP：打开 Assets/Bakery/examples/content，输入 "t:material" 选择所有材质，并仅在 "content" 文件夹下搜索。点击 Edit->Rendering->Materials->Convert Selected Built-in Materials To URP。
		+	* 将 Bakery_ShaderGraphURP.unitypackage 导入项目，因为它包含实现高级 Bakery 功能的特殊 Shader Graph（对于经典颜色/方向/遮罩光照贴图不需要）。
		+	* '''example_directional''': 将 Shader 更改为 BakeryURPLit，启用 "Bakery Lightmapped Specular"（或者仅保持常规 URP/Lit 用于仅漫反射法线映射）。删除球体，因为当前没有支持逐顶点方向的 Shader Graph。
		+	* '''example_directional_MonoSH''': 将 Shader 更改为 BakeryURPLit，将 Bakery Mode 设置为 MonoSH，启用 "Bakery Lightmapped Specular"。在顶点光照球体上也启用 "Per-vertex"。
		+	* '''example_RNM''': 将 Shader 更改为 BakeryURPLit，将 Bakery Mode 设置为 RNM，启用 "Bakery Lightmapped Specular"。
		+	* '''example_SH''': 将 Shader 更改为 BakeryURPLit，将 Bakery Mode 设置为 SH，启用 "Bakery Lightmapped Specular"。删除球体，因为当前没有支持逐顶点 SH 的 Shader Graph。
		+	* '''example_mixed_directional_mode''': 类似地使用 BakeryURPLit 并设置不同的 Bakery Mode（MonoSH、RNM、SH）。非方向性/主方向/烘焙法线贴图可使用常规 URP/Lit。
		+	* '''example_lights''': 无需进一步调整。
		+	* '''example_prefabs_bake''': 无需进一步调整。
		+	* '''example_sectors''': 无需进一步调整。
		+	* '''example_shadowmask''': 类似于 Built-in 渲染管线，在 Bakery 窗口（或项目 Quality Settings）中取消选中 Distance Shadowmask，以在摄像机附近查看实际烘焙/实时阴影混合效果。
		+	* '''example_sponza_day''': 在植被材质上启用 alpha clipping。
		+	* '''example_sponza_evening''': 同 example_sponza_day。
		+	* '''example_subtractive''': 无需进一步调整。
		+	* '''example_volumes_simple''': 将火车 Shader 更改为 BakeryURPLit，并将 Bakery Mode 设置为 Volume。可选启用 "Bakery Lightmapped Specular"。
		+	* '''example_volumes_simple_shadowmask''': 与 example_volumes_simple 相同，但也启用 "Volume Shadowmask"。
		+	* '''example_volumes_advanced''': 与 example_volumes_simple 相同。
		+	* '''example_translucency''': 场景大部分应显示正常。对于 "Dynamic sphere lit by volume"，将 Shader 设置为 BakeryURPLit 并将 Bakery Mode 设置为 Volume。
		+
		+	= 升级 Bakery =
		+	在升级该资源时，建议遵循以下步骤：
		+
		+	* 关闭 Bakery 窗口。
		+	* 关闭 Unity。
		+	* 重新打开 Unity。
		+	* 导入更新后的包。
		+
		+	请注意，如果不先关闭 Unity，导入可能会失败，因为 DLL 文件被锁定（会出现类似 "alphabuffergen.dll: Access is denied." 的提示）。
		+
		+	如果你移动过 Bakery 文件夹（Assets/Bakery 和 Assets/Editor/x64/Bakery）到其他位置，可能需要在更新前将它们移回原处，以避免出现两个冲突的包副本。
		+
		+	= 脚本 API =
		+
		+	== 基本用法 ==
		+
		+	获取并修改渲染设置：
		+
		+	<pre>
		+	ftLightmapsStorage storage = ftRenderLightmap.FindRenderSettingsStorage();
		+	</pre>

← Older revision		Revision as of 14:32, 5 November 2025
Line 1,168:		Line 1,168:
	\| style="text-align: center; background-color:#d9ead3;" \| 是		\| style="text-align: center; background-color:#d9ead3;" \| 是
	\|}		\|}
		+
		+	{{note\| 除了普通颜色光照贴图之外，所有功能都至少需要 Shader Model 3.0 才能运行。}}
		+	{{note\| 使用 SH 模式的顶点光照贴图由于插值器数量限制，至少需要 Shader Model 4.0。}}
		+	{{note\| 含有从 Dominant Direction 生成高光的更新版 URP 图表可在 [[Bakery_-_GPU_Lightmapper\|主维基页面]] 下载。}}
		+
		+	另请参阅：[[Integrating_Bakery_shader_features_to_custom_shaders\| 将 Bakery 着色器特性集成到自定义着色器中]]