Blender V5.3
editmesh_flatten.cc
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2026 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
8
9#include "DNA_mesh_types.h"
10#include "DNA_object_types.h"
11#include "DNA_view3d_types.h"
12
13#include "BKE_context.hh"
14#include "BKE_editmesh.hh"
15#include "BKE_layer.hh"
16
17#include "BLI_math_matrix.hh"
18#include "BLI_math_vector_c.hh"
19
20#include "BLT_translation.hh"
21
22#include "ED_mesh.hh"
23#include "ED_screen.hh"
24
25#include "RNA_access.hh"
26#include "RNA_define.hh"
27
28#include "UI_interface.hh"
30
31#include "mesh_intern.hh" /* own include */
32
33namespace blender {
34
36 {FLATTEN_BEST_FIT, "BEST_FIT", 0, "Best Fit", "Calculate a best fitting plane"},
37 {FLATTEN_NORMAL, "NORMAL", 0, "Normal", "Derive plane by averaging face normals"},
38 {FLATTEN_VIEW, "VIEW", 0, "View", "Flatten on a plane perpendicular to the viewing angle"},
39 {0, nullptr},
40};
41
43{
44 const Main *bmain = CTX_data_main(C);
45 const Scene *scene = CTX_data_scene(C);
46 ViewLayer *view_layer = CTX_data_view_layer(C);
48 *bmain, scene, view_layer, CTX_wm_view3d(C));
49
50 const float factor = RNA_float_get(op->ptr, "factor");
51 const int method = RNA_enum_get(op->ptr, "method");
52 bool lock[3];
53 RNA_boolean_get_array(op->ptr, "lock", lock);
54 bool changed = false;
55 RegionView3D *rv3d = method == FLATTEN_VIEW ? CTX_wm_region_view3d(C) : nullptr;
56
57 for (Object *obedit : objects) {
59
60 float view_normal[3] = {0.0f, 0.0f, 1.0f};
61 if (rv3d) {
63 math::transform_direction(obedit->world_to_object(), float3(rv3d->viewinv[2])));
64 copy_v3_v3(view_normal, vn);
65 }
66
67 if (!EDBM_op_callf(
68 bm,
69 op,
70 "flatten geom=%hvef factor=%f method=%i view_normal=%v lock_x=%b lock_y=%b lock_z=%b",
72 factor,
73 method,
74 view_normal,
75 lock[0],
76 lock[1],
77 lock[2]))
78 {
79 continue;
80 }
81
82 changed = true;
83 EDBMUpdate_Params params{};
84 params.calc_looptris = true;
85 params.calc_normals = true;
86 EDBM_update(id_cast<Mesh *>(obedit->data), &params);
87 }
88
89 return changed ? OPERATOR_FINISHED : OPERATOR_CANCELLED;
90}
91
92static void edbm_flatten_ui(bContext * /*C*/, wmOperator *op)
93{
94 ui::Layout &layout = *op->layout;
95 layout.use_property_split_set(true);
96
97 layout.prop(op->ptr, "factor", UI_ITEM_NONE, std::nullopt, ICON_NONE);
98 layout.prop(op->ptr, "method", UI_ITEM_NONE, std::nullopt, ICON_NONE);
99
100 ui::Layout &lock_row = layout.row(true, IFACE_("Lock"));
101 PropertyRNA *lock_prop = RNA_struct_find_property(op->ptr, "lock");
102 lock_row.prop(op->ptr, lock_prop, 0, 0, ui::ITEM_R_TOGGLE, "X", ICON_NONE);
103 lock_row.prop(op->ptr, lock_prop, 1, 0, ui::ITEM_R_TOGGLE, "Y", ICON_NONE);
104 lock_row.prop(op->ptr, lock_prop, 2, 0, ui::ITEM_R_TOGGLE, "Z", ICON_NONE);
105}
106
108{
109 ot->name = "Flatten";
110 ot->description = "Flatten vertices on a best-fitting plane";
111 ot->idname = "MESH_OT_flatten";
112
115 ot->ui = edbm_flatten_ui;
116
118
120 ot->srna, "factor", 1.0f, 0.0f, 1.0f, "Factor", "Flattening factor", 0.0f, 1.0f);
122 ot->srna, "method", prop_method_items, 0, "Method", "Plane on which vertices are flattened");
123 RNA_def_boolean_array(ot->srna, "lock", 3, nullptr, "Lock", "Lock editing of the axis");
124}
125
126} // namespace blender
#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
MatBase< T, NumCol, NumRow > normalize(const MatBase< T, NumCol, NumRow > &a)
VecBase< T, 3 > transform_direction(const MatBase< T, 3, 3 > &mat, const VecBase< T, 3 > &direction)
BMesh Iterators.
int RNA_enum_get(PointerRNA *ptr, const char *name)
PropertyRNA * RNA_struct_find_property(PointerRNA *ptr, const char *identifier)
BMesh * BKE_editmesh_bmesh_get_for_write(Mesh *mesh)
Definition editmesh.cc:79
MINLINE void copy_v3_v3(float r[3], const float a[3])
static wmOperatorStatus edbm_flatten_exec(bContext *C, wmOperator *op)
static void edbm_flatten_ui(bContext *, wmOperator *op)
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)
static const EnumPropertyItem prop_method_items[]
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)
RegionView3D * CTX_wm_region_view3d(const bContext *C)
Main * CTX_data_main(const bContext *C)
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)
Scene * CTX_data_scene(const bContext *C)
@ OPTYPE_REGISTER
Definition WM_types.hh:188
@ OPTYPE_UNDO
Definition WM_types.hh:190
VecBase< float, 3 > float3
void MESH_OT_flatten(wmOperatorType *ot)
float RNA_float_get(PointerRNA *ptr, const char *name)
View3D * CTX_wm_view3d(const bContext *C)
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)
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