Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
/*
|
|
|
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
|
|
|
*
|
|
|
|
* 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) 2014 Blender Foundation.
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* The Original Code is: all of this file.
|
|
|
|
*
|
|
|
|
* Contributor(s): Bastien Montagne
|
|
|
|
*
|
|
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
|
|
*/
|
|
|
|
|
2015-01-12 12:03:28 +01:00
|
|
|
/** \file blender/blenkernel/BKE_data_transfer.h
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
* \ingroup bke
|
|
|
|
*/
|
|
|
|
|
2015-01-14 13:53:03 +01:00
|
|
|
#ifndef __BKE_DATA_TRANSFER_H__
|
|
|
|
#define __BKE_DATA_TRANSFER_H__
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#include "BKE_customdata.h"
|
|
|
|
|
2018-04-06 12:07:27 +02:00
|
|
|
struct Depsgraph;
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
struct Object;
|
|
|
|
struct Scene;
|
|
|
|
struct SpaceTransform;
|
|
|
|
struct ReportList;
|
|
|
|
|
|
|
|
/* Warning, those def are stored in files (TransferData modifier), *DO NOT* modify those values. */
|
|
|
|
enum {
|
|
|
|
DT_TYPE_MDEFORMVERT = 1 << 0,
|
|
|
|
DT_TYPE_SHAPEKEY = 1 << 1,
|
|
|
|
DT_TYPE_SKIN = 1 << 2,
|
|
|
|
DT_TYPE_BWEIGHT_VERT = 1 << 3,
|
|
|
|
|
|
|
|
DT_TYPE_SHARP_EDGE = 1 << 8,
|
|
|
|
DT_TYPE_SEAM = 1 << 9,
|
|
|
|
DT_TYPE_CREASE = 1 << 10,
|
|
|
|
DT_TYPE_BWEIGHT_EDGE = 1 << 11,
|
|
|
|
DT_TYPE_FREESTYLE_EDGE = 1 << 12,
|
|
|
|
|
|
|
|
DT_TYPE_VCOL = 1 << 16,
|
2015-02-05 14:38:59 +01:00
|
|
|
DT_TYPE_LNOR = 1 << 17,
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
|
|
|
|
DT_TYPE_UV = 1 << 24,
|
|
|
|
DT_TYPE_SHARP_FACE = 1 << 25,
|
|
|
|
DT_TYPE_FREESTYLE_FACE = 1 << 26,
|
|
|
|
#define \
|
|
|
|
DT_TYPE_MAX 27
|
|
|
|
|
|
|
|
DT_TYPE_VERT_ALL = DT_TYPE_MDEFORMVERT | DT_TYPE_SHAPEKEY | DT_TYPE_SKIN | DT_TYPE_BWEIGHT_VERT,
|
|
|
|
DT_TYPE_EDGE_ALL = DT_TYPE_SHARP_EDGE | DT_TYPE_SEAM | DT_TYPE_CREASE | DT_TYPE_BWEIGHT_EDGE |
|
|
|
|
DT_TYPE_FREESTYLE_EDGE,
|
2015-02-05 14:38:59 +01:00
|
|
|
DT_TYPE_LOOP_ALL = DT_TYPE_VCOL | DT_TYPE_LNOR | DT_TYPE_UV,
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
DT_TYPE_POLY_ALL = DT_TYPE_UV | DT_TYPE_SHARP_FACE | DT_TYPE_FREESTYLE_FACE,
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
CustomDataMask BKE_object_data_transfer_dttypes_to_cdmask(const int dtdata_types);
|
|
|
|
bool BKE_object_data_transfer_get_dttypes_capacity(
|
|
|
|
const int dtdata_types, bool *r_advanced_mixing, bool *r_threshold);
|
|
|
|
int BKE_object_data_transfer_get_dttypes_item_types(const int dtdata_types);
|
|
|
|
|
|
|
|
int BKE_object_data_transfer_dttype_to_cdtype(const int dtdata_type);
|
|
|
|
int BKE_object_data_transfer_dttype_to_srcdst_index(const int dtdata_type);
|
|
|
|
|
|
|
|
#define DT_DATATYPE_IS_VERT(_dt) \
|
|
|
|
ELEM(_dt, DT_TYPE_MDEFORMVERT, DT_TYPE_SHAPEKEY, DT_TYPE_SKIN, DT_TYPE_BWEIGHT_VERT)
|
|
|
|
#define DT_DATATYPE_IS_EDGE(_dt) \
|
|
|
|
ELEM(_dt, DT_TYPE_CREASE, DT_TYPE_SHARP_EDGE, DT_TYPE_SEAM, DT_TYPE_BWEIGHT_EDGE, DT_TYPE_FREESTYLE_EDGE)
|
|
|
|
#define DT_DATATYPE_IS_LOOP(_dt) \
|
2015-02-05 14:38:59 +01:00
|
|
|
ELEM(_dt, DT_TYPE_UV, DT_TYPE_VCOL, DT_TYPE_LNOR)
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
#define DT_DATATYPE_IS_POLY(_dt) \
|
|
|
|
ELEM(_dt, DT_TYPE_UV, DT_TYPE_SHARP_FACE, DT_TYPE_FREESTYLE_FACE)
|
|
|
|
|
|
|
|
#define DT_DATATYPE_IS_MULTILAYERS(_dt) \
|
|
|
|
ELEM(_dt, DT_TYPE_MDEFORMVERT, DT_TYPE_SHAPEKEY, DT_TYPE_VCOL, DT_TYPE_UV)
|
|
|
|
|
|
|
|
|
|
|
|
enum {
|
|
|
|
DT_MULTILAYER_INDEX_INVALID = -1,
|
|
|
|
DT_MULTILAYER_INDEX_MDEFORMVERT = 0,
|
|
|
|
DT_MULTILAYER_INDEX_SHAPEKEY = 1,
|
|
|
|
DT_MULTILAYER_INDEX_VCOL = 2,
|
|
|
|
DT_MULTILAYER_INDEX_UV = 3,
|
|
|
|
DT_MULTILAYER_INDEX_MAX = 4,
|
|
|
|
};
|
|
|
|
|
|
|
|
/* Below we keep positive values for real layers idx (generated dynamically). */
|
|
|
|
|
|
|
|
/* How to select data layers, for types supporting multi-layers.
|
|
|
|
* Here too, some options are highly dependent on type of transferred data! */
|
|
|
|
enum {
|
|
|
|
DT_LAYERS_ACTIVE_SRC = -1,
|
|
|
|
DT_LAYERS_ALL_SRC = -2,
|
|
|
|
/* Datatype-specific. */
|
|
|
|
DT_LAYERS_VGROUP_SRC = 1 << 8,
|
|
|
|
DT_LAYERS_VGROUP_SRC_BONE_SELECT = -(DT_LAYERS_VGROUP_SRC | 1),
|
|
|
|
DT_LAYERS_VGROUP_SRC_BONE_DEFORM = -(DT_LAYERS_VGROUP_SRC | 2),
|
|
|
|
/* Other types-related modes... */
|
|
|
|
};
|
|
|
|
|
|
|
|
/* How to map a source layer to a destination layer, for types supporting multi-layers.
|
|
|
|
* Note: if no matching layer can be found, it will be created. */
|
|
|
|
enum {
|
|
|
|
DT_LAYERS_ACTIVE_DST = -1, /* Only for DT_LAYERS_FROMSEL_ACTIVE. */
|
|
|
|
DT_LAYERS_NAME_DST = -2,
|
|
|
|
DT_LAYERS_INDEX_DST = -3,
|
|
|
|
#if 0 /* TODO */
|
|
|
|
DT_LAYERS_CREATE_DST = -4, /* Never replace existing data in dst, always create new layers. */
|
|
|
|
#endif
|
|
|
|
};
|
|
|
|
|
|
|
|
void BKE_object_data_transfer_layout(
|
2018-04-06 12:07:27 +02:00
|
|
|
struct Depsgraph *depsgraph, struct Scene *scene, struct Object *ob_src,
|
2017-07-21 11:53:13 +02:00
|
|
|
struct Object *ob_dst, const int data_types, const bool use_delete,
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
const int fromlayers_select[DT_MULTILAYER_INDEX_MAX], const int tolayers_select[DT_MULTILAYER_INDEX_MAX]);
|
|
|
|
|
|
|
|
bool BKE_object_data_transfer_mesh(
|
2018-04-06 12:07:27 +02:00
|
|
|
struct Depsgraph *depsgraph, struct Scene *scene,
|
2015-07-24 23:40:02 +02:00
|
|
|
struct Object *ob_src, struct Object *ob_dst, const int data_types, const bool use_create,
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
const int map_vert_mode, const int map_edge_mode, const int map_loop_mode, const int map_poly_mode,
|
2015-07-13 18:00:08 +02:00
|
|
|
struct SpaceTransform *space_transform, const bool auto_transform,
|
|
|
|
const float max_distance, const float ray_radius, const float islands_handling_precision,
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
const int fromlayers_select[DT_MULTILAYER_INDEX_MAX], const int tolayers_select[DT_MULTILAYER_INDEX_MAX],
|
|
|
|
const int mix_mode, const float mix_factor, const char *vgroup_name, const bool invert_vgroup,
|
|
|
|
struct ReportList *reports);
|
2018-06-21 15:32:01 +02:00
|
|
|
bool BKE_object_data_transfer_ex(
|
2018-04-06 12:07:27 +02:00
|
|
|
struct Depsgraph *depsgraph, struct Scene *scene,
|
2018-06-21 15:17:40 +02:00
|
|
|
struct Object *ob_src, struct Object *ob_dst, struct Mesh *me_dst,
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
const int data_types, bool use_create,
|
|
|
|
const int map_vert_mode, const int map_edge_mode, const int map_loop_mode, const int map_poly_mode,
|
2015-07-13 18:00:08 +02:00
|
|
|
struct SpaceTransform *space_transform, const bool auto_transform,
|
|
|
|
const float max_distance, const float ray_radius, const float islands_handling_precision,
|
Transfer Data: add main core code and operators.
This add code needed to map a CD data layout from source mesh towards destination one,
and code needed to actually transfer data, using BKE's mesh remap generated data.
This allows to transfer most CD layers (vgroups, vcols, uvs...) as well as fake, boolean ones
(like smooth/sharp edges/faces, etc.). Some types are not yet transferable, mainly
shape keys, this is known TODO.
Data transfer can also use some advanced mixing in some cases (mostly, vgroups and vcols).
Notes:
* New transfer operators transfer data from active object towards selected ones.
* Modifier will be committed separately.
* Old weight transfer code (for vgroups) is kept for now, mostly because it is the only
usable one in weightpaint mode (it transfers from selected object to active one,
this is not sensible in Object mode, but needed in WeightPaint one). This will be addressed soon.
Again, heavily reviewed and enhanced by Campbell, thanks!
2015-01-09 19:11:40 +01:00
|
|
|
const int fromlayers_select[DT_MULTILAYER_INDEX_MAX], const int tolayers_select[DT_MULTILAYER_INDEX_MAX],
|
|
|
|
const int mix_mode, const float mix_factor, const char *vgroup_name, const bool invert_vgroup,
|
|
|
|
struct ReportList *reports);
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
2015-01-14 13:53:03 +01:00
|
|
|
#endif /* __BKE_DATA_TRANSFER_H__ */
|