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.context.blend_data

bpy.context.blend_data 是 Blender 中用于访问当前文件中的数据的上下文管理器。该对象的方法和属性可用于获取、创建、管理和修改当前文件中的各种数据类型,包括场景、对象、材质、贴图、动画等等。

属性

  • bpy.context.blend_data.scenes:当前文件中所有场景的列表。
  • bpy.context.blend_data.materials:当前文件中所有材质的列表。
  • bpy.context.blend_data.textures:当前文件中所有纹理的列表。
  • bpy.context.blend_data.images:当前文件中所有图像的列表。
  • bpy.context.blend_data.objects:当前文件中所有对象的列表。
  • bpy.context.blend_data.lights:当前文件中所有灯光的列表。
  • bpy.context.blend_data.cameras:当前文件中所有相机的列表。
  • bpy.context.blend_data.worlds:当前文件中所有世界的列表。

方法

  • bpy.context.blend_data.scenes.new(name):创建一个新场景并返回其引用。
  • bpy.context.blend_data.scenes.remove(scene):从当前文件中删除指定场景。
  • bpy.context.blend_data.materials.new(name):创建一个新材质并返回其引用。
  • bpy.context.blend_data.materials.remove(material):从当前文件中删除指定材质。
  • bpy.context.blend_data.textures.new(name, type):创建一个新纹理并返回其引用。
  • bpy.context.blend_data.textures.remove(texture):从当前文件中删除指定纹理。
  • bpy.context.blend_data.images.new(name, width, height):创建一个新图像并返回其引用。
  • bpy.context.blend_data.images.remove(image):从当前文件中删除指定图像。
  • bpy.context.blend_data.objects.new(name, data):创建一个新对象并返回其引用。
  • bpy.context.blend_data.objects.remove(obj):从当前文件中删除指定对象。
  • bpy.context.blend_data.lights.new(name, type):创建一个新灯光并返回其引用。
  • bpy.context.blend_data.lights.remove(light):从当前文件中删除指定灯光。
  • bpy.context.blend_data.cameras.new(name):创建一个新相机并返回其引用。
  • bpy.context.blend_data.cameras.remove(camera):从当前文件中删除指定相机。
  • bpy.context.blend_data.worlds.new(name):创建一个新世界并返回其引用。
  • bpy.context.blend_data.worlds.remove(world):从当前文件中删除指定世界。

注意:以上方法中的名称参数都是必需的,表示创建的数据的名称;data 参数表示新对象的数据,包括网格数据、材质数据等等;type 参数表示创建的数据类型,包括纹理类型、灯光类型等等。

示例

以下示例演示了如何使用 bpy.context.blend_data 从当前文件中获取、创建和修改对象数据。

import bpy

# 获取当前文件中的第一个场景
scene = bpy.context.blend_data.scenes[0]

# 创建一个新对象并添加到场景中
mesh = bpy.context.blend_data.meshes.new(name="CubeMesh")
obj = bpy.context.blend_data.objects.new(name="Cube", data=mesh)
scene.objects.link(obj)

# 修改新对象的位置
obj.location.x = 2.0
obj.location.y = 1.0

以上代码中,我们首先使用 bpy.context.blend_data.scenes 属性访问当前文件中的场景列表,并获取第一个场景的引用。接着,我们创建一个新网格数据并使用 bpy.context.blend_data.objects 属性和 bpy.context.blend_data.meshes 方法创建一个对象,然后将其添加到之前获取的场景中。最后,我们修改新对象的位置属性,将其移动到场景中指定的位置。

参考链接