NVIDIA OptiX 6.0 API nvidia_logo_transpbg.gif Up
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
rtContextLaunch functions

Functions

RTresult RTAPI rtContextLaunch1D (RTcontext context, unsigned int entryPointIndex, RTsize width)
 
RTresult RTAPI rtContextLaunch2D (RTcontext context, unsigned int entryPointIndex, RTsize width, RTsize height)
 
RTresult RTAPI rtContextLaunch3D (RTcontext context, unsigned int entryPointIndex, RTsize width, RTsize height, RTsize depth)
 

Detailed Description

Functions designed to launch OptiX ray tracing.

Function Documentation

RTresult RTAPI rtContextLaunch1D ( RTcontext  context,
unsigned int  entryPointIndex,
RTsize  width 
)

Executes the computation kernel for a given context.

Description

rtContextLaunch functions execute the computation kernel associated with the given context. If the context has not yet been compiled, or if the context has been modified since the last compile, rtContextLaunch will recompile the kernel internally. Acceleration structures of the context which are marked dirty will be updated and their dirty flags will be cleared. Similarly, validation will occur if necessary. The ray generation program specified by entryPointIndex will be invoked once for every element (pixel or voxel) of the computation grid specified by width, height, and depth.

For 3D launches, the product of width and depth must be smaller than 4294967296 (2^32).

Return values

Relevant return values:

History

rtContextLaunch was introduced in OptiX 1.0.

See also rtContextGetRunningState, rtContextValidate

Parameters
[in]contextThe context to be executed
[in]entryPointIndexThe initial entry point into kernel
[in]widthWidth of the computation grid
RTresult RTAPI rtContextLaunch2D ( RTcontext  context,
unsigned int  entryPointIndex,
RTsize  width,
RTsize  height 
)
Parameters
[in]contextThe context to be executed
[in]entryPointIndexThe initial entry point into kernel
[in]widthWidth of the computation grid
[in]heightHeight of the computation grid
RTresult RTAPI rtContextLaunch3D ( RTcontext  context,
unsigned int  entryPointIndex,
RTsize  width,
RTsize  height,
RTsize  depth 
)
Parameters
[in]contextThe context to be executed
[in]entryPointIndexThe initial entry point into kernel
[in]widthWidth of the computation grid
[in]heightHeight of the computation grid
[in]depthDepth of the computation grid