## PropertyTransfer

### Introduced

v2.03

### Description

Connects an operator to transfer property data from one object to another. Primarily used for hair properties, defined on the surface of the emitter.

### Scripting Syntax

    PropertyTransfer( [Target], PropObj );

### Parameters

Parameter | Type | Description
--- | --- | ---
Target | List | Hair object that receives the transfered property. Default Value: Current selection
PropObj | String | Map property that will be transferred.

### Examples

#### VBScript Example

    '
    ' This example shows how to transfer a property from a hair emitter
    ' to the hair object.  A weightmap is transferred and used to modulate
    ' the cut parameter of an hair object.
    '
    NewScene , false
    'Create hair
    CreatePrim "Sphere", "MeshSurface"
    ApplyHairOp "sphere"
    'Install weightmap
    SelectObj "sphere", , True
    CreateWeightMap , , "Weight_Map"
    SetValue "sphere.polymsh.cls.WeightMapCls.Weight_Map.weightmapop.type", 6
    SetValue "sphere.polymsh.cls.WeightMapCls.Weight_Map.weightmapop.invert", True
    'Transfer properties
    PropertyTransfer "Hair", "sphere.polymsh.cls.WeightMapCls.Weight_Map"
    'Connect the transferred weight map to the cut parameter of the hair object.
    ApplyOp "MapCompOp", "sphere.polymsh.cls.WeightMapCls.Weight_Map;Hair.hair.Cut;Hair.hair.cls.WeightMapCls.Weight_Map"
    'Display results. Note the effect of the weightmap on the hair object.
    SetValue "Hair.hair.DisplayType", 1
    SetValue "Hair.hair.DisplayPercentage", 50.0
    SelectObj "sphere", , True
    SetValue "Camera.camvis.objctrlpropmaps", True
    SetDisplayMode "Camera", "constant"

### See Also

ApplyHairOp