Motivation is to disambiguate on the naming level what the matrix actually means. It is very easy to understand the meaning backwards, especially since in Python the name goes the opposite way (it is called `world_matrix` in the Python API). It is important to disambiguate the naming without making developers to look into the comment in the header file (which is also not super clear either). Additionally, more clear naming facilitates the unit verification (or, in this case, space validation) when reading an expression. This patch calls the matrix `object_to_world` which makes it clear from the local code what is it exactly going on. This is only done on DNA level, and a lot of local variables still follow the old naming. A DNA rename is setup in a way that there is no change on the file level, so there should be no regressions at all. The possibility is to add `_matrix` or `_mat` suffix to the name to make it explicit that it is a matrix. Although, not sure if it really helps the readability, or is it something redundant. Differential Revision: https://developer.blender.org/D16328
339 lines
10 KiB
C++
339 lines
10 KiB
C++
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup modifiers
|
|
*/
|
|
|
|
#include <cstring>
|
|
|
|
#include "BLI_utildefines.h"
|
|
|
|
#include "BLI_math.h"
|
|
#include "BLI_task.h"
|
|
|
|
#include "BLT_translation.h"
|
|
|
|
#include "DNA_defaults.h"
|
|
#include "DNA_mesh_types.h"
|
|
#include "DNA_meshdata_types.h"
|
|
#include "DNA_object_types.h"
|
|
#include "DNA_screen_types.h"
|
|
|
|
#include "BKE_action.h" /* BKE_pose_channel_find_name */
|
|
#include "BKE_context.h"
|
|
#include "BKE_deform.h"
|
|
#include "BKE_lib_query.h"
|
|
#include "BKE_mesh.h"
|
|
#include "BKE_modifier.h"
|
|
#include "BKE_screen.h"
|
|
|
|
#include "UI_interface.h"
|
|
#include "UI_resources.h"
|
|
|
|
#include "RNA_access.h"
|
|
#include "RNA_prototypes.h"
|
|
|
|
#include "DEG_depsgraph_query.h"
|
|
|
|
#include "MOD_ui_common.h"
|
|
#include "MOD_util.h"
|
|
|
|
static void uv_warp_from_mat4_pair(float uv_dst[2],
|
|
const float uv_src[2],
|
|
const float warp_mat[4][4])
|
|
{
|
|
float tuv[3] = {0.0f};
|
|
|
|
copy_v2_v2(tuv, uv_src);
|
|
mul_m4_v3(warp_mat, tuv);
|
|
copy_v2_v2(uv_dst, tuv);
|
|
}
|
|
|
|
static void initData(ModifierData *md)
|
|
{
|
|
UVWarpModifierData *umd = (UVWarpModifierData *)md;
|
|
|
|
BLI_assert(MEMCMP_STRUCT_AFTER_IS_ZERO(umd, modifier));
|
|
|
|
MEMCPY_STRUCT_AFTER(umd, DNA_struct_default_get(UVWarpModifierData), modifier);
|
|
}
|
|
|
|
static void requiredDataMask(ModifierData *md, CustomData_MeshMasks *r_cddata_masks)
|
|
{
|
|
UVWarpModifierData *umd = (UVWarpModifierData *)md;
|
|
|
|
/* ask for vertexgroups if we need them */
|
|
if (umd->vgroup_name[0] != '\0') {
|
|
r_cddata_masks->vmask |= CD_MASK_MDEFORMVERT;
|
|
}
|
|
}
|
|
|
|
static void matrix_from_obj_pchan(float mat[4][4], Object *ob, const char *bonename)
|
|
{
|
|
bPoseChannel *pchan = BKE_pose_channel_find_name(ob->pose, bonename);
|
|
if (pchan) {
|
|
mul_m4_m4m4(mat, ob->object_to_world, pchan->pose_mat);
|
|
}
|
|
else {
|
|
copy_m4_m4(mat, ob->object_to_world);
|
|
}
|
|
}
|
|
|
|
struct UVWarpData {
|
|
const MPoly *mpoly;
|
|
const MLoop *mloop;
|
|
MLoopUV *mloopuv;
|
|
|
|
const MDeformVert *dvert;
|
|
int defgrp_index;
|
|
|
|
float (*warp_mat)[4];
|
|
bool invert_vgroup;
|
|
};
|
|
|
|
static void uv_warp_compute(void *__restrict userdata,
|
|
const int i,
|
|
const TaskParallelTLS *__restrict /*tls*/)
|
|
{
|
|
const UVWarpData *data = static_cast<const UVWarpData *>(userdata);
|
|
|
|
const MPoly *mp = &data->mpoly[i];
|
|
const MLoop *ml = &data->mloop[mp->loopstart];
|
|
MLoopUV *mluv = &data->mloopuv[mp->loopstart];
|
|
|
|
const MDeformVert *dvert = data->dvert;
|
|
const int defgrp_index = data->defgrp_index;
|
|
|
|
float(*warp_mat)[4] = data->warp_mat;
|
|
|
|
int l;
|
|
|
|
if (dvert) {
|
|
for (l = 0; l < mp->totloop; l++, ml++, mluv++) {
|
|
float uv[2];
|
|
const float weight = data->invert_vgroup ?
|
|
1.0f - BKE_defvert_find_weight(&dvert[ml->v], defgrp_index) :
|
|
BKE_defvert_find_weight(&dvert[ml->v], defgrp_index);
|
|
|
|
uv_warp_from_mat4_pair(uv, mluv->uv, warp_mat);
|
|
interp_v2_v2v2(mluv->uv, mluv->uv, uv, weight);
|
|
}
|
|
}
|
|
else {
|
|
for (l = 0; l < mp->totloop; l++, ml++, mluv++) {
|
|
uv_warp_from_mat4_pair(mluv->uv, mluv->uv, warp_mat);
|
|
}
|
|
}
|
|
}
|
|
|
|
static Mesh *modifyMesh(ModifierData *md, const ModifierEvalContext *ctx, Mesh *mesh)
|
|
{
|
|
UVWarpModifierData *umd = (UVWarpModifierData *)md;
|
|
int polys_num, loops_num;
|
|
const MDeformVert *dvert;
|
|
int defgrp_index;
|
|
char uvname[MAX_CUSTOMDATA_LAYER_NAME];
|
|
float warp_mat[4][4];
|
|
const int axis_u = umd->axis_u;
|
|
const int axis_v = umd->axis_v;
|
|
const bool invert_vgroup = (umd->flag & MOD_UVWARP_INVERT_VGROUP) != 0;
|
|
|
|
/* make sure there are UV Maps available */
|
|
if (!CustomData_has_layer(&mesh->ldata, CD_MLOOPUV)) {
|
|
return mesh;
|
|
}
|
|
|
|
if (!ELEM(nullptr, umd->object_src, umd->object_dst)) {
|
|
float mat_src[4][4];
|
|
float mat_dst[4][4];
|
|
float imat_dst[4][4];
|
|
float shuf_mat[4][4];
|
|
|
|
/* make sure anything moving UVs is available */
|
|
matrix_from_obj_pchan(mat_src, umd->object_src, umd->bone_src);
|
|
matrix_from_obj_pchan(mat_dst, umd->object_dst, umd->bone_dst);
|
|
|
|
invert_m4_m4(imat_dst, mat_dst);
|
|
mul_m4_m4m4(warp_mat, imat_dst, mat_src);
|
|
|
|
/* apply warp */
|
|
if (!is_zero_v2(umd->center)) {
|
|
float mat_cent[4][4];
|
|
float imat_cent[4][4];
|
|
|
|
unit_m4(mat_cent);
|
|
mat_cent[3][axis_u] = umd->center[0];
|
|
mat_cent[3][axis_v] = umd->center[1];
|
|
|
|
invert_m4_m4(imat_cent, mat_cent);
|
|
|
|
mul_m4_m4m4(warp_mat, warp_mat, imat_cent);
|
|
mul_m4_m4m4(warp_mat, mat_cent, warp_mat);
|
|
}
|
|
|
|
const int shuf_indices[4] = {axis_u, axis_v, -1, 3};
|
|
shuffle_m4(shuf_mat, shuf_indices);
|
|
mul_m4_m4m4(warp_mat, shuf_mat, warp_mat);
|
|
transpose_m4(shuf_mat);
|
|
mul_m4_m4m4(warp_mat, warp_mat, shuf_mat);
|
|
}
|
|
else {
|
|
unit_m4(warp_mat);
|
|
}
|
|
|
|
/* Apply direct 2d transform. */
|
|
translate_m4(warp_mat, umd->center[0], umd->center[1], 0.0f);
|
|
const float scale[3] = {umd->scale[0], umd->scale[1], 1.0f};
|
|
rescale_m4(warp_mat, scale);
|
|
rotate_m4(warp_mat, 'Z', umd->rotation);
|
|
translate_m4(warp_mat, umd->offset[0], umd->offset[1], 0.0f);
|
|
translate_m4(warp_mat, -umd->center[0], -umd->center[1], 0.0f);
|
|
|
|
/* make sure we're using an existing layer */
|
|
CustomData_validate_layer_name(&mesh->ldata, CD_MLOOPUV, umd->uvlayer_name, uvname);
|
|
|
|
const MPoly *polys = BKE_mesh_polys(mesh);
|
|
const MLoop *loops = BKE_mesh_loops(mesh);
|
|
polys_num = mesh->totpoly;
|
|
loops_num = mesh->totloop;
|
|
|
|
/* make sure we are not modifying the original UV map */
|
|
MLoopUV *mloopuv = static_cast<MLoopUV *>(
|
|
CustomData_duplicate_referenced_layer_named(&mesh->ldata, CD_MLOOPUV, uvname, loops_num));
|
|
MOD_get_vgroup(ctx->object, mesh, umd->vgroup_name, &dvert, &defgrp_index);
|
|
|
|
UVWarpData data{};
|
|
data.mpoly = polys;
|
|
data.mloop = loops;
|
|
data.mloopuv = mloopuv;
|
|
data.dvert = dvert;
|
|
data.defgrp_index = defgrp_index;
|
|
data.warp_mat = warp_mat;
|
|
data.invert_vgroup = invert_vgroup;
|
|
|
|
TaskParallelSettings settings;
|
|
BLI_parallel_range_settings_defaults(&settings);
|
|
settings.use_threading = (polys_num > 1000);
|
|
BLI_task_parallel_range(0, polys_num, &data, uv_warp_compute, &settings);
|
|
|
|
mesh->runtime->is_original_bmesh = false;
|
|
|
|
return mesh;
|
|
}
|
|
|
|
static void foreachIDLink(ModifierData *md, Object *ob, IDWalkFunc walk, void *userData)
|
|
{
|
|
UVWarpModifierData *umd = (UVWarpModifierData *)md;
|
|
|
|
walk(userData, ob, (ID **)&umd->object_dst, IDWALK_CB_NOP);
|
|
walk(userData, ob, (ID **)&umd->object_src, IDWALK_CB_NOP);
|
|
}
|
|
|
|
static void updateDepsgraph(ModifierData *md, const ModifierUpdateDepsgraphContext *ctx)
|
|
{
|
|
UVWarpModifierData *umd = (UVWarpModifierData *)md;
|
|
|
|
MOD_depsgraph_update_object_bone_relation(
|
|
ctx->node, umd->object_src, umd->bone_src, "UVWarp Modifier");
|
|
MOD_depsgraph_update_object_bone_relation(
|
|
ctx->node, umd->object_dst, umd->bone_dst, "UVWarp Modifier");
|
|
|
|
DEG_add_depends_on_transform_relation(ctx->node, "UVWarp Modifier");
|
|
}
|
|
|
|
static void panel_draw(const bContext * /*C*/, Panel *panel)
|
|
{
|
|
uiLayout *col;
|
|
uiLayout *layout = panel->layout;
|
|
|
|
PointerRNA ob_ptr;
|
|
PointerRNA *ptr = modifier_panel_get_property_pointers(panel, &ob_ptr);
|
|
|
|
PointerRNA warp_obj_ptr;
|
|
PointerRNA obj_data_ptr = RNA_pointer_get(&ob_ptr, "data");
|
|
|
|
uiLayoutSetPropSep(layout, true);
|
|
|
|
uiItemPointerR(layout, ptr, "uv_layer", &obj_data_ptr, "uv_layers", nullptr, ICON_NONE);
|
|
|
|
col = uiLayoutColumn(layout, false);
|
|
uiItemR(col, ptr, "center", 0, nullptr, ICON_NONE);
|
|
|
|
col = uiLayoutColumn(layout, false);
|
|
uiItemR(col, ptr, "axis_u", 0, IFACE_("Axis U"), ICON_NONE);
|
|
uiItemR(col, ptr, "axis_v", 0, IFACE_("V"), ICON_NONE);
|
|
|
|
col = uiLayoutColumn(layout, false);
|
|
uiItemR(col, ptr, "object_from", 0, nullptr, ICON_NONE);
|
|
warp_obj_ptr = RNA_pointer_get(ptr, "object_from");
|
|
if (!RNA_pointer_is_null(&warp_obj_ptr) && RNA_enum_get(&warp_obj_ptr, "type") == OB_ARMATURE) {
|
|
PointerRNA warp_obj_data_ptr = RNA_pointer_get(&warp_obj_ptr, "data");
|
|
uiItemPointerR(col, ptr, "bone_from", &warp_obj_data_ptr, "bones", nullptr, ICON_NONE);
|
|
}
|
|
|
|
uiItemR(col, ptr, "object_to", 0, IFACE_("To"), ICON_NONE);
|
|
warp_obj_ptr = RNA_pointer_get(ptr, "object_to");
|
|
if (!RNA_pointer_is_null(&warp_obj_ptr) && RNA_enum_get(&warp_obj_ptr, "type") == OB_ARMATURE) {
|
|
PointerRNA warp_obj_data_ptr = RNA_pointer_get(&warp_obj_ptr, "data");
|
|
uiItemPointerR(col, ptr, "bone_to", &warp_obj_data_ptr, "bones", nullptr, ICON_NONE);
|
|
}
|
|
|
|
modifier_vgroup_ui(layout, ptr, &ob_ptr, "vertex_group", "invert_vertex_group", nullptr);
|
|
|
|
modifier_panel_end(layout, ptr);
|
|
}
|
|
|
|
static void transform_panel_draw(const bContext * /*C*/, Panel *panel)
|
|
{
|
|
uiLayout *layout = panel->layout;
|
|
|
|
PointerRNA *ptr = modifier_panel_get_property_pointers(panel, nullptr);
|
|
|
|
uiLayoutSetPropSep(layout, true);
|
|
|
|
uiItemR(layout, ptr, "offset", 0, nullptr, ICON_NONE);
|
|
uiItemR(layout, ptr, "scale", 0, nullptr, ICON_NONE);
|
|
uiItemR(layout, ptr, "rotation", 0, nullptr, ICON_NONE);
|
|
}
|
|
|
|
static void panelRegister(ARegionType *region_type)
|
|
{
|
|
PanelType *panel_type = modifier_panel_register(region_type, eModifierType_UVWarp, panel_draw);
|
|
modifier_subpanel_register(
|
|
region_type, "offset", "Transform", nullptr, transform_panel_draw, panel_type);
|
|
}
|
|
|
|
ModifierTypeInfo modifierType_UVWarp = {
|
|
/* name */ N_("UVWarp"),
|
|
/* structName */ "UVWarpModifierData",
|
|
/* structSize */ sizeof(UVWarpModifierData),
|
|
/* srna */ &RNA_UVWarpModifier,
|
|
/* type */ eModifierTypeType_NonGeometrical,
|
|
/* flags */ eModifierTypeFlag_AcceptsMesh | eModifierTypeFlag_SupportsEditmode |
|
|
eModifierTypeFlag_EnableInEditmode,
|
|
/* icon */ ICON_MOD_UVPROJECT, /* TODO: Use correct icon. */
|
|
|
|
/* copyData */ BKE_modifier_copydata_generic,
|
|
|
|
/* deformVerts */ nullptr,
|
|
/* deformMatrices */ nullptr,
|
|
/* deformVertsEM */ nullptr,
|
|
/* deformMatricesEM */ nullptr,
|
|
/* modifyMesh */ modifyMesh,
|
|
/* modifyGeometrySet */ nullptr,
|
|
|
|
/* initData */ initData,
|
|
/* requiredDataMask */ requiredDataMask,
|
|
/* freeData */ nullptr,
|
|
/* isDisabled */ nullptr,
|
|
/* updateDepsgraph */ updateDepsgraph,
|
|
/* dependsOnTime */ nullptr,
|
|
/* dependsOnNormals */ nullptr,
|
|
/* foreachIDLink */ foreachIDLink,
|
|
/* foreachTexLink */ nullptr,
|
|
/* freeRuntimeData */ nullptr,
|
|
/* panelRegister */ panelRegister,
|
|
/* blendWrite */ nullptr,
|
|
/* blendRead */ nullptr,
|
|
};
|