Blender V5.3
editmesh_circularize.cc
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2025 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
8
9#include "BKE_context.hh"
10#include "BKE_editmesh.hh"
11#include "BKE_layer.hh"
12#include "BKE_object.hh"
13#include "BLI_listbase.hh"
14#include "BLT_translation.hh"
15
16#include <numbers>
17
18#include "DNA_mesh_types.h"
19#include "DNA_modifier_types.h"
20#include "DNA_object_types.h"
21#include "ED_mesh.hh"
22#include "ED_screen.hh"
23#include "RNA_access.hh"
24#include "RNA_define.hh"
25
26#include "UI_interface.hh"
28
29#include "mesh_intern.hh" /* own include */
30
31namespace blender {
32
34 {0,
35 "LEAST_SQUARE",
36 0,
37 "Best Fit",
38 "Calculate a best-fit circle using non-linear least squares"},
39 {1, "CONTRACT", 0, "Interior Fit", "Only move vertices towards the center"},
40 {0, nullptr},
41};
42
44{
45 const Main *bmain = CTX_data_main(C);
46 const Scene *scene = CTX_data_scene(C);
47 ViewLayer *view_layer = CTX_data_view_layer(C);
48
49 const float factor = RNA_float_get(op->ptr, "factor");
50 const float flatten = RNA_float_get(op->ptr, "flatten");
51 const bool regular = RNA_boolean_get(op->ptr, "regular");
52 const int fit_method = RNA_enum_get(op->ptr, "fit_method");
53 float custom_radius = RNA_float_get(op->ptr, "custom_radius");
54 if (!RNA_boolean_get(op->ptr, "use_custom_radius")) {
55 custom_radius = 0.0f;
56 }
57 const float angle = RNA_float_get(op->ptr, "angle");
58 bool lock[3];
59 RNA_boolean_get_array(op->ptr, "lock", lock);
60
62 *bmain, scene, view_layer, CTX_wm_view3d(C));
63 bool changed_multi = false;
64 bool has_valid_selection = false;
65
66 for (Object *obedit : objects) {
68 if (bm->totvertsel < 3) {
69 continue;
70 }
71 has_valid_selection = true;
72 bool mirror_axis[3];
73 BKE_object_get_mirror_axes(obedit, mirror_axis);
74
75 if (!EDBM_op_callf(bm,
76 op,
77 "circularize geom=%hvef factor=%f flatten=%f regular=%b fit_method=%i "
78 "custom_radius=%f angle=%f lock_x=%b lock_y=%b lock_z=%b mirror_x=%b "
79 "mirror_y=%b mirror_z=%b",
81 factor,
82 flatten,
83 regular,
84 fit_method,
85 custom_radius,
86 angle,
87 lock[0],
88 lock[1],
89 lock[2],
90 mirror_axis[0],
91 mirror_axis[1],
92 mirror_axis[2]))
93 {
94 continue;
95 }
96 changed_multi = true;
97 EDBMUpdate_Params params{};
98 params.calc_looptris = true;
99 params.calc_normals = true;
100 EDBM_update(id_cast<Mesh *>(obedit->data), &params);
101 }
102 if (!changed_multi) {
103 if (!has_valid_selection) {
104 BKE_report(op->reports, RPT_WARNING, "No edge loops found containing 2 or more edges");
105 }
106 }
107
108 return changed_multi ? OPERATOR_FINISHED : OPERATOR_CANCELLED;
109}
110
111static void edbm_circularize_ui(bContext * /*C*/, wmOperator *op)
112{
113 ui::Layout &layout = *op->layout;
114 layout.use_property_split_set(true);
115
116 layout.prop(op->ptr, "factor", UI_ITEM_NONE, std::nullopt, ICON_NONE);
117 layout.prop(op->ptr, "fit_method", UI_ITEM_NONE, std::nullopt, ICON_NONE);
118 layout.prop(op->ptr, "angle", UI_ITEM_NONE, std::nullopt, ICON_NONE);
119
120 ui::Layout &row = layout.row(true, IFACE_("Radius"));
121 row.prop(op->ptr, "use_custom_radius", UI_ITEM_NONE, "", ICON_NONE);
122 ui::Layout &sub = row.row(true);
123 sub.active_set(RNA_boolean_get(op->ptr, "use_custom_radius"));
124 sub.prop(op->ptr, "custom_radius", UI_ITEM_NONE, "", ICON_NONE);
125
126 layout.prop(op->ptr, "regular", UI_ITEM_NONE, std::nullopt, ICON_NONE);
127 layout.prop(op->ptr, "flatten", UI_ITEM_NONE, std::nullopt, ICON_NONE);
128
129 ui::Layout &lock_row = layout.row(true, IFACE_("Lock"));
130 PropertyRNA *lock_prop = RNA_struct_find_property(op->ptr, "lock");
131 lock_row.prop(op->ptr, lock_prop, 0, 0, ui::ITEM_R_TOGGLE, "X", ICON_NONE);
132 lock_row.prop(op->ptr, lock_prop, 1, 0, ui::ITEM_R_TOGGLE, "Y", ICON_NONE);
133 lock_row.prop(op->ptr, lock_prop, 2, 0, ui::ITEM_R_TOGGLE, "Z", ICON_NONE);
134}
135
137{
138 PropertyRNA *prop;
139 /* identifiers */
140 ot->name = "To Circle";
141 ot->description = "Shape selected geometry into a circle";
142 ot->idname = "MESH_OT_circularize";
143
144 /* API callbacks */
147
148 /* flags */
151
153 ot->srna, "factor", 1.0f, 0.0f, 1.0f, "Factor", "Circularization factor", 0.0f, 1.0f);
154 RNA_def_enum(ot->srna,
155 "fit_method",
157 0,
158 "Method",
159 "Method used for fitting a circle to the vertices");
160 prop = RNA_def_float(ot->srna,
161 "angle",
162 0.0f,
163 -std::numbers::pi_v<float> * 2.0f,
164 std::numbers::pi_v<float> * 2.0f,
165 "Rotation",
166 "Rotate the circle",
167 -std::numbers::pi_v<float> * 2.0f,
168 std::numbers::pi_v<float> * 2.0f);
171 ot->srna, "use_custom_radius", false, "Use Custom Radius", "Enable custom radius");
173 "custom_radius",
174 1.0f,
175 0.0f,
176 FLT_MAX,
177 "Radius",
178 "Radius of the circle",
179 0.0f,
180 1000.0f);
182 "regular",
183 true,
184 "Space Evenly",
185 "Distribute vertices at constant distances along the circle, otherwise "
186 "preserves original spacing");
188 "flatten",
189 1.0f,
190 0.0f,
191 1.0f,
192 "Flatten",
193 "Flatten the circle, instead of projecting it on the mesh",
194 0.0f,
195 1.0f);
196 RNA_def_boolean_array(ot->srna, "lock", 3, nullptr, "Lock", "Lock editing of the axis");
197}
198
199} // namespace blender
General operations, lookup, etc. for blender objects.
#define IFACE_(msgid)
Object is a sort of wrapper for general info.
#define C
Definition RandGen.cpp:29
#define UI_ITEM_NONE
volatile int lock
SIMD_FORCE_INLINE btScalar angle(const btVector3 &v) const
Return the angle between this and another vector.
Definition btVector3.h:356
#define FLT_MAX
BMesh Iterators.
int RNA_enum_get(PointerRNA *ptr, const char *name)
@ RPT_WARNING
Definition BKE_report.hh:40
PropertyRNA * RNA_struct_find_property(PointerRNA *ptr, const char *identifier)
BMesh * BKE_editmesh_bmesh_get_for_write(Mesh *mesh)
Definition editmesh.cc:79
static const EnumPropertyItem prop_fit_method_items[]
void EDBM_update(Mesh *mesh, const EDBMUpdate_Params *params)
bool EDBM_op_callf(BMesh *bm, wmOperator *op, const char *fmt,...)
PropertyRNA * RNA_def_enum(StructOrFunctionRNA *cont_, const char *identifier, const EnumPropertyItem *items, const int default_value, const char *ui_name, const char *ui_description)
PropertyRNA * RNA_def_boolean_array(StructOrFunctionRNA *cont_, const char *identifier, const int len, const bool *default_value, const char *ui_name, const char *ui_description)
void RNA_boolean_get_array(PointerRNA *ptr, const char *name, bool *values)
ViewLayer * CTX_data_view_layer(const bContext *C)
PropertyRNA * RNA_def_float_factor(StructOrFunctionRNA *cont_, const char *identifier, const float default_value, const float hardmin, const float hardmax, const char *ui_name, const char *ui_description, const float softmin, const float softmax)
bool ED_operator_editmesh(bContext *C)
void BKE_report(ReportList *reports, eReportType type, const char *message)
Definition report.cc:162
void RNA_def_property_subtype(PropertyRNA *prop, PropertySubType subtype)
bool RNA_boolean_get(PointerRNA *ptr, const char *name)
Main * CTX_data_main(const bContext *C)
void MESH_OT_circularize(wmOperatorType *ot)
Vector< Object * > BKE_view_layer_array_from_objects_in_edit_mode_unique_data(const Main &bmain, const Scene *scene, ViewLayer *view_layer, const View3D *v3d)
void BKE_object_get_mirror_axes(const Object *ob, bool r_axis[3])
Definition object.cc:5115
Scene * CTX_data_scene(const bContext *C)
@ OPTYPE_REGISTER
Definition WM_types.hh:188
@ OPTYPE_UNDO
Definition WM_types.hh:190
PropertyRNA * RNA_def_boolean(StructOrFunctionRNA *cont_, const char *identifier, const bool default_value, const char *ui_name, const char *ui_description)
PropertyRNA * RNA_def_float(StructOrFunctionRNA *cont_, const char *identifier, const float default_value, const float hardmin, const float hardmax, const char *ui_name, const char *ui_description, const float softmin, const float softmax)
float RNA_float_get(PointerRNA *ptr, const char *name)
static wmOperatorStatus edbm_circularize_exec(bContext *C, wmOperator *op)
View3D * CTX_wm_view3d(const bContext *C)
static void edbm_circularize_ui(bContext *, wmOperator *op)
void use_property_split_set(bool is_sep)
void prop(PointerRNA *ptr, PropertyRNA *prop, int index, int value, eUI_Item_Flag flag, std::optional< StringRef > name_opt, int icon, std::optional< StringRef > placeholder=std::nullopt)
void active_set(bool active)
Layout & row(bool align)
wmOperatorStatus(*) exec(bContext *C, wmOperator *op) ATTR_WARN_UNUSED_RESULT
Definition WM_types.hh:1125
const char * description
Definition WM_types.hh:1115
void(*) ui(bContext *C, wmOperator *op)
Definition WM_types.hh:1176
bool(*) poll(bContext *C) ATTR_WARN_UNUSED_RESULT
Definition WM_types.hh:1165
struct ReportList * reports