Allows to perform correction of coordinate delta/displacement in a
similar way of how sculpt mode handles sculpting on a deformed mesh.
An example of usecase of this is allowing riggers and sciprters to
improve corrective shapekey workflow.
The usage consists of pre-processing and access. For example:
object.crazyspace_eval(depsgraph, scene)
# When we have a difference between two vertices and want to convert
# it to a space to be stored, say, in shapekey:
delta_in_orig_space = rigged_ob.crazyspace_displacement_to_original(
vertex_index=i, displacement=delta)
# The reverse of above.
delta_in_deformed_space = rigged_ob.crazyspace_displacement_to_deformed(
vertex_index=i, displacement=delta)
object.crazyspace_eval_clear()
Fuller explanation with actual usecases and studio examples are written in
the comment:
https://developer.blender.org/D13892#368898
Differential Revision: https://developer.blender.org/D13892
102 lines
4.0 KiB
C++
102 lines
4.0 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) 2008 Blender Foundation.
|
|
* All rights reserved.
|
|
*/
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct BMEditMesh;
|
|
struct Depsgraph;
|
|
struct Mesh;
|
|
struct Object;
|
|
struct ReportList;
|
|
struct Scene;
|
|
|
|
/* crazyspace.c */
|
|
|
|
/**
|
|
* Disable subdivision-surface temporal, get mapped coordinates, and enable it.
|
|
*/
|
|
float (*BKE_crazyspace_get_mapped_editverts(struct Depsgraph *depsgraph,
|
|
struct Object *obedit))[3];
|
|
void BKE_crazyspace_set_quats_editmesh(struct BMEditMesh *em,
|
|
float (*origcos)[3],
|
|
float (*mappedcos)[3],
|
|
float (*quats)[4],
|
|
bool use_select);
|
|
void BKE_crazyspace_set_quats_mesh(struct Mesh *me,
|
|
float (*origcos)[3],
|
|
float (*mappedcos)[3],
|
|
float (*quats)[4]);
|
|
/**
|
|
* Returns an array of deform matrices for crazy-space correction,
|
|
* and the number of modifiers left.
|
|
*/
|
|
int BKE_crazyspace_get_first_deform_matrices_editbmesh(struct Depsgraph *depsgraph,
|
|
struct Scene *,
|
|
struct Object *,
|
|
struct BMEditMesh *em,
|
|
float (**deformmats)[3][3],
|
|
float (**deformcos)[3]);
|
|
int BKE_sculpt_get_first_deform_matrices(struct Depsgraph *depsgraph,
|
|
struct Scene *scene,
|
|
struct Object *ob,
|
|
float (**deformmats)[3][3],
|
|
float (**deformcos)[3]);
|
|
void BKE_crazyspace_build_sculpt(struct Depsgraph *depsgraph,
|
|
struct Scene *scene,
|
|
struct Object *ob,
|
|
float (**deformmats)[3][3],
|
|
float (**deformcos)[3]);
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Crazyspace API
|
|
* \{ */
|
|
|
|
void BKE_crazyspace_api_eval(struct Depsgraph *depsgraph,
|
|
struct Scene *scene,
|
|
struct Object *object,
|
|
struct ReportList *reports);
|
|
|
|
void BKE_crazyspace_api_displacement_to_deformed(struct Object *object,
|
|
struct ReportList *reports,
|
|
int vertex_index,
|
|
float displacement[3],
|
|
float r_displacement_deformed[3]);
|
|
|
|
void BKE_crazyspace_api_displacement_to_original(struct Object *object,
|
|
struct ReportList *reports,
|
|
int vertex_index,
|
|
float displacement_deformed[3],
|
|
float r_displacement[3]);
|
|
|
|
void BKE_crazyspace_api_eval_clear(struct Object *object);
|
|
|
|
/** \} */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|