NURBSTextureSurface : Value

This class contains an editable texture coordinate surface corresponding to the editable texture surface in NURBS surfaces. You can create and apply them to any NURBSSurface value or retrieve existing texture surfaces using the getTextureSurface() and setTextureSurface() methods to access any of the 99 texture channels for a NURBS surface.

3ds max uses the texture surface to control how materials are mapped. In effect, changing the texture surface stretches or otherwise changes the UV coordinates for the surface, altering the mapping. This is a 2D (not 3D) surface that lives in the parameter space of the corresponding NURBSSurface which controls the texture mapping used by the NURBSSurface.

It is not possible to assign texture surfaces to NURBS objects that are present in the scene. You can create new NURBSSets and the texture surface is used when you call createNURBSObject(). However, if you do a getNURBSSet() and assign a NURBSTextureSurface to a texture channel for a NURBS surface, nothing happens.

Constructors

NURBSTextureSurface [<property>:<val>]...

Any of the object's properties may be set via optional keyword arguments on the constructor.

getTextureSurface <nurbssurface> <channel_index>

<nurbssurface>.textureSurface1

<nurbssurface>.textureSurface2

Provides backward compatibility for scripts written for 3ds max R2.5. Get and set the texture surfaces for the first two texture channels.

Properties

<nurbstexturesurface>.type         : #default, #userDefined, #projected

The type of texture surface.

<nurbstexturesurface>.parent       : integer

The parent surface by NURBSet index.

<nurbstexturesurface>.parentID     : integer

The parent surface by NURBSId.

<nurbstexturesurface>.numUPoints   : integer -- read-only

<nurbstexturesurface>.numVPoints   : integer -- read-only

<nurbstexturesurface>.numPoints    : point2

The number of U and V points.

Methods

getPoint <nurbstexturesurface> <u_index> <v_index>

setPoint <nurbstexturesurface> <u_index> <v_index> <texturepoint>

Get or set a NURBSTexturePoint value for the texture point at the U and V index of the texture surface.

Associated Methods

setTextureSurface <nurbssurface> <channel_index> <NURBSTextureSurface>

This method sets the texture surface for the selected channel.

Notes

The NURBSTextureSurface class has been updated to correspond to the new texture surface mechanism in 3ds max 4, and has different properties and methods that were defined in 3ds max R3.

See also