这个操作是用于在 UV 贴图上烘焙某个对象表面的纹理,例如光照、阴影、反射等等。它可以使用多种不同的方法来烘焙出纹理信息,并将其保存到指定的图像文件中。
type
(字符串) - 烘焙类型,支持以下选项:
COMBINED
- 烘焙所有的纹理信息(默认值)AO
- 烘焙环境遮挡(AO)SHADOW
- 烘焙阴影NORMALS
- 烘焙法线信息TEXTURE
- 烘焙贴图GLOSSY
- 烘焙光泽度EMIT
- 烘焙自发光filepath
(字符串) - 保存文件的路径width
(整数) - 纹理图像的宽度(像素)height
(整数) - 纹理图像的高度(像素)margin
(整数) - 纹理图像周围的边距宽度(像素)use_selected_to_active
(布尔值) - 是否烘焙选中的对象到活动对象(默认值为 False)normal_space
(字符串) - 烘焙法线信息时使用的坐标空间,支持以下选项:
WORLD
- 世界坐标系(默认值)OBJECT
- 对象坐标系TANGENT
- 割线坐标系CAMERA
- 相机坐标系normal_r
(实数) - 烘焙法线信息时使用的红色通道比重(默认值为 0.5)normal_g
(实数) - 烘焙法线信息时使用的绿色通道比重(默认值为 0.5)normal_b
(实数) - 烘焙法线信息时使用的蓝色通道比重(默认值为 1.0)normal_a
(实数) - 烘焙法线信息时使用的透明度比重(默认值为 1.0)normal_space
(字符串) - 烘焙法线信息时使用的坐标空间,支持以下选项:
WORLD
- 世界坐标系(默认值)OBJECT
- 对象坐标系TANGENT
- 割线坐标系CAMERA
- 相机坐标系normal_r
(实数) - 烘焙法线信息时使用的红色通道比重(默认值为 0.5)normal_g
(实数) - 烘焙法线信息时使用的绿色通道比重(默认值为 0.5)normal_b
(实数) - 烘焙法线信息时使用的蓝色通道比重(默认值为 1.0)normal_a
(实数) - 烘焙法线信息时使用的透明度比重(默认值为 1.0)texture_mode
(字符串) - 烘焙贴图时使用的模式,支持以下选项:
MULTIRES
- 利用 Multires 细节模型生成纹理映射(默认值)NORMALS
- 利用法线生成纹理映射DISPLACEMENT
- 利用位移生成纹理映射pass_filter
(布尔值) - 是否仅烘焙选择的通道(默认值为 False)use_clear
(布尔值) - 是否在烘焙前清空图像(默认值为 False)该操作不返回任何有用的结果信息。
如果保存文件失败,则会抛出 FileNotFoundError
异常。如果某些参数无效或无法执行操作,则会抛出 RuntimeError
异常。