DataTransferModifier(Modifier)

base classes — bpy_struct, Modifier

class bpy.types.DataTransferModifier(Modifier)

Modifier transferring some data from a source mesh

data_types_edges

Which edge data layers to transfer

  • SHARP_EDGE Sharp – Transfer sharp mark.

  • SEAM UV Seam – Transfer UV seam mark.

  • CREASE Crease – Transfer subdivision crease values.

  • BEVEL_WEIGHT_EDGE Bevel Weight – Transfer bevel weights.

  • FREESTYLE_EDGE Freestyle – Transfer Freestyle edge mark.

Type

enum set in {‘SHARP_EDGE’, ‘SEAM’, ‘CREASE’, ‘BEVEL_WEIGHT_EDGE’, ‘FREESTYLE_EDGE’}, default {‘SHARP_EDGE’}

data_types_loops

Which face corner data layers to transfer

  • CUSTOM_NORMAL Custom Normals – Transfer custom normals.

  • VCOL Vertex Colors – Vertex (face corners) colors.

  • UV UVs – Transfer UV layers.

Type

enum set in {‘CUSTOM_NORMAL’, ‘VCOL’, ‘UV’}, default {‘CUSTOM_NORMAL’}

data_types_polys

Which poly data layers to transfer

  • SMOOTH Smooth – Transfer flat/smooth mark.

  • FREESTYLE_FACE Freestyle Mark – Transfer Freestyle face mark.

Type

enum set in {‘SMOOTH’, ‘FREESTYLE_FACE’}, default {‘SMOOTH’}

data_types_verts

Which vertex data layers to transfer

  • VGROUP_WEIGHTS Vertex Groups – Transfer active or all vertex groups.

  • BEVEL_WEIGHT_VERT Bevel Weight – Transfer bevel weights.

Type

enum set in {‘VGROUP_WEIGHTS’, ‘BEVEL_WEIGHT_VERT’}, default {‘VGROUP_WEIGHTS’}

edge_mapping

Method used to map source edges to destination ones

  • TOPOLOGY Topology – Copy from identical topology meshes.

  • VERT_NEAREST Nearest Vertices – Copy from most similar edge (edge which vertices are the closest of destination edge’s ones).

  • NEAREST Nearest Edge – Copy from closest edge (using midpoints).

  • POLY_NEAREST Nearest Face Edge – Copy from closest edge of closest face (using midpoints).

  • EDGEINTERP_VNORPROJ Projected Edge Interpolated – Interpolate all source edges hit by the projection of destination one along its own normal (from vertices).

Type

enum in [‘TOPOLOGY’, ‘VERT_NEAREST’, ‘NEAREST’, ‘POLY_NEAREST’, ‘EDGEINTERP_VNORPROJ’], default ‘NEAREST’

invert_vertex_group

Invert vertex group influence

Type

boolean, default False

islands_precision

Factor controlling precision of islands handling (typically, 0.1 should be enough, higher values can make things really slow)

Type

float in [0, 1], default 0.0

layers_uv_select_dst

How to match source and destination layers

  • ACTIVE Active Layer – Affect active data layer of all targets.

  • NAME By Name – Match target data layers to affect by name.

  • INDEX By Order – Match target data layers to affect by order (indices).

Type

enum in [‘ACTIVE’, ‘NAME’, ‘INDEX’], default ‘NAME’

layers_uv_select_src

Which layers to transfer, in case of multi-layers types

  • ACTIVE Active Layer – Only transfer active data layer.

  • ALL All Layers – Transfer all data layers.

  • BONE_SELECT Selected Pose Bones – Transfer all vertex groups used by selected pose bones.

  • BONE_DEFORM Deform Pose Bones – Transfer all vertex groups used by deform bones.

Type

enum in [‘ACTIVE’, ‘ALL’, ‘BONE_SELECT’, ‘BONE_DEFORM’], default ‘ALL’

layers_vcol_select_dst

How to match source and destination layers

  • ACTIVE Active Layer – Affect active data layer of all targets.

  • NAME By Name – Match target data layers to affect by name.

  • INDEX By Order – Match target data layers to affect by order (indices).

Type

enum in [‘ACTIVE’, ‘NAME’, ‘INDEX’], default ‘NAME’

layers_vcol_select_src

Which layers to transfer, in case of multi-layers types

  • ACTIVE Active Layer – Only transfer active data layer.

  • ALL All Layers – Transfer all data layers.

  • BONE_SELECT Selected Pose Bones – Transfer all vertex groups used by selected pose bones.

  • BONE_DEFORM Deform Pose Bones – Transfer all vertex groups used by deform bones.

Type

enum in [‘ACTIVE’, ‘ALL’, ‘BONE_SELECT’, ‘BONE_DEFORM’], default ‘ALL’

layers_vgroup_select_dst

How to match source and destination layers

  • ACTIVE Active Layer – Affect active data layer of all targets.

  • NAME By Name – Match target data layers to affect by name.

  • INDEX By Order – Match target data layers to affect by order (indices).

Type

enum in [‘ACTIVE’, ‘NAME’, ‘INDEX’], default ‘NAME’

layers_vgroup_select_src

