Share via

IPixEngine5::RenderTextureAsync method

  • Article

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