Blender  V3.3
Classes
view3d_utils.c File Reference
#include <float.h>
#include <math.h>
#include <stdio.h>
#include <string.h>
#include "DNA_camera_types.h"
#include "DNA_curve_types.h"
#include "DNA_object_types.h"
#include "DNA_scene_types.h"
#include "DNA_world_types.h"
#include "MEM_guardedalloc.h"
#include "BLI_array_utils.h"
#include "BLI_bitmap_draw_2d.h"
#include "BLI_blenlib.h"
#include "BLI_math.h"
#include "BLI_utildefines.h"
#include "BKE_camera.h"
#include "BKE_context.h"
#include "BKE_object.h"
#include "BKE_scene.h"
#include "BKE_screen.h"
#include "DEG_depsgraph.h"
#include "DEG_depsgraph_query.h"
#include "BIF_glutil.h"
#include "GPU_matrix.h"
#include "WM_api.h"
#include "WM_types.h"
#include "ED_keyframing.h"
#include "ED_screen.h"
#include "ED_undo.h"
#include "ED_view3d.h"
#include "UI_resources.h"
#include "view3d_intern.h"

Go to the source code of this file.

Classes

struct  PointsInPlanesMinMax_UserData
 
struct  ReadData
 

Functions

View Data Access Utilities
void ED_view3d_background_color_get (const Scene *scene, const View3D *v3d, float r_color[3])
 
bool ED_view3d_has_workbench_in_texture_color (const Scene *scene, const Object *ob, const View3D *v3d)
 
CameraED_view3d_camera_data_get (View3D *v3d, RegionView3D *rv3d)
 
void ED_view3d_dist_range_get (const View3D *v3d, float r_dist_range[2])
 
bool ED_view3d_clip_range_get (const Depsgraph *depsgraph, const View3D *v3d, const RegionView3D *rv3d, float *r_clipsta, float *r_clipend, const bool use_ortho_factor)
 
bool ED_view3d_viewplane_get (Depsgraph *depsgraph, const View3D *v3d, const RegionView3D *rv3d, int winx, int winy, rctf *r_viewplane, float *r_clip_start, float *r_clip_end, float *r_pixsize)
 
View State/Context Utilities
void view3d_operator_needs_opengl (const bContext *C)
 
void view3d_region_operator_needs_opengl (wmWindow *UNUSED(win), ARegion *region)
 
void ED_view3d_polygon_offset (const RegionView3D *rv3d, const float dist)
 
bool ED_view3d_context_activate (bContext *C)
 
View Clipping Utilities
void ED_view3d_clipping_calc_from_boundbox (float clip[4][4], const BoundBox *bb, const bool is_flip)
 
void ED_view3d_clipping_calc (BoundBox *bb, float planes[4][4], const ARegion *region, const Object *ob, const rcti *rect)
 
View Clipping Clamp Min/Max
static void points_in_planes_minmax_fn (const float co[3], int UNUSED(i), int UNUSED(j), int UNUSED(k), void *user_data_p)
 
bool ED_view3d_clipping_clamp_minmax (const RegionView3D *rv3d, float min[3], float max[3])
 
View Bound-Box Utilities
static bool view3d_boundbox_clip_m4 (const BoundBox *bb, const float persmatob[4][4])
 
bool ED_view3d_boundbox_clip_ex (const RegionView3D *rv3d, const BoundBox *bb, float obmat[4][4])
 
bool ED_view3d_boundbox_clip (RegionView3D *rv3d, const BoundBox *bb)
 
View Perspective & Mode Switching

Misc view utility functions.

bool ED_view3d_offset_lock_check (const View3D *v3d, const RegionView3D *rv3d)
 
void ED_view3d_lastview_store (RegionView3D *rv3d)
 
void ED_view3d_lock_clear (View3D *v3d)
 
void ED_view3d_persp_switch_from_camera (const Depsgraph *depsgraph, View3D *v3d, RegionView3D *rv3d, const char persp)
 
