VTK-m  2.0
Public Member Functions | Static Private Member Functions | List of all members
vtkm::cont::ArrayHandleCast< T, ArrayHandleType > Class Template Reference

Cast the values of an array to the specified type, on demand. More...

#include <ArrayHandleCast.h>

Inheritance diagram for vtkm::cont::ArrayHandleCast< T, ArrayHandleType >:
vtkm::cont::ArrayHandle< T, StorageTagCast< ArrayHandleType::ValueType, ArrayHandleType::StorageTag > >

Public Member Functions

 VTKM_ARRAY_HANDLE_SUBCLASS (ArrayHandleCast,(ArrayHandleCast< T, ArrayHandleType >),(vtkm::cont::ArrayHandle< T, StorageTagCast< typename ArrayHandleType::ValueType, typename ArrayHandleType::StorageTag >>))
 
 ArrayHandleCast (const vtkm::cont::ArrayHandle< typename ArrayHandleType::ValueType, typename ArrayHandleType::StorageTag > &handle)
 
 ~ArrayHandleCast ()
 Implemented so that it is defined exclusively in the control environment. More...
 
ArrayHandleType GetSourceArray () const
 Returns the ArrayHandle that is being transformed. More...
 
- Public Member Functions inherited from vtkm::cont::ArrayHandle< T, StorageTagCast< ArrayHandleType::ValueType, ArrayHandleType::StorageTag > >
VTKM_CONT ArrayHandle ()
 Constructs an empty ArrayHandle. More...
 
VTKM_CONT ArrayHandle (const vtkm::cont::ArrayHandle< ValueType, StorageTag > &src)
 Copy constructor. More...
 
VTKM_CONT ArrayHandle (vtkm::cont::ArrayHandle< ValueType, StorageTag > &&src) noexcept
 Move constructor. More...
 
VTKM_CONT ~ArrayHandle ()
 Destructs an empty ArrayHandle. More...
 
VTKM_CONT vtkm::cont::ArrayHandle< ValueType, StorageTag > & operator= (const vtkm::cont::ArrayHandle< ValueType, StorageTag > &src)
 Copies an ArrayHandle. More...
 
VTKM_CONT vtkm::cont::ArrayHandle< ValueType, StorageTag > & operator= (vtkm::cont::ArrayHandle< ValueType, StorageTag > &&src) noexcept
 Move and Assignment of an ArrayHandle. More...
 
VTKM_CONT bool operator== (const ArrayHandle< ValueType, StorageTag > &rhs) const
 Like a pointer, two ArrayHandles are considered equal if they point to the same location in memory. More...
 
VTKM_CONT bool operator== (const ArrayHandle< VT, ST > &) const
 
VTKM_CONT bool operator!= (const ArrayHandle< ValueType, StorageTag > &rhs) const
 
VTKM_CONT bool operator!= (const ArrayHandle< VT, ST > &) const
 
VTKM_CONT StorageType GetStorage () const
 Get the storage. More...
 
VTKM_CONT WritePortalType WritePortal () const
 Get an array portal that can be used in the control environment. More...
 
VTKM_CONT WritePortalType WritePortal (vtkm::cont::Token &token) const
 
VTKM_CONT vtkm::Id GetNumberOfValues () const
 Returns the number of entries in the array. More...
 
VTKM_CONT void ReleaseResourcesExecution () const
 Releases any resources being used in the execution environment (that are not being shared by the control environment). More...
 
VTKM_CONT void ReleaseResources () const
 Releases all resources in both the control and execution environments. More...
 
VTKM_CONT ReadPortalType PrepareForInput (vtkm::cont::DeviceAdapterId device, vtkm::cont::Token &token) const
 Prepares this array to be used as an input to an operation in the execution environment. More...
 
VTKM_CONT WritePortalType PrepareForInPlace (vtkm::cont::DeviceAdapterId device, vtkm::cont::Token &token) const
 Prepares this array to be used in an in-place operation (both as input and output) in the execution environment. More...
 
VTKM_CONT WritePortalType PrepareForOutput (vtkm::Id numberOfValues, vtkm::cont::DeviceAdapterId device, vtkm::cont::Token &token) const
 Prepares (allocates) this array to be used as an output from an operation in the execution environment. More...
 
VTKM_CONT bool IsOnDevice (vtkm::cont::DeviceAdapterId device) const
 Returns true if the ArrayHandle's data is on the given device. More...
 
VTKM_CONT bool IsOnHost () const
 Returns true if the ArrayHandle's data is on the host. More...
 
VTKM_CONT void SyncControlArray () const
 Synchronizes the control array with the execution array. More...
 
VTKM_CONT void Enqueue (const vtkm::cont::Token &token) const
 Enqueue a token for access to this ArrayHandle. More...
 
VTKM_CONT void DeepCopyFrom (const vtkm::cont::ArrayHandle< ValueType, StorageTag > &source) const
 Deep copies the data in the array. More...
 
const VTKM_CONT std::vector< vtkm::cont::internal::Buffer > & GetBuffers () const
 Returns the internal Buffer structures that hold the data. More...
 
VTKM_CONT std::vector< vtkm::cont::internal::Buffer > & GetBuffers ()
 
VTKM_CONT ArrayHandle (const std::vector< vtkm::cont::internal::Buffer > &buffers)
 
VTKM_CONT ArrayHandle (std::vector< vtkm::cont::internal::Buffer > &&buffers) noexcept
 
