[Bf-blender-cvs] [c7651be1e19] master: Multires: Cleanup, clarify comments

[Sergey Sharybin]

Commit: c7651be1e1983af2b7273793028d70a43886dcca
Author: Sergey Sharybin
Date:   Tue May 12 15:23:58 2020 +0200
Branches: master
https://developer.blender.org/rBc7651be1e1983af2b7273793028d70a43886dcca

Multires: Cleanup, clarify comments

===================================================================

M	source/blender/blenkernel/intern/multires_reshape.h
M	source/blender/blenkernel/intern/multires_reshape_smooth.c

===================================================================

diff --git a/source/blender/blenkernel/intern/multires_reshape.h b/source/blender/blenkernel/intern/multires_reshape.h
index 1c86a56d468..8eb90809c31 100644
--- a/source/blender/blenkernel/intern/multires_reshape.h
+++ b/source/blender/blenkernel/intern/multires_reshape.h
@@ -256,7 +256,11 @@ bool multires_reshape_assign_final_coords_from_vertcos(
  * Functions specific to reshaping from CCG.
  */
 
-/* NOTE: Displacement grids to be at least at a reshape level.
+/* Store final object-space coordinates in the displacement grids.
+ * The reason why displacement grids are used for storage is based on memory
+ * footprint optimization.
+ *
+ * NOTE: Displacement grids to be at least at a reshape level.
  *
  * Return truth if all coordinates have been updated. */
 bool multires_reshape_assign_final_coords_from_ccg(const MultiresReshapeContext *reshape_context,
diff --git a/source/blender/blenkernel/intern/multires_reshape_smooth.c b/source/blender/blenkernel/intern/multires_reshape_smooth.c
index c1a03e19335..2ab0a9c1e7f 100644
--- a/source/blender/blenkernel/intern/multires_reshape_smooth.c
+++ b/source/blender/blenkernel/intern/multires_reshape_smooth.c
@@ -118,6 +118,8 @@ typedef struct MultiresReshapeSmoothContext {
   /* Subdivision surface created for geometry at a reshape level. */
   Subdiv *reshape_subdiv;
 
+  /* Grids allocated at the top level storing state of the base mesh,
+   * Basically, lower memory footprint version of the base mesh limit surface. */
   SurfaceGrid *base_surface_grids;
 
   /* Defines how displacement is interpolated on the higher levels (for example, whether