bpy.context

bpy.data

bpy.msgbus

bpy.msgbus bpy.msgbus.clear_by_owner bpy.msgbus.publish_rna bpy.msgbus.subscribe_rna

bpy.ops

bpy.ops.actions

bpy.ops.anim

bpy.opts.armature

bpy.ops.asset

bpy.ops.asset.assign_action bpy.ops.asset.bundle_install bpy.ops.asset.catalog_delete bpy.ops.asset.catalog_new bpy.ops.asset.catalog_redo bpy.ops.asset.catalog_undo bpy.ops.asset.catalog_undo_push bpy.ops.asset.catalogs_save bpy.ops.asset.clear bpy.ops.asset.library_refresh bpy.ops.asset.mark bpy.ops.asset.open_containing_blend_file bpy.ops.asset.tag_add bpy.ops.asset.tag_remove

bpy.ops.boid

bpy.ops.boid.rule_add bpy.ops.boid.rule_del bpy.ops.boid.rule_move_down bpy.ops.boid.rule_move_up bpy.ops.boid.state_add bpy.ops.boid.state_del bpy.ops.boid.state_move_down bpy.ops.boid.state_move_up

bpy.ops.brush

bpy.ops.brush.add bpy.ops.brush.add_gpencil bpy.ops.brush.curve_preset bpy.ops.brush.reset bpy.ops.brush.scale_size bpy.ops.brush.stencil_control bpy.ops.brush.stencil_fit_image_aspect bpy.ops.brush.stencil_reset_transform

bpy.ops.buttons

bpy.ops.buttons.clear_filter bpy.ops.buttons.context_menu bpy.ops.buttons.directory_browse bpy.ops.buttons.file_browse bpy.ops.buttons.start_filter bpy.ops.buttons.toggle_pin

bpy.ops.cachefile

bpy.ops.cachefile.layer_add bpy.ops.cachefile.layer_move bpy.ops.cachefile.layer_remove bpy.ops.cachefile.open bpy.ops.cachefile.reload

bpy.ops.camera

bpy.ops.camera.preset_add

bpy.ops.clip

bpy.ops.cloth

bpy.ops.cloth.preset_add

bpy.ops.collection

bpy.ops.collection.create bpy.ops.collection.objects_add_active bpy.ops.collection.objects_remove bpy.ops.collection.objects_remove_active bpy.ops.collection.objects_remove_all

bpy.ops.console

bpy.ops.constraint

bpy.ops.curve

bpy.ops.curves

bpy.ops.curves.convert_from_particle_system bpy.ops.curves.convert_to_particle_system bpy.ops.curves.disable_selection bpy.ops.curves.sculptmode_toggle bpy.ops.curves.set_selection_domain bpy.ops.curves.snap_curves_to_surface bpy.ops.curves.surface_set

bpy.ops.cycles

bpy.ops.cycles.denoise_animation bpy.ops.cycles.merge_images bpy.ops.cycles.use_shading_nodes

bpy.ops.dpaint

bpy.ops.dpaint.bake bpy.ops.dpaint.output_toggle bpy.ops.dpaint.surface_slot_add bpy.ops.dpaint.surface_slot_remove bpy.ops.dpaint.type_toggle

bpy.ops.ed

bpy.ops.ed.flush_edits bpy.ops.ed.lib_id_fake_user_toggle bpy.ops.ed.lib_id_generate_preview bpy.ops.ed.lib_id_generate_preview_from_object bpy.ops.ed.lib_id_load_custom_preview bpy.ops.ed.lib_id_override_editable_toggle bpy.ops.ed.lib_id_unlink bpy.ops.ed.redo bpy.ops.ed.undo bpy.ops.ed.undo_history bpy.ops.ed.undo_push bpy.ops.ed.undo_redo

bpy.ops.export_

bpy.ops.export_anim.bvh bpy.ops.export_mesh.ply bpy.ops.export_mesh.stl bpy.ops.export_scene.fbx bpy.ops.export_scene.gltf bpy.ops.export_scene.obj bpy.ops.export_scene.x3d

bpy.ops.file

bpy.ops.file.autopack_toggle bpy.ops.file.bookmark_add bpy.ops.file.bookmark_cleanup bpy.ops.file.bookmark_delete bpy.ops.file.bookmark_move bpy.ops.file.cancel bpy.ops.file.delete bpy.ops.file.directory_new bpy.ops.file.edit_directory_path bpy.ops.file.execute bpy.ops.file.filenum bpy.ops.file.filepath_drop bpy.ops.file.find_missing_files bpy.ops.file.hidedot bpy.ops.file.highlight bpy.ops.file.make_paths_absolute bpy.ops.file.make_paths_relative bpy.ops.file.mouse_execute bpy.ops.file.next bpy.ops.file.pack_all bpy.ops.file.pack_libraries bpy.ops.file.parent bpy.ops.file.previous bpy.ops.file.refresh bpy.ops.file.rename bpy.ops.file.report_missing_files bpy.ops.file.reset_recent bpy.ops.file.select bpy.ops.file.select_all bpy.ops.file.select_bookmark bpy.ops.file.select_box bpy.ops.file.select_walk bpy.ops.file.smoothscroll bpy.ops.file.sort_column_ui_context bpy.ops.file.start_filter bpy.ops.file.unpack_all bpy.ops.file.unpack_item bpy.ops.file.unpack_libraries bpy.ops.file.view_selected

bpy.ops.fluid

bpy.ops.fluid.bake_all bpy.ops.fluid.bake_data bpy.ops.fluid.bake_guides bpy.ops.fluid.bake_mesh bpy.ops.fluid.bake_noise bpy.ops.fluid.bake_particles bpy.ops.fluid.free_all bpy.ops.fluid.free_data bpy.ops.fluid.free_guides bpy.ops.fluid.free_mesh bpy.ops.fluid.free_noise bpy.ops.fluid.free_particles bpy.ops.fluid.pause_bake bpy.ops.fluid.preset_add

bpy.ops.font

bpy.ops.geometry

bpy.ops.geometry.attribute_add bpy.ops.geometry.attribute_convert bpy.ops.geometry.attribute_remove bpy.ops.geometry.color_attribute_add bpy.ops.geometry.color_attribute_duplicate bpy.ops.geometry.color_attribute_remove bpy.ops.geometry.color_attribute_render_set

bpy.ops.gizmogroup

bpy.ops.gizmogroup.gizmo_select bpy.ops.gizmogroup.gizmo_tweak

bpy.ops.gpencil

bpy.ops.collection.objects_add_active

描述

向当前活动集合中添加一个新对象，并将其设置为活动对象。

语法

bpy.ops.collection.objects_add_active(type='EMPTY', align='WORLD', location=(0, 0, 0), rotation=(0, 0, 0))

参数

type (string, 可选) - 要创建的对象类型，默认为'EMPTY'。
align (string, 可选) - 对象定位方式，默认为'WORLD'。
location (tuple of floats, 可选) - 对象放置的位置，默认为(0, 0, 0)。
rotation (tuple of floats, 可选) - 对象的旋转角度，默认为(0, 0, 0)。

返回值

None.

示例

将一个新的空对象添加到当前活动的集合中，并将其设置为活动对象。

import bpy

bpy.ops.collection.objects_add_active(type='EMPTY', align='WORLD', location=(0, 0, 0), rotation=(0, 0, 0))

异常

无。

注意事项

如果在编辑模式下添加新对象，则该对象将添加到当前编辑的对象所在的集合中，而不是当前活动集合中。