bpy.ops.ed.lib_id_generate_preview_from_object

描述

根据给定的对象生成库元素的预览图像。

库元素是在文件中存在的可重用数据，例如材质和纹理。 预览图像是用户可以在用户界面中看到的图像，以帮助他们确定要使用的库元素。

此操作将替换库元素的现有预览图像（如果存在）。

用法

bpy.ops.ed.lib_id_generate_preview_from_object(object, filepath=None, size=(256, 256), use_viewport=True)

参数

• object：Object， 要使用其生成预览的对象。
• filepath：string，要将预览图像保存到的文件路径。 如果不指定文件路径，则此操作不会保存文件，仅在内存中创建预览图像。
• size：(int, int)，预览图像的大小（以像素为单位）。 默认为（256, 256）。
• use_viewport：bool，如果为True，则使用当前视口设置生成预览。 如果为False，则使用完整场景渲染生成预览。 默认为True。

返回值

• {'FINISHED'}，如果成功生成预览图像，则返回此状态。

示例

import bpy

# 选择一个对象并生成预览图像
selection = bpy.context.selected_objects[0]
bpy.ops.ed.lib_id_generate_preview_from_object(selection)

# 生成预览图像并将其保存到文件
bpy.ops.ed.lib_id_generate_preview_from_object(selection, filepath="/tmp/my_preview.png")

异常

• RuntimeError， 如果在生成预览图像期间发生错误，则会引发此异常。