Scripting: Create2DMap

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