#include "DNA_ID_enums.h"
#include "DNA_space_types.h"
#include "BKE_lib_id.hh"
#include "BKE_main.hh"
#include "BLI_math_base.h"
#include "BLI_rect.h"
#include "UI_resources.hh"
#include "RNA_access.hh"
#include "RNA_define.hh"
#include "RNA_enum_types.hh"
#include "RNA_prototypes.hh"
#include "ED_select_utils.hh"
#include "WM_api.hh"
#include "WM_types.hh"

Functions
void	WM_operator_properties_confirm_or_exec (wmOperatorType *ot)
static const EnumPropertyItem *	wm_operator_properties_filesel_sort_items_itemf (bContext , PointerRNA , PropertyRNA , bool r_free)
void	WM_operator_properties_filesel (wmOperatorType *ot, const int filter, const short type, const eFileSel_Action action, const eFileSel_Flag flag, const short display, const short sort)
void	WM_operator_properties_id_lookup_set_from_id (PointerRNA ptr, const ID id)
ID *	WM_operator_properties_id_lookup_from_name_or_session_uid (Main bmain, PointerRNA ptr, const ID_Type type)
bool	WM_operator_properties_id_lookup_is_set (PointerRNA *ptr)
void	WM_operator_properties_id_lookup (wmOperatorType *ot, const bool add_name_prop)
static void	wm_operator_properties_select_action_ex (wmOperatorType ot, int default_action, const EnumPropertyItem select_actions, bool hide_gui)
void	WM_operator_properties_select_action (wmOperatorType *ot, int default_action, bool hide_gui)
void	WM_operator_properties_select_action_simple (wmOperatorType *ot, int default_action, bool hide_gui)
void	WM_operator_properties_select_random (wmOperatorType *ot)
int	WM_operator_properties_select_random_seed_increment_get (wmOperator *op)
void	WM_operator_properties_select_all (wmOperatorType *ot)
void	WM_operator_properties_border (wmOperatorType *ot)
void	WM_operator_properties_border_to_rcti (wmOperator op, rcti r_rect)
void	WM_operator_properties_border_to_rctf (wmOperator op, rctf r_rect)
blender::Bounds< blender::int2 >	WM_operator_properties_border_to_bounds (wmOperator *op)
void	WM_operator_properties_gesture_box_ex (wmOperatorType *ot, bool deselect, bool extend)
void	WM_operator_properties_use_cursor_init (wmOperatorType *ot)
void	WM_operator_properties_gesture_box_select (wmOperatorType *ot)
void	WM_operator_properties_gesture_box (wmOperatorType *ot)
void	WM_operator_properties_select_operation (wmOperatorType *ot)
void	WM_operator_properties_select_operation_simple (wmOperatorType *ot)
void	WM_operator_properties_select_walk_direction (wmOperatorType *ot)
void	WM_operator_properties_generic_select (wmOperatorType *ot)
void	WM_operator_properties_gesture_box_zoom (wmOperatorType *ot)
void	WM_operator_properties_gesture_lasso (wmOperatorType *ot)
void	WM_operator_properties_gesture_polyline (wmOperatorType *ot)
void	WM_operator_properties_gesture_straightline (wmOperatorType *ot, int cursor)
void	WM_operator_properties_gesture_circle (wmOperatorType *ot)
void	WM_operator_properties_mouse_select (wmOperatorType *ot)
void	WM_operator_properties_checker_interval (wmOperatorType *ot, bool nth_can_disable)
void	WM_operator_properties_checker_interval_from_op (wmOperator op, CheckerIntervalParams op_params)
bool	WM_operator_properties_checker_interval_test (const CheckerIntervalParams *op_params, int depth)

Detailed Description

Generic re-usable property definitions and accessors for operators to share. (WM_operator_properties_* functions).

Definition in file wm_operator_props.cc.

Function Documentation

◆ WM_operator_properties_border()

void WM_operator_properties_border ( wmOperatorType * ot )