bool ED_view3d_persp_ensure (const Depsgraph *depsgraph, View3D *v3d, ARegion *region)
 
Camera View Utilities

Utilities for manipulating the camera-view.

bool ED_view3d_camera_view_zoom_scale (RegionView3D *rv3d, const float scale)
 
bool ED_view3d_camera_view_pan (ARegion *region, const float event_ofs[2])
 
Camera Lock API

Lock the camera to the 3D Viewport, allowing view manipulation to transform the camera.

bool ED_view3d_camera_lock_check (const View3D *v3d, const RegionView3D *rv3d)
 
void ED_view3d_camera_lock_init_ex (const Depsgraph *depsgraph, View3D *v3d, RegionView3D *rv3d, const bool calc_dist)
 
void ED_view3d_camera_lock_init (const Depsgraph *depsgraph, View3D *v3d, RegionView3D *rv3d)
 
bool ED_view3d_camera_lock_sync (const Depsgraph *depsgraph, View3D *v3d, RegionView3D *rv3d)
 
bool ED_view3d_camera_autokey (const Scene *scene, ID *id_key, struct bContext *C, const bool do_rotate, const bool do_translate)
 
bool ED_view3d_camera_lock_autokey (View3D *v3d, RegionView3D *rv3d, struct bContext *C, const bool do_rotate, const bool do_translate)
 
bool ED_view3d_camera_lock_undo_test (const View3D *v3d, const RegionView3D *rv3d, struct bContext *C)
 
static bool view3d_camera_lock_undo_ex (const char *str, View3D *v3d, RegionView3D *rv3d, struct bContext *C, bool undo_group)
 
bool ED_view3d_camera_lock_undo_push (const char *str, View3D *v3d, RegionView3D *rv3d, bContext *C)
 
bool ED_view3d_camera_lock_undo_grouped_push (const char *str, View3D *v3d, RegionView3D *rv3d, bContext *C)
 
Box View Support

Use with quad-split so each view is clipped by the bounds of each view axis.

static void view3d_boxview_clip (ScrArea *area)
 
static void view3d_boxview_sync_axis (RegionView3D *rv3d_dst, RegionView3D *rv3d_src)
 
void view3d_boxview_sync (ScrArea *area, ARegion *region)
 
void view3d_boxview_copy (ScrArea *area, ARegion *region)
 
void ED_view3d_quadview_update (ScrArea *area, ARegion *region, bool do_clip)
 
View Auto-Depth Utilities
static float view_autodist_depth_margin (ARegion *region, const int mval[2], int margin)
 
bool ED_view3d_autodist (Depsgraph *depsgraph, ARegion *region, View3D *v3d, const int mval[2], float mouse_worldloc[3], const bool UNUSED(alphaoverride), const float fallback_depth_pt[3])
 
bool ED_view3d_autodist_simple (ARegion *region, const int mval[2], float mouse_worldloc[3], int margin, const float *force_depth)
 
static bool depth_segment_cb (int x, int y, void *userData)
 
bool ED_view3d_depth_read_cached_seg (const ViewDepths *vd, const int mval_sta[2], const int mval_end[2], int margin, float *depth)
 
View Radius/Distance Utilities

Use to calculate a distance to a point based on its radius.

float ED_view3d_radius_to_dist_persp (const float angle, const float radius)
 
float ED_view3d_radius_to_dist_ortho (const float lens, const float radius)
 
float ED_view3d_radius_to_dist (const View3D *v3d, const ARegion *region, const struct Depsgraph *depsgraph, const char persp, const bool use_aspect, const float radius)
 
View Distance Utilities
float ED_view3d_offset_distance (const float mat[4][4], const float ofs[3], const float fallback_dist)
 
void ED_view3d_distance_set (RegionView3D *rv3d, const float dist)
 
bool ED_view3d_distance_set_from_location (RegionView3D *rv3d, const float dist_co[3], const float dist_min)
 
View Transform Utilities
void ED_view3d_from_m4 (const float mat[4][4], float ofs[3], float quat[4], const float *dist)
 
