Support Forum G3D Web Page |
Inherits G3D::TriTreeBase.
Classes | |
class | Field |
struct | SurfaceCacheElement |
struct | VertexCacheElement |
Public Types | |
typedef unsigned int | IntersectRayOptions |
Options for intersectRays. More... | |
Public Member Functions | |
virtual | ~OptiXTriTree () |
wave::BVH * | BVH () |
virtual const String & | className () const override |
virtual void | clear () override |
virtual void | intersectBox (const AABox &box, Array< Tri > &results) const override |
Returns all triangles that lie within the box. More... | |
virtual bool | intersectRay (const Ray &ray, Hit &hit, IntersectRayOptions options=IntersectRayOptions(0)) const override |
Intersect a single ray. More... | |
shared_ptr< Surfel > | intersectRay (const Ray &ray) const |
Special single-ray CPU function for simplicity. More... | |
virtual void | intersectRays (const shared_ptr< Texture > &rayOrigin, const shared_ptr< Texture > &rayDirection, const shared_ptr< GBuffer > &results, IntersectRayOptions options=IntersectRayOptions(0), const shared_ptr< Texture > &rayCone=nullptr) const override |
virtual void | intersectRays (const shared_ptr< Texture > &rayOrigin, const shared_ptr< Texture > &rayDirection, const shared_ptr< Texture > &booleanResults, IntersectRayOptions options=IntersectRayOptions(0)) const override |
void | intersectRays (const shared_ptr< GLPixelTransferBuffer > &rayOrigins, const shared_ptr< GLPixelTransferBuffer > &rayDirections, Array< Hit > &results, IntersectRayOptions options) const |
virtual void | intersectRays (const Array< Ray > &rays, Array< shared_ptr< Surfel >> &results, IntersectRayOptions options=IntersectRayOptions(0), const Array< float > &coneBuffer=Array< float >()) const override |
Values in results will be reused if already allocated, which can increase performance. More... | |
virtual void | intersectRays (const Array< Ray > &rays, Array< bool > &results, IntersectRayOptions options=IntersectRayOptions(0)) const override |
virtual void | intersectRays (const Array< Ray > &rays, Array< Hit > &results, IntersectRayOptions options=IntersectRayOptions(0)) const override |
Batch ray casting. More... | |
virtual void | intersectRays (const shared_ptr< GLPixelTransferBuffer > &rayOrigin, const shared_ptr< GLPixelTransferBuffer > &rayDirection, const shared_ptr< GLPixelTransferBuffer > results[5], IntersectRayOptions options=IntersectRayOptions(0), const shared_ptr< GLPixelTransferBuffer > &rayCone=nullptr, const int baseMipLevel=0, const Vector2int32 wavefrontDimensions=Vector2int32(-1,-1), const RenderMask mask=0xFF) const override |
virtual void | intersectRays (const shared_ptr< GLPixelTransferBuffer > &rayOrigin, const shared_ptr< GLPixelTransferBuffer > &rayDirection, const shared_ptr< GLPixelTransferBuffer > &booleanResults, IntersectRayOptions options=IntersectRayOptions(0)) const override |
virtual void | intersectSphere (const Sphere &sphere, Array< Tri > &triArray) const override |
Returns all triangles that intersect or are contained within the sphere (technically, this is a ball intersection). More... | |
RealTime | lastBuildTime () const |
Time at which setContents() or rebuild() was last invoked. More... | |
const Tri & | operator[] (int i) const |
Array access to the stored Tris. More... | |
virtual void | OptiXTriTree::rebuild () override |
virtual void | rebuild ()=0 |
Rebuild the tree after m_triArray or CPUVertexArray have been mutated. More... | |
void | sample (const Hit &hit, shared_ptr< Surfel > &surfel) const |
virtual void | setContents (const Array< shared_ptr< Surface >> &surfaceArray, ImageStorage newImageStorage=ImageStorage::COPY_TO_CPU) override |
Base class implementation populates m_triArray and m_vertexArray and applies the image storage option. More... | |
virtual void | setContents (const shared_ptr< class Scene > &scene, ImageStorage newStorage=ImageStorage::COPY_TO_CPU) override |
virtual void | setContents (const Array< Tri > &triArray, const CPUVertexArray &vertexArray, ImageStorage newStorage=ImageStorage::COPY_TO_CPU) |
virtual void | setContents (const Array< shared_ptr< Surface > > &surfaceArray, ImageStorage newStorage=ImageStorage::COPY_TO_CPU) override |
void | setTimingCallback (wave::TimingCallback *callback, int verbosityLevel) |
Set a timing function callback to print timing details from OptiX. More... | |
int | size () const |
bool | supported () |
If false after construction then OptiXTriTree will not work on this machine and you should switch to EmbreeTriTree. More... | |
const Array< Tri > & | triArray () const |
Array< Tri > & | triArray () |
If you mutate this, you must call rebuild() More... | |
const CPUVertexArray & | vertexArray () const |
CPUVertexArray & | vertexArray () |
If you mutate this, you must call rebuild() More... | |
Static Public Member Functions | |
static shared_ptr< OptiXTriTree > | create () |
static shared_ptr< TriTree > | create (bool preferGPUData=true) |
Create an instance of whatever is the fastest implementation subclass for this machine. More... | |
static shared_ptr< TriTree > | create (const shared_ptr< Scene > &scene, ImageStorage newImageStorage) |
Public Attributes | |
RealTime | debugConversionOverheadTime = 0 |
CPU timing of API conversion overhead for the most recent call to intersectRays. More... | |
Static Public Attributes | |
static const IntersectRayOptions | COHERENT_RAY_HINT = 16 |
Make optimizations appropriate for coherent rays (same origin) More... | |
static const IntersectRayOptions | DO_NOT_CULL_BACKFACES = 2 |
Do not allow the intersector to perform backface culling as an optimization. More... | |
static const IntersectRayOptions | NO_PARTIAL_COVERAGE_TEST = 8 |
Disable partial coverage (alpha) testing. More... | |
static const IntersectRayOptions | OCCLUSION_TEST_ONLY = 1 |
Test for occlusion and do not necessarily return valid triIndex, backfacing, etc. More... | |
static const IntersectRayOptions | PARTIAL_COVERAGE_THRESHOLD_ZERO = 4 |
Only fail the partial coverage (alpha) test on zero coverage. More... | |
Protected Types | |
using | CFrameCache = Table< CFrame, int > |
using | SurfaceCache = Table< SurfaceId, SurfaceCacheElement > |
using | VertexCache = Table< const CPUVertexArray *, VertexCacheElement > |
Protected Member Functions | |
OptiXTriTree () | |
bool | _intersectRay (const Ray &ray, Hit &hit, IntersectRayOptions options) const |
void | copyToRayPBOs (const Array< Ray > &rays) const |
void | ensureMaterialCached (const shared_ptr< UniversalMaterial > &material) |
void | intersectRays (const shared_ptr< GLPixelTransferBuffer > &rayOrigins, const shared_ptr< GLPixelTransferBuffer > &rayDirections, Array< shared_ptr< Surfel >> &results, IntersectRayOptions options) const |
void | registerReallocationAndMapHooks (const shared_ptr< GLPixelTransferBuffer > &t) const |
Static Protected Member Functions | |
static shared_ptr< Texture > | convertToOptiXFormat (const shared_ptr< Texture > &tex) |
static void | copyToCPU (const shared_ptr< GLPixelTransferBuffer > &rayOrigin, const shared_ptr< GLPixelTransferBuffer > &rayDirection, Array< Ray > &rayBuffer, const int width=-1, const int height=-1) |
static void | copyToCPU (const shared_ptr< GLPixelTransferBuffer > &rayCoherence, Array< float > &rayCoherenceBuffer) |
template<class T , class ... ArgTypes> | |
static shared_ptr< T > | createShared (ArgTypes &&... args) |
Like std::make_shared, but works for protected constructors. More... | |
static bool | optixSupportsTexture (const shared_ptr< Texture > &tex) |
Protected Attributes | |
wave::BVH * | m_bvh |
CFrameCache | m_frameCache |
shared_ptr< Texture > | m_ignoreTexture |
RealTime | m_lastBuildTime = -1e6 |
Table< shared_ptr< Material >, MaterialIndex > | m_materialCache |
int | m_nextFrameCacheID = 0 |
int | m_outHeight = -1 |
Array< shared_ptr< GLPixelTransferBuffer > > | m_outPBOArray |
int | m_outWidth = -1 |
shared_ptr< GLPixelTransferBuffer > | m_rayDirections |
shared_ptr< GLPixelTransferBuffer > | m_rayOrigins |
Table< int, weak_ptr< GLPixelTransferBuffer > > | m_registeredBufferIDs |
shared_ptr< CubeMap > | m_sky |
SurfaceCache | m_surfaceCache |
Array< Tri > | m_triArray |
CPUVertexArray | m_vertexArray |
VertexCache | m_vertexCache |
|
protected |
|
inherited |
Options for intersectRays.
Default is full intersection with no backface culling optimization and partial coverage (alpha) test passing for values over 0.5.
|
protected |
|
protected |
|
protected |
|
virtual |
|
inlineprotectedinherited |
|
inline |
|
inlineoverridevirtual |
Implements G3D::TriTree.
|
overridevirtualinherited |
Implements G3D::TriTree.
Reimplemented in G3D::NativeTriTree.
|
staticprotected |
|
staticprotectedinherited |
|
staticprotectedinherited |
|
inlinestatic |
|
staticinherited |
Create an instance of whatever is the fastest implementation subclass for this machine.
preferGPUData | If true, use an implementation that is fast for ray buffers already on the GPU. |
Referenced by G3D::MeshShape::bspTree().
|
staticinherited |
|
inlinestaticprotectedinherited |
Like std::make_shared, but works for protected constructors.
Call as createShared<myclass>.
|
protected |
|
overridevirtualinherited |
Returns all triangles that lie within the box.
Default implementation tests each triangle in turn (linear time).
Implements G3D::TriTree.
Reimplemented in G3D::NativeTriTree.
|
overridevirtual |
Intersect a single ray.
Return value is hit.triIndex != Hit::NONE
for convenience.
filterFunction | Set to nullptr to accept any geometric ray-triangle instersection. |
Implements G3D::TriTree.
|
overridevirtualinherited |
|
overridevirtualinherited |
Implements G3D::TriTree.
|
protected |
void G3D::OptiXTriTree::intersectRays | ( | const shared_ptr< GLPixelTransferBuffer > & | rayOrigins, |
const shared_ptr< GLPixelTransferBuffer > & | rayDirections, | ||
Array< Hit > & | results, | ||
IntersectRayOptions | options | ||
) | const |
|
overridevirtual |
Values in results will be reused if already allocated, which can increase performance.
Reimplemented from G3D::TriTreeBase.
|
overridevirtual |
booleanResults | The red channel is nonzero on hit, 0 on miss. Subclasses are free to change the format of the booleanResults texture to whatever is most convenient for them, so make no assumptions other than that it has a red channel. |
Reimplemented from G3D::TriTreeBase.
|
overridevirtual |
Batch ray casting.
The default implementation calls the single-ray version using Thread::runConcurrently.
Reimplemented from G3D::TriTreeBase.
|
overridevirtual |
rayOrigin | must be RGBA32F() = XYZ, min distance |
rayDirection | must be RGBA32F() or RGBA16F() = normalized XYZ, max distance |
rayCone | must be null or a single-channel (R-only) texture. If not null, each element is the cosine of the half-angle of the cone about rayDirection that should be used to select a MIP-level at the intersection point. The easy way to compute this for primary rays is to pass the dot products of adjacent pixel ray directions. |
The GBuffer and both textures must have the same dimensions.
Writes the following fields to the GLPixelTransferBuffers in order in the passed in array:
WS_NORMAL is zero at pixels where the ray misses
All other fields are ignored. The GBuffer may be reallocated with textures in a different format as well.
The base class implementation copies all data to the CPU, invokes the intersectRays overload that accepts CPU data, and then copies all data back to the GPU.
Reimplemented from G3D::TriTreeBase.
|
overridevirtual |
booleanResults | The red channel is nonzero on hit, 0 on miss. Subclasses are free to change the format of the booleanResults texture to whatever is most convenient for them, so make no assumptions other than that it has a red channel. This is the fastest overload for OptiXTriTree |
Reimplemented from G3D::TriTreeBase.
|
overridevirtualinherited |
Returns all triangles that intersect or are contained within the sphere (technically, this is a ball intersection).
Default implementation calls intersectBox and then filters the results for the sphere.
Implements G3D::TriTree.
Reimplemented in G3D::NativeTriTree.
|
inlineinherited |
Time at which setContents() or rebuild() was last invoked.
|
inlinestaticprotected |
|
inlineoverridevirtual |
|
pure virtualinherited |
Rebuild the tree after m_triArray or CPUVertexArray have been mutated.
Called automatically by setContents()
Implemented in G3D::NativeTriTree, and G3D::VulkanTriTree.
|
protected |
|
overridevirtualinherited |
Base class implementation populates m_triArray and m_vertexArray and applies the image storage option.
Implements G3D::TriTree.
|
overridevirtualinherited |
Implements G3D::TriTree.
|
inlinevirtual |
Reimplemented from G3D::TriTreeBase.
|
overridevirtual |
void G3D::OptiXTriTree::setTimingCallback | ( | wave::TimingCallback * | callback, |
int | verbosityLevel | ||
) |
Set a timing function callback to print timing details from OptiX.
|
inlineinherited |
bool G3D::OptiXTriTree::supported | ( | ) |
If false after construction then OptiXTriTree will not work on this machine and you should switch to EmbreeTriTree.
This cannot be static because it has to try to construct an OptiX context.
|
inlineinherited |
|
inlineinherited |
If you mutate this, you must call rebuild()
|
staticinherited |
Make optimizations appropriate for coherent rays (same origin)
|
mutableinherited |
CPU timing of API conversion overhead for the most recent call to intersectRays.
|
staticinherited |
Do not allow the intersector to perform backface culling as an optimization.
Backface culling is not required in any case.
|
protected |
Referenced by BVH().
|
mutableprotected |
|
protected |
|
protectedinherited |
Referenced by G3D::TriTree::lastBuildTime().
|
mutableprotected |
|
mutableprotected |
|
mutableprotected |
|
mutableprotected |
|
mutableprotected |
|
mutableprotected |
|
mutableprotected |
|
protectedinherited |
|
mutableprotected |
Referenced by G3D::TriTree::operator[](), G3D::TriTree::size(), and G3D::TriTree::triArray().
|
protectedinherited |
Referenced by G3D::TriTree::vertexArray().
|
mutableprotected |
|
staticinherited |
Disable partial coverage (alpha) testing.
|
staticinherited |
Test for occlusion and do not necessarily return valid triIndex, backfacing, etc.
data (useful for shadow rays and testing line of sight)
|
staticinherited |
Only fail the partial coverage (alpha) test on zero coverage.