Package cz.fidentis.analyst.opencl.services.octree

Interface OctreeOpenCL

All Superinterfaces:

CLResources

All Known Implementing Classes:

OctreeOpenCLImpl

public interface OctreeOpenCL
extends CLResources

Creates octree in OpenCL memory Octree is static - Does not support modifications after creation The implementation is thread-safe

Method Summary

Modifier and Type	Method	Description
void	build(Collection<MeshFacet> facets)	Builds the octree with provided facets.
static OctreeOpenCL	create(com.jogamp.opencl.CLContext clContext)	Creates empty instance of OpenCL Octree.
Box	getBBox()	Gets BBox calculated during the Octree creation.
com.jogamp.opencl.CLBuffer<FloatBuffer>	getBBoxBuffer()	Gets Octree Bounding Box in buffer
int	getMaxTrianglesPerLeaf()	Largest existing leaf - maximal number of triangles
com.jogamp.opencl.CLBuffer<IntBuffer>	getTree()	Get indexes pointing from parent nodes to their children and leaves to their respective triangle content index -1 --> reserved as empty value indexes > -1 --> Pointers to nodes, each value points to where node's children are stored continuously For example: If we find 64 at index 5, it means children of node 5 are stored at indexes 64-72 indexes invalid input: '<' -1 --> To save memory, the negative value signify the child is leaf.
MeshTriangle	getTriangle(int index)	Gets triangle corresponding to its index from GPU buffer
com.jogamp.opencl.CLBuffer<IntBuffer>	getTriangleIndices()	Triangle indexes stored in array to represent leaves.
WriteBufferGPU<MeshTriangle>	getTriangles()	Gets Triangles from the octree.

Methods inherited from interface cz.fidentis.analyst.opencl.memory.CLResources

release

Method Details

create

static OctreeOpenCL create(com.jogamp.opencl.CLContext clContext)

Creates empty instance of OpenCL Octree.

Returns:

a new OpenCL Octree

build

void build(Collection<MeshFacet> facets)

Builds the octree with provided facets. Reuses allocated memory if possible

Parameters:

facets - Facets to be loaded in octree

getTriangles

WriteBufferGPU<MeshTriangle> getTriangles()

Gets Triangles from the octree. The triangles are loaded in MeshTriangleBuffer

Returns:

MeshTriangleBuffer instance

getMaxTrianglesPerLeaf

int getMaxTrianglesPerLeaf()

Largest existing leaf - maximal number of triangles

Returns:

The Largest existing leaf

getTriangleIndices

com.jogamp.opencl.CLBuffer<IntBuffer> getTriangleIndices()

Triangle indexes stored in array to represent leaves. Each leaf has reserved length of getMayTrianglesPerLeaf

Returns:

leaves to triangles indexation

getTriangle

MeshTriangle getTriangle(int index)

Gets triangle corresponding to its index from GPU buffer

Parameters:

index - of triangle from GPU

Returns:

MeshTriangle instance

getBBox

Box getBBox()

Gets BBox calculated during the Octree creation. Equal to Bounding Box of all vertices of the submitted facets

Returns:

Octree Bounding Box

getBBoxBuffer

com.jogamp.opencl.CLBuffer<FloatBuffer> getBBoxBuffer()

Gets Octree Bounding Box in buffer

Returns:

CLBuffer containing Bounding Box

getTree

com.jogamp.opencl.CLBuffer<IntBuffer> getTree()

Get indexes pointing from parent nodes to their children and leaves to their respective triangle content index -1 --> reserved as empty value indexes > -1 --> Pointers to nodes, each value points to where node's children are stored continuously For example: If we find 64 at index 5, it means children of node 5 are stored at indexes 64-72 indexes invalid input: '<' -1 --> To save memory, the negative value signify the child is leaf. Making the value positive gives us pointer to the leaf's triangles in Triangle Indices

Returns:

CLBuffer of integers