void ED_view3d_to_m4 (float mat[4][4], const float ofs[3], const float quat[4], const float dist)
 
void ED_view3d_from_object (const Object *ob, float ofs[3], float quat[4], float *dist, float *lens)
 
void ED_view3d_to_object (const Depsgraph *depsgraph, Object *ob, const float ofs[3], const float quat[4], const float dist)
 
static bool view3d_camera_to_view_selected_impl (struct Main *bmain, Depsgraph *depsgraph, const Scene *scene, Object *camera_ob, float *r_clip_start, float *r_clip_end)
 
bool ED_view3d_camera_to_view_selected (struct Main *bmain, Depsgraph *depsgraph, const Scene *scene, Object *camera_ob)
 
bool ED_view3d_camera_to_view_selected_with_set_clipping (struct Main *bmain, Depsgraph *depsgraph, const Scene *scene, Object *camera_ob)
 
Depth Buffer Utilities
static bool depth_read_test_fn (const void *value, void *userdata)
 
bool ED_view3d_depth_read_cached (const ViewDepths *vd, const int mval[2], int margin, float *r_depth)
 
bool ED_view3d_depth_read_cached_normal (const ARegion *region, const ViewDepths *depths, const int mval[2], float r_normal[3])
 
bool ED_view3d_depth_unproject_v3 (const ARegion *region, const int mval[2], const double depth, float r_location_world[3])
 

View Axis Utilities

static float view3d_quat_axis [6][4][4]
 
bool ED_view3d_quat_from_axis_view (const char view, const char view_axis_roll, float r_quat[4])
 
bool ED_view3d_quat_to_axis_view (const float quat[4], const float epsilon, char *r_view, char *r_view_axis_roll)
 
bool ED_view3d_quat_to_axis_view_and_reset_quat (float quat[4], const float epsilon, char *r_view, char *r_view_axis_roll)
 
char ED_view3d_lock_view_from_index (int index)
 
char ED_view3d_axis_view_opposite (char view)
 
bool ED_view3d_lock (RegionView3D *rv3d)
 

Detailed Description

3D View checks and manipulation (no operators).

Definition in file view3d_utils.c.

Function Documentation

◆ depth_read_test_fn()

static bool depth_read_test_fn ( const void value,
void userdata 
)
static

Definition at line 1615 of file view3d_utils.c.

References data, and ReadData::r_depth.

Referenced by ED_view3d_depth_read_cached().

◆ depth_segment_cb()

static bool depth_segment_cb ( int  x,
int  y,
void userData 
)
static

Definition at line 1087 of file view3d_utils.c.

References data, ED_view3d_depth_read_cached(), x, and y.

Referenced by ED_view3d_depth_read_cached_seg().

◆ ED_view3d_autodist()

bool ED_view3d_autodist ( Depsgraph depsgraph,
ARegion region,
View3D v3d,
const int  mval[2],
float  mouse_worldloc[3],
const bool   UNUSEDalphaoverride,
const float  fallback_depth_pt[3] 
)

◆ ED_view3d_autodist_simple()

bool ED_view3d_autodist_simple ( struct ARegion region,
const int  mval[2],
float  mouse_worldloc[3],
int  margin,
const float force_depth 
)

◆ ED_view3d_axis_view_opposite()

char ED_view3d_axis_view_opposite ( char  view)

◆ ED_view3d_background_color_get()

void ED_view3d_background_color_get ( const Scene scene,
const View3D v3d,
float  r_color[3] 
)

◆ ED_view3d_boundbox_clip()

bool ED_view3d_boundbox_clip ( RegionView3D rv3d,
const BoundBox bb 
)

Definition at line 419 of file view3d_utils.c.

References NULL, RegionView3D::persmatob, and view3d_boundbox_clip_m4().

◆ ED_view3d_boundbox_clip_ex()

bool ED_view3d_boundbox_clip_ex ( const RegionView3D rv3d,
const BoundBox bb,
float  obmat[4][4] 
)

Definition at line 404 of file view3d_utils.c.