VTKM_CONT ReadPortalType ReadPortal () const
 Get an array portal that can be used in the control environment. More...
 
VTKM_CONT ReadPortalType ReadPortal (vtkm::cont::Token &token) const
 Get an array portal that can be used in the control environment. More...
 
VTKM_CONT void Allocate (vtkm::Id numberOfValues, vtkm::CopyFlag preserve, vtkm::cont::Token &token) const
 Allocates an array large enough to hold the given number of values. More...
 
VTKM_CONT void Allocate (vtkm::Id numberOfValues, vtkm::CopyFlag preserve=vtkm::CopyFlag::Off) const
 Allocates an array large enough to hold the given number of values. More...
 
VTKM_CONT void AllocateAndFill (vtkm::Id numberOfValues, const ValueType &fillValue, vtkm::CopyFlag preserve, vtkm::cont::Token &token) const
 Allocates an array and fills it with an initial value. More...
 
VTKM_CONT void AllocateAndFill (vtkm::Id numberOfValues, const ValueType &fillValue, vtkm::CopyFlag preserve=vtkm::CopyFlag::Off) const
 Allocates an array and fills it with an initial value. More...
 
VTKM_CONT void Fill (const ValueType &fillValue, vtkm::Id startIndex, vtkm::Id endIndex, vtkm::cont::Token &token) const
 Fills the array with a given value. More...
 
VTKM_CONT void Fill (const ValueType &fillValue, vtkm::Id startIndex, vtkm::Id endIndex) const
 Fills the array with a given value. More...
 
VTKM_CONT void Fill (const ValueType &fillValue, vtkm::Id startIndex=0) const
 Fills the array with a given value. More...
 

Static Private Member Functions

template<typename SrcValueType >
static VTKM_CONT std::enable_if<!std::is_same< T, SrcValueType >::value >::type ValidateTypeCast ()
 
template<typename SrcValueType >
static VTKM_CONT std::enable_if< std::is_same< T, SrcValueType >::value >::type ValidateTypeCast ()
 

Additional Inherited Members

- Public Types inherited from vtkm::cont::ArrayHandle< T, StorageTagCast< ArrayHandleType::ValueType, ArrayHandleType::StorageTag > >
using ValueType = T
 
using StorageTag = StorageTagCast< ArrayHandleType::ValueType, ArrayHandleType::StorageTag >
 
using StorageType = vtkm::cont::internal::Storage< ValueType, StorageTag >
 
using ReadPortalType = typename StorageType::ReadPortalType
 
using WritePortalType = typename StorageType::WritePortalType
 
- Protected Member Functions inherited from vtkm::cont::ArrayHandle< T, StorageTagCast< ArrayHandleType::ValueType, ArrayHandleType::StorageTag > >
VTKM_CONT void SetBuffer (vtkm::IdComponent index, const vtkm::cont::internal::Buffer &buffer)
 
VTKM_CONT void SetBuffers (const std::vector< vtkm::cont::internal::Buffer > &buffers)
 
VTKM_CONT void SetBuffers (std::vector< vtkm::cont::internal::Buffer > &&buffers)
 

Detailed Description

template<typename T, typename ArrayHandleType>
class vtkm::cont::ArrayHandleCast< T, ArrayHandleType >

Cast the values of an array to the specified type, on demand.

ArrayHandleCast is a specialization of ArrayHandleTransform. Given an ArrayHandle and a type, it creates a new handle that returns the elements of the array cast to the specified type.

Constructor & Destructor Documentation

◆ ArrayHandleCast()

template<typename T , typename ArrayHandleType >
vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ArrayHandleCast ( const vtkm::cont::ArrayHandle< typename ArrayHandleType::ValueType, typename ArrayHandleType::StorageTag > &  handle)
inline

◆ ~ArrayHandleCast()

template<typename T , typename ArrayHandleType >
vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::~ArrayHandleCast ( )
inline

Implemented so that it is defined exclusively in the control environment.

If there is a separate device for the execution environment (for example, with CUDA), then the automatically generated destructor could be created for all devices, and it would not be valid for all devices.

Member Function Documentation

◆ GetSourceArray()

template<typename T , typename ArrayHandleType >
ArrayHandleType vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::GetSourceArray ( ) const
inline

Returns the ArrayHandle that is being transformed.

◆ ValidateTypeCast() [1/2]

template<typename T , typename ArrayHandleType >
template<typename SrcValueType >
static VTKM_CONT std::enable_if<!std::is_same<T, SrcValueType>::value>::type vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ValidateTypeCast ( )
inlinestaticprivate

◆ ValidateTypeCast() [2/2]

template<typename T , typename ArrayHandleType >
template<typename SrcValueType >
static VTKM_CONT std::enable_if<std::is_same<T, SrcValueType>::value>::type vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ValidateTypeCast ( )
inlinestaticprivate

◆ VTKM_ARRAY_HANDLE_SUBCLASS()

template<typename T , typename ArrayHandleType >
vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::VTKM_ARRAY_HANDLE_SUBCLASS ( ArrayHandleCast< T, ArrayHandleType >  ,
(ArrayHandleCast< T, ArrayHandleType >)  ,
(vtkm::cont::ArrayHandle< T, StorageTagCast< typename ArrayHandleType::ValueType, typename ArrayHandleType::StorageTag >>)   
)

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