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