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.gpencil.snap_to_cursor

描述

将当前选择的 Grease Pencil 键盘对象的位置捕捉到 3D 光标处。

语法

bpy.ops.gpencil.snap_to_cursor(grease_pencil=None, mode='ALL')

参数

grease_pencil (GPencil) – 要操作的 Grease Pencil 键盘对象。如果未指定，则使用活动 Grease Pencil 对象。
mode (str) – 用于限制捕捉的许可模式。默认为“ALL”。

可以使用以下模式之一：

- 'ALL'：水平和垂直 (XY) 平面上的捕捉。
- 'HORIZONTAL'：只在水平平面上捕捉对象的位置下降。
- 'VERTICAL'：只在垂直平面上捕捉对象的位置下降。

返回值

{'FINISHED'} – 操作成功完成。

示例

import bpy

# Select the Grease Pencil object
bpy.context.scene.objects.active = bpy.data.objects['GPencil']

# Snap the selected object to the 3D cursor
bpy.ops.gpencil.snap_to_cursor()

bpy.ops.gpencil.snap_to_cursor

描述

语法

参数

返回值

示例

作者

版本

参考