◆ WM_operator_properties_border_to_bounds()

blender::Bounds< blender::int2 > WM_operator_properties_border_to_bounds ( wmOperator * op )

Definition at line 415 of file wm_operator_props.cc.

References Bounds< T >::Bounds(), wmOperator::ptr, RNA_int_get(), and WM_operator_properties_border_to_bounds().

Referenced by blender::ed::sculpt_paint::grease_pencil_erase_box_exec(), and WM_operator_properties_border_to_bounds().

◆ WM_operator_properties_border_to_rctf()

void WM_operator_properties_border_to_rctf	(	wmOperator *	op,
		rctf *	r_rect )

Definition at line 408 of file wm_operator_props.cc.

References BLI_rctf_rcti_copy(), WM_operator_properties_border_to_rctf(), and WM_operator_properties_border_to_rcti().

Referenced by box_select_graph_exec(), ed_marker_box_select_exec(), image_view_zoom_border_exec(), blender::ed::space_node::node_box_select_exec(), blender::ed::outliner::outliner_box_select_exec(), render_border_exec(), blender::ed::vse::sequencer_box_select_exec(), blender::ed::vse::sequencer_retiming_box_select_exec(), uv_box_select_exec(), view_borderzoom_exec(), blender::ed::vse::view_ghost_border_exec(), and WM_operator_properties_border_to_rctf().

◆ WM_operator_properties_border_to_rcti()

void WM_operator_properties_border_to_rcti	(	wmOperator *	op,
		rcti *	r_rect )

◆ WM_operator_properties_checker_interval()

void WM_operator_properties_checker_interval	(	wmOperatorType *	ot,
		bool	nth_can_disable )

Parameters

nth_can_disable Enable if we want to be able to select no interval at all.

Definition at line 644 of file wm_operator_props.cc.

References min_ii(), RNA_def_int(), wmOperatorType::srna, and WM_operator_properties_checker_interval().

Referenced by CURVE_OT_select_nth(), MESH_OT_select_nth(), path_select_properties(), path_select_properties(), and WM_operator_properties_checker_interval().

◆ WM_operator_properties_checker_interval_from_op()

void WM_operator_properties_checker_interval_from_op	(	wmOperator *	op,
		CheckerIntervalParams *	op_params )

Definition at line 677 of file wm_operator_props.cc.

References mod_i(), CheckerIntervalParams::nth, CheckerIntervalParams::offset, wmOperator::ptr, RNA_int_get(), CheckerIntervalParams::skip, and WM_operator_properties_checker_interval_from_op().

Referenced by edbm_select_nth_exec(), path_select_params_from_op(), path_select_params_from_op(), select_nth_exec(), and WM_operator_properties_checker_interval_from_op().

◆ WM_operator_properties_checker_interval_test()

bool WM_operator_properties_checker_interval_test	(	const CheckerIntervalParams *	op_params,
		int	depth )

Definition at line 691 of file wm_operator_props.cc.

References CheckerIntervalParams::nth, CheckerIntervalParams::offset, CheckerIntervalParams::skip, and WM_operator_properties_checker_interval_test().

Referenced by mouse_mesh_shortest_path_edge(), mouse_mesh_shortest_path_face(), mouse_mesh_shortest_path_vert(), mouse_mesh_uv_shortest_path_edge(), mouse_mesh_uv_shortest_path_face(), mouse_mesh_uv_shortest_path_vert(), select_nth_bezt(), select_nth_bp(), walker_deselect_nth(), and WM_operator_properties_checker_interval_test().

◆ WM_operator_properties_confirm_or_exec()

void WM_operator_properties_confirm_or_exec ( wmOperatorType * ot )

◆ WM_operator_properties_filesel()

void WM_operator_properties_filesel	(	wmOperatorType *	ot,
		int	filter,
		short	type,
		eFileSel_Action	action,
		eFileSel_Flag	flag,
		short	display,
		short	sort )

Default properties for file-select.

Definition at line 65 of file wm_operator_props.cc.

