## Create2DMap

### Description

Create a new 2D texture map property that can be used to connect with mappable parameters. Texture maps can only be used with mappable parameters for the Particle operator and the hair object, and in render trees using the Map Lookup shader.

### Scripting Syntax

    oReturn = Create2DMap( [InputObjs], [PropertyName], [PropagationType] );

### Return Value

Returns an XSICollection that contains the 2D Texture Map objects.

### Parameters

Parameter | Type | Description
--- | --- | ---
InputObjs | String | List of objects to connect. Default Value: Selected objects
PropertyName | String | Name for the new texture map.
PropagationType | siPropagationType | Propagation method for the property. Default Value: siDefaultPropagation

### Examples

#### 1. VBScript Example

    NewScene

    CreatePrim "Sphere", "MeshSurface"

    CreatePrim "Sphere", "MeshSurface"

    Translate , -5.0, 0.0, 0.0, siRelative, siView, siObj, siXYZ

    AddToSelection "sphere", , True

    set List = Create2DMap

    for each Map in List

    	  logmessage "new map:" & Map

    next

#### 2. VBScript Example

    NewScene

    ' Create Particle Cloud

    CreateParticleCloud , "Sphere"

    ' Create a 2D Texture Map in the Particle Emitter obj

    Create2DMap "PEmitter", "Texture_Map", siDefaultPropagation

    ' Create a "spherical" Projection

    CreateProjection "PEmitter", siTxtSpherical, siTxtDefaultSpherical, "Texture_Support", "Texture_Projection"

    ' Associate the TextureMap UVReference with the projection

    SetInstanceDataValue , "PEmitter.Texture_Map.UVReference", "Texture_Projection"

    ' Connect the MapColor param of the particle emitter with

    ' the texture map

    ConnectMap "PEmitter.Texture_Map", "PEmitter.PEmitter_emission.MapColor"

    ' Activate the MapColor param of the Particle Emitter

    SetValue "PEmitter.PEmitter_emission.MapColor", True

### See Also

Create2DMapWithProjection