TextureGutterHelper Class

Language:

Used to build and manage gutter regions in a texture. Gutter regions separate textures and allow for bilinear interpolation to avoid rendering artifacts at texture boundaries.

Definition

Visual Basic Public Class TextureGutterHelper
Inherits MarshalByRefObject
Implements IDisposable

C# public class TextureGutterHelper : MarshalByRefObject, IDisposable

C++ public ref class TextureGutterHelper : MarshalByRefObject, IDisposable

JScript public class TextureGutterHelper extends MarshalByRefObject implements IDisposable

Visual Basic	Public Class TextureGutterHelper Inherits MarshalByRefObject Implements IDisposable
C#	public class TextureGutterHelper : MarshalByRefObject, IDisposable
C++	public ref class TextureGutterHelper : MarshalByRefObject, IDisposable
JScript	public class TextureGutterHelper extends MarshalByRefObject implements IDisposable

Members Table

The following table lists the members exposed by the object. Click a tab on the left to choose the type of member you want to view.

Events

Event Description

Disposing Occurs when the Dispose method is called or when the TextureGutterHelper object is finalized and collected by the garbage collector of the .NET common language runtime.

Methods

Method Description

ApplyGutters Applies gutters to a texture object.

Dispose Immediately releases the unmanaged resources used by the TextureGutterHelper object.

Equals Returns a value that indicates whether the current instance is equal to a specified object.

Finalize Allows the TextureGutterHelper object to free resources before it is destroyed by the garbage collector.

GetBaryMap Retrieves texel barycentric coordinates.

GetFaceMap Retrieves the index of the mesh face to which each texel belongs.

GetGutterMap Receives a texel class value that indicates texel class according to each texel's location.

GetHashCode Returns the hash code for the current instance.

GetObjectByValue This member supports the infrastructure for Microsoft DirectX 9.0 for Managed Code and is not intended to be used directly from your code.

GetTexelMap Retrieves the (u, v) texture coordinates of each texel.

op_Equality Compares the current instance of a class to another instance to determine whether they are the same.

op_Inequality Compares the current instance of a class to another instance to determine whether they are different.

raise_Disposing Raises the Microsoft.DirectX.Direct3D.TextureGutterHelper.Disposing event when called from within a derived class.

ResampleTexture Resamples a texture into this gutterhelper's parameterization.

SetBaryMap Sets texel barycentric coordinates.

SetFaceMap Sets the index of the mesh face to which each texel belongs.

SetGutterMap Sets a texel class value that indicates texel class according to each texel's location.

SetTexelMap Sets the (u, v) texture coordinates of each texel.

TextureGutterHelper Initializes a new instance of the TextureGutterHelper class.

UpdateUnmanagedPointer Updates the unmanaged pointer for this TextureGutterHelper object. This method supports the Microsoft .NET Framework infrastructure and is not intended to be used directly in your code.

Properties

Property Description

Disposed Gets a value that indicates whether the object is disposed.

Height Retrieves the height of the texture, in pixels.

UnmanagedComPointer Returns the unmanaged Component Object Model (COM) ID3DXTextureGutterHelper interface pointer.

Width Retrieves the width of the texture, in pixels.

Event	Description
Disposing	Occurs when the Dispose method is called or when the TextureGutterHelper object is finalized and collected by the garbage collector of the .NET common language runtime.

Method	Description
ApplyGutters	Applies gutters to a texture object.
Dispose	Immediately releases the unmanaged resources used by the TextureGutterHelper object.
Equals	Returns a value that indicates whether the current instance is equal to a specified object.
Finalize	Allows the TextureGutterHelper object to free resources before it is destroyed by the garbage collector.
GetBaryMap	Retrieves texel barycentric coordinates.
GetFaceMap	Retrieves the index of the mesh face to which each texel belongs.
GetGutterMap	Receives a texel class value that indicates texel class according to each texel's location.
GetHashCode	Returns the hash code for the current instance.
GetObjectByValue	This member supports the infrastructure for Microsoft DirectX 9.0 for Managed Code and is not intended to be used directly from your code.
GetTexelMap	Retrieves the (u, v) texture coordinates of each texel.
op_Equality	Compares the current instance of a class to another instance to determine whether they are the same.
op_Inequality	Compares the current instance of a class to another instance to determine whether they are different.
raise_Disposing	Raises the Microsoft.DirectX.Direct3D.TextureGutterHelper.Disposing event when called from within a derived class.
ResampleTexture	Resamples a texture into this gutterhelper's parameterization.
SetBaryMap	Sets texel barycentric coordinates.
SetFaceMap	Sets the index of the mesh face to which each texel belongs.
SetGutterMap	Sets a texel class value that indicates texel class according to each texel's location.
SetTexelMap	Sets the (u, v) texture coordinates of each texel.
TextureGutterHelper	Initializes a new instance of the TextureGutterHelper class.
UpdateUnmanagedPointer	Updates the unmanaged pointer for this TextureGutterHelper object. This method supports the Microsoft .NET Framework infrastructure and is not intended to be used directly in your code.

Property	Description
Disposed	Gets a value that indicates whether the object is disposed.
Height	Retrieves the height of the texture, in pixels.
UnmanagedComPointer	Returns the unmanaged Component Object Model (COM) ID3DXTextureGutterHelper interface pointer.
Width	Retrieves the width of the texture, in pixels.

Inheritance Hierarchy

Object
MarshalByRefObject
TextureGutterHelper

Remarks

Note: When used with precomputed radiance transfer (PRT), this class requires a unique parameterization of the model. Every texel must correspond to a single point on the surface of the model and vice-versa. If the model includes multiple textures, it must be split into separate pieces that each contain one gutter helper object per texture.

This class can be used to generate a map in texture space in which each texel is in one of four classes.

Texel Class Texel Location

0 Invalid point; texel will not be used.

1 Inside triangle.

2 Inside gutter.

4 Inside gutter; texel will be evaluated as a full sample in the ApplyGutters method.

For classes 1 and 2, a texel is stored with the face it belongs to, along with barycentric coordinates of the first two vertices of that face. Gutter vertices are assigned to the closest edge in texture space.

There is no texel class 3.

Texel Class	Texel Location
0	Invalid point; texel will not be used.
1	Inside triangle.
2	Inside gutter.
4	Inside gutter; texel will be evaluated as a full sample in the ApplyGutters method.

Class Information

Namespace Microsoft.DirectX.Direct3D

Assembly Microsoft.DirectX.Direct3DX (microsoft.directx.direct3dx.dll)

Strong Name Microsoft.DirectX.Direct3DX, Version=1.0.900.0, Culture=neutral, PublicKeyToken=d3231b57b74a1492

Namespace	Microsoft.DirectX.Direct3D
Assembly	Microsoft.DirectX.Direct3DX (microsoft.directx.direct3dx.dll)
Strong Name	Microsoft.DirectX.Direct3DX, Version=1.0.900.0, Culture=neutral, PublicKeyToken=d3231b57b74a1492

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center