## CreateSubprojection

### Description

Creates a subprojection on an existing UV property. Use this command to reproject portions of an object. Portions of the object not included in the input object list will not be affected.
Subprojections simplify the texturing process by allowing you to apply a planar, spherical, or cylindrical projection to a selection of sample points in an existing texture projection. The sample points are reprojected onto the current texture, leaving you with a single set of UV coordinates to manage.
You could use this command to texture a human body. For example, if the body already has a planar projection on it, you could perform a cylindrical subprojection on the arm. The UVs on the rest of the object will be unchanged.
Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:
For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.
For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).

### Scripting Syntax

    CreateSubprojection( InputObjs, TextureProjection, [Type], [Plane], [SupportName], [Parenting], [Fitting], [FitToImage], [MaintainAspect], [TextureAspectRatio], [3DObjTexture] );

### Parameters

Parameter | Type | Description
--- | --- | ---
InputObjs | String | List of objects to which the texture support is applied. Default Value: Selected objects
TextureProjection | String | Texture projection to modify.
Type | siTxtProjType | Projection type Default Value: siTxtPlanar
Plane | siTxtProjPlane | Projection plane Default Value: siPlaneXY
SupportName | String | Name for the texture support object. Default Value: Texture_Support
Parenting | Boolean | True to parent the texture support to the objects. Default Value: True
Fitting | siTxtProjFitMethod | Fitting Method Default Value: siRelBestFit
FitToImage | Boolean | If true, modify the uvs after projecting to fit the image. Default Value: False
MaintainAspect | Boolean | If true, correct for aspect ratio distortion caused by the projection and/or the image aspect ratio. Default Value: False
TextureAspectRatio | Double | The aspect ratio (x resolution/y resolution) of the image for which the UVs are being used. If specified (see MaintainAspect), the command performs a scaling to compensate for the aspect ratio. Default Value: 1.0
3DObjTexture | X3DObject | Returns the new texture projection. Default Value: False

### Examples

#### VBScript Example

    CreatePrim "Sphere", "MeshSurface"
    SetValue "sphere.polymsh.geom.subdivu,sphere.polymsh.geom.subdivv", Array(16,16)
    ApplyShader , , , , siLetLocalMaterialsOverlap
    SIApplyShaderToCnxPoint "Image", "sphere.Material.Phong.diffuse"
    CreateProjection "sphere", siTxtSpherical, siTxtDefaultSpherical, "Texture_Support", "Texture_Projection"
    SetInstanceDataValue , "sphere.Material.Phong.Image.tspace_id", "Texture_Projection"
    SetDisplayMode "Camera", "texturedecal"
    ActivateRaycastPolySelTool
    SelectGeometryComponents "sphere.poly[57,58,73,74]"
    CreateSubprojection "sphere.sample[221-228,283-290]", "sphere.polymsh.cls.Texture_Coordinates_AUTO.Texture_Projection", siTxtPlanar, siPlaneXY, , True, siRelBestFit

### See Also

CreateProjection FitSubcomponentUVsToImage