FitSubcomponentUVsToImage

This command performs a scaling and translation operation on the UV properties so that the bounding box of the UV values of the selected subcomponents is equal to (0,0)x(1,1). As a result, if the UV properties are used for texturing, the selected subcomponents are guaranteed to be covered by texture.

There are two ways a UV property can be modified, based on the value of the Explicit parameter. If Explicit is false, the transformation in the UV property's projection definition is modified, and the actual UV values of the property are not changed. If Explicit is true, the command explicitly modifies the UV values of the UV property, and does not modify the projection definition transform.

Regardless of the Explicit parameter's setting, no rotation is performed when fitting.

Scripting Syntax

FitSubcomponentUVsToImage( Properties, SubComp, [Explicit], [MaintainAspect] );

Parameters

Parameter	Type	Description
Properties	UV Property set	The set of UV properties to perform the fitting on. Each UV property is handled independently.
SubComp	String	Subcomponents for which the UVs should be made to fit to the image.
Explicit	Boolean	If true, modify the UVs explicitly instead of modifying the transform. Default Value: False
MaintainAspect	Boolean	If true, maintain the aspect ratio of the UVs (i.e., only perform uniform scaling). Default Value: True

Examples

VBScript Example

NewScene
CreatePrim "Sphere", "MeshSurface"
SetDisplayMode "Camera", "texturedecal"
ApplyShader
SIApplyShaderToCnxPoint "Image", "sphere.Material.Phong.diffuse"
CreateProjection "sphere", siTxtCylindrical, siTxtDefaultSpherical, "Texture_Support", "Texture_Projection"
SetInstanceDataValue , "sphere.Material.Phong.Image.tspace_id", "Texture_Projection"
FitSubcomponentUVsToImage "sphere.polymsh.cls.Texture_Coordinates_AUTO.Texture_Projection", "sphere.poly[11,12,19,20]"