Which layers to transfer, in case of multi-layers types

  • ACTIVE Active Layer – Only transfer active data layer.

  • ALL All Layers – Transfer all data layers.

  • BONE_SELECT Selected Pose Bones – Transfer all vertex groups used by selected pose bones.

  • BONE_DEFORM Deform Pose Bones – Transfer all vertex groups used by deform bones.

Type

enum in [‘ACTIVE’, ‘ALL’, ‘BONE_SELECT’, ‘BONE_DEFORM’], default ‘ALL’

loop_mapping

Method used to map source faces’ corners to destination ones

  • TOPOLOGY Topology – Copy from identical topology meshes.

  • NEAREST_NORMAL Nearest Corner and Best Matching Normal – Copy from nearest corner which has the best matching normal.

  • NEAREST_POLYNOR Nearest Corner and Best Matching Face Normal – Copy from nearest corner which has the face with the best matching normal to destination corner’s face one.

  • NEAREST_POLY Nearest Corner of Nearest Face – Copy from nearest corner of nearest polygon.

  • POLYINTERP_NEAREST Nearest Face Interpolated – Copy from interpolated corners of the nearest source polygon.

  • POLYINTERP_LNORPROJ Projected Face Interpolated – Copy from interpolated corners of the source polygon hit by corner normal projection.

Type

enum in [‘TOPOLOGY’, ‘NEAREST_NORMAL’, ‘NEAREST_POLYNOR’, ‘NEAREST_POLY’, ‘POLYINTERP_NEAREST’, ‘POLYINTERP_LNORPROJ’], default ‘NEAREST_POLYNOR’

max_distance

Maximum allowed distance between source and destination element, for non-topology mappings

Type

float in [0, inf], default 1.0

mix_factor

Factor to use when applying data to destination (exact behavior depends on mix mode, multiplied with weights from vertex group when defined)

Type

float in [0, 1], default 0.0

mix_mode

How to affect destination elements with source values

  • REPLACE Replace – Overwrite all elements’ data.

  • ABOVE_THRESHOLD Above Threshold – Only replace destination elements where data is above given threshold (exact behavior depends on data type).

  • BELOW_THRESHOLD Below Threshold – Only replace destination elements where data is below given threshold (exact behavior depends on data type).

  • MIX Mix – Mix source value into destination one, using given threshold as factor.

  • ADD Add – Add source value to destination one, using given threshold as factor.

  • SUB Subtract – Subtract source value to destination one, using given threshold as factor.

  • MUL Multiply – Multiply source value to destination one, using given threshold as factor.

Type

enum in [‘REPLACE’, ‘ABOVE_THRESHOLD’, ‘BELOW_THRESHOLD’, ‘MIX’, ‘ADD’, ‘SUB’, ‘MUL’], default ‘REPLACE’

object

Object to transfer data from

Type

Object

poly_mapping

Method used to map source faces to destination ones

  • TOPOLOGY Topology – Copy from identical topology meshes.

  • NEAREST Nearest Face – Copy from nearest polygon (using center points).

  • NORMAL Best Normal-Matching – Copy from source polygon which normal is the closest to destination one.

  • POLYINTERP_PNORPROJ Projected Face Interpolated – Interpolate all source polygons intersected by the projection of destination one along its own normal.

Type

enum in [‘TOPOLOGY’, ‘NEAREST’, ‘NORMAL’, ‘POLYINTERP_PNORPROJ’], default ‘NEAREST’

ray_radius

‘Width’ of rays (especially useful when raycasting against vertices or edges)

Type

float in [0, inf], default 0.0

use_edge_data

Enable edge data transfer

Type

boolean, default False

use_loop_data

Enable face corner data transfer

Type

boolean, default False

use_max_distance

Source elements must be closer than given distance from destination one

Type

boolean, default False

use_object_transform

Evaluate source and destination meshes in global space

Type

boolean, default True

use_poly_data

Enable face data transfer

Type

boolean, default False

use_vert_data

Enable vertex data transfer

Type

boolean, default False

vert_mapping

Method used to map source vertices to destination ones

  • TOPOLOGY Topology – Copy from identical topology meshes.

  • NEAREST Nearest Vertex – Copy from closest vertex.

  • EDGE_NEAREST Nearest Edge Vertex – Copy from closest vertex of closest edge.

  • EDGEINTERP_NEAREST Nearest Edge Interpolated – Copy from interpolated values of vertices from closest point on closest edge.

  • POLY_NEAREST Nearest Face Vertex – Copy from closest vertex of closest face.

  • POLYINTERP_NEAREST Nearest Face Interpolated – Copy from interpolated values of vertices from closest point on closest face.

  • POLYINTERP_VNORPROJ Projected Face Interpolated – Copy from interpolated values of vertices from point on closest face hit by normal-projection.

Type

enum in [‘TOPOLOGY’, ‘NEAREST’, ‘EDGE_NEAREST’, ‘EDGEINTERP_NEAREST’, ‘POLY_NEAREST’, ‘POLYINTERP_NEAREST’, ‘POLYINTERP_VNORPROJ’], default ‘NEAREST’

vertex_group

Vertex group name for selecting the affected areas

Type

string, default “”, (never None)

classmethod bl_rna_get_subclass(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions