Kévin Dietrich
eed45d2a23
This evaluator is used in order to evaluate subdivision at render time, allowing for faster renders of meshes with a subdivision surface modifier placed at the last position in the modifier list. When evaluating the subsurf modifier, we detect whether we can delegate evaluation to the draw code. If so, the subdivision is first evaluated on the GPU using our own custom evaluator (only the coarse data needs to be initially sent to the GPU), then, buffers for the final `MeshBufferCache` are filled on the GPU using a set of compute shaders. However, some buffers are still filled on the CPU side, if doing so on the GPU is impractical (e.g. the line adjacency buffer used for x-ray, whose logic is hardly GPU compatible). This is done at the mesh buffer extraction level so that the result can be readily used in the various OpenGL engines, without having to write custom geometry or tesselation shaders. We use our own subdivision evaluation shaders, instead of OpenSubDiv's vanilla one, in order to control the data layout, and interpolation. For example, we store vertex colors as compressed 16-bit integers, while OpenSubDiv's default evaluator only work for float types. In order to still access the modified geometry on the CPU side, for use in modifiers or transform operators, a dedicated wrapper type is added `MESH_WRAPPER_TYPE_SUBD`. Subdivision will be lazily evaluated via `BKE_object_get_evaluated_mesh` which will create such a wrapper if possible. If the final subdivision surface is not needed on the CPU side, `BKE_object_get_evaluated_mesh_no_subsurf` should be used. Enabling or disabling GPU subdivision can be done through the user preferences (under Viewport -> Subdivision). See patch description for benchmarks. Reviewed By: campbellbarton, jbakker, fclem, brecht, #eevee_viewport Differential Revision: https://developer.blender.org/D12406
161 lines
8.1 KiB
C++
161 lines
8.1 KiB
C++
/*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*
|
|
* The Original Code is Copyright (C) 2018 by Blender Foundation.
|
|
* All rights reserved.
|
|
*/
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "BLI_sys_types.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct Mesh;
|
|
struct Subdiv;
|
|
struct OpenSubdiv_EvaluatorCache;
|
|
|
|
typedef enum eSubdivEvaluatorType {
|
|
SUBDIV_EVALUATOR_TYPE_CPU,
|
|
SUBDIV_EVALUATOR_TYPE_GLSL_COMPUTE,
|
|
} eSubdivEvaluatorType;
|
|
|
|
/* Returns true if evaluator is ready for use. */
|
|
bool BKE_subdiv_eval_begin(struct Subdiv *subdiv,
|
|
eSubdivEvaluatorType evaluator_type,
|
|
struct OpenSubdiv_EvaluatorCache *evaluator_cache);
|
|
|
|
/* coarse_vertex_cos is an optional argument which allows to override coordinates of the coarse
|
|
* mesh. */
|
|
bool BKE_subdiv_eval_begin_from_mesh(struct Subdiv *subdiv,
|
|
const struct Mesh *mesh,
|
|
const float (*coarse_vertex_cos)[3],
|
|
eSubdivEvaluatorType evaluator_type,
|
|
struct OpenSubdiv_EvaluatorCache *evaluator_cache);
|
|
bool BKE_subdiv_eval_refine_from_mesh(struct Subdiv *subdiv,
|
|
const struct Mesh *mesh,
|
|
const float (*coarse_vertex_cos)[3]);
|
|
|
|
/* Makes sure displacement evaluator is initialized.
|
|
*
|
|
* NOTE: This function must be called once before evaluating displacement or
|
|
* final surface position. */
|
|
void BKE_subdiv_eval_init_displacement(struct Subdiv *subdiv);
|
|
|
|
/* Single point queries. */
|
|
|
|
/* Evaluate point at a limit surface, with optional derivatives and normal. */
|
|
|
|
void BKE_subdiv_eval_limit_point(
|
|
struct Subdiv *subdiv, const int ptex_face_index, const float u, const float v, float r_P[3]);
|
|
void BKE_subdiv_eval_limit_point_and_derivatives(struct Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const float u,
|
|
const float v,
|
|
float r_P[3],
|
|
float r_dPdu[3],
|
|
float r_dPdv[3]);
|
|
void BKE_subdiv_eval_limit_point_and_normal(struct Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const float u,
|
|
const float v,
|
|
float r_P[3],
|
|
float r_N[3]);
|
|
void BKE_subdiv_eval_limit_point_and_short_normal(struct Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const float u,
|
|
const float v,
|
|
float r_P[3],
|
|
short r_N[3]);
|
|
|
|
/* Evaluate face-varying layer (such as UV). */
|
|
void BKE_subdiv_eval_face_varying(struct Subdiv *subdiv,
|
|
const int face_varying_channel,
|
|
const int ptex_face_index,
|
|
const float u,
|
|
const float v,
|
|
float r_face_varying[2]);
|
|
|
|
/* NOTE: Expects derivatives to be correct.
|
|
*
|
|
* TODO(sergey): This is currently used together with
|
|
* BKE_subdiv_eval_final_point() which can easily evaluate derivatives.
|
|
* Would be nice to have displacement evaluation function which does not require
|
|
* knowing derivatives ahead of a time. */
|
|
void BKE_subdiv_eval_displacement(struct Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const float u,
|
|
const float v,
|
|
const float dPdu[3],
|
|
const float dPdv[3],
|
|
float r_D[3]);
|
|
|
|
/* Evaluate point on a limit surface with displacement applied to it. */
|
|
void BKE_subdiv_eval_final_point(
|
|
struct Subdiv *subdiv, const int ptex_face_index, const float u, const float v, float r_P[3]);
|
|
|
|
/* Patch queries at given resolution.
|
|
*
|
|
* Will evaluate patch at uniformly distributed (u, v) coordinates on a grid
|
|
* of given resolution, producing resolution^2 evaluation points. The order
|
|
* goes as u in rows, v in columns. */
|
|
|
|
void BKE_subdiv_eval_limit_patch_resolution_point(struct Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const int resolution,
|
|
void *buffer,
|
|
const int offset,
|
|
const int stride);
|
|
void BKE_subdiv_eval_limit_patch_resolution_point_and_derivatives(struct Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const int resolution,
|
|
void *point_buffer,
|
|
const int point_offset,
|
|
const int point_stride,
|
|
void *du_buffer,
|
|
const int du_offset,
|
|
const int du_stride,
|
|
void *dv_buffer,
|
|
const int dv_offset,
|
|
const int dv_stride);
|
|
void BKE_subdiv_eval_limit_patch_resolution_point_and_normal(struct Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const int resolution,
|
|
void *point_buffer,
|
|
const int point_offset,
|
|
const int point_stride,
|
|
void *normal_buffer,
|
|
const int normal_offset,
|
|
const int normal_stride);
|
|
void BKE_subdiv_eval_limit_patch_resolution_point_and_short_normal(struct Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const int resolution,
|
|
void *point_buffer,
|
|
const int point_offset,
|
|
const int point_stride,
|
|
void *normal_buffer,
|
|
const int normal_offset,
|
|
const int normal_stride);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|