Medical Imaging Interaction Toolkit  2023.12.00
Medical Imaging Interaction Toolkit
mitk::OclDataSetToDataSetFilter Class Referenceabstract

The OclDataSetToDataSetFilter is the base class for all OpenCL DataSet filter generating DataSets. More...

#include <mitkOclDataSetToDataSetFilter.h>

Inheritance diagram for mitk::OclDataSetToDataSetFilter:
Collaboration diagram for mitk::OclDataSetToDataSetFilter:

Public Member Functions

void * GetOutput ()
 Returns an pointer to the filtered data. More...
 
mitk::OclDataSet::Pointer GetGPUOutput ()
 Returns a pointer to the graphics memory. More...
 
- Public Member Functions inherited from mitk::OclDataSetFilter
void SetInput (mitk::OclDataSet::Pointer DataSet)
 SetInput SetInput Set the input DataSet (as mitk::OclDataSet). More...
 
void SetInput (void *DataSet, unsigned int size, unsigned int BpE)
 SetInput Set the input DataSet (as a pointer to the data). More...
 
void SetInput (mitk::Image::Pointer image)
 SetInput Set the input DataSet (as mitk::Image). More...
 
- Public Member Functions inherited from mitk::OclFilter
void AddSourceFile (const char *filename)
 Add a source file from the resource files to the OpenCL shader file list. Multiple files can be added to the list. More...
 
void SetCompilerFlags (const char *flags)
 Set specific compilerflags to compile the CL source. Default is set to nullptr; example: "-cl-fast-relaxed-math -cl-mad-enable -cl-strict-aliasing". More...
 
virtual bool IsInitialized ()
 Returns true if the initialization was successfull. More...
 
virtual unsigned long GetDeviceMemory ()
 Returns the amount of global memory of the used device in bytes. More...
 
virtual ~OclFilter ()
 Destructor. More...
 

Protected Member Functions

 OclDataSetToDataSetFilter ()
 OclDataSetToDataSetFilter Default constructor. More...
 
virtual ~OclDataSetToDataSetFilter ()
 Destructor. More...
 
virtual void Update ()=0
 (Virtual) method Update() to be implemented in derived classes. More...
 
bool InitExec (cl_kernel ckKernel, unsigned int *dimensions, size_t outputDataSize, unsigned int outputBpE)
 InitExec Initialize the execution. More...
 
bool InitExecNoInput (cl_kernel ckKernel, unsigned int *dimensions, size_t outputDataSize, unsigned int outputBpE)
 
virtual int GetBytesPerElem ()
 Get the memory size needed for each element. More...
 
- Protected Member Functions inherited from mitk::OclDataSetFilter
 OclDataSetFilter ()
 
virtual ~OclDataSetFilter ()
 
- Protected Member Functions inherited from mitk::OclFilter
 OclFilter ()
 Constructor. More...
 
 OclFilter (const char *filename)
 Constructor ( overloaded ) More...
 
void SetWorkingSize (unsigned int locx, unsigned int dimx, unsigned int locy=1, unsigned int dimy=1, unsigned int locz=1, unsigned int dimz=1)
 Set the working size for the following OpenCL kernel call. More...
 
bool ExecuteKernel (cl_kernel kernel, unsigned int workSizeDim)
 Execute the given kernel on the OpenCL Index-Space defined by the local and global work sizes. More...
 
bool ExecuteKernelChunks (cl_kernel kernel, unsigned int workSizeDim, size_t *chunksDim)
 Execute the given kernel on the OpenCL Index-Space defined by the local and global work sizes, but divide it into chunks of dimension chunksDim. More...
 
bool ExecuteKernelChunksInBatches (cl_kernel kernel, unsigned int workSizeDim, size_t *chunksDim, size_t batchSize, int waitTimems)
 Execute the given kernel on the OpenCL Index-Space defined by the local and global work sizes, but divide it into chunks of dimension chunksDim and wait between batches of batchSize chunks a time of waitTimems milliseconds. More...
 
bool Initialize ()
 Initialize all necessary parts of the filter. More...
 
void CompileSource ()
 Compile the program source. More...
 
void SetSourcePreambel (const char *preambel)
 Add some source code on the beginning of the loaded source. More...
 
