bartvdbraak/blender
1
0
Fork 4
Code Issues 4 Pull Requests 1 Actions 1 Packages Projects Releases Wiki Activity

Subdiv: Clarify Subdiv settings

Browse Source 
The actual naming might also be a subject to change, especially the one
around `level`. Tricky part here is that at some point in the API there
will be change from Blender modifier's Quality to OpenSubdiv's Level,
but which API level is most suitable for this?

At least now meaning of settings is better documented ans should be
clear what's going on.
This commit is contained in:
Sergey Sharybin 2020-02-18 17:23:52 +01:00
parent 02f44049a8
commit 3b01dbdeb1
1 changed files with 23 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
source/blender/blenkernel/BKE_subdiv.h
View File

@ -53,10 +53,33 @@ typedef enum eSubdivFVarLinearInterpolation {
} eSubdivFVarLinearInterpolation;
typedef struct SubdivSettings {
/* Simple subdivision corresponds to "Simple" option in the interface. When its enabled the
* subdivided mesh is not "smoothed": new vertices are added uniformly on the existing surface.
*
* On an OpenSubdiv implementation level this translates to a subdivision scheme:
* when is_simple is true OSD_SCHEME_BILINEAR is used, otherwise OSD_SCHEME_CATMARK. */
bool is_simple;
/* This refers to an adaptive isolation when creating patches for the subdivided surface.
*
* When is set to to false (aka uniform subdivision) fixed depth of isolation is used, which
* allows to iteratively add more subdivisions (uniform subdivision level 2 = uniform subdivision
* level 1 + uniform subdivision level 1). Uniform subdivisions will progressively go to a limit
* surface.
*
* Adaptive isolation generates patches at a limit surface (aka as if infinite number of uniform
* subdivisions have been applied). This setting allows to have matches normal and tangent space
* the same independent of number of subdivisions set in modifier settings. */
bool is_adaptive;
/* Corresponds to Quality option in modifier settings: higher values means the final surface
* will be more accurately represented by patches.
*
* On an OpenSubdiv implementation level this is an isolation level. */
int level;
bool use_creases;
eSubdivVtxBoundaryInterpolation vtx_boundary_interpolation;
eSubdivFVarLinearInterpolation fvar_linear_interpolation;
} SubdivSettings;