e955c94ed3
Listing the "Blender Foundation" as copyright holder implied the Blender Foundation holds copyright to files which may include work from many developers. While keeping copyright on headers makes sense for isolated libraries, Blender's own code may be refactored or moved between files in a way that makes the per file copyright holders less meaningful. Copyright references to the "Blender Foundation" have been replaced with "Blender Authors", with the exception of `./extern/` since these this contains libraries which are more isolated, any changed to license headers there can be handled on a case-by-case basis. Some directories in `./intern/` have also been excluded: - `./intern/cycles/` it's own `AUTHORS` file is planned. - `./intern/opensubdiv/`. An "AUTHORS" file has been added, using the chromium projects authors file as a template. Design task: #110784 Ref !110783.
94 lines
3.7 KiB
C++
94 lines
3.7 KiB
C++
/* SPDX-FileCopyrightText: 2018 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "BLI_sys_types.h"
|
|
|
|
struct Mesh;
|
|
struct OpenSubdiv_EvaluatorCache;
|
|
struct OpenSubdiv_EvaluatorSettings;
|
|
struct Subdiv;
|
|
|
|
enum eSubdivEvaluatorType {
|
|
SUBDIV_EVALUATOR_TYPE_CPU,
|
|
SUBDIV_EVALUATOR_TYPE_GPU,
|
|
};
|
|
|
|
/* Returns true if evaluator is ready for use. */
|
|
bool BKE_subdiv_eval_begin(Subdiv *subdiv,
|
|
eSubdivEvaluatorType evaluator_type,
|
|
OpenSubdiv_EvaluatorCache *evaluator_cache,
|
|
const OpenSubdiv_EvaluatorSettings *settings);
|
|
|
|
/* coarse_vertex_cos is an optional argument which allows to override coordinates of the coarse
|
|
* mesh. */
|
|
bool BKE_subdiv_eval_begin_from_mesh(Subdiv *subdiv,
|
|
const Mesh *mesh,
|
|
const float (*coarse_vertex_cos)[3],
|
|
eSubdivEvaluatorType evaluator_type,
|
|
OpenSubdiv_EvaluatorCache *evaluator_cache);
|
|
bool BKE_subdiv_eval_refine_from_mesh(Subdiv *subdiv,
|
|
const 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(Subdiv *subdiv);
|
|
|
|
/* Single point queries. */
|
|
|
|
/* Evaluate point at a limit surface, with optional derivatives and normal. */
|
|
|
|
void BKE_subdiv_eval_limit_point(
|
|
Subdiv *subdiv, int ptex_face_index, float u, float v, float r_P[3]);
|
|
void BKE_subdiv_eval_limit_point_and_derivatives(Subdiv *subdiv,
|
|
int ptex_face_index,
|
|
float u,
|
|
float v,
|
|
float r_P[3],
|
|
float r_dPdu[3],
|
|
float r_dPdv[3]);
|
|
void BKE_subdiv_eval_limit_point_and_normal(
|
|
Subdiv *subdiv, int ptex_face_index, float u, float v, float r_P[3], float r_N[3]);
|
|
|
|
/* Evaluate smoothly interpolated vertex data (such as ORCO). */
|
|
void BKE_subdiv_eval_vertex_data(Subdiv *subdiv,
|
|
const int ptex_face_index,
|
|
const float u,
|
|
const float v,
|
|
float r_vertex_data[]);
|
|
|
|
/* Evaluate face-varying layer (such as UV). */
|
|
void BKE_subdiv_eval_face_varying(Subdiv *subdiv,
|
|
int face_varying_channel,
|
|
int ptex_face_index,
|
|
float u,
|
|
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(Subdiv *subdiv,
|
|
int ptex_face_index,
|
|
float u,
|
|
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(
|
|
Subdiv *subdiv, int ptex_face_index, float u, float v, float r_P[3]);
|