NURBSTextureSurface Class Reference

This reference page is linked to from the following overview topics: NURBS Texture Mapping.

---

Search for all occurrences

---

Detailed Description

See also:

Class NURBSControlVertex, Class NURBSSurface, Class NURBSTexturePoint.

Description:

This class is available in release 2.5 and later only.

A NURBS texture surface is a surface associated with the surface sub-object. 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 class provides access to the NURBS Texture Surface. 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.

#include <surf_api.h>

Inheritance diagram for NURBSTextureSurface:

List of all members.

Public Member Functions
DllExport	NURBSTextureSurface (void)
DllExport	~NURBSTextureSurface (void)
DllExport	NURBSTextureSurface (NURBSTextureSurface &tsurf)
DllExport NURBSTextureSurface &	operator= (const NURBSTextureSurface &surf)
DllExport NURBSTexSurfType	MapperType ()
DllExport void	SetMapperType (NURBSTexSurfType type)
DllExport void	SetParent (int index)
DllExport void	SetParentId (NURBSId id)
DllExport int	GetParent ()
DllExport NURBSId	GetParentId ()
DllExport void	SetNumPoints (int u, int v)
DllExport int	GetNumUPoints (void)
DllExport int	GetNumVPoints (void)
DllExport void	GetNumPoints (int &u, int &v)
DllExport NURBSTexturePoint *	GetPoint (int u, int v)
DllExport void	SetPoint (int u, int v, NURBSTexturePoint &pnt)

---

Constructor & Destructor Documentation

DllExport NURBSTextureSurface

(

void

)

Remarks:

Constructor. The data members are initialized as follows:

mMapperType = kNMapDefault;

mpPoints = NULL;

DllExport ~NURBSTextureSurface

(

void

)

Remarks:

Destructor. Any mpPoints are deleted.

DllExport NURBSTextureSurface

(

NURBSTextureSurface &

tsurf

)

---

Member Function Documentation

DllExport NURBSTextureSurface& operator=

(

const NURBSTextureSurface &

surf

)

Remarks:

Assignment operator.

Parameters:

const NURBSTextureSurface& surf

The surface to assign.

DllExport NURBSTexSurfType MapperType

(

)

Search for all occurrences

Remarks:

Returns the NURBS Texture Surface Type. See NURBSTextureSurface Types.

DllExport void SetMapperType

(

NURBSTexSurfType

type

)

Search for all occurrences

Remarks:

Sets the NURBS Texture Surface Type.

Parameters:

NURBSTexSurfType type

The type to set. See NURBSTextureSurface Types.

DllExport void SetParent

(

int

index

)

Search for all occurrences

Remarks:

This sets the Id of the "source" surface for a kNMapSurfaceMapper texture surface, it should be NULL in other cases. This is only used if the NURBSTexSurfType is set the kNMapSufaceMapper. In that case the texture surface is generated by projecting the texture of another NURBS surface sub-object in the NURBS model. The projection travels along the direction of the normals of the source surface. Projected texture surfaces are relational. This method set the parent surface which is projected.

Parameters:

int index

The index in the NURBSSet of the source surface.

DllExport void SetParentId

(

NURBSId

id

)

Search for all occurrences

Remarks:

This sets the index in the NURBSSet of the "source" surface for a kNMapSurfaceMapper texture surface. This is only used if the NURBSTexSurfType is set the kNMapSufaceMapper. In that case the texture surface is generated by projecting the texture of another NURBS surface sub-object in the NURBS model. The projection travels along the direction of the normals of the source surface. Projected texture surfaces are relational. This method set the parent surface which is projected.

Parameters:

NURBSId id

The ID of the source surface.

DllExport int GetParent

(

)

Search for all occurrences

Remarks:

Returns the index in the NURBSSet of the surface that's mapped.

DllExport NURBSId GetParentId

(

)

Search for all occurrences

Remarks:

Returns the ID of the surface that's mapped.

DllExport void SetNumPoints	(	int	u,
		int	v
	)

Search for all occurrences

Remarks:

Sets the number of points in U and V for the texture surface.

Parameters:

int u

The number of points in U.

int v

The number of points in V.

DllExport int GetNumUPoints

(

void

)

Search for all occurrences

Remarks:

Returns the number of points in U.

DllExport int GetNumVPoints

(

void

)

Search for all occurrences

Remarks:

Returns the number of points in V.

DllExport void GetNumPoints	(	int &	u,
		int &	v
	)

Search for all occurrences

Remarks:

Retrieves the number of points in U and V.

Parameters:

int &u

The number of points in U is returned here.

int &v

The number of points in V is returned here.

DllExport NURBSTexturePoint* GetPoint	(	int	u,
		int	v
	)

Search for all occurrences

Remarks:

Returns a pointer to the specified NURBS Texture Point.

Parameters:

int u

Specifies the U point.

int v

Specifies the V point.

DllExport void SetPoint	(	int	u,
		int	v,
		NURBSTexturePoint &	pnt
	)

Search for all occurrences

Remarks:

Sets the specified NURBS Texture Point.

Parameters:

int u

Specifies the U point.

int v

Specifies the V point.

NURBSTexturePoint& pnt

The point to set.