bpy.ops.export_mesh.ply

描述

bpy.ops.export_mesh.ply是Blender操作，用于导出网格对象为PLY文件格式。

语法

bpy.ops.export_mesh.ply(filepath="", check_existing=True, filter_glob="*.ply", use_ascii=False, global_scale=1.0, axis_forward='-Z', axis_up='Y', use_mesh_modifiers=True, mesh_as_point_cloud=False, use_normals=True, use_uv_coords=True, use_colors=True, use_export_selected=False, color_source='TEXTURE')

参数

• filepath (string, (optional)) - 文件路径，需要导出的文件路径。默认值为 ""。
• check_existing (boolean, (optional)) - 如果为True，则在导出之前检查文件是否存在，并要求确认是否要覆盖该文件。默认值为 True。
• filter_glob (string, (optional)) - 文件过滤器，用于确定哪些文件导出为PLY。默认值为 "*.ply"。
• use_ascii (boolean, (optional)) - 如果为True，则使用ASCII格式导出PLY文件，否则使用二进制格式。默认值为 False。
• global_scale (float, (optional)) - 全局缩放因子。默认值为 1.0。
• axis_forward (string, (optional)) - 前向和上向轴的方向。默认为 -Z。
• axis_up (string, (optional)) - 前向和上向轴的方向。默认为 Y。
• use_mesh_modifiers (boolean, (optional)) - 如果为True，则使用对象的所有网格修饰符进行导出。否则，将仅使用基元网格。默认值为 True。
• mesh_as_point_cloud (boolean, (optional)) - 如果为True，则将每个顶点作为点云指定，而不是通过连接它们创建三角形。默认值为 False。
• use_normals (boolean, (optional)) - 如果为True，则在PLY文件中导出法向量。默认值为 True。
• use_uv_coords (boolean, (optional)) - 如果为True，则在PLY文件中导出UV坐标。默认值为 True。
• use_colors (boolean, (optional)) - 如果为True，则在PLY文件中导出颜色。默认值为 True。
• use_export_selected (boolean, (optional)) - 如果为True，则仅导出选定的对象。默认值为 False。
• color_source (string, (optional)) - 颜色来源。可选值为 'VERTEX' 或 'TEXTURE'。默认为 'TEXTURE'。

返回值

• {'FINISHED'} - 如果操作成功完成。

示例

# 导出默认场景中的选定对象为PLY格式
import bpy

file_path = "C:/Users/Admin/Desktop/my_object.ply"

bpy.ops.export_mesh.ply(filepath=file_path, use_export_selected=True)

参考

• Blender Python API: Operators > Export