References FILE_DEFAULTDISPLAY, FILE_HORIZONTALDISPLAY, FILE_IMGDISPLAY, FILE_LOADLIB, FILE_MAX, FILE_SAVE, FILE_SPECIAL, FILE_TYPE_ALEMBIC, FILE_TYPE_ARCHIVE, FILE_TYPE_BLENDER, FILE_TYPE_BLENDER_BACKUP, FILE_TYPE_BLENDERLIB, FILE_TYPE_BTX, FILE_TYPE_COLLADA, FILE_TYPE_FOLDER, FILE_TYPE_FTFONT, FILE_TYPE_IMAGE, FILE_TYPE_MOVIE, FILE_TYPE_OBJECT_IO, FILE_TYPE_PYSCRIPT, FILE_TYPE_SOUND, FILE_TYPE_TEXT, FILE_TYPE_USD, FILE_TYPE_VOLUME, FILE_VERTICALDISPLAY, filter, PROP_HIDDEN, PROP_SKIP_PRESET, PROP_SKIP_SAVE, RNA_def_boolean(), RNA_def_collection_runtime(), RNA_def_enum(), RNA_def_enum_funcs(), RNA_def_int(), RNA_def_property_flag(), RNA_def_string_dir_path(), RNA_def_string_file_name(), RNA_def_string_file_path(), rna_enum_dummy_NULL_items, sort(), wmOperatorType::srna, WM_FILESEL_DIRECTORY, WM_FILESEL_FILENAME, WM_FILESEL_FILEPATH, WM_FILESEL_FILES, WM_FILESEL_RELPATH, WM_FILESEL_SHOW_PROPS, WM_operator_properties_filesel(), and wm_operator_properties_filesel_sort_items_itemf().

Referenced by blender::ed::asset::ASSET_OT_bundle_install(), blender::ed::sculpt_paint::BRUSH_OT_asset_load_preview(), BUTTONS_OT_directory_browse(), BUTTONS_OT_file_browse(), CACHEFILE_OT_layer_add(), CACHEFILE_OT_open(), CLIP_OT_open(), ED_OT_lib_id_load_custom_preview(), FILE_OT_find_missing_files(), FONT_OT_open(), FONT_OT_text_paste_from_file(), GRAPH_OT_sound_to_samples(), IMAGE_OT_file_browse(), IMAGE_OT_open(), IMAGE_OT_replace(), IMAGE_OT_save_as(), blender::ed::space_node::NODE_OT_add_image(), blender::ed::object::OBJECT_OT_empty_image_add(), blender::ed::object::OBJECT_OT_multires_external_save(), blender::ed::object::OBJECT_OT_volume_import(), PREFERENCES_OT_asset_library_add(), RIGIDBODY_OT_world_export(), screen_screenshot_impl(), blender::ed::vse::SEQUENCER_OT_change_path(), blender::ed::vse::SEQUENCER_OT_export_subtitles(), blender::ed::vse::SEQUENCER_OT_image_strip_add(), blender::ed::vse::SEQUENCER_OT_movie_strip_add(), blender::ed::vse::SEQUENCER_OT_sound_strip_add(), SOUND_OT_mixdown(), SOUND_OT_open(), SOUND_OT_open_mono(), TEXT_OT_open(), TEXT_OT_save_as(), WM_operator_properties_filesel(), WM_OT_append(), WM_OT_id_linked_relocate(), WM_OT_lib_reload(), WM_OT_lib_relocate(), WM_OT_link(), WM_OT_open_mainfile(), WM_OT_recover_auto_save(), WM_OT_save_as_mainfile(), and WM_OT_save_mainfile().

◆ wm_operator_properties_filesel_sort_items_itemf()

const EnumPropertyItem * wm_operator_properties_filesel_sort_items_itemf	(	bContext *	,
		PointerRNA *	,
		PropertyRNA *	,
		bool *	r_free )

static

Extends rna_enum_fileselect_params_sort_items with a default item for operators to use.

