Blender V5.3
view3d_navigate_view_axis.cc
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2023 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
8
9#include "BLI_math_base_c.hh"
11
12#include "DNA_userdef_types.h"
13
14#include "BLT_translation.hh"
15
16#include "BKE_context.hh"
17
18#include "ED_transform.hh"
19
20#include "WM_api.hh"
21
22#include "RNA_access.hh"
23#include "RNA_define.hh"
24
25#include "UI_resources.hh"
26
27#include "view3d_intern.hh"
28
29#include "view3d_navigate.hh" /* own include */
30
31namespace blender {
32
33/* -------------------------------------------------------------------- */
36
38 {RV3D_VIEW_LEFT, "LEFT", ICON_TRIA_LEFT, "Left", "View from the left"},
39 {RV3D_VIEW_RIGHT, "RIGHT", ICON_TRIA_RIGHT, "Right", "View from the right"},
40 {RV3D_VIEW_BOTTOM, "BOTTOM", ICON_TRIA_DOWN, "Bottom", "View from the bottom"},
41 {RV3D_VIEW_TOP, "TOP", ICON_TRIA_UP, "Top", "View from the top"},
42 {RV3D_VIEW_FRONT, "FRONT", 0, "Front", "View from the front"},
43 {RV3D_VIEW_BACK, "BACK", 0, "Back", "View from the back"},
44 {0, nullptr, 0, nullptr, nullptr},
45};
46
48{
49 View3D *v3d;
50 ARegion *region;
51 RegionView3D *rv3d;
52 static eRegionView3D_Persp perspo = RV3D_PERSP;
53 int viewnum;
54 int view_axis_roll = RV3D_VIEW_AXIS_ROLL_0;
55 const int smooth_viewtx = WM_operator_smooth_viewtx_get(op);
56
57 /* no nullptr check is needed, poll checks */
58 ED_view3d_context_user_region(C, &v3d, &region);
59 rv3d = static_cast<RegionView3D *>(region->regiondata);
60
62
63 viewnum = RNA_enum_get(op->ptr, "type");
64
65 float align_quat_buf[4];
66 float *align_quat = nullptr;
67
68 if (RNA_boolean_get(op->ptr, "align_active")) {
69 /* align to active object */
71 if (obact != nullptr) {
72 float twmat[3][3];
73 const Main *bmain = CTX_data_main(C);
74 const Scene *scene = CTX_data_scene(C);
75 ViewLayer *view_layer = CTX_data_view_layer(C);
76 Object *obedit = CTX_data_edit_object(C);
77 /* same as transform gizmo when normal is set */
79 *bmain, scene, view_layer, v3d, obact, obedit, V3D_AROUND_ACTIVE, twmat);
80 align_quat = align_quat_buf;
81 mat3_to_quat(align_quat, twmat);
82 invert_qt_normalized(align_quat);
83 }
84 }
85
86 if (RNA_boolean_get(op->ptr, "relative")) {
87 float quat_rotate[4];
88 float quat_test[4];
89
90 if (viewnum == RV3D_VIEW_LEFT) {
91 axis_angle_to_quat(quat_rotate, rv3d->viewinv[1], -M_PI_2);
92 }
93 else if (viewnum == RV3D_VIEW_RIGHT) {
94 axis_angle_to_quat(quat_rotate, rv3d->viewinv[1], M_PI_2);
95 }
96 else if (viewnum == RV3D_VIEW_TOP) {
97 axis_angle_to_quat(quat_rotate, rv3d->viewinv[0], -M_PI_2);
98 }
99 else if (viewnum == RV3D_VIEW_BOTTOM) {
100 axis_angle_to_quat(quat_rotate, rv3d->viewinv[0], M_PI_2);
101 }
102 else if (viewnum == RV3D_VIEW_FRONT) {
103 unit_qt(quat_rotate);
104 }
105 else if (viewnum == RV3D_VIEW_BACK) {
106 axis_angle_to_quat(quat_rotate, rv3d->viewinv[0], M_PI);
107 }
108 else {
109 BLI_assert(0);
110 }
111
112 mul_qt_qtqt(quat_test, rv3d->viewquat, quat_rotate);
113
114 float angle_best = FLT_MAX;
115 int view_best = -1;
116 int view_axis_roll_best = -1;
117 for (int i = RV3D_VIEW_FRONT; i <= RV3D_VIEW_BOTTOM; i++) {
118 for (int j = RV3D_VIEW_AXIS_ROLL_0; j <= RV3D_VIEW_AXIS_ROLL_270; j++) {
119 float quat_axis[4];
122 if (align_quat) {
123 mul_qt_qtqt(quat_axis, quat_axis, align_quat);
124 }
125 const float angle_test = fabsf(angle_signed_qtqt(quat_axis, quat_test));
126 if (angle_best > angle_test) {
127 angle_best = angle_test;
128 view_best = i;
129 view_axis_roll_best = j;
130 }
131 }
132 }
133 if (view_best == -1) {
134 view_best = RV3D_VIEW_FRONT;
135 view_axis_roll_best = RV3D_VIEW_AXIS_ROLL_0;
136 }
137
138 /* Disallow non-upright views in turn-table modes,
139 * it's too difficult to navigate out of them. */
140 if ((U.flag & USER_TRACKBALL) == 0) {
141 if (!ELEM(view_best, RV3D_VIEW_TOP, RV3D_VIEW_BOTTOM)) {
142 view_axis_roll_best = RV3D_VIEW_AXIS_ROLL_0;
143 }
144 }
145
146 viewnum = view_best;
147 view_axis_roll = view_axis_roll_best;
148 }
149
150 /* Use this to test if we started out with a camera */
151 const eRegionView3D_Persp nextperspo = (rv3d->persp == RV3D_CAMOB) ? rv3d->lpersp : perspo;
152 float quat[4];
153 const eRegionView3D_View viewnum_enum = eRegionView3D_View(viewnum);
154 const eRegionView3D_ViewAxisRoll view_axis_roll_enum = eRegionView3D_ViewAxisRoll(
155 view_axis_roll);
156 ED_view3d_quat_from_axis_view(viewnum_enum, view_axis_roll_enum, quat);
158 v3d,
159 region,
160 quat,
161 viewnum_enum,
162 view_axis_roll_enum,
163 nextperspo,
164 align_quat,
165 smooth_viewtx);
166
167 perspo = rv3d->persp;
168
169 return OPERATOR_FINISHED;
170}
171
173{
174 PropertyRNA *prop;
175
176 /* identifiers */
177 ot->name = "View Axis";
178 ot->description = "Use a preset viewpoint";
179 ot->idname = "VIEW3D_OT_view_axis";
180
181 /* API callbacks. */
182 ot->exec = view_axis_exec;
184
185 /* flags */
186 ot->flag = 0;
187
188 ot->prop = RNA_def_enum(ot->srna, "type", prop_view_items, 0, "View", "Preset viewpoint to use");
191
192 prop = RNA_def_boolean(
193 ot->srna, "align_active", false, "Align Active", "Align to the active object's axis");
195 prop = RNA_def_boolean(
196 ot->srna, "relative", false, "Relative", "Rotate relative to the current orientation");
198}
199
201
202} // namespace blender
#define M_PI_2
#define M_PI
#define BLT_I18NCONTEXT_EDITOR_VIEW3D
#define C
Definition RandGen.cpp:29
#define ELEM(...)
#define FLT_MAX
void ED_getTransformOrientationMatrix(const Main &bmain, const Scene *scene, ViewLayer *view_layer, const View3D *v3d, Object *ob, Object *obedit, short around, float r_orientation_mat[3][3])
BMesh Iterators.
void VIEW3D_OT_view_axis(wmOperatorType *ot)
bool ED_view3d_context_user_region(bContext *C, View3D **r_v3d, ARegion **r_region)
UserDef U
Definition blender.cc:58
BLI_assert(slot->slot_subtype.map==BMO_OP_SLOT_SUBTYPE_MAP_FLT)
int RNA_enum_get(PointerRNA *ptr, const char *name)
bool ED_operator_rv3d_user_region_poll(bContext *C)
static wmOperatorStatus view_axis_exec(bContext *C, wmOperator *op)
int WM_operator_smooth_viewtx_get(const wmOperator *op)
PropertyRNA * RNA_def_enum(StructOrFunctionRNA *cont_, const char *identifier, const EnumPropertyItem *items, const int default_value, const char *ui_name, const char *ui_description)
void axis_angle_to_quat(float r[4], const float axis[3], float angle)
void mul_qt_qtqt(float q[4], const float a[4], const float b[4])
ViewLayer * CTX_data_view_layer(const bContext *C)
@ RV3D_VIEW_AXIS_ROLL_270
void unit_qt(float q[4])
void axis_set_view(bContext *C, View3D *v3d, ARegion *region, const float quat_[4], eRegionView3D_View view, eRegionView3D_ViewAxisRoll view_axis_roll, eRegionView3D_Persp perspo, const float *align_to_quat, const int smooth_viewtx)
Object * CTX_data_edit_object(const bContext *C)
void invert_qt_normalized(float q[4])
bool RNA_boolean_get(PointerRNA *ptr, const char *name)
static const EnumPropertyItem prop_view_items[]
void RNA_def_property_translation_context(PropertyRNA *prop, const char *context)
void RNA_def_property_flag(PropertyRNA *prop, PropertyFlag flag)
Main * CTX_data_main(const bContext *C)
@ PROP_SKIP_SAVE
Definition RNA_types.hh:414
void ED_view3d_smooth_view_force_finish(bContext *C, View3D *v3d, ARegion *region)
Scene * CTX_data_scene(const bContext *C)
bool ED_view3d_quat_from_axis_view(eRegionView3D_View view, eRegionView3D_ViewAxisRoll view_axis_roll, float r_quat[4])
PropertyRNA * RNA_def_boolean(StructOrFunctionRNA *cont_, const char *identifier, const bool default_value, const char *ui_name, const char *ui_description)
float angle_signed_qtqt(const float q1[4], const float q2[4])
Object * CTX_data_active_object(const bContext *C)
void mat3_to_quat(float q[4], const float mat[3][3])
#define fabsf
eRegionView3D_Persp lpersp
eRegionView3D_Persp persp
wmOperatorStatus(*) exec(bContext *C, wmOperator *op) ATTR_WARN_UNUSED_RESULT
Definition WM_types.hh:1125
const char * description
Definition WM_types.hh:1115
bool(*) poll(bContext *C) ATTR_WARN_UNUSED_RESULT
Definition WM_types.hh:1165