References mul_m4_m4m4(), NULL, RegionView3D::persmat, and view3d_boundbox_clip_m4().

◆ ED_view3d_camera_autokey()

bool ED_view3d_camera_autokey ( const Scene scene,
ID id_key,
struct bContext C,
const bool  do_rotate,
const bool  do_translate 
)

◆ ED_view3d_camera_data_get()

Camera* ED_view3d_camera_data_get ( View3D v3d,
RegionView3D rv3d 
)

◆ ED_view3d_camera_lock_autokey()

bool ED_view3d_camera_lock_autokey ( struct View3D v3d,
struct RegionView3D rv3d,
struct bContext C,
bool  do_rotate,
bool  do_translate 
)

Call after modifying a locked view.

Note
Not every view edit currently auto-keys (numeric-pad for eg), this is complicated because of smooth-view.

Definition at line 665 of file view3d_utils.c.

References C, View3D::camera, CTX_data_scene(), ED_view3d_camera_autokey(), ED_view3d_camera_lock_check(), Object::id, OB_TRANSFORM_ADJUST_ROOT_PARENT_FOR_VIEW_LOCK, Object::parent, scene, and Object::transflag.

Referenced by view3d_smoothview_apply_ex(), viewdolly_modal(), viewmove_modal(), viewroll_modal(), viewrotate_modal(), viewzoom_exec(), viewzoom_invoke(), and viewzoom_modal().

◆ ED_view3d_camera_lock_check()

bool ED_view3d_camera_lock_check ( const View3D v3d,
const RegionView3D rv3d 
)

◆ ED_view3d_camera_lock_init()

void ED_view3d_camera_lock_init ( const Depsgraph depsgraph,
View3D v3d,
RegionView3D rv3d 
)

Definition at line 567 of file view3d_utils.c.

References depsgraph, and ED_view3d_camera_lock_init_ex().

◆ ED_view3d_camera_lock_init_ex()

void ED_view3d_camera_lock_init_ex ( const Depsgraph depsgraph,
View3D v3d,
RegionView3D rv3d,
const bool  calc_dist 
)

◆ ED_view3d_camera_lock_sync()

bool ED_view3d_camera_lock_sync ( const Depsgraph depsgraph,
View3D v3d,
RegionView3D rv3d 
)

◆ ED_view3d_camera_lock_undo_grouped_push()

bool ED_view3d_camera_lock_undo_grouped_push ( const char *  str,
View3D v3d,
struct RegionView3D rv3d,
struct bContext C 
)

A version of ED_view3d_camera_lock_undo_push that performs a grouped undo push.

Note
use for actions that are likely to be repeated such as mouse wheel to zoom, where adding a separate undo step each time isn't desirable.

Definition at line 731 of file view3d_utils.c.

References C, str, and view3d_camera_lock_undo_ex().

Referenced by ED_view3d_smooth_view_undo_end(), and viewzoom_exec().

◆ ED_view3d_camera_lock_undo_push()

bool ED_view3d_camera_lock_undo_push ( const char *  str,
View3D v3d,
struct RegionView3D rv3d,
struct bContext C 
)

Create an undo step when the camera is locked to the view.

Parameters
strThe name of the undo step (typically wmOperatorType.name should be used).
Returns
true when the call to push an undo step was made.

Definition at line 726 of file view3d_utils.c.

References C, str, and view3d_camera_lock_undo_ex().

Referenced by ED_view3d_smooth_view_undo_end(), fly_modal(), viewdolly_modal(), viewmove_modal(), viewpan_invoke(), viewrotate_modal(), viewzoom_modal(), and walk_modal().

◆ ED_view3d_camera_lock_undo_test()

bool ED_view3d_camera_lock_undo_test ( const View3D v3d,
const RegionView3D rv3d,
struct bContext C 
)

Check if creating an undo step should be performed if the viewport moves.

Returns
true if ED_view3d_camera_lock_undo_push would do an undo push.

Definition at line 692 of file view3d_utils.c.

