diff options
author | Campbell Barton <ideasman42@gmail.com> | 2015-08-18 00:10:01 +0300 |
---|---|---|
committer | Campbell Barton <ideasman42@gmail.com> | 2015-08-18 00:11:55 +0300 |
commit | ac62d44e4f570173d2094612c31615b5ff4acc7f (patch) | |
tree | b2f6aabe2890b9f5a70e72e6129e2d1906dfe621 | |
parent | 2e2dc9b9e32d104a0f7c3241ea0c11b57a37fd5b (diff) |
Docs: function comments
-rw-r--r-- | doc/doxygen/doxygen.source.h | 4 | ||||
-rw-r--r-- | source/blender/editors/space_view3d/view3d_edit.c | 13 |
2 files changed, 16 insertions, 1 deletions
diff --git a/doc/doxygen/doxygen.source.h b/doc/doxygen/doxygen.source.h index 1a77a374009..3ef20466664 100644 --- a/doc/doxygen/doxygen.source.h +++ b/doc/doxygen/doxygen.source.h @@ -94,6 +94,10 @@ /** \defgroup blender Blender */ +/** \defgroup blt BlenTranslation + * \ingroup blender + */ + /** \defgroup blf BlenFont * \ingroup blender */ diff --git a/source/blender/editors/space_view3d/view3d_edit.c b/source/blender/editors/space_view3d/view3d_edit.c index d38de4a426e..8d7596afc51 100644 --- a/source/blender/editors/space_view3d/view3d_edit.c +++ b/source/blender/editors/space_view3d/view3d_edit.c @@ -100,6 +100,9 @@ static bool view3d_operator_offset_lock_check(bContext *C, wmOperator *op) /* ********************** view3d_edit: view manipulations ********************* */ +/** + * \return true when the view-port is locked to its camera. + */ bool ED_view3d_camera_lock_check(const View3D *v3d, const RegionView3D *rv3d) { return ((v3d->camera) && @@ -108,6 +111,10 @@ bool ED_view3d_camera_lock_check(const View3D *v3d, const RegionView3D *rv3d) (rv3d->persp == RV3D_CAMOB)); } +/** + * Apply the camera object transformation to the view-port. + * (needed so we can use regular view-port manipulation operators, that sync back to the camera). + */ void ED_view3d_camera_lock_init_ex(View3D *v3d, RegionView3D *rv3d, const bool calc_dist) { if (ED_view3d_camera_lock_check(v3d, rv3d)) { @@ -124,7 +131,11 @@ void ED_view3d_camera_lock_init(View3D *v3d, RegionView3D *rv3d) ED_view3d_camera_lock_init_ex(v3d, rv3d, true); } -/* return true if the camera is moved */ +/** + * Apply the view-port transformation back to the camera object. + * + * \return true if the camera is moved. + */ bool ED_view3d_camera_lock_sync(View3D *v3d, RegionView3D *rv3d) { if (ED_view3d_camera_lock_check(v3d, rv3d)) { |