Point Cloud Library (PCL)  1.14.1-dev
List of all members | Public Member Functions
pcl::gpu::DeviceMemory Class Reference

DeviceMemory class More...

#include </__w/1/s/gpu/containers/include/pcl/gpu/containers/device_memory.h>

+ Inheritance diagram for pcl::gpu::DeviceMemory:

Public Member Functions

 DeviceMemory ()
 Empty constructor. More...
 
 ~DeviceMemory ()
 Destructor. More...
 
 DeviceMemory (std::size_t sizeBytes_arg)
 Allocates internal buffer in GPU memory. More...
 
 DeviceMemory (void *ptr_arg, std::size_t sizeBytes_arg)
 Initializes with user allocated buffer. More...
 
 DeviceMemory (const DeviceMemory &other_arg)
 Copy constructor. More...
 
DeviceMemoryoperator= (const DeviceMemory &other_arg)
 Assignment operator. More...
 
void create (std::size_t sizeBytes_arg)
 Allocates internal buffer in GPU memory. More...
 
void release ()
 Decrements reference counter and releases internal buffer if needed. More...
 
void copyTo (DeviceMemory &other) const
 Performs data copying. More...
 
void upload (const void *host_ptr_arg, std::size_t sizeBytes_arg)
 Uploads data to internal buffer in GPU memory. More...
 
bool upload (const void *host_ptr_arg, std::size_t device_begin_byte_offset, std::size_t num_bytes)
 Uploads data from CPU memory to device array. More...
 
void download (void *host_ptr_arg) const
 Downloads data from internal buffer to CPU memory. More...
 
bool download (void *host_ptr_arg, std::size_t device_begin_byte_offset, std::size_t num_bytes) const
 Downloads data from internal buffer to CPU memory. More...
 
void swap (DeviceMemory &other_arg)
 Performs swap of data pointed with another device memory. More...
 
template<class T >
T * ptr ()
 Returns pointer for internal buffer in GPU memory. More...
 
template<class T >
const T * ptr () const
 Returns constant pointer for internal buffer in GPU memory. More...
 
template<class U >
 operator PtrSz< U > () const
 Conversion to PtrSz for passing to kernel functions. More...
 
bool empty () const
 Returns true if unallocated otherwise false. More...
 
std::size_t sizeBytes () const
 

Detailed Description

DeviceMemory class

Note
This is a BLOB container class with reference counting for GPU memory.
Author
Anatoly Baksheev

Definition at line 54 of file device_memory.h.

Constructor & Destructor Documentation

◆ DeviceMemory() [1/4]

pcl::gpu::DeviceMemory::DeviceMemory ( )

Empty constructor.

◆ ~DeviceMemory()

pcl::gpu::DeviceMemory::~DeviceMemory ( )

Destructor.

◆ DeviceMemory() [2/4]

pcl::gpu::DeviceMemory::DeviceMemory ( std::size_t  sizeBytes_arg)

Allocates internal buffer in GPU memory.

Parameters
sizeBytes_argamount of memory to allocate

◆ DeviceMemory() [3/4]

pcl::gpu::DeviceMemory::DeviceMemory ( void *  ptr_arg,
std::size_t  sizeBytes_arg 
)

Initializes with user allocated buffer.

Reference counting is disabled in this case.

Parameters
ptr_argpointer to buffer
sizeBytes_argbuffer size

◆ DeviceMemory() [4/4]

pcl::gpu::DeviceMemory::DeviceMemory ( const DeviceMemory other_arg)

Copy constructor.

Just increments reference counter.

Member Function Documentation

◆ copyTo()

void pcl::gpu::DeviceMemory::copyTo ( DeviceMemory other) const

Performs data copying.

If destination size differs it will be reallocated.

Parameters
otherdestination container

Referenced by pcl::gpu::DeviceArray< T >::copyTo().

◆ create()

void pcl::gpu::DeviceMemory::create ( std::size_t  sizeBytes_arg)

Allocates internal buffer in GPU memory.

If internal buffer was created before the function recreates it with new size. If new and old sizes are equal it does nothing.

Parameters
sizeBytes_argbuffer size

◆ download() [1/2]

void pcl::gpu::DeviceMemory::download ( void *  host_ptr_arg) const

Downloads data from internal buffer to CPU memory.

Parameters
host_ptr_argpointer to buffer to download

Referenced by pcl::gpu::DeviceArray< T >::download().

◆ download() [2/2]

bool pcl::gpu::DeviceMemory::download ( void *  host_ptr_arg,
std::size_t  device_begin_byte_offset,
std::size_t  num_bytes 
) const

Downloads data from internal buffer to CPU memory.

Returns
true if download successful
Parameters
host_ptr_argpointer to buffer to download
device_begin_byte_offsetfirst byte position to download
num_bytesnumber of bytes to download

◆ empty()

bool pcl::gpu::DeviceMemory::empty ( ) const

Returns true if unallocated otherwise false.

Referenced by pcl::gpu::kinfuLS::StandaloneMarchingCubes< PointT >::convertTrianglesToMesh().

◆ operator PtrSz< U >()

template<class U >
pcl::gpu::DeviceMemory::operator PtrSz< U >
inline

Conversion to PtrSz for passing to kernel functions.

Definition at line 60 of file device_memory.hpp.

References pcl::gpu::DevPtr< T >::data, and pcl::gpu::PtrSz< T >::size.

◆ operator=()

DeviceMemory& pcl::gpu::DeviceMemory::operator= ( const DeviceMemory other_arg)

Assignment operator.

Just increments reference counter.

Referenced by pcl::gpu::DeviceArray< T >::operator=().

◆ ptr() [1/2]

template<class T >
T * pcl::gpu::DeviceMemory::ptr
inline

Returns pointer for internal buffer in GPU memory.

Definition at line 47 of file device_memory.hpp.

◆ ptr() [2/2]

template<class T >
const T * pcl::gpu::DeviceMemory::ptr
inline

Returns constant pointer for internal buffer in GPU memory.

Definition at line 54 of file device_memory.hpp.

◆ release()

void pcl::gpu::DeviceMemory::release ( )

Decrements reference counter and releases internal buffer if needed.

◆ sizeBytes()

std::size_t pcl::gpu::DeviceMemory::sizeBytes ( ) const

◆ swap()

void pcl::gpu::DeviceMemory::swap ( DeviceMemory other_arg)

Performs swap of data pointed with another device memory.

Parameters
other_argdevice memory to swap with

Referenced by pcl::gpu::DeviceArray< T >::swap().

◆ upload() [1/2]

bool pcl::gpu::DeviceMemory::upload ( const void *  host_ptr_arg,
std::size_t  device_begin_byte_offset,
std::size_t  num_bytes 
)

Uploads data from CPU memory to device array.

Note
This overload never allocates memory in contrast to the other upload function.
Returns
true if upload successful
Parameters
host_ptr_argpointer to buffer to upload
device_begin_byte_offsetfirst byte position to upload to
num_bytesnumber of bytes to upload

◆ upload() [2/2]

void pcl::gpu::DeviceMemory::upload ( const void *  host_ptr_arg,
std::size_t  sizeBytes_arg 
)

Uploads data to internal buffer in GPU memory.

It calls create() inside to ensure that internal buffer size is enough.

Parameters
host_ptr_argpointer to buffer to upload
sizeBytes_argbuffer size

Referenced by pcl::gpu::DeviceArray< float4 >::release(), and pcl::gpu::DeviceArray< T >::upload().


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