IPixEngine5::RenderTextureAsync method

Renders a texture to a file and returns the result to the host asynchrnously.

Syntax

HRESULT RenderTextureAsync(
   UINT                       textureId,
   PixEngineTextureSliceIndex sliceIndex,
   int                        formatOverride,
   float [4]                  lower,
   float [4]                  upper,
   BSTR                       shaderFileName,
   UINT                       numFloatShaderVars,
   BSTR []                    count6_shaderFloatVarName,
   float []                   count6_shaderFloatVarValue,
   UINT                       numBoolShaderVars,
   BSTR []                    count9_shaderBoolVarName,
   BOOL []                    count9_shaderBoolVarValue,
   BSTR                       renderContentFileName,
   IPixEngine5Callbacks*      callbacks,
   DWORD                      requestCookie,
   DWORD                      progressIntervalMsecs
);

Parameters

textureId
The ID of the texture to render.

sliceIndex
The index of the slice within the texture to render.

formatOverride
The color format override.

lower

upper

shaderFileName
A COM string containing the pathname of the shader file.

numFloatShaderVars
The number of floating-point shader variables

count6_shaderFloatVarName
COM strings contianing the names of the floating-point shader variables.

count6_shaderFloatVarValue
The floating-point shader variables.

numBoolShaderVars
The number of boolean shader variables.

count9_shaderBoolVarName
COM strings contianing the names of the boolean shader variables.

count9_shaderBoolVarValue
The boolean shader variables.

renderContentFileName
A COM string containing the pathname of the file where the rendered texture was written.

callbacks
The address of an object that provides the IPixEngine5 callbacks interface.

requestCookie
A cookie that uniquely identifies the request, and can be used to signal for it to be cancelled.

progressIntervalMsecs
Not used.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Header

Vspixengine.h

See also

IPixEngine5