References C, ED_undo_is_memfile_compatible(), and ED_view3d_camera_lock_check().

Referenced by ED_view3d_smooth_view_undo_begin(), ED_view3d_smooth_view_undo_end(), and view3d_camera_lock_undo_ex().

◆ ED_view3d_camera_to_view_selected()

bool ED_view3d_camera_to_view_selected ( struct Main bmain,
Depsgraph depsgraph,
const Scene scene,
Object camera_ob 
)

Definition at line 1571 of file view3d_utils.c.

References depsgraph, NULL, scene, and view3d_camera_to_view_selected_impl().

◆ ED_view3d_camera_to_view_selected_with_set_clipping()

bool ED_view3d_camera_to_view_selected_with_set_clipping ( struct Main bmain,
Depsgraph depsgraph,
const Scene scene,
Object camera_ob 
)

◆ ED_view3d_camera_view_pan()

bool ED_view3d_camera_view_pan ( struct ARegion region,
const float  event_ofs[2] 
)

Utility to pan when in camera view.

Parameters
event_ofsThe offset the pan in screen (pixel) coordinates.
Returns
true when a change was made.

Definition at line 525 of file view3d_utils.c.

References BKE_screen_view3d_zoom_to_fac(), RegionView3D::camdx, RegionView3D::camdy, RegionView3D::camzoom, CLAMP, ARegion::regiondata, ARegion::winx, and ARegion::winy.

Referenced by viewmove_apply().

◆ ED_view3d_camera_view_zoom_scale()

bool ED_view3d_camera_view_zoom_scale ( struct RegionView3D rv3d,
const float  scale 
)

Utility to scale zoom level when in camera-view RegionView3D.camzoom and apply limits.

Returns
true a change was made.

Definition at line 512 of file view3d_utils.c.

References BKE_screen_view3d_zoom_from_fac(), BKE_screen_view3d_zoom_to_fac(), RegionView3D::camzoom, CLAMP, RV3D_CAMZOOM_MAX, RV3D_CAMZOOM_MAX_FACTOR, RV3D_CAMZOOM_MIN, and RV3D_CAMZOOM_MIN_FACTOR.

◆ ED_view3d_clip_range_get()

bool ED_view3d_clip_range_get ( const Depsgraph depsgraph,
const View3D v3d,
const RegionView3D rv3d,
float r_clipsta,
float r_clipend,
const bool  use_ortho_factor 
)

◆ ED_view3d_clipping_calc()

void ED_view3d_clipping_calc ( BoundBox bb,
float  planes[4][4],
const ARegion region,
const Object ob,
const rcti rect 
)

◆ ED_view3d_clipping_calc_from_boundbox()

void ED_view3d_clipping_calc_from_boundbox ( float  clip[4][4],
const BoundBox bb,
const bool  is_flip 
)

Definition at line 251 of file view3d_utils.c.

References dot_v3v3(), negate_v3(), normal_tri_v3(), UNLIKELY, and BoundBox::vec.

Referenced by ED_view3d_clipping_calc().

◆ ED_view3d_clipping_clamp_minmax()

bool ED_view3d_clipping_clamp_minmax ( const RegionView3D rv3d,
float  min[3],
float  max[3] 
)

◆ ED_view3d_context_activate()

bool ED_view3d_context_activate ( bContext C)

◆ ED_view3d_depth_read_cached()

bool ED_view3d_depth_read_cached ( const ViewDepths vd,
const int  mval[2],
int  margin,
float r_depth 
)

◆ ED_view3d_depth_read_cached_normal()

bool ED_view3d_depth_read_cached_normal ( const ARegion region,
const ViewDepths depths,
const int  mval[2],
float  r_normal[3] 
)

◆ ED_view3d_depth_read_cached_seg()

bool ED_view3d_depth_read_cached_seg ( const ViewDepths vd,
const int  mval_sta[2],
const int  mval_end[2],
int  margin,
float depth 
)

◆ ED_view3d_depth_unproject_v3()

bool ED_view3d_depth_unproject_v3 ( const ARegion region,
const int  mval[2],
const double  depth,
float  r_location_world[3] 
)

Definition at line 1730 of file view3d_utils.c.

References ED_view3d_unproject_v3(), and float().

Referenced by ED_view3d_depth_read_cached_normal().

◆ ED_view3d_dist_range_get()

void ED_view3d_dist_range_get ( const View3D v3d,
float  r_dist_range[2] 
)

Definition at line 104 of file view3d_utils.c.

References View3D::clip_end, and View3D::grid.

◆ ED_view3d_distance_set()

void ED_view3d_distance_set ( struct RegionView3D rv3d,
float  dist 
)

Set the dist without moving the view (compensate with RegionView3D.ofs)

Note
take care that #RegionView3d.viewinv is up to date, ED_view3d_update_viewmat first.

Definition at line 1251 of file view3d_utils.c.

References BLI_assert, copy_v3_fl3(), RegionView3D::dist, invert_qt_qt_normalized(), mul_mat3_m4_v3(), mul_qt_v3(), RegionView3D::ofs, sub_v3_v3(), RegionView3D::viewinv, and RegionView3D::viewquat.

Referenced by ED_view3d_cameracontrol_acquire(), and ED_view3d_cameracontrol_release().

◆ ED_view3d_distance_set_from_location()

bool ED_view3d_distance_set_from_location ( struct RegionView3D rv3d,
const float  dist_co[3],
float  dist_min 
)

Change the distance & offset to match the depth of dist_co along the view axis.

Parameters
dist_coA world-space location to use for the new depth.
dist_minResulting distances below this will be ignored.
Returns
Success if the distance was set.

Definition at line 1271 of file view3d_utils.c.

References RegionView3D::dist, dot_v3v3(), invert_qt_qt_normalized(), madd_v3_v3fl(), mul_qt_v3(), negate_v3_v3(), RegionView3D::ofs, sub_v3_v3v3(), and RegionView3D::viewquat.

◆ ED_view3d_from_m4()

void ED_view3d_from_m4 ( const float  mat[4][4],
float  ofs[3],
float  quat[4],
const float dist 
)

Set the view transformation from a 4x4 matrix.

Parameters
matThe view 4x4 transformation matrix to assign.
ofsThe view offset, normally from RegionView3D.ofs.
quatThe view rotation, quaternion normally from RegionView3D.viewquat.
distThe view distance from ofs, normally from RegionView3D.dist.

Definition at line 1466 of file view3d_utils.c.

References BLI_assert, copy_m3_m4(), invert_qt_normalized(), madd_v3_v3fl(), mat3_normalized_to_quat(), negate_v3_v3(), normalize_m3(), and NULL.

Referenced by ED_view3d_from_object(), and object_apply_mat4_with_protect().

◆ ED_view3d_from_object()

void ED_view3d_from_object ( const Object ob,
float  ofs[3],
float  quat[4],
float dist,
float lens 
)

◆ ED_view3d_has_workbench_in_texture_color()

bool ED_view3d_has_workbench_in_texture_color ( const Scene scene,
const Object ob,
const View3D v3d 
)

◆ ED_view3d_lastview_store()

void ED_view3d_lastview_store ( struct RegionView3D rv3d)

◆ ED_view3d_lock()

bool ED_view3d_lock ( RegionView3D rv3d)

◆ ED_view3d_lock_clear()

void ED_view3d_lock_clear ( View3D v3d)

◆ ED_view3d_lock_view_from_index()

char ED_view3d_lock_view_from_index ( int  index)

◆ ED_view3d_offset_distance()

float ED_view3d_offset_distance ( const float  mat[4][4],
const float  ofs[3],
float  fallback_dist 
)

This function solves the problem of having to switch between camera and non-camera views.

When viewing from the perspective of mat, and having the view center ofs, this calculates a distance from ofs to the matrix mat. Using fallback_dist when the distance would be too small.