virtual us::ModuleGetModule ()=0
 Get the Module of the filter. Needs to be implemented by every subclass. The filter will load the OpenCL sourcefiles from this module context. More...
 
void LoadSourceFiles (CStringList &SourceCodeList, ClSizeList &SourceCodeSizeList)
 Helper functions that load sourcefiles from the module context in the Initialize function. More...
 

Protected Attributes

mitk::OclDataSet::Pointer m_Output
 
unsigned int m_CurrentSizeOutput
 
- Protected Attributes inherited from mitk::OclDataSetFilter
mitk::OclDataSet::Pointer m_Input
 
unsigned int m_CurrentSize
 
- Protected Attributes inherited from mitk::OclFilter
const char * m_ClCompilerFlags
 String that contains the compiler flags. More...
 
cl_program m_ClProgram
 The compiled OpenCL program. More...
 
cl_command_queue m_CommandQue
 Command queue for the filter. More...
 
std::string m_FilterID
 Unique ID of the filter, needs to be specified in the constructor of the derived class. More...
 
const char * m_Preambel
 source preambel for e.g. #define commands to be inserted into the OpenCL source More...
 
CStringList m_ClFiles
 List of sourcefiles that will be compiled for this filter. More...
 
bool m_Initialized
 status of the filter More...
 
size_t m_LocalWorkSize [3]
 The local work size fo the filter. More...
 
size_t m_GlobalWorkSize [3]
 The global work size of the filter. More...
 

Additional Inherited Members

- Protected Types inherited from mitk::OclFilter
typedef std::vector< const char * > CStringList
 
typedef std::vector< size_t > ClSizeList
 

Detailed Description

The OclDataSetToDataSetFilter is the base class for all OpenCL DataSet filter generating DataSets.

Definition at line 26 of file mitkOclDataSetToDataSetFilter.h.

Constructor & Destructor Documentation

◆ OclDataSetToDataSetFilter()

mitk::OclDataSetToDataSetFilter::OclDataSetToDataSetFilter ( )
protected

OclDataSetToDataSetFilter Default constructor.

◆ ~OclDataSetToDataSetFilter()

virtual mitk::OclDataSetToDataSetFilter::~OclDataSetToDataSetFilter ( )
protectedvirtual

Destructor.

Member Function Documentation

◆ GetBytesPerElem()

virtual int mitk::OclDataSetToDataSetFilter::GetBytesPerElem ( )
protectedvirtual

Get the memory size needed for each element.

◆ GetGPUOutput()

mitk::OclDataSet::Pointer mitk::OclDataSetToDataSetFilter::GetGPUOutput ( )

Returns a pointer to the graphics memory.

Use this method when executing two and more filters on the GPU for fast access. This method does not copy the data to RAM. It returns only a pointer.

◆ GetOutput()

void* mitk::OclDataSetToDataSetFilter::GetOutput ( )

Returns an pointer to the filtered data.

◆ InitExec()

bool mitk::OclDataSetToDataSetFilter::InitExec ( cl_kernel  ckKernel,
unsigned int *  dimensions,
size_t  outputDataSize,
unsigned int  outputBpE 
)
protected

InitExec Initialize the execution.

Parameters
ckKernelThe GPU kernel.
dimensions
outputDataSize
outputBpE
Exceptions
mitk::Exceptionif something goes wrong.
Returns
True for success.

◆ InitExecNoInput()

bool mitk::OclDataSetToDataSetFilter::InitExecNoInput ( cl_kernel  ckKernel,
unsigned int *  dimensions,
size_t  outputDataSize,
unsigned int  outputBpE 
)
protected

◆ Update()

virtual void mitk::OclDataSetToDataSetFilter::Update ( )
protectedpure virtual

(Virtual) method Update() to be implemented in derived classes.

Member Data Documentation

◆ m_CurrentSizeOutput

unsigned int mitk::OclDataSetToDataSetFilter::m_CurrentSizeOutput
protected

Definition at line 73 of file mitkOclDataSetToDataSetFilter.h.

◆ m_Output

mitk::OclDataSet::Pointer mitk::OclDataSetToDataSetFilter::m_Output
protected

Output DataSet

Definition at line 52 of file mitkOclDataSetToDataSetFilter.h.


The documentation for this class was generated from the following file: