bpy.context
bpy.contextbpy.context.areabpy.context.asset_file_handlebpy.context.blend_databpy.context.collectiobpy.context.enginebpy.context.gizmo_groupbpy.context.layer_collectionbpy.context.modebpy.context.preferencesbpy.context.regionbpy.context.region_databpy.context.scenebpy.context.screenbpy.context.space_databpy.context.tool_settingsbpy.context.view_layerbpy.context.windowbpy.context.window_managerbpy.context.workspacebpy.context.texture_slotbpy.context.scenebpy.context.worldbpy.context.objectbpy.context.meshbpy.context.armaturebpy.context.latticebpy.context.curvebpy.context.meta_ballbpy.context.lightbpy.context.speakerbpy.context.lightprobebpy.context.camerabpy.context.materialbpy.context.material_slotbpy.context.texturebpy.context.texture_userbpy.context.texture_user_propertybpy.context.bonebpy.context.edit_bonebpy.context.pose_bonebpy.context.particle_systembpy.context.particle_system_editablebpy.context.particle_settingsbpy.context.clothbpy.context.soft_bodybpy.context.fluidbpy.context.collisionbpy.context.brushbpy.context.dynamic_paintbpy.context.line_stylebpy.context.collectionbpy.context.gpencilbpy.context.curvesbpy.context.volumebpy.context.edit_movieclipbpy.context.edit_maskbpy.context.active_filebpy.context.selected_filesbpy.context.asset_library_refbpy.context.selected_asset_filesbpy.context.idbpy.context.edit_imagebpy.context.edit_maskbpy.context.selected_nodesbpy.context.active_nodebpy.context.lightbpy.context.materialbpy.context.worldbpy.context.scenebpy.context.view_layerbpy.context.visible_objectsbpy.context.selectable_objectsbpy.context.selected_objectsbpy.context.editable_objectsbpy.context.selected_editable_objectsbpy.context.objects_in_modebpy.context.objects_in_mode_unique_databpy.context.visible_bonesbpy.context.editable_bonesbpy.context.selected_bonesbpy.context.selected_editable_bonesbpy.context.visible_pose_bonesbpy.context.selected_pose_bonesbpy.context.selected_pose_bones_from_active_objectbpy.context.active_bonebpy.context.active_pose_bonebpy.context.active_objectbpy.context.objectbpy.context.edit_objectbpy.context.sculpt_objectbpy.context.vertex_paint_objectbpy.context.weight_paint_objectbpy.context.image_paint_objectbpy.context.particle_edit_objectbpy.context.pose_objectbpy.context.active_sequence_stripbpy.context.sequencesbpy.context.selected_sequencesbpy.context.selected_editable_sequencesbpy.context.active_nla_trackbpy.context.active_nla_stripbpy.context.selected_nla_stripsbpy.context.selected_movieclip_tracksbpy.context.gpencil_databpy.context.gpencil_data_ownerbpy.context.annotation_databpy.context.annotation_data_ownerbpy.context.visible_gpencil_layersbpy.context.editable_gpencil_layersbpy.context.editable_gpencil_strokesbpy.context.active_gpencil_layerbpy.context.active_gpencil_framebpy.context.active_annotation_layerbpy.context.active_operatorbpy.context.active_actionbpy.context.selected_visible_actionsbpy.context.selected_editable_actionsbpy.context.visible_fcurvesbpy.context.editable_fcurvesbpy.context.selected_visible_fcurvesbpy.context.selected_editable_fcurvesbpy.context.active_editable_fcurvebpy.context.selected_editable_keyframesbpy.context.ui_listbpy.context.asset_library_refbpy.context.edit_maskbpy.context.edit_textbpy.context.active_objectbpy.context.selected_ids
bpy.data
bpy.msgbus
bpy.ops
bpy.ops.actions
bpy.ops.anim
bpy.ops.anim.change_framebpy.ops.anim.channel_select_keysbpy.ops.anim.channels_clean_emptybpy.ops.anim.channels_clickbpy.ops.anim.channels_collapsebpy.ops.anim.channels_deletebpy.ops.anim.channels_editable_togglebpy.ops.anim.channels_expandbpy.ops.anim.channels_fcurves_enablebpy.ops.anim.channels_groupbpy.ops.anim.channels_movebpy.ops.anim.channels_renamebpy.ops.anim.channels_select_allbpy.ops.anim.channels_select_boxbpy.ops.anim.channels_select_filterbpy.ops.anim.channels_setting_disablebpy.ops.anim.channels_setting_enablebpy.ops.anim.channels_setting_togglebpy.ops.anim.channels_ungroupbpy.ops.anim.clear_useless_actionsbpy.ops.anim.copy_driver_buttonbpy.ops.anim.driver_button_addbpy.ops.anim.driver_button_editbpy.ops.anim.driver_button_removebpy.ops.anim.end_frame_setbpy.ops.anim.keyframe_clear_buttonbpy.ops.anim.keyframe_clear_v3dbpy.ops.anim.keyframe_deletebpy.ops.anim.keyframe_delete_buttonbpy.ops.anim.keyframe_delete_by_namebpy.ops.anim.keyframe_delete_v3dbpy.ops.anim.keyframe_insertbpy.ops.anim.keyframe_insert_buttonbpy.ops.anim.keyframe_insert_by_namebpy.ops.anim.keyframe_insert_menubpy.ops.anim.keying_set_active_setbpy.ops.anim.keying_set_addbpy.ops.anim.keying_set_exportbpy.ops.anim.keying_set_path_addbpy.ops.anim.keying_set_path_removebpy.ops.anim.keying_set_removebpy.ops.anim.keyingset_button_addbpy.ops.anim.keyingset_button_removebpy.ops.anim.paste_driver_buttonbpy.ops.anim.previewrange_clearbpy.ops.anim.previewrange_setbpy.ops.anim.start_frame_setbpy.ops.anim.update_animated_transform_constraintsbpy.ops.anim.snapbpy.ops.anim.stashbpy.ops.anim.stash_and_createbpy.ops.anim.unlinkbpy.ops.anim.view_allbpy.ops.anim.view_framebpy.ops.anim.view_selected
bpy.opts.armature
bpy.ops.asset
bpy.ops.boid
bpy.ops.brush
bpy.ops.buttons
bpy.ops.cachefile
bpy.ops.camera
bpy.ops.clip
bpy.ops.clip.add_markerbpy.ops.clip.add_marker_at_clickbpy.ops.clip.add_marker_movebpy.ops.clip.add_marker_slidebpy.ops.clip.apply_solution_scalebpy.ops.clip.average_tracksbpy.ops.clip.bundles_to_meshbpy.ops.clip.camera_preset_addbpy.ops.clip.change_framebpy.ops.clip.clean_tracksbpy.ops.clip.clear_solutionbpy.ops.clip.clear_track_pathbpy.ops.clip.constraint_to_fcurvebpy.ops.clip.copy_tracksbpy.ops.clip.create_plane_trackbpy.ops.clip.cursor_setbpy.ops.clip.delete_markerbpy.ops.clip.delete_proxybpy.ops.clip.delete_trackbpy.ops.clip.detect_featuresbpy.ops.clip.disable_markersbpy.ops.clip.dopesheet_select_channelbpy.ops.clip.dopesheet_view_allbpy.ops.clip.filter_tracksbpy.ops.clip.frame_jumpbpy.ops.clip.graph_center_current_framebpy.ops.clip.graph_delete_curvebpy.ops.clip.graph_delete_knotbpy.ops.clip.graph_disable_markersbpy.ops.clip.graph_selectbpy.ops.clip.graph_select_all_markersbpy.ops.clip.graph_select_boxbpy.ops.clip.graph_view_allbpy.ops.clip.hide_tracksbpy.ops.clip.hide_tracks_clearbpy.ops.clip.join_tracksbpy.ops.clip.keyframe_deletebpy.ops.clip.keyframe_insertbpy.ops.clip.lock_selection_togglebpy.ops.clip.lock_tracksbpy.ops.clip.mode_setbpy.ops.clip.new_image_from_plane_markerbpy.ops.clip.openbpy.ops.clip.paste_tracksbpy.ops.clip.prefetchbpy.ops.clip.rebuild_proxybpy.ops.clip.refine_markersbpy.ops.clip.reloadbpy.ops.clip.selectbpy.ops.clip.select_allbpy.ops.clip.select_boxbpy.ops.clip.select_circlebpy.ops.clip.select_groupedbpy.ops.clip.select_lassobpy.ops.clip.set_active_clipbpy.ops.clip.set_axisbpy.ops.clip.set_center_principalbpy.ops.clip.set_originbpy.ops.clip.set_planebpy.ops.clip.set_scalebpy.ops.clip.set_scene_framebpy.ops.clip.set_solution_scalebpy.ops.clip.set_solver_keyframebpy.ops.clip.set_viewport_backgroundbpy.ops.clip.setup_tracking_scenebpy.ops.clip.slide_markerbpy.ops.clip.slide_plane_markerbpy.ops.clip.solve_camerabpy.ops.clip.stabilize_2d_addbpy.ops.clip.stabilize_2d_removebpy.ops.clip.stabilize_2d_rotation_addbpy.ops.clip.bilize_2d_rotation_removebpy.ops.clip.stabilize_2d_rotation_selectbpy.ops.clip.stabilize_2d_selectbpy.ops.clip.track_color_preset_addbpy.ops.clip.track_copy_colorbpy.ops.clip.track_markersbpy.ops.clip.track_settings_as_defaultbpy.ops.clip.track_settings_to_trackbpy.ops.clip.track_to_emptybpy.ops.clip.tracking_object_newbpy.ops.clip.tracking_object_removebpy.ops.clip.tracking_settings_preset_addbpy.ops.clip.update_image_from_plane_markerbpy.ops.clip.view_allbpy.ops.clip.view_center_cursorbpy.ops.clip.view_ndofbpy.ops.clip.view_panbpy.ops.clip.view_selectedbpy.ops.clip.view_zoombpy.ops.clip.view_zoom_inbpy.ops.clip.view_zoom_outbpy.ops.clip.view_zoom_ratio
bpy.ops.cloth
bpy.ops.collection
bpy.ops.console
bpy.ops.constraint
bpy.ops.curve
bpy.ops.curves
bpy.ops.cycles
bpy.ops.dpaint
bpy.ops.ed
bpy.ops.export_
bpy.ops.file
bpy.ops.fluid
bpy.ops.font
bpy.ops.geometry
bpy.ops.gizmogroup
bpy.ops.gpencil
bpy.ops.gpencil.active_frame_deletebpy.ops.gpencil.active_frames_delete_allbpy.ops.gpencil.annotatebpy.ops.gpencil.annotation_active_frame_deletebpy.ops.gpencil.annotation_addbpy.ops.gpencil.bake_grease_pencil_animationbpy.ops.gpencil.bake_mesh_animationbpy.ops.gpencil.blank_frame_addbpy.ops.gpencil.brush_resetbpy.ops.gpencil.brush_reset_allbpy.ops.gpencil.convertbpy.ops.gpencil.convert_old_filesbpy.ops.gpencil.copybpy.ops.gpencil.data_unlinkbpy.ops.gpencil.deletebpy.ops.gpencil.dissolvebpy.ops.gpencil.drawbpy.ops.gpencil.duplicatebpy.ops.gpencil.duplicate_movebpy.ops.gpencil.editmode_togglebpy.ops.gpencil.extract_palette_vertexbpy.ops.gpencil.extrudebpy.ops.gpencil.extrude_movebpy.ops.gpencil.fillbpy.ops.gpencil.frame_clean_duplicatebpy.ops.gpencil.frame_clean_fillbpy.ops.gpencil.frame_clean_loosebpy.ops.gpencil.frame_duplicatebpy.ops.gpencil.generate_weightsbpy.ops.gpencil.guide_rotatebpy.ops.gpencil.hidebpy.ops.gpencil.image_to_grease_pencilbpy.ops.gpencil.interpolatebpy.ops.gpencil.interpolate_reversebpy.ops.gpencil.interpolate_sequencebpy.ops.gpencil.layer_activebpy.ops.gpencil.layer_addbpy.ops.gpencil.layer_annotation_addbpy.ops.gpencil.layer_annotation_movebpy.ops.gpencil.layer_annotation_removebpy.ops.gpencil.layer_changebpy.ops.gpencil.layer_duplicatebpy.ops.gpencil.layer_duplicate_objectbpy.ops.gpencil.layer_isolatebpy.ops.gpencil.layer_mask_addbpy.ops.gpencil.layer_mask_movebpy.ops.gpencil.layer_mask_removebpy.ops.gpencil.layer_mergebpy.ops.gpencil.layer_movebpy.ops.gpencil.layer_removebpy.ops.gpencil.lock_allbpy.ops.gpencil.lock_layerbpy.ops.gpencil.material_hidebpy.ops.gpencil.material_isolatebpy.ops.gpencil.material_lock_allbpy.ops.gpencil.material_lock_unusedbpy.ops.gpencil.material_revealbpy.ops.gpencil.material_selectbpy.ops.gpencil.material_setbpy.ops.gpencil.material_to_vertex_colorbpy.ops.gpencil.material_unlock_allbpy.ops.gpencil.materials_copy_to_objectbpy.ops.gpencil.move_to_layerbpy.ops.gpencil.paintmode_togglebpy.ops.gpencil.pastebpy.ops.gpencil.primitive_boxbpy.ops.gpencil.primitive_circlebpy.ops.gpencil.primitive_curvebpy.ops.gpencil.primitive_linebpy.ops.gpencil.primitive_polylinebpy.ops.gpencil.recalc_geometrybpy.ops.gpencil.reprojectbpy.ops.gpencil.reset_transform_fillbpy.ops.gpencil.revealbpy.ops.gpencil.sculpt_paintbpy.ops.gpencil.sculptmode_togglebpy.ops.gpencil.segment_addbpy.ops.gpencil.segment_movebpy.ops.gpencil.segment_removebpy.ops.gpencil.selectbpy.ops.gpencil.select_allbpy.ops.gpencil.select_alternatebpy.ops.gpencil.select_boxbpy.ops.gpencil.select_circlebpy.ops.gpencil.select_firstbpy.ops.gpencil.select_groupedbpy.ops.gpencil.select_lassobpy.ops.gpencil.select_lastbpy.ops.gpencil.select_lessbpy.ops.gpencil.select_linkedbpy.ops.gpencil.select_morebpy.ops.gpencil.select_randombpy.ops.gpencil.select_vertex_colorbpy.ops.gpencil.selection_opacity_togglebpy.ops.gpencil.selectmode_togglebpy.ops.gpencil.set_active_materialbpy.ops.gpencil.snap_cursor_to_selectedbpy.ops.gpencil.snap_to_cursorbpy.ops.gpencil.snap_to_gridbpy.ops.gpencil.stroke_apply_thicknessbpy.ops.gpencil.stroke_arrangebpy.ops.gpencil.stroke_caps_setbpy.ops.gpencil.stroke_change_colorbpy.ops.gpencil.stroke_cutterbpy.ops.gpencil.stroke_cyclical_setbpy.ops.gpencil.stroke_editcurve_set_handle_typebpy.ops.gpencil.stroke_enter_editcurve_modebpy.ops.gpencil.stroke_flipbpy.ops.gpencil.stroke_joinbpy.ops.gpencil.stroke_mergebpy.ops.gpencil.stroke_merge_by_distancebpy.ops.gpencil.stroke_merge_materialbpy.ops.gpencil.stroke_normalizebpy.ops.gpencil.stroke_outlinebpy.ops.gpencil.stroke_reset_vertex_colorbpy.ops.gpencil.stroke_samplebpy.ops.gpencil.stroke_separatebpy.ops.gpencil.stroke_simplifybpy.ops.gpencil.stroke_simplify_fixedbpy.ops.gpencil.stroke_smoothbpy.ops.gpencil.stroke_splitbpy.ops.gpencil.stroke_start_setbpy.ops.gpencil.stroke_subdividebpy.ops.gpencil.stroke_trimbpy.ops.gpencil.time_segment_addbpy.ops.gpencil.time_segment_movebpy.ops.gpencil.time_segment_removebpy.ops.gpencil.tint_flipbpy.ops.gpencil.trace_imagebpy.ops.gpencil.transform_fillbpy.ops.gpencil.unlock_allbpy.ops.gpencil.vertex_color_brightness_contrastbpy.ops.gpencil.vertex_color_hsvbpy.ops.gpencil.vertex_color_invertbpy.ops.gpencil.vertex_color_levelsbpy.ops.gpencil.vertex_color_setbpy.ops.gpencil.vertex_group_assignbpy.ops.gpencil.vertex_group_deselectbpy.ops.gpencil.vertex_group_invertbpy.ops.gpencil.vertex_group_normalizebpy.ops.gpencil.vertex_group_normalize_allbpy.ops.gpencil.vertex_group_remove_frombpy.ops.gpencil.vertex_group_selectbpy.ops.gpencil.vertex_group_smoothbpy.ops.gpencil.vertex_paintbpy.ops.gpencil.vertexmode_togglebpy.ops.gpencil.weight_paintbpy.ops.gpencil.weightmode_toggle

bpy.ops.export_scene.gltf

bpy.ops.export_scene.gltf() 操作将场景导出为 glTF 文件格式。

参数

  • filepath(字符串):导出文件的路径。支持绝对和相对路径。
  • export_format(枚举):导出格式。支持 glTF (.gltf) 和 glb (.glb)。
  • export_texture_dir(字符串):纹理文件输出目录的路径。
  • check_existing(布尔值):如果允许覆盖现有文件,则为 True。
  • export_selected(布尔值):如果只导出选定的对象,则为 True。
  • export_apply(布尔值):如果应用 transform,则为 True。
  • export_texcoords(布尔值):如果输出纹理坐标,则为 True。
  • export_normals(布尔值):如果输出法线,则为 True。
  • export_tangents(布尔值):如果输出切线,则为 True。
  • export_colors(布尔值):如果输出顶点色,则为 True。
  • export_materials(布尔值):如果输出材料信息,则为 True。
  • export_cameras(布尔值):如果输出相机信息,则为 True。
  • export_selected_cameras(布尔值):如果只输出选定的相机信息,则为 True。
  • export_animation(布尔值):如果输出动画信息,则为 True。
  • export_frame_range(布尔值):如果只输出选定的帧,则为 True。
  • export_frame_step(整数):每帧的步长。
  • export_force_sampling(布尔值):如果要强制采样,则为 True。
  • export_current_frame(布尔值):如果导出当前帧,则为 True。
  • export_skins(布尔值):如果输出皮肤信息,则为 True。
  • export_all_influences(布尔值):如果输出影响权重,则为 True。
  • export_morph_normals(布尔值):如果输出变形后的法线,则为 True。
  • export_morph_tangents(布尔值):如果输出变形后的切线,则为 True。
  • export_morph_colors(布尔值):如果输出变形后的顶点色,则为 True。
  • export_morph_shapekeys(布尔值):如果输出变形关键帧,则为 True。

返回值

  • set(objects):需要导出的对象。
  • set_override(context):替代上下文。

示例

下面是一个例子,演示如何将场景导出为 glTF 格式:

import bpy

filepath = '/path/to/export.gltf'

bpy.ops.export_scene.gltf(filepath=filepath, export_format='GLTF')

异常

  • RuntimeError:如果出现运行时错误,则引发异常。