Parameters
matA matrix use for the view-point (typically the camera objects matrix).
ofsOrbit center (negated), matching RegionView3D.ofs, which is typically passed in.
fallback_distThe distance to use if the object is too near or in front of ofs.
Returns
A newly calculated distance or the fallback.

Definition at line 1230 of file view3d_utils.c.

References add_v3_v3(), dot_v3v3(), mul_m4_v4(), normalize_v3(), and pos.

Referenced by ED_view3d_camera_lock_init_ex(), ED_view3d_persp_switch_from_camera(), and ED_view3d_smooth_view_ex().

◆ ED_view3d_offset_lock_check()

bool ED_view3d_offset_lock_check ( const View3D v3d,
const RegionView3D rv3d 
)

◆ ED_view3d_persp_ensure()

bool ED_view3d_persp_ensure ( const Depsgraph depsgraph,
View3D v3d,
ARegion region 
)

◆ ED_view3d_persp_switch_from_camera()

void ED_view3d_persp_switch_from_camera ( const Depsgraph depsgraph,
View3D v3d,
RegionView3D rv3d,
const char  persp 
)

◆ ED_view3d_polygon_offset()

void ED_view3d_polygon_offset ( const RegionView3D rv3d,
const float  dist 
)

◆ ED_view3d_quadview_update()

void ED_view3d_quadview_update ( struct ScrArea area,
struct ARegion region,
bool  do_clip 
)

◆ ED_view3d_quat_from_axis_view()

bool ED_view3d_quat_from_axis_view ( const char  view,
const char  view_axis_roll,
float  r_quat[4] 
)

◆ ED_view3d_quat_to_axis_view()

bool ED_view3d_quat_to_axis_view ( const float  quat[4],
const float  epsilon,
char *  r_view,
char *  r_view_axis_roll 
)

◆ ED_view3d_quat_to_axis_view_and_reset_quat()

bool ED_view3d_quat_to_axis_view_and_reset_quat ( float  viewquat[4],
float  epsilon,
char *  r_view,
char *  r_view_axis_rotation 
)

A version of ED_view3d_quat_to_axis_view that updates viewquat if it's within epsilon to an axis-view.

Note
Include the special case function since most callers need to perform these operations.

Definition at line 1407 of file view3d_utils.c.

References BLI_assert, ED_view3d_quat_from_axis_view(), ED_view3d_quat_to_axis_view(), blender::robust_pred::epsilon, and RV3D_VIEW_USER.

Referenced by view_roll_angle(), and viewrotate_apply_snap().

◆ ED_view3d_radius_to_dist()

float ED_view3d_radius_to_dist ( const View3D v3d,
const ARegion region,
const struct Depsgraph depsgraph,
const char  persp,
const bool  use_aspect,
const float  radius 
)

◆ ED_view3d_radius_to_dist_ortho()

float ED_view3d_radius_to_dist_ortho ( const float  lens,
const float  radius 
)

Definition at line 1145 of file view3d_utils.c.

References DEFAULT_SENSOR_WIDTH.

Referenced by ED_view3d_radius_to_dist().

◆ ED_view3d_radius_to_dist_persp()

float ED_view3d_radius_to_dist_persp ( const float  angle,
const float  radius 
)

Definition at line 1140 of file view3d_utils.c.

References angle(), and tanf.

Referenced by ED_view3d_radius_to_dist().

◆ ED_view3d_to_m4()

void ED_view3d_to_m4 ( float  mat[4][4],
const float  ofs[3],
const float  quat[4],
float  dist 
)

Calculate the view transformation matrix from RegionView3D input. The resulting matrix is equivalent to RegionView3D.viewinv

Parameters
matThe view 4x4 transformation matrix to calculate.
ofsThe view offset, normally from RegionView3D.ofs.
quatThe view rotation, quaternion normally from RegionView3D.viewquat.
distThe view distance from ofs, normally from RegionView3D.dist.

Definition at line 1492 of file view3d_utils.c.

References mul_mat3_m4_v3(), quat_to_mat4(), and sub_v3_v3v3().