Definition at line 44 of file wm_operator_props.cc.

References FILE_SORT_DEFAULT, rna_enum_fileselect_params_sort_items, RNA_enum_item_add(), RNA_enum_item_end(), RNA_enum_items_add(), and wm_operator_properties_filesel_sort_items_itemf().

Referenced by WM_operator_properties_filesel(), and wm_operator_properties_filesel_sort_items_itemf().

◆ WM_operator_properties_generic_select()

void WM_operator_properties_generic_select ( wmOperatorType * ot )

Selecting and tweaking items are overlapping operations. Getting both to work without conflicts requires special care. See https://wiki.blender.org/wiki/Human_Interface_Guidelines/Selection#Select-tweaking for the desired behavior.

For default click selection (with no modifier keys held), the select operators can do the following:

On a mouse press on an unselected item, change selection and finish immediately after. This sends an undo push and allows transform to take over should a click-drag event be caught.
On a mouse press on a selected item, don't change selection state, but start modal execution of the operator. Idea is that we wait with deselecting other items until we know that the intention wasn't to tweak (mouse press+drag) all selected items.
If a click-drag is recognized before the release event happens, cancel the operator, so that transform can take over and no undo-push is sent.
If the release event occurs rather than a click-drag one, deselect all items but the one under the cursor, and finish the modal operator.

This utility, together with WM_generic_select_invoke() and WM_generic_select_modal() should help getting the wanted behavior to work. Most generic logic should be handled in these, so that the select operators only have to care for the case dependent handling.

Every select operator has slightly different requirements, e.g. sequencer strip selection also needs to account for handle selection. This should be the baseline behavior though.

Definition at line 507 of file wm_operator_props.cc.

References PROP_HIDDEN, PROP_SKIP_SAVE, RNA_def_boolean(), RNA_def_int(), RNA_def_property_flag(), wmOperatorType::srna, and WM_operator_properties_generic_select().

Referenced by ACTION_OT_clickselect(), FILE_OT_select(), GRAPH_OT_clickselect(), MARKER_OT_select(), NLA_OT_click_select(), blender::ed::vse::SEQUENCER_OT_select(), blender::ed::vse::SEQUENCER_OT_select_handle(), and WM_operator_properties_generic_select().

◆ WM_operator_properties_gesture_box()

void WM_operator_properties_gesture_box ( wmOperatorType * ot )

◆ WM_operator_properties_gesture_box_ex()

void WM_operator_properties_gesture_box_ex	(	wmOperatorType *	ot,
		bool	deselect,
		bool	extend )

Use with WM_gesture_box_invoke

Definition at line 422 of file wm_operator_props.cc.

References PROP_SKIP_SAVE, RNA_def_boolean(), RNA_def_property_flag(), wmOperatorType::srna, WM_operator_properties_border(), and WM_operator_properties_gesture_box_ex().

Referenced by WM_operator_properties_gesture_box(), WM_operator_properties_gesture_box_ex(), and WM_operator_properties_gesture_box_select().

◆ WM_operator_properties_gesture_box_select()

void WM_operator_properties_gesture_box_select ( wmOperatorType * ot )

Definition at line 453 of file wm_operator_props.cc.

References WM_operator_properties_gesture_box_ex(), and WM_operator_properties_gesture_box_select().

Referenced by ANIM_OT_channels_select_box(), CLIP_OT_graph_select_box(), and WM_operator_properties_gesture_box_select().

◆ WM_operator_properties_gesture_box_zoom()

void WM_operator_properties_gesture_box_zoom ( wmOperatorType * ot )

Definition at line 522 of file wm_operator_props.cc.

References PROP_HIDDEN, PROP_SKIP_SAVE, RNA_def_boolean(), RNA_def_property_flag(), wmOperatorType::srna, WM_operator_properties_border(), and WM_operator_properties_gesture_box_zoom().

