diff options
author | Campbell Barton <ideasman42@gmail.com> | 2021-12-14 07:49:31 +0300 |
---|---|---|
committer | Campbell Barton <ideasman42@gmail.com> | 2021-12-14 08:17:10 +0300 |
commit | c097c7b855d4b01950494dc369e9def59486b0fd (patch) | |
tree | d6a9c5a7108e97b0c38f5ba6cb4ded2a2e45ba2e /source/blender/editors | |
parent | c1f5d8d023c6fdef67efbc6ce2af49e384c9bd98 (diff) |
Cleanup: correct unbalanced doxygen groups
Also add groups in some files.
Diffstat (limited to 'source/blender/editors')
60 files changed, 226 insertions, 39 deletions
diff --git a/source/blender/editors/armature/armature_intern.h b/source/blender/editors/armature/armature_intern.h index 77607cedcb1..97f8c0cf630 100644 --- a/source/blender/editors/armature/armature_intern.h +++ b/source/blender/editors/armature/armature_intern.h @@ -302,6 +302,12 @@ void armature_select_mirrored(struct bArmature *arm); /** Only works when tagged. */ void armature_tag_unselect(struct bArmature *arm); +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Selection Picking + * \{ */ + struct EditBone *ED_armature_pick_ebone(struct bContext *C, const int xy[2], bool findunsel, @@ -337,6 +343,12 @@ struct Bone *ED_armature_pick_bone_from_selectbuffer(struct Base **bases, bool do_nearest, struct Base **r_base); +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Iteration + * \{ */ + /** * XXX: bone_looper is only to be used when we want to access settings * (i.e. editability/visibility/selected) that context doesn't offer. @@ -345,3 +357,5 @@ int bone_looper(struct Object *ob, struct Bone *bone, void *data, int (*bone_func)(struct Object *, struct Bone *, void *)); + +/** \} */ diff --git a/source/blender/editors/asset/intern/asset_list.cc b/source/blender/editors/asset/intern/asset_list.cc index af6dbf24209..1bfdd83b8e3 100644 --- a/source/blender/editors/asset/intern/asset_list.cc +++ b/source/blender/editors/asset/intern/asset_list.cc @@ -318,6 +318,7 @@ StringRef AssetList::filepath() const { return filelist_dir(filelist_); } + /** \} */ /* -------------------------------------------------------------------- */ diff --git a/source/blender/editors/curve/editfont.c b/source/blender/editors/curve/editfont.c index e2005795970..6e0aeb87318 100644 --- a/source/blender/editors/curve/editfont.c +++ b/source/blender/editors/curve/editfont.c @@ -71,8 +71,6 @@ static int kill_selection(Object *obedit, int ins); -/** \} */ - /* -------------------------------------------------------------------- */ /** \name Internal Utilities * \{ */ diff --git a/source/blender/editors/gizmo_library/gizmo_types/button2d_gizmo.c b/source/blender/editors/gizmo_library/gizmo_types/button2d_gizmo.c index f286d3930e2..553ea4bbb6e 100644 --- a/source/blender/editors/gizmo_library/gizmo_types/button2d_gizmo.c +++ b/source/blender/editors/gizmo_library/gizmo_types/button2d_gizmo.c @@ -59,6 +59,10 @@ #include "../gizmo_geometry.h" #include "../gizmo_library_intern.h" +/* -------------------------------------------------------------------- */ +/** \name Internal Types + * \{ */ + typedef struct ButtonGizmo2D { wmGizmo gizmo; bool is_init; @@ -69,7 +73,11 @@ typedef struct ButtonGizmo2D { #define CIRCLE_RESOLUTION 32 +/** \} */ + /* -------------------------------------------------------------------- */ +/** \name Internal API + * \{ */ static void button2d_geom_draw_backdrop(const wmGizmo *gz, const float color[4], diff --git a/source/blender/editors/gpencil/gpencil_edit.c b/source/blender/editors/gpencil/gpencil_edit.c index 836d6bf90fe..2a656ac3aad 100644 --- a/source/blender/editors/gpencil/gpencil_edit.c +++ b/source/blender/editors/gpencil/gpencil_edit.c @@ -5337,6 +5337,7 @@ void GPENCIL_OT_stroke_merge_by_distance(wmOperatorType *ot) ot->srna, "use_unselected", 0, "Unselected", "Use whole stroke, not only selected points"); RNA_def_property_flag(prop, PROP_SKIP_SAVE); } + /** \} */ /* -------------------------------------------------------------------- */ diff --git a/source/blender/editors/gpencil/gpencil_edit_curve.c b/source/blender/editors/gpencil/gpencil_edit_curve.c index e766a410889..2d7497357f2 100644 --- a/source/blender/editors/gpencil/gpencil_edit_curve.c +++ b/source/blender/editors/gpencil/gpencil_edit_curve.c @@ -51,6 +51,10 @@ #include "gpencil_intern.h" +/* -------------------------------------------------------------------- */ +/** \name Enter Edit-Mode + * \{ */ + /* Poll callback for checking if there is an active layer and we are in curve edit mode. */ static bool gpencil_curve_edit_mode_poll(bContext *C) { @@ -135,6 +139,12 @@ void GPENCIL_OT_stroke_enter_editcurve_mode(wmOperatorType *ot) RNA_def_property_ui_range(prop, FLT_MIN, 10.0f, 0.1f, 5); } +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Set Handle Type + * \{ */ + static int gpencil_editcurve_set_handle_type_exec(bContext *C, wmOperator *op) { Object *ob = CTX_data_active_object(C); diff --git a/source/blender/editors/gpencil/gpencil_select.c b/source/blender/editors/gpencil/gpencil_select.c index 6ad2fffc773..ed8d2996b6a 100644 --- a/source/blender/editors/gpencil/gpencil_select.c +++ b/source/blender/editors/gpencil/gpencil_select.c @@ -248,6 +248,7 @@ static void select_all_curve_points(bGPdata *gpd, bGPDstroke *gps, bGPDcurve *gp /* -------------------------------------------------------------------- */ /** \name Select All Operator * \{ */ + static bool gpencil_select_all_poll(bContext *C) { bGPdata *gpd = ED_gpencil_data_get_active(C); diff --git a/source/blender/editors/include/UI_interface.h b/source/blender/editors/include/UI_interface.h index 10548e9b48d..5d21c30644f 100644 --- a/source/blender/editors/include/UI_interface.h +++ b/source/blender/editors/include/UI_interface.h @@ -1717,8 +1717,8 @@ uiBut *uiDefHotKeyevtButS(uiBlock *block, const char *tip); /** - * \param arg is pointer to string/name, use UI_but_func_search_set() below to make this work. - * here a1 and a2, if set, control thumbnail preview rows/cols. + * \param arg: A pointer to string/name, use #UI_but_func_search_set() below to make this work. + * here `a1` and `a2`, if set, control thumbnail preview rows/cols. */ uiBut *uiDefSearchBut(uiBlock *block, void *arg, diff --git a/source/blender/editors/interface/interface_context_path.cc b/source/blender/editors/interface/interface_context_path.cc index 3f5efd187d8..0b774b79a5c 100644 --- a/source/blender/editors/interface/interface_context_path.cc +++ b/source/blender/editors/interface/interface_context_path.cc @@ -80,6 +80,6 @@ void template_breadcrumbs(uiLayout &layout, Span<ContextPathItem> context_path) } } -} // namespace blender::ui - /** \} */ + +} // namespace blender::ui diff --git a/source/blender/editors/interface/interface_eyedropper.c b/source/blender/editors/interface/interface_eyedropper.c index 08ff05e517b..27fa2e5a22f 100644 --- a/source/blender/editors/interface/interface_eyedropper.c +++ b/source/blender/editors/interface/interface_eyedropper.c @@ -103,8 +103,10 @@ wmKeyMap *eyedropper_colorband_modal_keymap(wmKeyConfig *keyconf) /* -------------------------------------------------------------------- */ /* Utility Functions */ + /** \name Generic Shared Functions * \{ */ + static void eyedropper_draw_cursor_text_ex(const int x, const int y, const char *name) { const uiFontStyle *fstyle = UI_FSTYLE_WIDGET; diff --git a/source/blender/editors/interface/interface_region_hud.c b/source/blender/editors/interface/interface_region_hud.c index b50daa0df21..fc4ce6180c3 100644 --- a/source/blender/editors/interface/interface_region_hud.c +++ b/source/blender/editors/interface/interface_region_hud.c @@ -57,6 +57,7 @@ /* -------------------------------------------------------------------- */ /** \name Utilities * \{ */ + struct HudRegionData { short regionid; }; diff --git a/source/blender/editors/interface/interface_region_menu_pie.c b/source/blender/editors/interface/interface_region_menu_pie.c index 788d04a8271..677da07d53d 100644 --- a/source/blender/editors/interface/interface_region_menu_pie.c +++ b/source/blender/editors/interface/interface_region_menu_pie.c @@ -305,8 +305,7 @@ int UI_pie_menu_invoke_from_rna_enum(struct bContext *C, /** \} */ /* -------------------------------------------------------------------- */ -/** - * \name Pie Menu Levels +/** \name Pie Menu Levels * * Pie menus can't contain more than 8 items (yet). * When using #uiItemsFullEnumO, a "More" button is created that calls @@ -318,7 +317,6 @@ int UI_pie_menu_invoke_from_rna_enum(struct bContext *C, * Ideally we'd have some way of handling this for all kinds of pie items, but that's tricky. * * - Julian (Feb 2016) - * * \{ */ typedef struct PieMenuLevelData { diff --git a/source/blender/editors/interface/interface_templates.c b/source/blender/editors/interface/interface_templates.c index a4fd817001a..b8026cbb40c 100644 --- a/source/blender/editors/interface/interface_templates.c +++ b/source/blender/editors/interface/interface_templates.c @@ -2234,8 +2234,6 @@ void uiTemplateGpencilModifiers(uiLayout *UNUSED(layout), bContext *C) /** \} */ -/** \} */ - #define ERROR_LIBDATA_MESSAGE TIP_("Can't edit external library data") /* -------------------------------------------------------------------- */ diff --git a/source/blender/editors/interface/interface_widgets.c b/source/blender/editors/interface/interface_widgets.c index d5cbb271c8d..ad8c0842657 100644 --- a/source/blender/editors/interface/interface_widgets.c +++ b/source/blender/editors/interface/interface_widgets.c @@ -4647,6 +4647,8 @@ static int widget_roundbox_set(uiBut *but, rcti *rect) return roundbox; } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Public API * \{ */ diff --git a/source/blender/editors/interface/view2d.c b/source/blender/editors/interface/view2d.c index a4c3f622ad5..b530693a7e5 100644 --- a/source/blender/editors/interface/view2d.c +++ b/source/blender/editors/interface/view2d.c @@ -1365,6 +1365,7 @@ void UI_view2d_dot_grid_draw(const View2D *v2d, immUnbindProgram(); } + /** \} */ /* -------------------------------------------------------------------- */ diff --git a/source/blender/editors/lattice/editlattice_tools.c b/source/blender/editors/lattice/editlattice_tools.c index d503cbc87b8..15325c7648c 100644 --- a/source/blender/editors/lattice/editlattice_tools.c +++ b/source/blender/editors/lattice/editlattice_tools.c @@ -47,8 +47,6 @@ #include "lattice_intern.h" -/** \} */ - /* -------------------------------------------------------------------- */ /** \name Make Regular Operator * \{ */ diff --git a/source/blender/editors/mesh/editmesh_preselect_elem.c b/source/blender/editors/mesh/editmesh_preselect_elem.c index dfd646c767f..ab268251061 100644 --- a/source/blender/editors/mesh/editmesh_preselect_elem.c +++ b/source/blender/editors/mesh/editmesh_preselect_elem.c @@ -411,4 +411,5 @@ void EDBM_preselect_elem_update_preview(struct EditMesh_PreSelElem *psel, BLI_assert(0); } } + /** \} */ diff --git a/source/blender/editors/mesh/editmesh_select_similar.c b/source/blender/editors/mesh/editmesh_select_similar.c index c452f7a7487..f2311eb926d 100644 --- a/source/blender/editors/mesh/editmesh_select_similar.c +++ b/source/blender/editors/mesh/editmesh_select_similar.c @@ -974,6 +974,7 @@ static int similar_edge_select_exec(bContext *C, wmOperator *op) return OPERATOR_FINISHED; } + /** \} */ /* -------------------------------------------------------------------- */ @@ -1255,6 +1256,7 @@ static int similar_vert_select_exec(bContext *C, wmOperator *op) return OPERATOR_FINISHED; } + /** \} */ /* -------------------------------------------------------------------- */ diff --git a/source/blender/editors/object/object_modifier.c b/source/blender/editors/object/object_modifier.c index b07e9ffc882..71ad54383a6 100644 --- a/source/blender/editors/object/object_modifier.c +++ b/source/blender/editors/object/object_modifier.c @@ -1679,6 +1679,8 @@ void OBJECT_OT_modifier_set_active(wmOperatorType *ot) } /** \} */ + +/* ------------------------------------------------------------------- */ /** \name Copy Modifier To Selected Operator * \{ */ @@ -2678,6 +2680,7 @@ void OBJECT_OT_skin_armature_create(wmOperatorType *ot) ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO | OPTYPE_INTERNAL; edit_modifier_properties(ot); } + /** \} */ /* ------------------------------------------------------------------- */ diff --git a/source/blender/editors/object/object_shader_fx.c b/source/blender/editors/object/object_shader_fx.c index 2723d7ad1e3..043a679a0c0 100644 --- a/source/blender/editors/object/object_shader_fx.c +++ b/source/blender/editors/object/object_shader_fx.c @@ -402,6 +402,8 @@ void OBJECT_OT_shaderfx_add(wmOperatorType *ot) RNA_def_property_translation_context(ot->prop, BLT_I18NCONTEXT_ID_ID); } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Generic Functions for Operators Using Names and Data Context * \{ */ diff --git a/source/blender/editors/render/render_shading.c b/source/blender/editors/render/render_shading.c index b6e6869f4e2..54ff25ede28 100644 --- a/source/blender/editors/render/render_shading.c +++ b/source/blender/editors/render/render_shading.c @@ -2226,10 +2226,10 @@ void SCENE_OT_freestyle_stroke_material_create(wmOperatorType *ot) ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO; } -#endif /* WITH_FREESTYLE */ - /** \} */ +#endif /* WITH_FREESTYLE */ + /* -------------------------------------------------------------------- */ /** \name Texture Slot Move Operator * \{ */ diff --git a/source/blender/editors/screen/screen_ops.c b/source/blender/editors/screen/screen_ops.c index 96012155a55..d017345b523 100644 --- a/source/blender/editors/screen/screen_ops.c +++ b/source/blender/editors/screen/screen_ops.c @@ -4405,6 +4405,7 @@ static void SCREEN_OT_region_context_menu(wmOperatorType *ot) * * Animation Step. * \{ */ + static bool screen_animation_region_supports_time_follow(eSpace_Type spacetype, eRegion_Type regiontype) { diff --git a/source/blender/editors/sculpt_paint/paint_vertex_weight_utils.c b/source/blender/editors/sculpt_paint/paint_vertex_weight_utils.c index 63a70baeaad..34a27d5a5c2 100644 --- a/source/blender/editors/sculpt_paint/paint_vertex_weight_utils.c +++ b/source/blender/editors/sculpt_paint/paint_vertex_weight_utils.c @@ -130,6 +130,7 @@ bool ED_wpaint_ensure_data(bContext *C, return true; } + /** \} */ int ED_wpaint_mirror_vgroup_ensure(Object *ob, const int vgroup_active) diff --git a/source/blender/editors/sculpt_paint/sculpt.c b/source/blender/editors/sculpt_paint/sculpt.c index 5e34c526d47..aeeed094aab 100644 --- a/source/blender/editors/sculpt_paint/sculpt.c +++ b/source/blender/editors/sculpt_paint/sculpt.c @@ -102,13 +102,15 @@ #include <stdlib.h> #include <string.h> -/* Sculpt PBVH abstraction API +/* -------------------------------------------------------------------- */ +/** \name Sculpt PBVH Abstraction API * * This is read-only, for writing use PBVH vertex iterators. There vd.index matches * the indices used here. * * For multi-resolution, the same vertex in multiple grids is counted multiple times, with - * different index for each grid. */ + * different index for each grid. + * \{ */ void SCULPT_vertex_random_access_ensure(SculptSession *ss) { @@ -1068,9 +1070,13 @@ void SCULPT_tag_update_overlays(bContext *C) } } -/* Sculpt Flood Fill API +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Sculpt Flood Fill API * - * Iterate over connected vertices, starting from one or more initial vertices. */ + * Iterate over connected vertices, starting from one or more initial vertices. + * \{ */ void SCULPT_floodfill_init(SculptSession *ss, SculptFloodFill *flood) { @@ -1181,12 +1187,13 @@ void SCULPT_floodfill_free(SculptFloodFill *flood) flood->queue = NULL; } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Tool Capabilities * * Avoid duplicate checks, internal logic only, * share logic with #rna_def_sculpt_capabilities where possible. - * * \{ */ static bool sculpt_tool_needs_original(const char sculpt_tool) @@ -1246,13 +1253,18 @@ static int sculpt_brush_needs_normal(const SculptSession *ss, const Brush *brush (brush->mtex.brush_map_mode == MTEX_MAP_MODE_AREA)) || sculpt_brush_use_topology_rake(ss, brush); } -/** \} */ static bool sculpt_brush_needs_rake_rotation(const Brush *brush) { return SCULPT_TOOL_HAS_RAKE(brush->sculpt_tool) && (brush->rake_factor != 0.0f); } +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Sculpt Init/Update + * \{ */ + typedef enum StrokeFlags { CLIP_X = 1, CLIP_Y = 2, @@ -1374,11 +1386,12 @@ static void sculpt_project_v3_normal_align(SculptSession *ss, grab_delta, ss->cache->sculpt_normal_symm, (len_signed * normal_weight) * len_view_scale); } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name SculptProjectVector * * Fast-path for #project_plane_v3_v3v3 - * * \{ */ typedef struct SculptProjectVector { @@ -1415,7 +1428,9 @@ static void sculpt_project_v3(const SculptProjectVector *spvc, const float vec[3 /** \} */ -/**********************************************************************/ +/* -------------------------------------------------------------------- */ +/** \name Sculpt Dynamic Topology + * \{ */ bool SCULPT_stroke_is_dynamic_topology(const SculptSession *ss, const Brush *brush) { @@ -1430,7 +1445,11 @@ bool SCULPT_stroke_is_dynamic_topology(const SculptSession *ss, const Brush *bru SCULPT_TOOL_HAS_DYNTOPO(brush->sculpt_tool)); } -/*** paint mesh ***/ +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Sculpt Paint Mesh + * \{ */ static void paint_mesh_restore_co_task_cb(void *__restrict userdata, const int n, @@ -1885,6 +1904,8 @@ static float calc_symmetry_feather(Sculpt *sd, StrokeCache *cache) return 1.0f / overlap; } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Calculate Normal and Center * @@ -2213,8 +2234,10 @@ bool SCULPT_pbvh_calc_area_normal(const Brush *brush, return data.any_vertex_sampled; } -/* This calculates flatten center and area normal together, - * amortizing the memory bandwidth and loop overhead to calculate both at the same time. */ +/** + * This calculates flatten center and area normal together, + * amortizing the memory bandwidth and loop overhead to calculate both at the same time. + */ static void calc_area_normal_and_center( Sculpt *sd, Object *ob, PBVHNode **nodes, int totnode, float r_area_no[3], float r_area_co[3]) { @@ -2274,6 +2297,10 @@ static void calc_area_normal_and_center( /** \} */ +/* -------------------------------------------------------------------- */ +/** \name Generic Brush Utilities + * \{ */ + /** * Return modified brush strength. Includes the direction of the brush, positive * values pull vertices, negative values push. Uses tablet pressure and a @@ -2827,6 +2854,12 @@ static void update_brush_local_mat(Sculpt *sd, Object *ob) } } +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Sculpt Topology Rake (Shared Utility) + * \{ */ + typedef struct { SculptSession *ss; const float *ray_start; @@ -2939,6 +2972,12 @@ static void bmesh_topology_rake( } } +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Sculpt Mask Brush + * \{ */ + static void do_mask_brush_draw_task_cb_ex(void *__restrict userdata, const int n, const TaskParallelTLS *__restrict tls) @@ -3010,6 +3049,8 @@ static void do_mask_brush(Sculpt *sd, Object *ob, PBVHNode **nodes, int totnode) } } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Sculpt Multires Displacement Eraser Brush * \{ */ @@ -3078,6 +3119,7 @@ static void do_displacement_eraser_brush(Sculpt *sd, Object *ob, PBVHNode **node /** \} */ +/* -------------------------------------------------------------------- */ /** \name Sculpt Multires Displacement Smear Brush * \{ */ @@ -3220,6 +3262,10 @@ static void do_displacement_smear_brush(Sculpt *sd, Object *ob, PBVHNode **nodes /** \} */ +/* -------------------------------------------------------------------- */ +/** \name Sculpt Draw Brush + * \{ */ + static void do_draw_brush_task_cb_ex(void *__restrict userdata, const int n, const TaskParallelTLS *__restrict tls) @@ -3374,6 +3420,8 @@ static void do_draw_sharp_brush(Sculpt *sd, Object *ob, PBVHNode **nodes, int to BLI_task_parallel_range(0, totnode, &data, do_draw_sharp_brush_task_cb_ex, &settings); } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Sculpt Topology Brush * \{ */ @@ -3698,6 +3746,10 @@ static void calc_sculpt_plane( /** \} */ +/* -------------------------------------------------------------------- */ +/** \name Sculpt Crease & Blob Brush + * \{ */ + /** * Used for 'SCULPT_TOOL_CREASE' and 'SCULPT_TOOL_BLOB' */ @@ -4934,6 +4986,8 @@ static void do_flatten_brush(Sculpt *sd, Object *ob, PBVHNode **nodes, int totno BLI_task_parallel_range(0, totnode, &data, do_flatten_brush_task_cb_ex, &settings); } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Sculpt Clay Brush * \{ */ @@ -5466,6 +5520,8 @@ static void do_scrape_brush(Sculpt *sd, Object *ob, PBVHNode **nodes, int totnod BLI_task_parallel_range(0, totnode, &data, do_scrape_brush_task_cb_ex, &settings); } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Sculpt Clay Thumb Brush * \{ */ @@ -5640,6 +5696,10 @@ static void do_clay_thumb_brush(Sculpt *sd, Object *ob, PBVHNode **nodes, int to /** \} */ +/* -------------------------------------------------------------------- */ +/** \name Sculpt Gravity Brush + * \{ */ + static void do_gravity_task_cb_ex(void *__restrict userdata, const int n, const TaskParallelTLS *__restrict tls) @@ -5710,6 +5770,12 @@ static void do_gravity(Sculpt *sd, Object *ob, PBVHNode **nodes, int totnode, fl BLI_task_parallel_range(0, totnode, &data, do_gravity_task_cb_ex, &settings); } +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Sculpt Prush Utilities + * \{ */ + void SCULPT_vertcos_to_key(Object *ob, KeyBlock *kb, const float (*vertCos)[3]) { Mesh *me = (Mesh *)ob->data; @@ -9346,6 +9412,12 @@ static void SCULPT_OT_mask_by_color(wmOperatorType *ot) 1.0f); } +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Operator Registration + * \{ */ + void ED_operatortypes_sculpt(void) { WM_operatortype_append(SCULPT_OT_brush_stroke); @@ -9384,3 +9456,5 @@ void ED_operatortypes_sculpt(void) WM_operatortype_append(SCULPT_OT_expand); } + +/** \} */ diff --git a/source/blender/editors/sculpt_paint/sculpt_detail.c b/source/blender/editors/sculpt_paint/sculpt_detail.c index edbb98b481e..9082408b8dd 100644 --- a/source/blender/editors/sculpt_paint/sculpt_detail.c +++ b/source/blender/editors/sculpt_paint/sculpt_detail.c @@ -57,6 +57,10 @@ #include <math.h> #include <stdlib.h> +/* -------------------------------------------------------------------- */ +/** \name Internal Utilities + * \{ */ + typedef struct { const float *ray_start; bool hit; @@ -82,6 +86,12 @@ static bool sculpt_and_dynamic_topology_poll(bContext *C) return SCULPT_mode_poll(C) && ob->sculpt->bm; } +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Detail Flood Fill + * \{ */ + static int sculpt_detail_flood_fill_exec(bContext *C, wmOperator *UNUSED(op)) { Sculpt *sd = CTX_data_tool_settings(C)->sculpt; @@ -147,6 +157,12 @@ void SCULPT_OT_detail_flood_fill(wmOperatorType *ot) ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO; } +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Sample Detail Size + * \{ */ + typedef enum eSculptSampleDetailModeTypes { SAMPLE_DETAIL_DYNTOPO = 0, SAMPLE_DETAIL_VOXEL = 1, @@ -364,13 +380,17 @@ void SCULPT_OT_sample_detail_size(wmOperatorType *ot) "Target sculpting workflow that is going to use the sampled size"); } -/* Dynamic-topology detail size. +/** \} */ + +/* -------------------------------------------------------------------- */ +/** \name Dynamic-topology detail size * * Currently, there are two operators editing the detail size: - * - SCULPT_OT_set_detail_size uses radial control for all methods - * - SCULPT_OT_dyntopo_detail_size_edit shows a triangle grid representation of the detail - * resolution (for constant detail method, falls back to radial control for the remaining methods). - */ + * - #SCULPT_OT_set_detail_size uses radial control for all methods + * - #SCULPT_OT_dyntopo_detail_size_edit shows a triangle grid representation of the detail + * resolution (for constant detail method, + * falls back to radial control for the remaining methods). + * \{ */ static void set_brush_rc_props(PointerRNA *ptr, const char *prop) { @@ -429,6 +449,8 @@ void SCULPT_OT_set_detail_size(wmOperatorType *ot) ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO; } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Dyntopo Detail Size Edit Operator * \{ */ @@ -759,3 +781,5 @@ void SCULPT_OT_dyntopo_detail_size_edit(wmOperatorType *ot) ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO; } + +/** \} */ diff --git a/source/blender/editors/space_clip/clip_ops.c b/source/blender/editors/space_clip/clip_ops.c index 57fa54582dd..0aa7e35aed6 100644 --- a/source/blender/editors/space_clip/clip_ops.c +++ b/source/blender/editors/space_clip/clip_ops.c @@ -911,6 +911,7 @@ void CLIP_OT_view_zoom_ratio(wmOperatorType *ot) -FLT_MAX, FLT_MAX); } + /** \} */ /* -------------------------------------------------------------------- */ @@ -988,6 +989,7 @@ void CLIP_OT_view_all(wmOperatorType *ot) prop = RNA_def_boolean(ot->srna, "fit_view", 0, "Fit View", "Fit frame to the viewport"); RNA_def_property_flag(prop, PROP_SKIP_SAVE); } + /** \} */ /* -------------------------------------------------------------------- */ @@ -1052,6 +1054,7 @@ void CLIP_OT_view_selected(wmOperatorType *ot) /* flags */ ot->flag = OPTYPE_LOCK_BYPASS; } + /** \} */ /* -------------------------------------------------------------------- */ @@ -1172,6 +1175,7 @@ void CLIP_OT_change_frame(wmOperatorType *ot) /* rna */ RNA_def_int(ot->srna, "frame", 0, MINAFRAME, MAXFRAME, "Frame", "", MINAFRAME, MAXFRAME); } + /** \} */ /* -------------------------------------------------------------------- */ @@ -1584,6 +1588,7 @@ void CLIP_OT_rebuild_proxy(wmOperatorType *ot) /* flags */ ot->flag = OPTYPE_REGISTER; } + /** \} */ /* -------------------------------------------------------------------- */ @@ -1623,10 +1628,10 @@ void CLIP_OT_mode_set(wmOperatorType *ot) RNA_def_enum(ot->srna, "mode", rna_enum_clip_editor_mode_items, SC_MODE_TRACKING, "Mode", ""); } -#ifdef WITH_INPUT_NDOF - /** \} */ +#ifdef WITH_INPUT_NDOF + /* -------------------------------------------------------------------- */ /** \name NDOF Operator * \{ */ @@ -1725,6 +1730,7 @@ void CLIP_OT_prefetch(wmOperatorType *ot) ot->invoke = clip_prefetch_invoke; ot->modal = clip_prefetch_modal; } + /** \} */ /* -------------------------------------------------------------------- */ @@ -1764,6 +1770,7 @@ void CLIP_OT_set_scene_frames(wmOperatorType *ot) ot->poll = ED_space_clip_view_clip_poll; ot->exec = clip_set_scene_frames_exec; } + /** \} */ /* -------------------------------------------------------------------- */ diff --git a/source/blender/editors/space_image/image_ops.c b/source/blender/editors/space_image/image_ops.c index da4ba8fd857..f9160774c41 100644 --- a/source/blender/editors/space_image/image_ops.c +++ b/source/blender/editors/space_image/image_ops.c @@ -728,10 +728,10 @@ void IMAGE_OT_view_zoom(wmOperatorType *ot) WM_operator_properties_use_cursor_init(ot); } -#ifdef WITH_INPUT_NDOF - /** \} */ +#ifdef WITH_INPUT_NDOF + /* -------------------------------------------------------------------- */ /** \name NDOF Operator * \{ */ @@ -4136,3 +4136,5 @@ void IMAGE_OT_tile_fill(wmOperatorType *ot) def_fill_tile(ot->srna); } + +/** \} */ diff --git a/source/blender/editors/space_outliner/outliner_edit.c b/source/blender/editors/space_outliner/outliner_edit.c index 9f6fd5d91bb..9d4b14a1f57 100644 --- a/source/blender/editors/space_outliner/outliner_edit.c +++ b/source/blender/editors/space_outliner/outliner_edit.c @@ -78,8 +78,6 @@ static void outliner_show_active(SpaceOutliner *space_outliner, TreeElement *te, ID *id); -/** \} */ - /* -------------------------------------------------------------------- */ /** \name Highlight on Cursor Motion Operator * \{ */ @@ -2227,8 +2225,6 @@ static bool ed_operator_outliner_id_orphans_active(bContext *C) return true; } -/** \} */ - static int outliner_orphans_purge_invoke(bContext *C, wmOperator *op, const wmEvent *UNUSED(event)) { Main *bmain = CTX_data_main(C); diff --git a/source/blender/editors/transform/transform.h b/source/blender/editors/transform/transform.h index 3a8155ce9f7..3035d11d0e3 100644 --- a/source/blender/editors/transform/transform.h +++ b/source/blender/editors/transform/transform.h @@ -298,6 +298,10 @@ enum { /** \} */ +/* -------------------------------------------------------------------- */ +/** \name Transform Types + * \{ */ + typedef struct TransSnapPoint { struct TransSnapPoint *next, *prev; float co[3]; diff --git a/source/blender/editors/transform/transform_convert_mesh.c b/source/blender/editors/transform/transform_convert_mesh.c index cd3d4fb0659..c3d95e1ad98 100644 --- a/source/blender/editors/transform/transform_convert_mesh.c +++ b/source/blender/editors/transform/transform_convert_mesh.c @@ -2092,6 +2092,7 @@ void recalcData_mesh(TransInfo *t) tc_mesh_partial_update(t, tc, &partial_state); } } + /** \} */ /* -------------------------------------------------------------------- */ @@ -2157,4 +2158,5 @@ void special_aftertrans_update__mesh(bContext *UNUSED(C), TransInfo *t) break; } } + /** \} */ diff --git a/source/blender/editors/transform/transform_convert_mesh_skin.c b/source/blender/editors/transform/transform_convert_mesh_skin.c index 69b44998980..7c742f29c86 100644 --- a/source/blender/editors/transform/transform_convert_mesh_skin.c +++ b/source/blender/editors/transform/transform_convert_mesh_skin.c @@ -303,4 +303,5 @@ void recalcData_mesh_skin(TransInfo *t) BKE_editmesh_looptri_and_normals_calc(em); } } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode.c b/source/blender/editors/transform/transform_mode.c index 5ecafdeb44e..d2e7f9f83df 100644 --- a/source/blender/editors/transform/transform_mode.c +++ b/source/blender/editors/transform/transform_mode.c @@ -519,9 +519,12 @@ void constraintSizeLim(const TransInfo *t, TransData *td) } } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Transform (Rotation Utils) * \{ */ + void headerRotation(TransInfo *t, char *str, const int str_size, float final) { size_t ofs = 0; @@ -820,6 +823,7 @@ void ElementRotation(const TransInfo *t, ElementRotation_ex(t, tc, td, mat, center); } + /** \} */ /* -------------------------------------------------------------------- */ @@ -1266,4 +1270,5 @@ void transform_mode_default_modal_orientation_set(TransInfo *t, int type) transform_orientations_current_set(t, O_DEFAULT); } } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_align.c b/source/blender/editors/transform/transform_mode_align.c index 1a1d84699f4..f27a194dda0 100644 --- a/source/blender/editors/transform/transform_mode_align.c +++ b/source/blender/editors/transform/transform_mode_align.c @@ -89,4 +89,5 @@ void initAlign(TransInfo *t) initMouseInputMode(t, &t->mouse, INPUT_NONE); } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_baketime.c b/source/blender/editors/transform/transform_mode_baketime.c index 653944b56a7..46d6e5c5983 100644 --- a/source/blender/editors/transform/transform_mode_baketime.c +++ b/source/blender/editors/transform/transform_mode_baketime.c @@ -132,4 +132,5 @@ void initBakeTime(TransInfo *t) t->num.unit_sys = t->scene->unit.system; t->num.unit_type[0] = B_UNIT_NONE; /* Don't think this uses units? */ } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_bbone_resize.c b/source/blender/editors/transform/transform_mode_bbone_resize.c index 53908564fe5..ce2f3c15651 100644 --- a/source/blender/editors/transform/transform_mode_bbone_resize.c +++ b/source/blender/editors/transform/transform_mode_bbone_resize.c @@ -185,4 +185,5 @@ void initBoneSize(TransInfo *t) t->num.unit_type[1] = B_UNIT_NONE; t->num.unit_type[2] = B_UNIT_NONE; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_bend.c b/source/blender/editors/transform/transform_mode_bend.c index 6d84c397fa6..a1bcd3aeb50 100644 --- a/source/blender/editors/transform/transform_mode_bend.c +++ b/source/blender/editors/transform/transform_mode_bend.c @@ -393,4 +393,5 @@ void initBend(TransInfo *t) t->custom.mode.data = data; t->custom.mode.use_free = true; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_boneroll.c b/source/blender/editors/transform/transform_mode_boneroll.c index 237a8a0719a..00629b13ede 100644 --- a/source/blender/editors/transform/transform_mode_boneroll.c +++ b/source/blender/editors/transform/transform_mode_boneroll.c @@ -107,4 +107,5 @@ void initBoneRoll(TransInfo *t) t->flag |= T_NO_CONSTRAINT | T_NO_PROJECT; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_curveshrinkfatten.c b/source/blender/editors/transform/transform_mode_curveshrinkfatten.c index f6d0eb49576..c4c33c881ed 100644 --- a/source/blender/editors/transform/transform_mode_curveshrinkfatten.c +++ b/source/blender/editors/transform/transform_mode_curveshrinkfatten.c @@ -115,4 +115,5 @@ void initCurveShrinkFatten(TransInfo *t) t->flag |= T_NO_CONSTRAINT; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_edge_bevelweight.c b/source/blender/editors/transform/transform_mode_edge_bevelweight.c index 56613a9d3be..8aa7955bc2a 100644 --- a/source/blender/editors/transform/transform_mode_edge_bevelweight.c +++ b/source/blender/editors/transform/transform_mode_edge_bevelweight.c @@ -174,4 +174,5 @@ void initBevelWeight(TransInfo *t) t->flag |= T_NO_CONSTRAINT | T_NO_PROJECT; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_edge_rotate_normal.c b/source/blender/editors/transform/transform_mode_edge_rotate_normal.c index 16263adb223..edba9809207 100644 --- a/source/blender/editors/transform/transform_mode_edge_rotate_normal.c +++ b/source/blender/editors/transform/transform_mode_edge_rotate_normal.c @@ -152,4 +152,5 @@ void initNormalRotation(TransInfo *t) transform_mode_default_modal_orientation_set(t, V3D_ORIENT_VIEW); } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_edge_slide.c b/source/blender/editors/transform/transform_mode_edge_slide.c index c7a42b0cd64..7a0f2743a98 100644 --- a/source/blender/editors/transform/transform_mode_edge_slide.c +++ b/source/blender/editors/transform/transform_mode_edge_slide.c @@ -1567,4 +1567,5 @@ void initEdgeSlide(TransInfo *t) { initEdgeSlide_ex(t, true, false, false, true); } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_gpopacity.c b/source/blender/editors/transform/transform_mode_gpopacity.c index b5a4b5d285e..5772c6b4717 100644 --- a/source/blender/editors/transform/transform_mode_gpopacity.c +++ b/source/blender/editors/transform/transform_mode_gpopacity.c @@ -125,4 +125,5 @@ void initGPOpacity(TransInfo *t) t->flag |= T_NO_CONSTRAINT; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_gpshrinkfatten.c b/source/blender/editors/transform/transform_mode_gpshrinkfatten.c index 3be7dde56a1..f4a0c3c659c 100644 --- a/source/blender/editors/transform/transform_mode_gpshrinkfatten.c +++ b/source/blender/editors/transform/transform_mode_gpshrinkfatten.c @@ -127,4 +127,5 @@ void initGPShrinkFatten(TransInfo *t) t->flag |= T_NO_CONSTRAINT; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_maskshrinkfatten.c b/source/blender/editors/transform/transform_mode_maskshrinkfatten.c index 9788b14e321..a1a8bed59b3 100644 --- a/source/blender/editors/transform/transform_mode_maskshrinkfatten.c +++ b/source/blender/editors/transform/transform_mode_maskshrinkfatten.c @@ -141,4 +141,5 @@ void initMaskShrinkFatten(TransInfo *t) t->flag |= T_NO_CONSTRAINT; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_mirror.c b/source/blender/editors/transform/transform_mode_mirror.c index 2ae32f3545a..ee584cb9833 100644 --- a/source/blender/editors/transform/transform_mode_mirror.c +++ b/source/blender/editors/transform/transform_mode_mirror.c @@ -238,4 +238,5 @@ void initMirror(TransInfo *t) t->flag |= T_NULL_ONE; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_push_pull.c b/source/blender/editors/transform/transform_mode_push_pull.c index bf6037572b9..8577a0a5e11 100644 --- a/source/blender/editors/transform/transform_mode_push_pull.c +++ b/source/blender/editors/transform/transform_mode_push_pull.c @@ -199,4 +199,5 @@ void initPushPull(TransInfo *t) t->num.unit_sys = t->scene->unit.system; t->num.unit_type[0] = B_UNIT_LENGTH; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_resize.c b/source/blender/editors/transform/transform_mode_resize.c index 28323460626..3d7f0aa6d67 100644 --- a/source/blender/editors/transform/transform_mode_resize.c +++ b/source/blender/editors/transform/transform_mode_resize.c @@ -267,4 +267,5 @@ void initResize(TransInfo *t, float mouse_dir_constraint[3]) transform_mode_default_modal_orientation_set(t, V3D_ORIENT_GLOBAL); } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_rotate.c b/source/blender/editors/transform/transform_mode_rotate.c index bfbdaa389f4..e8ef71a6639 100644 --- a/source/blender/editors/transform/transform_mode_rotate.c +++ b/source/blender/editors/transform/transform_mode_rotate.c @@ -363,4 +363,5 @@ void initRotation(TransInfo *t) transform_mode_default_modal_orientation_set(t, V3D_ORIENT_VIEW); } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_shear.c b/source/blender/editors/transform/transform_mode_shear.c index 819a1e321f4..9369cb2e62b 100644 --- a/source/blender/editors/transform/transform_mode_shear.c +++ b/source/blender/editors/transform/transform_mode_shear.c @@ -289,4 +289,5 @@ void initShear(TransInfo *t) transform_mode_default_modal_orientation_set(t, V3D_ORIENT_VIEW); } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_shrink_fatten.c b/source/blender/editors/transform/transform_mode_shrink_fatten.c index 032188e7115..01dd1b701a5 100644 --- a/source/blender/editors/transform/transform_mode_shrink_fatten.c +++ b/source/blender/editors/transform/transform_mode_shrink_fatten.c @@ -216,4 +216,5 @@ void initShrinkFatten(TransInfo *t) } } } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_skin_resize.c b/source/blender/editors/transform/transform_mode_skin_resize.c index d4ecaf1a27f..f5e502fed4f 100644 --- a/source/blender/editors/transform/transform_mode_skin_resize.c +++ b/source/blender/editors/transform/transform_mode_skin_resize.c @@ -180,4 +180,5 @@ void initSkinResize(TransInfo *t) t->num.unit_type[1] = B_UNIT_NONE; t->num.unit_type[2] = B_UNIT_NONE; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_tilt.c b/source/blender/editors/transform/transform_mode_tilt.c index 6b470177a12..6451a7d77d5 100644 --- a/source/blender/editors/transform/transform_mode_tilt.c +++ b/source/blender/editors/transform/transform_mode_tilt.c @@ -111,4 +111,5 @@ void initTilt(TransInfo *t) t->flag |= T_NO_CONSTRAINT | T_NO_PROJECT; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_timescale.c b/source/blender/editors/transform/transform_mode_timescale.c index 0a7ae54982e..c198f235cf8 100644 --- a/source/blender/editors/transform/transform_mode_timescale.c +++ b/source/blender/editors/transform/transform_mode_timescale.c @@ -151,4 +151,5 @@ void initTimeScale(TransInfo *t) t->num.unit_sys = t->scene->unit.system; t->num.unit_type[0] = B_UNIT_NONE; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_timeslide.c b/source/blender/editors/transform/transform_mode_timeslide.c index 5cc53eb08ce..98abab0fd6b 100644 --- a/source/blender/editors/transform/transform_mode_timeslide.c +++ b/source/blender/editors/transform/transform_mode_timeslide.c @@ -232,4 +232,5 @@ void initTimeSlide(TransInfo *t) /* No time unit supporting frames currently... */ t->num.unit_type[0] = B_UNIT_NONE; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_timetranslate.c b/source/blender/editors/transform/transform_mode_timetranslate.c index 294040946bd..5f2a2e472c5 100644 --- a/source/blender/editors/transform/transform_mode_timetranslate.c +++ b/source/blender/editors/transform/transform_mode_timetranslate.c @@ -157,4 +157,5 @@ void initTimeTranslate(TransInfo *t) /* No time unit supporting frames currently... */ t->num.unit_type[0] = B_UNIT_NONE; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_tosphere.c b/source/blender/editors/transform/transform_mode_tosphere.c index e3feaab5f20..2062f78c326 100644 --- a/source/blender/editors/transform/transform_mode_tosphere.c +++ b/source/blender/editors/transform/transform_mode_tosphere.c @@ -277,4 +277,5 @@ void initToSphere(TransInfo *t) to_sphere_radius_update(t); } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_trackball.c b/source/blender/editors/transform/transform_mode_trackball.c index aa8b0783d0a..ddffc4f8438 100644 --- a/source/blender/editors/transform/transform_mode_trackball.c +++ b/source/blender/editors/transform/transform_mode_trackball.c @@ -218,4 +218,5 @@ void initTrackball(TransInfo *t) t->flag |= T_NO_CONSTRAINT; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_translate.c b/source/blender/editors/transform/transform_mode_translate.c index 233e32c0e48..19d0c6d39a3 100644 --- a/source/blender/editors/transform/transform_mode_translate.c +++ b/source/blender/editors/transform/transform_mode_translate.c @@ -579,4 +579,5 @@ void initTranslation(TransInfo *t) t->custom.mode.data = custom_data; t->custom.mode.use_free = true; } + /** \} */ diff --git a/source/blender/editors/transform/transform_mode_vert_slide.c b/source/blender/editors/transform/transform_mode_vert_slide.c index efc4c73fbee..48a8fcf60eb 100644 --- a/source/blender/editors/transform/transform_mode_vert_slide.c +++ b/source/blender/editors/transform/transform_mode_vert_slide.c @@ -687,4 +687,5 @@ void initVertSlide(TransInfo *t) { initVertSlide_ex(t, false, false, true); } + /** \} */ diff --git a/source/blender/editors/uvedit/uvedit_unwrap_ops.c b/source/blender/editors/uvedit/uvedit_unwrap_ops.c index db838bf353b..362e020f306 100644 --- a/source/blender/editors/uvedit/uvedit_unwrap_ops.c +++ b/source/blender/editors/uvedit/uvedit_unwrap_ops.c @@ -2826,6 +2826,8 @@ void UV_OT_cylinder_project(wmOperatorType *ot) uv_map_clip_correct_properties(ot); } +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Cube UV Project Operator * \{ */ |