## GenerateUVSetByContourStretching

### Description

Create a new set of texture coordinates by contour stretching the polygon inputs onto a "surface" pinned on the contour of the polygon inputs. A proper contour of the polygon inputs must exist to guide the contour stretching process.

### Scripting Syntax

    oReturn = GenerateUVSetByContourStretching( InputObjs, PropertyName, [ContourStretchingMethod], [MaintainAspect], [CornerPoints] );

### Return Value

Returns an XSICollection object that contains two XSICollection objects. The first is a list of the created properties. The second is a list of the created operators.

### Parameters

Parameter | Type | Description
--- | --- | ---
InputObjs | String | List of polygon inputs to which the polygon UV texture coordinate contour stretching operator is applied. Default Value: Selected objects
PropertyName | String | Name suggestion for the texture coordinates.
ContourStretchingMethod | siTxtContourStretchingMethod | Polygon cluster contour stretching method. Default Value: siContourStretchingWalkingOnMesh
MaintainAspect | Boolean | Whether to maintain aspect ratio. Default Value: False
CornerPoints | String | Optional list of point inputs that define corners on the contour of the polygon inputs. Each input may contain from 0 to N points and only up to the first 4 points of each will be used to define corners. If the input corners are not part of the contour of the polygon inputs then they are ignored. Default Value: Empty. Corners are derived automatically internally.

### Examples

#### VBScript Example

    Dim l_CreatedObjects

    NewScene

    'This example will create a texture space by contour stretching the contour of

    'set of input polygons.

    CreatePrim "Sphere", "MeshSurface"

    ActivateRaycastPolySelTool

    SelectGeometryComponents "sphere.poly[3,4,11,12,19,20,27,28]"

    CreateCluster

    'Translate a point and notice that the texture follows the deformation

    Translate "sphere.pnt[20]", 0.15, 4.8, -0.48, siRelative, siView, siObj, siXYZ

    'Stretch the polygons - Method is by spatial distance, Default for MaintainAspect = FALSE, Pass-in corners.

    set l_CreatedObjects = GenerateUVSetByContourStretching( "sphere.polymsh.cls.Polygon", "Texture_Projection", siContourStretchingSpatialDistance, , "sphere.pnt[4,6,32,34]" )

    ' What was created

    logmessage "Created Properties: " & l_CreatedObjects(0)

    logmessage "Created Operators:" & l_CreatedObjects(1)

    'Use the generated texture space.

    ActivateObjectSelTool

    ApplyShader , , , , siLetLocalMaterialsOverlap

    SIApplyShaderToCnxPoint "Image", "sphere.Material.Phong.diffuse"

    SetInstanceDataValue , "sphere.Material.Phong.Image.tspace_id", "Texture_Projection"

    SetDisplayMode "Camera", "textured"

### See Also

ModifyUVSetByContourStretching