Referenced by IMAGE_OT_view_zoom_border(), VIEW2D_OT_zoom_border(), VIEW3D_OT_zoom_border(), and WM_operator_properties_gesture_box_zoom().

◆ WM_operator_properties_gesture_circle()

void WM_operator_properties_gesture_circle ( wmOperatorType * ot )

Use with WM_gesture_circle_invoke

Definition at line 598 of file wm_operator_props.cc.

References PROP_HIDDEN, PROP_SKIP_SAVE, RNA_def_boolean(), RNA_def_int(), RNA_def_property_flag(), wmOperatorType::srna, and WM_operator_properties_gesture_circle().

Referenced by ACTION_OT_select_circle(), CLIP_OT_select_circle(), GRAPH_OT_select_circle(), MASK_OT_select_circle(), blender::ed::space_node::NODE_OT_select_circle(), UV_OT_select_circle(), VIEW3D_OT_select_circle(), and WM_operator_properties_gesture_circle().

◆ WM_operator_properties_gesture_lasso()

void WM_operator_properties_gesture_lasso ( wmOperatorType * ot )

Use with WM_gesture_lasso_invoke

Definition at line 531 of file wm_operator_props.cc.

References PROP_HIDDEN, PROP_PIXEL, PROP_SKIP_SAVE, RNA_def_boolean(), RNA_def_collection_runtime(), RNA_def_float(), RNA_def_int(), RNA_def_property_flag(), RNA_def_property_subtype(), wmOperatorType::srna, and WM_operator_properties_gesture_lasso().

Referenced by ACTION_OT_select_lasso(), CLIP_OT_select_lasso(), GRAPH_OT_select_lasso(), blender::ed::sculpt_paint::GREASE_PENCIL_OT_erase_lasso(), GREASE_PENCIL_OT_stroke_trim(), MASK_OT_select_lasso(), blender::ed::space_node::NODE_OT_select_lasso(), blender::ed::sculpt_paint::hide::PAINT_OT_hide_show_lasso_gesture(), blender::ed::sculpt_paint::mask::PAINT_OT_mask_lasso_gesture(), blender::ed::sculpt_paint::face_set::SCULPT_OT_face_set_lasso_gesture(), blender::ed::sculpt_paint::trim::SCULPT_OT_trim_lasso_gesture(), UV_OT_select_lasso(), VIEW3D_OT_select_lasso(), and WM_operator_properties_gesture_lasso().

◆ WM_operator_properties_gesture_polyline()

void WM_operator_properties_gesture_polyline ( wmOperatorType * ot )

Use with WM_gesture_polyline_invoke

Definition at line 562 of file wm_operator_props.cc.

References PROP_HIDDEN, PROP_SKIP_SAVE, RNA_def_collection_runtime(), RNA_def_property_flag(), wmOperatorType::srna, and WM_operator_properties_gesture_polyline().

Referenced by blender::ed::sculpt_paint::hide::PAINT_OT_hide_show_polyline_gesture(), blender::ed::sculpt_paint::mask::PAINT_OT_mask_polyline_gesture(), blender::ed::sculpt_paint::face_set::SCULPT_OT_face_set_polyline_gesture(), blender::ed::sculpt_paint::trim::SCULPT_OT_trim_polyline_gesture(), and WM_operator_properties_gesture_polyline().

◆ WM_operator_properties_gesture_straightline()

void WM_operator_properties_gesture_straightline	(	wmOperatorType *	ot,
		int	cursor )

Use with WM_gesture_straightline_invoke

Definition at line 569 of file wm_operator_props.cc.

References PROP_HIDDEN, PROP_SKIP_SAVE, RNA_def_boolean(), RNA_def_int(), RNA_def_property_flag(), wmOperatorType::srna, and WM_operator_properties_gesture_straightline().

