Microsoft DirectX 9.0 SDK Update (October 2004)

PrtEngine.ComputeConvolutionCoefficients Method

Language:

Note: This documentation is preliminary and is subject to change.

Computes convolution coefficients relative to per-sample normal vectors to minimize the least-squares error with respect to input precomputed radiance transfer (PRT) data. The convolution coefficients can be used with skinned or transformed normals to model global effects on dynamic objects.

Definition

Visual Basic .NET Public Sub ComputeConvolutionCoefficients( _
    ByVal bufferIn As PrtBuffer, _
    ByVal shOrder As Integer, _
    ByVal normalData() As Vector3, _
    ByVal bufferOut As PrtBuffer _
)
C# public void ComputeConvolutionCoefficients(
    PrtBuffer bufferIn,
    int shOrder,
    Vector3[] normalData,
    PrtBuffer bufferOut
);
Managed C++ public: void ComputeConvolutionCoefficients(
    PrtBuffer *bufferIn,
    int shOrder,
    Vector3 normalData __gc[],
    PrtBuffer *bufferOut
);
JScript .NET public function ComputeConvolutionCoefficients(
    bufferIn : PrtBuffer,
    shOrder : int,
    normalData : Vector3[],
    bufferOut : PrtBuffer
);

Parameters

bufferIn Microsoft.DirectX.Direct3D.PrtBuffer. A PrtBuffer object that represents the spherical harmonic (SH) precomputed radiance transfer (PRT) data.
shOrder System.Int32. Order of the spherical harmonic (SH) evaluation. Must be in the range of SphericalHarmonics.MinimumOrder to SphericalHarmonics.MaximumOrder, inclusive. The evaluation generates shOrder2 coefficients. The degree of the evaluation is shOrder - 1.
normalData Microsoft.DirectX.Vector3[]. A Vector3 array to be filled with shader-optimal normal vectors for which convolution coefficients are optimized. This array must be the same size as the number of samples in bufferIn.
bufferOut Microsoft.DirectX.Direct3D.PrtBuffer. A PrtBuffer object that contains shOrder convolution coefficients per color channel per sample.

Remarks

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.
OutOfMemoryException Leave Site Microsoft® Direct3D® could not allocate sufficient memory to complete the call.


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

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