view3d_navigate.hh

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2008 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */
 
#pragma once
 
#include "BLI_utildefines.h"
 
#define V3D_OP_TRACKBALLSIZE (1.1f)
 
struct ARegion;
struct Depsgraph;
struct Dial;
struct RegionView3D;
struct Scene;
struct ScrArea;
struct View3D;
struct bContext;
struct Object;
struct PointerRNA;
struct rcti;
struct wmEvent;
struct wmKeyConfig;
struct wmOperator;
struct wmOperatorType;
struct wmTimer;
struct wmWindow;
struct wmWindowManager;
 
enum eV3D_OpPropFlag {
  V3D_OP_PROP_MOUSE_CO = (1 << 0),
  V3D_OP_PROP_DELTA = (1 << 1),
  V3D_OP_PROP_USE_ALL_REGIONS = (1 << 2),
  V3D_OP_PROP_USE_MOUSE_INIT = (1 << 3),
};
ENUM_OPERATORS(eV3D_OpPropFlag, V3D_OP_PROP_USE_MOUSE_INIT);
 
enum eV3D_OpEvent {
  VIEW_PASS = 0,
  VIEW_APPLY,
  VIEW_CONFIRM,
  VIEW_CANCEL,
};
 
/* NOTE: these defines are saved in keymap files, do not change values but just add new ones */
enum {
  VIEW_MODAL_CANCEL = 0,  /* used for all view operations */
  VIEW_MODAL_CONFIRM = 1, /* used for all view operations */
  VIEWROT_MODAL_AXIS_SNAP_ENABLE = 2,
  VIEWROT_MODAL_AXIS_SNAP_DISABLE = 3,
  VIEWROT_MODAL_SWITCH_ZOOM = 4,
  VIEWROT_MODAL_SWITCH_MOVE = 5,
  VIEWROT_MODAL_SWITCH_ROTATE = 6,
};
 
enum eViewOpsFlag {
  VIEWOPS_FLAG_NONE = 0,
  VIEWOPS_FLAG_ORBIT_SELECT = (1 << 0),
  VIEWOPS_FLAG_DEPTH_NAVIGATE = (1 << 1),
  VIEWOPS_FLAG_PERSP_ENSURE = (1 << 2),
 
  VIEWOPS_FLAG_ZOOM_TO_MOUSE = (1 << 3),
 
  VIEWOPS_FLAG_INIT_ZFAC = (1 << 4),
};
ENUM_OPERATORS(eViewOpsFlag, VIEWOPS_FLAG_INIT_ZFAC);
 
struct ViewOpsType {
  eViewOpsFlag flag;
  const char *idname;
  bool (*poll_fn)(bContext *C);
  int (*init_fn)(bContext *C, ViewOpsData *vod, const wmEvent *event, PointerRNA *ptr);
  int (*apply_fn)(bContext *C, ViewOpsData *vod, const eV3D_OpEvent event_code, const int xy[2]);
};
 
struct ViewOpsData {
  Scene *scene;
  ScrArea *area;
  ARegion *region;
  View3D *v3d;
  RegionView3D *rv3d;
  Depsgraph *depsgraph;
 
  wmTimer *timer;
 
  struct {
 
    float ofs[3];        /* DOLLY, MOVE, ROTATE and ZOOM. */
    float ofs_lock[2];   /* MOVE. */
    float camdx, camdy;  /* MOVE and ZOOM. */
    float camzoom;       /* ZOOM. */
    float dist;          /* ROTATE and ZOOM. */
    float quat[4];       /* ROLL and ROTATE. */
    char persp;          /* ROTATE. */
    char view;           /* ROTATE. */
    char view_axis_roll; /* ROTATE. */
 
    char persp_with_auto_persp_applied;
 
    int event_xy[2];
    /* Offset used when "use_cursor_init" is false to simulate pressing in the middle of the
     * region. */
    int event_xy_offset[2];
    int event_type;
 
    float zfac;
 
    float trackvec[3];
    float mousevec[3];
 
    Dial *dial;
  } init;
 
  struct {
    int event_xy[2];
    double time;
  } prev;
 
  struct {
    float viewquat[4];
  } curr;
 
  const ViewOpsType *nav_type;
  eViewOpsFlag viewops_flag;
 
  float reverse;
  bool axis_snap; /* view rotate only */
 
  float dyn_ofs[3];
  bool use_dyn_ofs;
 
  bool use_dyn_ofs_ortho_correction;
 
  void init_context(bContext *C);
  void state_backup();
  void state_restore();
  void init_navigation(bContext *C,
                       const wmEvent *event,
                       const ViewOpsType *nav_type,
                       const float dyn_ofs_override[3] = nullptr,
                       const bool use_cursor_init = false);
  void end_navigation(bContext *C);
 
#ifdef WITH_CXX_GUARDEDALLOC
  MEM_CXX_CLASS_ALLOC_FUNCS("ViewOpsData")
#endif
};
 
/* view3d_navigate.cc */
 
bool view3d_location_poll(bContext *C);
bool view3d_rotation_poll(bContext *C);
bool view3d_zoom_or_dolly_poll(bContext *C);
 
int view3d_navigate_invoke_impl(bContext *C,
                                wmOperator *op,
                                const wmEvent *event,
                                const ViewOpsType *nav_type);
int view3d_navigate_modal_fn(bContext *C, wmOperator *op, const wmEvent *event);
void view3d_navigate_cancel_fn(bContext *C, wmOperator *op);
 
void calctrackballvec(const rcti *rect, const int event_xy[2], float r_dir[3]);
void viewmove_apply(ViewOpsData *vod, int x, int y);
void view3d_orbit_apply_dyn_ofs(float r_ofs[3],
                                const float ofs_old[3],
                                const float viewquat_old[4],
                                const float viewquat_new[4],
                                const float dyn_ofs[3]);
void viewrotate_apply_dyn_ofs(ViewOpsData *vod, const float viewquat_new[4]);
bool view3d_orbit_calc_center(bContext *C, float r_dyn_ofs[3]);
 
void view3d_operator_properties_common(wmOperatorType *ot, const eV3D_OpPropFlag flag);
 
void viewops_data_free(bContext *C, ViewOpsData *vod);
 
ViewOpsData *viewops_data_create(bContext *C,
                                 const wmEvent *event,
                                 const ViewOpsType *nav_type,
                                 const bool use_cursor_init);
void axis_set_view(bContext *C,
                   View3D *v3d,
                   ARegion *region,
                   const float quat_[4],
                   char view,
                   char view_axis_roll,
                   int perspo,
                   const float *align_to_quat,
                   const int smooth_viewtx);
 
/* view3d_navigate_dolly.cc */
 
void viewdolly_modal_keymap(wmKeyConfig *keyconf);
void VIEW3D_OT_dolly(wmOperatorType *ot);
 
extern ViewOpsType ViewOpsType_dolly;
 
/* view3d_navigate_fly.cc */
 
void fly_modal_keymap(wmKeyConfig *keyconf);
void view3d_keymap(wmKeyConfig *keyconf);
void VIEW3D_OT_fly(wmOperatorType *ot);
 
/* view3d_navigate_move.cc */
 
void viewmove_modal_keymap(wmKeyConfig *keyconf);
void VIEW3D_OT_move(wmOperatorType *ot);
 
extern const ViewOpsType ViewOpsType_move;
 
/* view3d_navigate_ndof.cc */
 
#ifdef WITH_INPUT_NDOF
struct wmNDOFMotionData;
void view3d_ndof_fly(const wmNDOFMotionData *ndof,
                     View3D *v3d,
                     RegionView3D *rv3d,
                     bool use_precision,
                     short protectflag,
                     bool *r_has_translate,
                     bool *r_has_rotate);
void VIEW3D_OT_ndof_orbit(wmOperatorType *ot);
void VIEW3D_OT_ndof_orbit_zoom(wmOperatorType *ot);
void VIEW3D_OT_ndof_pan(wmOperatorType *ot);
void VIEW3D_OT_ndof_all(wmOperatorType *ot);
 
extern const ViewOpsType ViewOpsType_ndof_orbit;
extern const ViewOpsType ViewOpsType_ndof_orbit_zoom;
extern const ViewOpsType ViewOpsType_ndof_pan;
extern const ViewOpsType ViewOpsType_ndof_all;
#endif /* WITH_INPUT_NDOF */
 
/* view3d_navigate_roll.cc */
 
void VIEW3D_OT_view_roll(wmOperatorType *ot);
 
extern const ViewOpsType ViewOpsType_roll;
 
/* view3d_navigate_rotate.cc */
 
void viewrotate_modal_keymap(wmKeyConfig *keyconf);
void VIEW3D_OT_rotate(wmOperatorType *ot);
 
extern const ViewOpsType ViewOpsType_rotate;
 
/* view3d_navigate_smoothview.cc */
 
struct V3D_SmoothParams {
  Object *camera_old, *camera;
  const float *ofs, *quat, *dist, *lens;
 
  const float *dyn_ofs;
 
  const char *undo_str;
  bool undo_grouped;
};
 
void ED_view3d_smooth_view_ex(const Depsgraph *depsgraph,
                              wmWindowManager *wm,
                              wmWindow *win,
                              ScrArea *area,
                              View3D *v3d,
                              ARegion *region,
                              int smooth_viewtx,
                              const V3D_SmoothParams *sview);
 
void ED_view3d_smooth_view(
    bContext *C, View3D *v3d, ARegion *region, int smooth_viewtx, const V3D_SmoothParams *sview);
 
void ED_view3d_smooth_view_undo_begin(bContext *C, const ScrArea *area);
void ED_view3d_smooth_view_undo_end(bContext *C,
                                    const ScrArea *area,
                                    const char *undo_str,
                                    bool undo_grouped);
 
void ED_view3d_smooth_view_force_finish(bContext *C, View3D *v3d, ARegion *region);
 
void ED_view3d_smooth_view_force_finish_no_camera_lock(const Depsgraph *depsgraph,
                                                       wmWindowManager *wm,
                                                       wmWindow *win,
                                                       const Scene *scene,
                                                       View3D *v3d,
                                                       ARegion *region);
 
void VIEW3D_OT_smoothview(wmOperatorType *ot);
 
/* view3d_navigate_view_all.cc */
 
void VIEW3D_OT_view_all(wmOperatorType *ot);
void VIEW3D_OT_view_selected(wmOperatorType *ot);
 
/* view3d_navigate_view_axis.cc */
 
void VIEW3D_OT_view_axis(wmOperatorType *ot);
 
/* view3d_navigate_view_camera.cc */
 
void VIEW3D_OT_view_camera(wmOperatorType *ot);
 
/* view3d_navigate_view_center_cursor.cc */
 
void VIEW3D_OT_view_center_cursor(wmOperatorType *ot);
 
/* view3d_navigate_view_center_pick.cc */
 
void VIEW3D_OT_view_center_pick(wmOperatorType *ot);
 
/* view3d_navigate_view_orbit.cc */
 
void VIEW3D_OT_view_orbit(wmOperatorType *ot);
 
extern const ViewOpsType ViewOpsType_orbit;
 
/* view3d_navigate_view_pan.cc */
 
void VIEW3D_OT_view_pan(wmOperatorType *ot);
 
extern const ViewOpsType ViewOpsType_pan;
 
/* view3d_navigate_walk.cc */
 
void walk_modal_keymap(wmKeyConfig *keyconf);
void VIEW3D_OT_walk(wmOperatorType *ot);
 
/* view3d_navigate_zoom.cc */
 
void viewzoom_modal_keymap(wmKeyConfig *keyconf);
void VIEW3D_OT_zoom(wmOperatorType *ot);
 
extern const ViewOpsType ViewOpsType_zoom;
 
/* view3d_navigate_zoom_border.cc */
 
void VIEW3D_OT_zoom_border(wmOperatorType *ot);