Referenced by blender::ed::greasepencil::GREASE_PENCIL_OT_texture_gradient(), IMAGE_OT_sample_line(), MESH_OT_bisect(), blender::ed::sculpt_paint::hide::PAINT_OT_hide_show_line_gesture(), blender::ed::sculpt_paint::mask::PAINT_OT_mask_line_gesture(), PAINT_OT_weight_gradient(), blender::ed::sculpt_paint::face_set::SCULPT_OT_face_set_line_gesture(), blender::ed::sculpt_paint::project::SCULPT_OT_project_line_gesture(), blender::ed::sculpt_paint::trim::SCULPT_OT_trim_line_gesture(), and WM_operator_properties_gesture_straightline().

◆ WM_operator_properties_id_lookup()

void WM_operator_properties_id_lookup	(	wmOperatorType *	ot,
		const bool	add_name_prop )

Adds "name" and "session_uid" properties so the caller can tell the operator which ID to act on. See WM_operator_properties_id_lookup_from_name_or_session_uid(). Both properties will be hidden in the UI and not be saved over consecutive operator calls.

Note: New operators should probably use "session_uid" only (set add_name_prop to false), since this works properly with linked data and/or library overrides (in both cases, multiple IDs with the same name and type may be present). The "name" property is only kept to not break compatibility with old scripts using some previously existing operators.

Definition at line 274 of file wm_operator_props.cc.

References INT32_MAX, INT32_MIN, MAX_ID_NAME, PROP_HIDDEN, PROP_SKIP_SAVE, RNA_def_int(), RNA_def_property_flag(), RNA_def_string(), wmOperatorType::srna, and WM_operator_properties_id_lookup().

◆ WM_operator_properties_id_lookup_from_name_or_session_uid()

ID * WM_operator_properties_id_lookup_from_name_or_session_uid	(	Main *	bmain,
		PointerRNA *	ptr,
		enum ID_Type	type )

Tries to find an ID in bmain. There needs to be either a "session_uid" int or "name" string property defined and set. The former has priority. See WM_operator_properties_id_lookup() for a helper to add the properties.

Definition at line 249 of file wm_operator_props.cc.

References BKE_libblock_find_name(), BKE_libblock_find_session_uid(), MAX_ID_NAME, RNA_property_int_get(), RNA_property_is_set(), RNA_property_string_get(), RNA_struct_find_property(), and WM_operator_properties_id_lookup_from_name_or_session_uid().

◆ WM_operator_properties_id_lookup_is_set()

bool WM_operator_properties_id_lookup_is_set ( PointerRNA * ptr )

Check if either the "session_uid" or "name" property is set inside ptr. If this is the case the ID can be looked up by WM_operator_properties_id_lookup_from_name_or_session_uid().

Definition at line 269 of file wm_operator_props.cc.

References RNA_struct_property_is_set(), and WM_operator_properties_id_lookup_is_set().

Referenced by blender::ed::space_node::node_add_image_invoke(), blender::ed::object::object_image_add_invoke(), blender::ed::object::object_instance_add_invoke(), WM_operator_drop_load_path(), and WM_operator_properties_id_lookup_is_set().

◆ WM_operator_properties_id_lookup_set_from_id()

void WM_operator_properties_id_lookup_set_from_id	(	PointerRNA *	ptr,
		const ID *	id )

Tries to pass id to an operator via either a "session_uid" or a "name" property defined in the properties of ptr. The former is preferred, since it works properly with linking and library overrides (which may both result in multiple IDs with the same name and type).

Also see WM_operator_properties_id_lookup() and WM_operator_properties_id_lookup_from_name_or_session_uid()

Definition at line 233 of file wm_operator_props.cc.

References BLI_assert_unreachable, ID::name, RNA_int_set(), RNA_string_set(), RNA_struct_find_property(), ID::session_uid, and WM_operator_properties_id_lookup_set_from_id().

Referenced by blender::ed::geometry::catalog_assets_draw_unassigned(), blender::nodes::draw_bake_button_row(), blender::ed::object::unassigned_assets_draw(), view3d_id_drop_copy(), view3d_id_drop_copy_with_type(), view3d_id_path_drop_copy(), and WM_operator_properties_id_lookup_set_from_id().