Referenced by ED_view3d_camera_lock_sync(), ED_view3d_cameracontrol_acquire(), ED_view3d_cameracontrol_update(), and ED_view3d_to_object().

◆ ED_view3d_to_object()

void ED_view3d_to_object ( const Depsgraph depsgraph,
Object ob,
const float  ofs[3],
const float  quat[4],
const float  dist 
)

◆ ED_view3d_viewplane_get()

bool ED_view3d_viewplane_get ( Depsgraph depsgraph,
const View3D v3d,
const RegionView3D rv3d,
int  winx,
int  winy,
rctf r_viewplane,
float r_clip_start,
float r_clip_end,
float r_pixsize 
)

◆ points_in_planes_minmax_fn()

static void points_in_planes_minmax_fn ( const float  co[3],
int   UNUSEDi,
int   UNUSEDj,
int   UNUSEDk,
void user_data_p 
)
static

Definition at line 310 of file view3d_utils.c.

References minmax_v3v3_v3(), and user_data.

Referenced by ED_view3d_clipping_clamp_minmax().

◆ view3d_boundbox_clip_m4()

static bool view3d_boundbox_clip_m4 ( const BoundBox bb,
const float  persmatob[4][4] 
)
static

◆ view3d_boxview_clip()

static void view3d_boxview_clip ( ScrArea area)
static

◆ view3d_boxview_copy()

void view3d_boxview_copy ( struct ScrArea area,
struct ARegion region 
)

◆ view3d_boxview_sync()

void view3d_boxview_sync ( struct ScrArea area,
struct ARegion region 
)

◆ view3d_boxview_sync_axis()

static void view3d_boxview_sync_axis ( RegionView3D rv3d_dst,
RegionView3D rv3d_src 
)
static

Find which axis values are shared between both views and copy to rv3d_dst taking axis flipping into account.

Definition at line 847 of file view3d_utils.c.

References ED_view3d_quat_from_axis_view(), fabsf, invert_qt_normalized(), mul_qt_v3(), RegionView3D::ofs, UNLIKELY, RegionView3D::view, and RegionView3D::view_axis_roll.

Referenced by view3d_boxview_sync().

◆ view3d_camera_lock_undo_ex()

static bool view3d_camera_lock_undo_ex ( const char *  str,
View3D v3d,
RegionView3D rv3d,
struct bContext C,
bool  undo_group 
)
static

Create a MEMFILE undo-step for locked camera movement when transforming the view. Edit and texture paint mode don't use MEMFILE undo so undo push is skipped for them. NDOF and track-pad navigation would create an undo step on every gesture and we may end up with unnecessary undo steps so undo push for them is not supported for now. Also operators that uses smooth view for navigation are excluded too, but they can be supported, see: D15345.

Definition at line 711 of file view3d_utils.c.

References C, ED_undo_grouped_push(), ED_undo_push(), ED_view3d_camera_lock_undo_test(), and str.

Referenced by ED_view3d_camera_lock_undo_grouped_push(), and ED_view3d_camera_lock_undo_push().

◆ view3d_camera_to_view_selected_impl()

static bool view3d_camera_to_view_selected_impl ( struct Main bmain,
Depsgraph depsgraph,
const Scene scene,
Object camera_ob,
float r_clip_start,
float r_clip_end 
)
static

◆ view3d_operator_needs_opengl()

void view3d_operator_needs_opengl ( const bContext C)

◆ view3d_region_operator_needs_opengl()

void view3d_region_operator_needs_opengl ( wmWindow UNUSEDwin,
ARegion region 
)

◆ view_autodist_depth_margin()

static float view_autodist_depth_margin ( ARegion region,
const int  mval[2],
int  margin 
)
static

Variable Documentation

◆ view3d_quat_axis

float view3d_quat_axis[6][4][4]
static

Lookup by axis-view, axis-roll.

Definition at line 1303 of file view3d_utils.c.

Referenced by ED_view3d_quat_from_axis_view(), and ED_view3d_quat_to_axis_view().