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.

• COLOR_CORNER Colors – Transfer color attributes.

• UV UVs – Transfer UV layers.

Type:

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

data_types_polys

Which face 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.

• COLOR_VERTEX Colors – Transfer color attributes.

Type:

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

edge_mapping

Method used to map source edges to destination ones

Type:

enum in Dt Method Edge Items, 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

Type:

enum in Dt Layers Select Dst Items, default ‘NAME’

layers_uv_select_src

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

Type:

enum in Dt Layers Select Src Items, default ‘ALL’

layers_vcol_loop_select_dst

How to match source and destination layers

Type:

enum in Dt Layers Select Dst Items, default ‘NAME’

layers_vcol_loop_select_src

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

Type:

enum in Dt Layers Select Src Items, default ‘ALL’

layers_vcol_vert_select_dst

How to match source and destination layers

Type:

enum in Dt Layers Select Dst Items, default ‘NAME’

layers_vcol_vert_select_src

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

Type:

enum in Dt Layers Select Src Items, default ‘ALL’

layers_vgroup_select_dst

How to match source and destination layers

Type:

enum in Dt Layers Select Dst Items, default ‘NAME’

layers_vgroup_select_src

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

Type:

enum in Dt Layers Select Src Items, default ‘ALL’

loop_mapping

Method used to map source faces’ corners to destination ones

Type:

enum in Dt Method Loop Items, 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

Type:

enum in Dt Mix Mode Items, default ‘REPLACE’

object

Object to transfer data from

Type:

Object

poly_mapping

Method used to map source faces to destination ones

Type:

enum in Dt Method Poly Items, 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

Type:

enum in Dt Method Vertex Items, 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

bpy_struct.id_data Modifier.name Modifier.type Modifier.show_viewport Modifier.show_render Modifier.show_in_editmode Modifier.show_on_cage

Modifier.show_expanded Modifier.is_active Modifier.is_override_data Modifier.use_apply_on_spline Modifier.execution_time Modifier.persistent_uid

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.id_properties_clear bpy_struct.id_properties_ensure bpy_struct.id_properties_ui bpy_struct.is_property_hidden bpy_struct.is_property_overridable_library bpy_struct.is_property_readonly bpy_struct.is_property_set bpy_struct.items

bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.pop bpy_struct.property_overridable_library_set bpy_struct.property_unset bpy_struct.type_recast bpy_struct.values Modifier.bl_rna_get_subclass Modifier.bl_rna_get_subclass_py