Functions | |
template<typename... Payload> | |
static __forceinline__ __device__ void | optixTrace (OptixTraversableHandle handle, float3 rayOrigin, float3 rayDirection, float tmin, float tmax, float rayTime, OptixVisibilityMask visibilityMask, unsigned int rayFlags, unsigned int SBToffset, unsigned int SBTstride, unsigned int missSBTIndex, Payload &... payload) |
template<typename... Payload> | |
static __forceinline__ __device__ void | optixTrace (OptixPayloadTypeID type, OptixTraversableHandle handle, float3 rayOrigin, float3 rayDirection, float tmin, float tmax, float rayTime, OptixVisibilityMask visibilityMask, unsigned int rayFlags, unsigned int SBToffset, unsigned int SBTstride, unsigned int missSBTIndex, Payload &... payload) |
static __forceinline__ __device__ void | optixSetPayload_0 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_1 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_2 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_3 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_4 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_5 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_6 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_7 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_8 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_9 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_10 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_11 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_12 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_13 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_14 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_15 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_16 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_17 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_18 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_19 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_20 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_21 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_22 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_23 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_24 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_25 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_26 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_27 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_28 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_29 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_30 (unsigned int p) |
static __forceinline__ __device__ void | optixSetPayload_31 (unsigned int p) |
static __forceinline__ __device__ unsigned int | optixGetPayload_0 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_1 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_2 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_3 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_4 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_5 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_6 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_7 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_8 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_9 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_10 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_11 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_12 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_13 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_14 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_15 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_16 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_17 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_18 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_19 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_20 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_21 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_22 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_23 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_24 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_25 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_26 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_27 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_28 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_29 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_30 () |
static __forceinline__ __device__ unsigned int | optixGetPayload_31 () |
static __forceinline__ __device__ void | optixSetPayloadTypes (unsigned int typeMask) |
static __forceinline__ __device__ unsigned int | optixUndefinedValue () |
static __forceinline__ __device__ float3 | optixGetWorldRayOrigin () |
static __forceinline__ __device__ float3 | optixGetWorldRayDirection () |
static __forceinline__ __device__ float3 | optixGetObjectRayOrigin () |
static __forceinline__ __device__ float3 | optixGetObjectRayDirection () |
static __forceinline__ __device__ float | optixGetRayTmin () |
static __forceinline__ __device__ float | optixGetRayTmax () |
static __forceinline__ __device__ float | optixGetRayTime () |
static __forceinline__ __device__ unsigned int | optixGetRayFlags () |
static __forceinline__ __device__ unsigned int | optixGetRayVisibilityMask () |
static __forceinline__ __device__ OptixTraversableHandle | optixGetInstanceTraversableFromIAS (OptixTraversableHandle ias, unsigned int instIdx) |
static __forceinline__ __device__ void | optixGetTriangleVertexData (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float3 data[3]) |
static __forceinline__ __device__ void | optixGetMicroTriangleVertexData (float3 data[3]) |
static __forceinline__ __device__ void | optixGetMicroTriangleBarycentricsData (float2 data[3]) |
static __forceinline__ __device__ void | optixGetLinearCurveVertexData (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float4 data[2]) |
static __forceinline__ __device__ void | optixGetQuadraticBSplineVertexData (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float4 data[3]) |
static __forceinline__ __device__ void | optixGetCubicBSplineVertexData (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float4 data[4]) |
static __forceinline__ __device__ void | optixGetCatmullRomVertexData (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float4 data[4]) |
static __forceinline__ __device__ void | optixGetCubicBezierVertexData (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float4 data[4]) |
static __forceinline__ __device__ void | optixGetRibbonVertexData (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float4 data[3]) |
static __forceinline__ __device__ float3 | optixGetRibbonNormal (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float2 ribbonParameters) |
static __forceinline__ __device__ void | optixGetSphereData (OptixTraversableHandle gas, unsigned int primIdx, unsigned int sbtGASIndex, float time, float4 data[1]) |
static __forceinline__ __device__ OptixTraversableHandle | optixGetGASTraversableHandle () |
static __forceinline__ __device__ float | optixGetGASMotionTimeBegin (OptixTraversableHandle gas) |
static __forceinline__ __device__ float | optixGetGASMotionTimeEnd (OptixTraversableHandle gas) |
static __forceinline__ __device__ unsigned int | optixGetGASMotionStepCount (OptixTraversableHandle gas) |
static __forceinline__ __device__ void | optixGetWorldToObjectTransformMatrix (float m[12]) |
static __forceinline__ __device__ void | optixGetObjectToWorldTransformMatrix (float m[12]) |
static __forceinline__ __device__ float3 | optixTransformPointFromWorldToObjectSpace (float3 point) |
static __forceinline__ __device__ float3 | optixTransformVectorFromWorldToObjectSpace (float3 vec) |
static __forceinline__ __device__ float3 | optixTransformNormalFromWorldToObjectSpace (float3 normal) |
static __forceinline__ __device__ float3 | optixTransformPointFromObjectToWorldSpace (float3 point) |
static __forceinline__ __device__ float3 | optixTransformVectorFromObjectToWorldSpace (float3 vec) |
static __forceinline__ __device__ float3 | optixTransformNormalFromObjectToWorldSpace (float3 normal) |
static __forceinline__ __device__ unsigned int | optixGetTransformListSize () |
static __forceinline__ __device__ OptixTraversableHandle | optixGetTransformListHandle (unsigned int index) |
static __forceinline__ __device__ OptixTransformType | optixGetTransformTypeFromHandle (OptixTraversableHandle handle) |
static __forceinline__ __device__ const OptixStaticTransform * | optixGetStaticTransformFromHandle (OptixTraversableHandle handle) |
static __forceinline__ __device__ const OptixSRTMotionTransform * | optixGetSRTMotionTransformFromHandle (OptixTraversableHandle handle) |
static __forceinline__ __device__ const OptixMatrixMotionTransform * | optixGetMatrixMotionTransformFromHandle (OptixTraversableHandle handle) |
static __forceinline__ __device__ unsigned int | optixGetInstanceIdFromHandle (OptixTraversableHandle handle) |
static __forceinline__ __device__ OptixTraversableHandle | optixGetInstanceChildFromHandle (OptixTraversableHandle handle) |
static __forceinline__ __device__ const float4 * | optixGetInstanceTransformFromHandle (OptixTraversableHandle handle) |
static __forceinline__ __device__ const float4 * | optixGetInstanceInverseTransformFromHandle (OptixTraversableHandle handle) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind, unsigned int a0) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind, unsigned int a0, unsigned int a1) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind, unsigned int a0, unsigned int a1, unsigned int a2) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind, unsigned int a0, unsigned int a1, unsigned int a2, unsigned int a3) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind, unsigned int a0, unsigned int a1, unsigned int a2, unsigned int a3, unsigned int a4) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind, unsigned int a0, unsigned int a1, unsigned int a2, unsigned int a3, unsigned int a4, unsigned int a5) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind, unsigned int a0, unsigned int a1, unsigned int a2, unsigned int a3, unsigned int a4, unsigned int a5, unsigned int a6) |
static __forceinline__ __device__ bool | optixReportIntersection (float hitT, unsigned int hitKind, unsigned int a0, unsigned int a1, unsigned int a2, unsigned int a3, unsigned int a4, unsigned int a5, unsigned int a6, unsigned int a7) |
static __forceinline__ __device__ unsigned int | optixGetAttribute_0 () |
static __forceinline__ __device__ unsigned int | optixGetAttribute_1 () |
static __forceinline__ __device__ unsigned int | optixGetAttribute_2 () |
static __forceinline__ __device__ unsigned int | optixGetAttribute_3 () |
static __forceinline__ __device__ unsigned int | optixGetAttribute_4 () |
static __forceinline__ __device__ unsigned int | optixGetAttribute_5 () |
static __forceinline__ __device__ unsigned int | optixGetAttribute_6 () |
static __forceinline__ __device__ unsigned int | optixGetAttribute_7 () |
static __forceinline__ __device__ void | optixTerminateRay () |
static __forceinline__ __device__ void | optixIgnoreIntersection () |
static __forceinline__ __device__ unsigned int | optixGetPrimitiveIndex () |
static __forceinline__ __device__ unsigned int | optixGetSbtGASIndex () |
static __forceinline__ __device__ unsigned int | optixGetInstanceId () |
static __forceinline__ __device__ unsigned int | optixGetInstanceIndex () |
static __forceinline__ __device__ unsigned int | optixGetHitKind () |
static __forceinline__ __device__ OptixPrimitiveType | optixGetPrimitiveType (unsigned int hitKind) |
static __forceinline__ __device__ bool | optixIsFrontFaceHit (unsigned int hitKind) |
static __forceinline__ __device__ bool | optixIsBackFaceHit (unsigned int hitKind) |
static __forceinline__ __device__ OptixPrimitiveType | optixGetPrimitiveType () |
static __forceinline__ __device__ bool | optixIsFrontFaceHit () |
static __forceinline__ __device__ bool | optixIsBackFaceHit () |
static __forceinline__ __device__ bool | optixIsTriangleHit () |
static __forceinline__ __device__ bool | optixIsTriangleFrontFaceHit () |
static __forceinline__ __device__ bool | optixIsTriangleBackFaceHit () |
static __forceinline__ __device__ bool | optixIsDisplacedMicromeshTriangleHit () |
static __forceinline__ __device__ bool | optixIsDisplacedMicromeshTriangleFrontFaceHit () |
static __forceinline__ __device__ bool | optixIsDisplacedMicromeshTriangleBackFaceHit () |
static __forceinline__ __device__ float2 | optixGetTriangleBarycentrics () |
static __forceinline__ __device__ float | optixGetCurveParameter () |
static __forceinline__ __device__ float2 | optixGetRibbonParameters () |
static __forceinline__ __device__ uint3 | optixGetLaunchIndex () |
static __forceinline__ __device__ uint3 | optixGetLaunchDimensions () |
static __forceinline__ __device__ CUdeviceptr | optixGetSbtDataPointer () |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode) |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode, unsigned int exceptionDetail0) |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode, unsigned int exceptionDetail0, unsigned int exceptionDetail1) |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode, unsigned int exceptionDetail0, unsigned int exceptionDetail1, unsigned int exceptionDetail2) |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode, unsigned int exceptionDetail0, unsigned int exceptionDetail1, unsigned int exceptionDetail2, unsigned int exceptionDetail3) |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode, unsigned int exceptionDetail0, unsigned int exceptionDetail1, unsigned int exceptionDetail2, unsigned int exceptionDetail3, unsigned int exceptionDetail4) |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode, unsigned int exceptionDetail0, unsigned int exceptionDetail1, unsigned int exceptionDetail2, unsigned int exceptionDetail3, unsigned int exceptionDetail4, unsigned int exceptionDetail5) |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode, unsigned int exceptionDetail0, unsigned int exceptionDetail1, unsigned int exceptionDetail2, unsigned int exceptionDetail3, unsigned int exceptionDetail4, unsigned int exceptionDetail5, unsigned int exceptionDetail6) |
static __forceinline__ __device__ void | optixThrowException (int exceptionCode, unsigned int exceptionDetail0, unsigned int exceptionDetail1, unsigned int exceptionDetail2, unsigned int exceptionDetail3, unsigned int exceptionDetail4, unsigned int exceptionDetail5, unsigned int exceptionDetail6, unsigned int exceptionDetail7) |
static __forceinline__ __device__ int | optixGetExceptionCode () |
static __forceinline__ __device__ unsigned int | optixGetExceptionDetail_0 () |
static __forceinline__ __device__ unsigned int | optixGetExceptionDetail_1 () |
static __forceinline__ __device__ unsigned int | optixGetExceptionDetail_2 () |
static __forceinline__ __device__ unsigned int | optixGetExceptionDetail_3 () |
static __forceinline__ __device__ unsigned int | optixGetExceptionDetail_4 () |
static __forceinline__ __device__ unsigned int | optixGetExceptionDetail_5 () |
static __forceinline__ __device__ unsigned int | optixGetExceptionDetail_6 () |
static __forceinline__ __device__ unsigned int | optixGetExceptionDetail_7 () |
static __forceinline__ __device__ OptixTraversableHandle | optixGetExceptionInvalidTraversable () |
static __forceinline__ __device__ int | optixGetExceptionInvalidSbtOffset () |
static __forceinline__ __device__ OptixInvalidRayExceptionDetails | optixGetExceptionInvalidRay () |
static __forceinline__ __device__ OptixParameterMismatchExceptionDetails | optixGetExceptionParameterMismatch () |
static __forceinline__ __device__ char * | optixGetExceptionLineInfo () |
template<typename ReturnT , typename... ArgTypes> | |
static __forceinline__ __device__ ReturnT | optixDirectCall (unsigned int sbtIndex, ArgTypes... args) |
template<typename ReturnT , typename... ArgTypes> | |
static __forceinline__ __device__ ReturnT | optixContinuationCall (unsigned int sbtIndex, ArgTypes... args) |
static __forceinline__ __device__ uint4 | optixTexFootprint2D (unsigned long long tex, unsigned int texInfo, float x, float y, unsigned int *singleMipLevel) |
static __forceinline__ __device__ uint4 | optixTexFootprint2DLod (unsigned long long tex, unsigned int texInfo, float x, float y, float level, bool coarse, unsigned int *singleMipLevel) |
static __forceinline__ __device__ uint4 | optixTexFootprint2DGrad (unsigned long long tex, unsigned int texInfo, float x, float y, float dPdx_x, float dPdx_y, float dPdy_x, float dPdy_y, bool coarse, unsigned int *singleMipLevel) |
OptiX Device API.
|
static |
Creates a call to the continuation callable program at the specified SBT entry.
This will call the program that was specified in the OptixProgramGroupCallables::entryFunctionNameCC in the module specified by OptixProgramGroupCallables::moduleCC. The address of the SBT entry is calculated by OptixShaderBindingTable::callablesRecordBase + ( OptixShaderBindingTable::callablesRecordStrideInBytes * sbtIndex ). As opposed to direct callable programs, continuation callable programs are allowed to call optixTrace recursively.
Behavior is undefined if there is no continuation callable program at the specified SBT entry.
Behavior is undefined if the number of arguments that are being passed in does not match the number of parameters expected by the program that is called. In that case an exception of type OPTIX_EXCEPTION_CODE_CALLABLE_PARAMETER_MISMATCH will be thrown if OPTIX_EXCEPTION_FLAG_DEBUG was specified for the OptixPipelineCompileOptions::exceptionFlags.
[in] | sbtIndex | The offset of the SBT entry of the continuation callable program to call relative to OptixShaderBindingTable::callablesRecordBase. |
[in] | args | The arguments to pass to the continuation callable program. |
|
static |
Creates a call to the direct callable program at the specified SBT entry.
This will call the program that was specified in the OptixProgramGroupCallables::entryFunctionNameDC in the module specified by OptixProgramGroupCallables::moduleDC. The address of the SBT entry is calculated by OptixShaderBindingTable::callablesRecordBase + ( OptixShaderBindingTable::callablesRecordStrideInBytes * sbtIndex ).
Behavior is undefined if there is no direct callable program at the specified SBT entry.
Behavior is undefined if the number of arguments that are being passed in does not match the number of parameters expected by the program that is called. In that case an exception of type OPTIX_EXCEPTION_CODE_CALLABLE_PARAMETER_MISMATCH will be thrown if OPTIX_EXCEPTION_FLAG_DEBUG was specified for the OptixPipelineCompileOptions::exceptionFlags.
[in] | sbtIndex | The offset of the SBT entry of the direct callable program to call relative to OptixShaderBindingTable::callablesRecordBase. |
[in] | args | The arguments to pass to the direct callable program. |
|
static |
Returns the attribute at slot 0.
|
static |
Returns the attribute at slot 1.
|
static |
Returns the attribute at slot 2.
|
static |
Returns the attribute at slot 3.
|
static |
Returns the attribute at slot 4.
|
static |
Returns the attribute at slot 5.
|
static |
Returns the attribute at slot 6.
|
static |
Returns the attribute at slot 7.
|
static |
Return the object space curve control vertex data of a CatmullRom spline curve in a Geometry Acceleration Structure (GAS) at a given motion time. To access vertex data, the GAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_VERTEX_ACCESS.
data[i] = {x,y,z,w} with {x,y,z} the position and w the radius of control vertex i. If motion is disabled via OptixPipelineCompileOptions::usesMotionBlur, or the GAS does not contain motion, the time parameter is ignored.
|
static |
Return the object space curve control vertex data of a cubic Bezier curve in a Geometry Acceleration Structure (GAS) at a given motion time. To access vertex data, the GAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_VERTEX_ACCESS.
data[i] = {x,y,z,w} with {x,y,z} the position and w the radius of control vertex i. If motion is disabled via OptixPipelineCompileOptions::usesMotionBlur, or the GAS does not contain motion, the time parameter is ignored.
|
static |
Return the object space curve control vertex data of a cubic BSpline curve in a Geometry Acceleration Structure (GAS) at a given motion time. To access vertex data, the GAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_VERTEX_ACCESS.
data[i] = {x,y,z,w} with {x,y,z} the position and w the radius of control vertex i. If motion is disabled via OptixPipelineCompileOptions::usesMotionBlur, or the GAS does not contain motion, the time parameter is ignored.
|
static |
Returns the curve parameter associated with the current intersection when using OptixBuildInputCurveArray objects.
|
static |
Returns the exception code.
Only available in EX.
|
static |
Returns the 32-bit exception detail at slot 0.
The behavior is undefined if the exception is not a user exception, or the used overload optixThrowException() did not provide the queried exception detail.
Only available in EX.
|
static |
Returns the 32-bit exception detail at slot 1.
|
static |
Returns the 32-bit exception detail at slot 2.
|
static |
Returns the 32-bit exception detail at slot 3.
|
static |
Returns the 32-bit exception detail at slot 4.
|
static |
Returns the 32-bit exception detail at slot 5.
|
static |
Returns the 32-bit exception detail at slot 6.
|
static |
Returns the 32-bit exception detail at slot 7.
|
static |
Returns the invalid ray for exceptions with exception code OPTIX_EXCEPTION_CODE_INVALID_RAY. Exceptions of type OPTIX_EXCEPTION_CODE_INVALID_RAY are thrown when one or more values that were passed into optixTrace are either inf or nan.
OptixInvalidRayExceptionDetails::rayTime will always be 0 if OptixPipelineCompileOptions::usesMotionBlur is 0. Values in the returned struct are all zero for all other exception codes.
Only available in EX.
|
static |
Returns the invalid sbt offset for exceptions with exception code OPTIX_EXCEPTION_CODE_TRAVERSAL_INVALID_MISS_SBT and OPTIX_EXCEPTION_CODE_TRAVERSAL_INVALID_HIT_SBT.
Returns zero for all other exception codes.
Only available in EX.
|
static |
Returns the invalid traversable handle for exceptions with exception code OPTIX_EXCEPTION_CODE_TRAVERSAL_INVALID_TRAVERSABLE.
Returns zero for all other exception codes.
Only available in EX.
|
static |
Returns a string that includes information about the source location that caused the current exception.
The source location is only available for exceptions of type OPTIX_EXCEPTION_CODE_CALLABLE_PARAMETER_MISMATCH, OPTIX_EXCEPTION_CODE_UNSUPPORTED_PRIMITIVE_TYPE, OPTIX_EXCEPTION_CODE_INVALID_RAY, and for user exceptions. Line information needs to be present in the input PTX and OptixModuleCompileOptions::debugLevel may not be set to OPTIX_COMPILE_DEBUG_LEVEL_NONE.
Returns a NULL pointer if no line information is available.
Only available in EX.
|
static |
Returns information about an exception with code OPTIX_EXCEPTION_CODE_CALLABLE_PARAMETER_MISMATCH.
Exceptions of type OPTIX_EXCEPTION_CODE_CALLABLE_PARAMETER_MISMATCH are called when the number of arguments that were passed into a call to optixDirectCall or optixContinuationCall does not match the number of parameters of the callable that is called. Note that the parameters are packed by OptiX into individual 32 bit values, so the number of expected and passed values may not correspond to the number of arguments passed into optixDirectCall or optixContinuationCall.
Values in the returned struct are all zero for all other exception codes.
Only available in EX.
|
static |
Returns the number of motion steps of a GAS (see OptixMotionOptions)
|
static |
Returns the motion begin time of a GAS (see OptixMotionOptions)
|
static |
Returns the motion end time of a GAS (see OptixMotionOptions)
|
static |
Returns the traversable handle for the Geometry Acceleration Structure (GAS) containing the current hit. May be called from IS, AH and CH.
|
static |
Returns the 8 bit hit kind associated with the current hit.
Use optixGetPrimitiveType() to interpret the hit kind. For custom intersections (primitive type OPTIX_PRIMITIVE_TYPE_CUSTOM), this is the 7-bit hitKind passed to optixReportIntersection(). Hit kinds greater than 127 are reserved for built-in primitives.
Available only in AH and CH.
|
static |
Returns child traversable handle from an OptixInstance traversable.
Returns 0 if the traversable handle does not reference an OptixInstance.
|
static |
Returns the OPTIX_DEVICE_PROPERTY_LIMIT_MAX_INSTANCE...">OptixInstance::instanceId of the instance within the top level acceleration structure associated with the current intersection.
When building an acceleration structure using OptixBuildInputInstanceArray each OptixInstance has a user supplied instanceId. OptixInstance objects reference another acceleration structure. During traversal the acceleration structures are visited top down. In the IS and AH programs the OPTIX_DEVICE_PROPERTY_LIMIT_MAX_INSTANCE...">OptixInstance::instanceId corresponding to the most recently visited OptixInstance is returned when calling optixGetInstanceId(). In CH optixGetInstanceId() returns the OPTIX_DEVICE_PROPERTY_LIMIT_MAX_INSTANCE...">OptixInstance::instanceId when the hit was recorded with optixReportIntersection. In the case where there is no OptixInstance visited, optixGetInstanceId returns ~0u
|
static |
Returns instanceId from an OptixInstance traversable.
Returns 0 if the traversable handle does not reference an OptixInstance.
|
static |
Returns the zero-based index of the instance within its instance acceleration structure associated with the current intersection.
In the IS and AH programs the index corresponding to the most recently visited OptixInstance is returned when calling optixGetInstanceIndex(). In CH optixGetInstanceIndex() returns the index when the hit was recorded with optixReportIntersection. In the case where there is no OptixInstance visited, optixGetInstanceIndex returns 0
|
static |
Returns world-to-object transform from an OptixInstance traversable.
Returns 0 if the traversable handle does not reference an OptixInstance.
|
static |
Returns object-to-world transform from an OptixInstance traversable.
Returns 0 if the traversable handle does not reference an OptixInstance.
|
static |
Return the traversable handle of a given instance in an Instance Acceleration Structure (IAS) To obtain instance traversables by index, the IAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_INSTANCE_ACCESS.
|
static |
Available in any program, it returns the dimensions of the current launch specified by optixLaunch on the host.
|
static |
Available in any program, it returns the current launch index within the launch dimensions specified by optixLaunch on the host.
The raygen program is typically only launched once per launch index.
|
static |
Return the object space curve control vertex data of a linear curve in a Geometry Acceleration Structure (GAS) at a given motion time. To access vertex data, the GAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_VERTEX_ACCESS.
data[i] = {x,y,z,w} with {x,y,z} the position and w the radius of control vertex i. If motion is disabled via OptixPipelineCompileOptions::usesMotionBlur, or the GAS does not contain motion, the time parameter is ignored.
|
static |
Returns a pointer to a OptixMatrixMotionTransform from its traversable handle.
Returns 0 if the traversable is not of type OPTIX_TRANSFORM_TYPE_MATRIX_MOTION_TRANSFORM.
|
static |
Returns the barycentrics of the vertices of the currently intersected micro triangle with respect to the base triangle.
|
static |
Return the object space micro triangle vertex positions of the current hit. The current hit must be a displacement micromap triangle hit.
|
static |
Returns the current object space ray direction based on the current transform stack.
Only available in IS and AH.
|
static |
Returns the current object space ray origin based on the current transform stack.
Only available in IS and AH.
|
static |
Returns the object-to-world transformation matrix resulting from the current active transformation list.
The cost of this function may be proportional to the size of the transformation list.
|
static |
Reads the 32-bit payload value at slot 0.
|
static |
Reads the 32-bit payload value at slot 1.
|
static |
Reads the 32-bit payload value at slot 10.
|
static |
Reads the 32-bit payload value at slot 11.
|
static |
Reads the 32-bit payload value at slot 12.
|
static |
Reads the 32-bit payload value at slot 13.
|
static |
Reads the 32-bit payload value at slot 14.
|
static |
Reads the 32-bit payload value at slot 15.
|
static |
Reads the 32-bit payload value at slot 16.
|
static |
Reads the 32-bit payload value at slot 17.
|
static |
Reads the 32-bit payload value at slot 18.
|
static |
Reads the 32-bit payload value at slot 19.
|
static |
Reads the 32-bit payload value at slot 2.
|
static |
Reads the 32-bit payload value at slot 20.
|
static |
Reads the 32-bit payload value at slot 21.
|
static |
Reads the 32-bit payload value at slot 22.
|
static |
Reads the 32-bit payload value at slot 23.
|
static |
Reads the 32-bit payload value at slot 24.
|
static |
Reads the 32-bit payload value at slot 25.
|
static |
Reads the 32-bit payload value at slot 26.
|
static |
Reads the 32-bit payload value at slot 27.
|
static |
Reads the 32-bit payload value at slot 28.
|
static |
Reads the 32-bit payload value at slot 29.
|
static |
Reads the 32-bit payload value at slot 3.
|
static |
Reads the 32-bit payload value at slot 30.
|
static |
Reads the 32-bit payload value at slot 31.
|
static |
Reads the 32-bit payload value at slot 4.
|
static |
Reads the 32-bit payload value at slot 5.
|
static |
Reads the 32-bit payload value at slot 6.
|
static |
Reads the 32-bit payload value at slot 7.
|
static |
Reads the 32-bit payload value at slot 8.
|
static |
Reads the 32-bit payload value at slot 9.
|
static |
For a given OptixBuildInputTriangleArray the number of primitives is defined as "(OptixBuildInputTriangleArray::indexBuffer == 0) ? OptixBuildInputTriangleArray::numVertices/3 : OptixBuildInputTriangleArray::numIndexTriplets;". For a given OptixBuildInputCustomPrimitiveArray the number of primitives is defined as numAabbs.
The primitive index returns the index into the array of primitives plus the primitiveIndexOffset.
In IS and AH this corresponds to the currently intersected primitive. In CH this corresponds to the primitive index of the closest intersected primitive.
|
static |
Function interpreting the hit kind associated with the current optixReportIntersection.
|
static |
Function interpreting the result of optixGetHitKind().
|
static |
Return the object space curve control vertex data of a quadratic BSpline curve in a Geometry Acceleration Structure (GAS) at a given motion time. To access vertex data, the GAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_VERTEX_ACCESS.
data[i] = {x,y,z,w} with {x,y,z} the position and w the radius of control vertex i. If motion is disabled via OptixPipelineCompileOptions::usesMotionBlur, or the GAS does not contain motion, the time parameter is ignored.
|
static |
Returns the rayFlags passed into optixTrace.
Only available in IS, AH, CH, MS
|
static |
Returns the rayTime passed into optixTrace.
Will return 0 if motion is disabled. Only available in IS, AH, CH, MS
|
static |
In IS and CH returns the current smallest reported hitT or the tmax passed into optixTrace if no hit has been reported In AH returns the hitT value as passed in to optixReportIntersection In MS returns the tmax passed into optixTrace Only available in IS, AH, CH, MS.
|
static |
Returns the tmin passed into optixTrace.
Only available in IS, AH, CH, MS
|
static |
Returns the visibilityMask passed into optixTrace.
Only available in IS, AH, CH, MS
|
static |
Return ribbon normal at intersection reported by optixReportIntersection.
|
static |
Returns the ribbon parameters along directrix (length) and generator (width) of the current intersection when using OptixBuildInputCurveArray objects with curveType OPTIX_PRIMITIVE_TYPE_FLAT_QUADRATIC_BSPLINE.
|
static |
Return the object space curve control vertex data of a ribbon (flat quadratic BSpline) in a Geometry Acceleration Structure (GAS) at a given motion time. To access vertex data, the GAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_VERTEX_ACCESS.
data[i] = {x,y,z,w} with {x,y,z} the position and w the radius of control vertex i. If motion is disabled via OptixPipelineCompileOptions::usesMotionBlur, or the GAS does not contain motion, the time parameter is ignored.
|
static |
Returns the generic memory space pointer to the data region (past the header) of the currently active SBT record corresponding to the current program.
|
static |
Returns the Sbt GAS index of the primitive associated with the current intersection.
In IS and AH this corresponds to the currently intersected primitive. In CH this corresponds to the Sbt GAS index of the closest intersected primitive. In EX with exception code OPTIX_EXCEPTION_CODE_TRAVERSAL_INVALID_HIT_SBT corresponds to the sbt index within the hit GAS. Returns zero for all other exceptions.
|
static |
Return the object space sphere data, center point and radius, in a Geometry Acceleration Structure (GAS) at a given motion time. To access sphere data, the GAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_VERTEX_ACCESS.
data[0] = {x,y,z,w} with {x,y,z} the position of the sphere center and w the radius. If motion is disabled via OptixPipelineCompileOptions::usesMotionBlur, or the GAS does not contain motion, the time parameter is ignored.
|
static |
Returns a pointer to a OptixSRTMotionTransform from its traversable handle.
Returns 0 if the traversable is not of type OPTIX_TRANSFORM_TYPE_SRT_MOTION_TRANSFORM.
|
static |
Returns a pointer to a OptixStaticTransform from its traversable handle.
Returns 0 if the traversable is not of type OPTIX_TRANSFORM_TYPE_STATIC_TRANSFORM.
|
static |
Returns the traversable handle for a transform on the current transform list.
Only available in IS, AH, CH, EX
|
static |
Returns the number of transforms on the current transform list.
Only available in IS, AH, CH, EX
|
static |
Returns the transform type of a traversable handle from a transform list.
|
static |
Convenience function that returns the first two attributes as floats.
When using OptixBuildInputTriangleArray objects, during intersection the barycentric coordinates are stored into the first two attribute registers.
|
static |
Return the object space triangle vertex positions of a given triangle in a Geometry Acceleration Structure (GAS) at a given motion time. To access vertex data, the GAS must be built using the flag OPTIX_BUILD_FLAG_ALLOW_RANDOM_VERTEX_ACCESS.
If motion is disabled via OptixPipelineCompileOptions::usesMotionBlur, or the GAS does not contain motion, the time parameter is ignored.
|
static |
Returns the rayDirection passed into optixTrace.
May be more expensive to call in IS and AH than their object space counterparts, so effort should be made to use the object space ray in those programs. Only available in IS, AH, CH, MS
|
static |
Returns the rayOrigin passed into optixTrace.
May be more expensive to call in IS and AH than their object space counterparts, so effort should be made to use the object space ray in those programs. Only available in IS, AH, CH, MS
|
static |
Returns the world-to-object transformation matrix resulting from the current active transformation list.
The cost of this function may be proportional to the size of the transformation list.
|
static |
Discards the hit, and returns control to the calling optixReportIntersection or built-in intersection routine.
Available only in AH.
|
static |
Function interpreting the hit kind associated with the current optixReportIntersection.
|
static |
Function interpreting the result of optixGetHitKind().
|
static |
Convenience function interpreting the result of optixGetHitKind().
|
static |
Convenience function interpreting the result of optixGetHitKind().
|
static |
Convenience function interpreting the result of optixGetHitKind().
|
static |
Function interpreting the hit kind associated with the current optixReportIntersection.
|
static |
Function interpreting the result of optixGetHitKind().
|
static |
Convenience function interpreting the result of optixGetHitKind().
|
static |
Convenience function interpreting the result of optixGetHitKind().
|
static |
Convenience function interpreting the result of optixGetHitKind().
|
static |
Reports an intersections (overload without attributes).
If optixGetRayTmin() <= hitT <= optixGetRayTmax(), the any hit program associated with this intersection program (via the SBT entry) is called. The AH program can do one of three things:
The attributes specified with a0..a7 are available in the AH and CH programs. Note that the attributes available in the CH program correspond to the closest recorded intersection. The number of attributes in registers and memory can be configured in the pipeline.
[in] | hitT | |
[in] | hitKind |
|
static |
Reports an intersection (overload with 1 attribute register).
|
static |
Reports an intersection (overload with 2 attribute registers).
|
static |
Reports an intersection (overload with 3 attribute registers).
|
static |
Reports an intersection (overload with 4 attribute registers).
|
static |
Reports an intersection (overload with 5 attribute registers).
|
static |
Reports an intersection (overload with 6 attribute registers).
|
static |
Reports an intersection (overload with 7 attribute registers).
|
static |
Reports an intersection (overload with 8 attribute registers).
|
static |
Writes the 32-bit payload value at slot 0.
|
static |
Writes the 32-bit payload value at slot 1.
|
static |
Writes the 32-bit payload value at slot 10.
|
static |
Writes the 32-bit payload value at slot 11.
|
static |
Writes the 32-bit payload value at slot 12.
|
static |
Writes the 32-bit payload value at slot 13.
|
static |
Writes the 32-bit payload value at slot 14.
|
static |
Writes the 32-bit payload value at slot 15.
|
static |
Writes the 32-bit payload value at slot 16.
|
static |
Writes the 32-bit payload value at slot 17.
|
static |
Writes the 32-bit payload value at slot 18.
|
static |
Writes the 32-bit payload value at slot 19.
|
static |
Writes the 32-bit payload value at slot 2.
|
static |
Writes the 32-bit payload value at slot 20.
|
static |
Writes the 32-bit payload value at slot 21.
|
static |
Writes the 32-bit payload value at slot 22.
|
static |
Writes the 32-bit payload value at slot 23.
|
static |
Writes the 32-bit payload value at slot 24.
|
static |
Writes the 32-bit payload value at slot 25.
|
static |
Writes the 32-bit payload value at slot 26.
|
static |
Writes the 32-bit payload value at slot 27.
|
static |
Writes the 32-bit payload value at slot 28.
|
static |
Writes the 32-bit payload value at slot 29.
|
static |
Writes the 32-bit payload value at slot 3.
|
static |
Writes the 32-bit payload value at slot 30.
|
static |
Writes the 32-bit payload value at slot 31.
|
static |
Writes the 32-bit payload value at slot 4.
|
static |
Writes the 32-bit payload value at slot 5.
|
static |
Writes the 32-bit payload value at slot 6.
|
static |
Writes the 32-bit payload value at slot 7.
|
static |
Writes the 32-bit payload value at slot 8.
|
static |
Writes the 32-bit payload value at slot 9.
|
static |
Specify the supported payload types for a program.
The supported types are specified as a bitwise combination of payload types. (See OptixPayloadTypeID) May only be called once per program. Must be called at the top of the program. Only available in IS, AH, CH, MS
|
static |
Record the hit, stops traversal, and proceeds to CH.
Available only in AH.
|
static |
optixTexFootprint2D calculates the footprint of a corresponding 2D texture fetch (non-mipmapped).
On Turing and subsequent architectures, a texture footprint instruction allows user programs to determine the set of texels that would be accessed by an equivalent filtered texture lookup.
[in] | tex | CUDA texture object (cast to 64-bit integer) |
[in] | texInfo | Texture info packed into 32-bit integer, described below. |
[in] | x | Texture coordinate |
[in] | y | Texture coordinate |
[out] | singleMipLevel | Result indicating whether the footprint spans only a single miplevel. |
The texture info argument is a packed 32-bit integer with the following layout:
texInfo[31:29] = reserved (3 bits) texInfo[28:24] = miplevel count (5 bits) texInfo[23:20] = log2 of tile width (4 bits) texInfo[19:16] = log2 of tile height (4 bits) texInfo[15:10] = reserved (6 bits) texInfo[9:8] = horizontal wrap mode (2 bits) (CUaddress_mode) texInfo[7:6] = vertical wrap mode (2 bits) (CUaddress_mode) texInfo[5] = mipmap filter mode (1 bit) (CUfilter_mode) texInfo[4:0] = maximum anisotropy (5 bits)
Returns a 16-byte structure (as a uint4) that stores the footprint of a texture request at a particular "granularity", which has the following layout:
struct Texture2DFootprint { unsigned long long mask; unsigned int tileY : 12; unsigned int reserved1 : 4; unsigned int dx : 3; unsigned int dy : 3; unsigned int reserved2 : 2; unsigned int granularity : 4; unsigned int reserved3 : 4; unsigned int tileX : 12; unsigned int level : 4; unsigned int reserved4 : 16; };
The granularity indicates the size of texel groups that are represented by an 8x8 bitmask. For example, a granularity of 12 indicates texel groups that are 128x64 texels in size. In a footprint call, The returned granularity will either be the actual granularity of the result, or 0 if the footprint call was able to honor the requested granularity (the usual case).
level is the mip level of the returned footprint. Two footprint calls are needed to get the complete footprint when a texture call spans multiple mip levels.
mask is an 8x8 bitmask of texel groups that are covered, or partially covered, by the footprint. tileX and tileY give the starting position of the mask in 8x8 texel-group blocks. For example, suppose a granularity of 12 (128x64 texels), and tileX=3 and tileY=4. In this case, bit 0 of the mask (the low order bit) corresponds to texel group coordinates (3*8, 4*8), and texel coordinates (3*8*128, 4*8*64), within the specified mip level.
If nonzero, dx and dy specify a "toroidal rotation" of the bitmask. Toroidal rotation of a coordinate in the mask simply means that its value is reduced by 8. Continuing the example from above, if dx=0 and dy=0 the mask covers texel groups (3*8, 4*8) to (3*8+7, 4*8+7) inclusive. If, on the other hand, dx=2, the rightmost 2 columns in the mask have their x coordinates reduced by 8, and similarly for dy.
See the OptiX SDK for sample code that illustrates how to unpack the result.
|
static |
optixTexFootprint2DGrad calculates the footprint of a corresponding 2D texture fetch (tex2DGrad)
[in] | tex | CUDA texture object (cast to 64-bit integer) |
[in] | texInfo | Texture info packed into 32-bit integer, described below. |
[in] | x | Texture coordinate |
[in] | y | Texture coordinate |
[in] | dPdx_x | Derivative of x coordinte, which determines level of detail. |
[in] | dPdx_y | Derivative of x coordinte, which determines level of detail. |
[in] | dPdy_x | Derivative of y coordinte, which determines level of detail. |
[in] | dPdy_y | Derivative of y coordinte, which determines level of detail. |
[in] | coarse | Requests footprint from coarse miplevel, when the footprint spans two levels. |
[out] | singleMipLevel | Result indicating whether the footprint spans only a single miplevel. |
|
static |
optixTexFootprint2DLod calculates the footprint of a corresponding 2D texture fetch (tex2DLod)
[in] | tex | CUDA texture object (cast to 64-bit integer) |
[in] | texInfo | Texture info packed into 32-bit integer, described below. |
[in] | x | Texture coordinate |
[in] | y | Texture coordinate |
[in] | level | Level of detail (lod) |
[in] | coarse | Requests footprint from coarse miplevel, when the footprint spans two levels. |
[out] | singleMipLevel | Result indicating whether the footprint spans only a single miplevel. |
|
static |
Throws a user exception with the given exception code (overload without exception details).
The exception code must be in the range from 0 to 2^30 - 1. Up to 8 optional exception details can be passed. They can be queried in the EX program using optixGetExceptionDetail_0() to ..._8().
The exception details must not be used to encode pointers to the stack since the current stack is not preserved in the EX program.
Not available in EX.
[in] | exceptionCode | The exception code to be thrown. |
|
static |
Throws a user exception with the given exception code (overload with 1 exception detail).
|
static |
Throws a user exception with the given exception code (overload with 2 exception details).
|
static |
Throws a user exception with the given exception code (overload with 3 exception details).
|
static |
Throws a user exception with the given exception code (overload with 4 exception details).
|
static |
Throws a user exception with the given exception code (overload with 5 exception details).
|
static |
Throws a user exception with the given exception code (overload with 6 exception details).
|
static |
Throws a user exception with the given exception code (overload with 7 exception details).
|
static |
Throws a user exception with the given exception code (overload with 8 exception details).
|
static |
Initiates a ray tracing query starting with the given traversable.
[in] | type | |
[in] | handle | |
[in] | rayOrigin | |
[in] | rayDirection | |
[in] | tmin | |
[in] | tmax | |
[in] | rayTime | |
[in] | visibilityMask | really only 8 bits |
[in] | rayFlags | really only 16 bits, combination of OptixRayFlags |
[in] | SBToffset | really only 4 bits |
[in] | SBTstride | really only 4 bits |
[in] | missSBTIndex | specifies the miss program invoked on a miss |
[in,out] | payload | up to 32 unsigned int values that hold the payload |
|
static |
Initiates a ray tracing query starting with the given traversable.
[in] | handle | |
[in] | rayOrigin | |
[in] | rayDirection | |
[in] | tmin | |
[in] | tmax | |
[in] | rayTime | |
[in] | visibilityMask | really only 8 bits |
[in] | rayFlags | really only 16 bits, combination of OptixRayFlags |
[in] | SBToffset | really only 4 bits |
[in] | SBTstride | really only 4 bits |
[in] | missSBTIndex | specifies the miss program invoked on a miss |
[in,out] | payload | up to 32 unsigned int values that hold the payload |
|
static |
Transforms the normal using object-to-world transformation matrix resulting from the current active transformation list.
The cost of this function may be proportional to the size of the transformation list.
|
static |
Transforms the normal using world-to-object transformation matrix resulting from the current active transformation list.
The cost of this function may be proportional to the size of the transformation list.
|
static |
Transforms the point using object-to-world transformation matrix resulting from the current active transformation list.
The cost of this function may be proportional to the size of the transformation list.
|
static |
Transforms the point using world-to-object transformation matrix resulting from the current active transformation list.
The cost of this function may be proportional to the size of the transformation list.
|
static |
Transforms the vector using object-to-world transformation matrix resulting from the current active transformation list.
The cost of this function may be proportional to the size of the transformation list.
|
static |
Transforms the vector using world-to-object transformation matrix resulting from the current active transformation list.
The cost of this function may be proportional to the size of the transformation list.
|
static |
Returns an undefined value.