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

#include <ArrayHandleCast.h>

Inheritance diagram for vtkm::cont::ArrayHandleCast< T, ArrayHandleType >:

Public Types
using	Thisclass = typename vtkm::cont::detail::GetTypeInParentheses< void(ArrayHandleCast< T, ArrayHandleType >) >::type

using	Superclass = typename vtkm::cont::detail::GetTypeInParentheses< void(vtkm::cont::ArrayHandle< T, StorageTagCast< typename ArrayHandleType::ValueType, typename ArrayHandleType::StorageTag > >) >::type

using	ValueType = typename Superclass::ValueType

using	StorageTag = typename Superclass::StorageTag

using	StorageType = typename Superclass::StorageType

using	ReadPortalType = typename Superclass::ReadPortalType

using	WritePortalType = typename Superclass::WritePortalType

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

Public Member Functions
	ArrayHandleCast ()

VTKM_CONT	ArrayHandleCast (const Thisclass &src)

VTKM_CONT	ArrayHandleCast (Thisclass &&src) noexcept

VTKM_CONT	ArrayHandleCast (const vtkm::cont::ArrayHandle< typename Superclass::ValueType, typename Superclass::StorageTag > &src)

VTKM_CONT	ArrayHandleCast (vtkm::cont::ArrayHandle< typename Superclass::ValueType, typename Superclass::StorageTag > &&src) noexcept

VTKM_CONT	ArrayHandleCast (const std::vector< vtkm::cont::internal::Buffer > &buffers)

VTKM_CONT	ArrayHandleCast (std::vector< vtkm::cont::internal::Buffer > &&buffers) noexcept

VTKM_CONT Thisclass &	operator= (const Thisclass &src)

VTKM_CONT Thisclass &	operator= (Thisclass &&src) noexcept

	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 > >
	ArrayHandle ()
	Constructs an empty ArrayHandle. More...

	ArrayHandle (const vtkm::cont::ArrayHandle< ValueType, StorageTag > &src)
	Copy constructor. More...

	ArrayHandle (vtkm::cont::ArrayHandle< ValueType, StorageTag > &&src) noexcept
	Move constructor. More...

	ArrayHandle (const std::vector< vtkm::cont::internal::Buffer > &buffers)
	Special constructor for subclass specializations that need to set the initial state array. More...

	ArrayHandle (std::vector< vtkm::cont::internal::Buffer > &&buffers) noexcept
	Special constructor for subclass specializations that need to set the initial state array. More...

	~ArrayHandle ()
	Destructs an empty ArrayHandle. More...

vtkm::cont::ArrayHandle< ValueType, StorageTag > &	operator= (const vtkm::cont::ArrayHandle< ValueType, StorageTag > &src)
	Shallow copies an ArrayHandle. More...

vtkm::cont::ArrayHandle< ValueType, StorageTag > &	operator= (vtkm::cont::ArrayHandle< ValueType, StorageTag > &&src) noexcept
	Move and Assignment of an ArrayHandle. More...

bool	operator== (const ArrayHandle< ValueType, StorageTag > &rhs) const
	Like a pointer, two `ArrayHandle`s are considered equal if they point to the same location in memory. More...

bool	operator== (const ArrayHandle< VT, ST > &) const

bool	operator!= (const ArrayHandle< ValueType, StorageTag > &rhs) const

bool	operator!= (const ArrayHandle< VT, ST > &) const

StorageType	GetStorage () const
	Get the storage. More...

ReadPortalType	ReadPortal () const
	Get an array portal that can be used in the control environment. More...

ReadPortalType	ReadPortal (vtkm::cont::Token &token) const

WritePortalType	WritePortal () const
	Get an array portal that can be used in the control environment. More...

WritePortalType	WritePortal (vtkm::cont::Token &token) const
	Get an array portal that can be used in the control environment. More...

vtkm::Id	GetNumberOfValues () const
	Returns the number of entries in the array. More...

vtkm::IdComponent	GetNumberOfComponentsFlat () const
	Returns the total number of components for each value in the array. More...

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...

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...

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...

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...

void	Fill (const ValueType &fillValue, vtkm::Id startIndex, vtkm::Id endIndex, vtkm::cont::Token &token) const
	Fills the array with a given value. More...

void	Fill (const ValueType &fillValue, vtkm::Id startIndex, vtkm::Id endIndex) const
	Fills the array with a given value. More...

void	Fill (const ValueType &fillValue, vtkm::Id startIndex=0) const
	Fills the array with a given value. More...

void	ReleaseResourcesExecution () const
	Releases any resources being used in the execution environment (that are not being shared by the control environment). More...

void	ReleaseResources () const
	Releases all resources in both the control and execution environments. More...

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...

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...

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...

bool	IsOnDevice (vtkm::cont::DeviceAdapterId device) const
	Returns true if the ArrayHandle's data is on the given device. More...

bool	IsOnHost () const
	Returns true if the ArrayHandle's data is on the host. More...

void	SyncControlArray () const
	Synchronizes the control array with the execution array. More...

void	Enqueue (const vtkm::cont::Token &token) const
	Enqueue a token for access to this ArrayHandle. More...

void	DeepCopyFrom (const vtkm::cont::ArrayHandle< ValueType, StorageTag > &source) const
	Deep copies the data in the array. More...

const std::vector< vtkm::cont::internal::Buffer > &	GetBuffers () const
	Returns the internal `Buffer` structures that hold the data. More...

std::vector< vtkm::cont::internal::Buffer > &	GetBuffers ()

Static Private Member Functions
template<typename SrcValueType >
static std::enable_if<!std::is_same< T, SrcValueType >::value >::type	ValidateTypeCast ()

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

Additional Inherited Members
Protected Member Functions inherited from vtkm::cont::ArrayHandle< T, StorageTagCast< ArrayHandleType::ValueType, ArrayHandleType::StorageTag > >
void	SetBuffer (vtkm::IdComponent index, const vtkm::cont::internal::Buffer &buffer)

void	SetBuffers (const std::vector< vtkm::cont::internal::Buffer > &buffers)

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.

Member Typedef Documentation

◆ ReadPortalType

template<typename T , typename ArrayHandleType >

using vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ReadPortalType = typename Superclass::ReadPortalType

◆ StorageTag

template<typename T , typename ArrayHandleType >

using vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::StorageTag = typename Superclass::StorageTag

◆ StorageType

template<typename T , typename ArrayHandleType >

using vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::StorageType = typename Superclass::StorageType

◆ Superclass

template<typename T , typename ArrayHandleType >

using vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::Superclass = typename vtkm::cont::detail::GetTypeInParentheses<void (vtkm::cont::ArrayHandle< T, StorageTagCast<typename ArrayHandleType::ValueType, typename ArrayHandleType::StorageTag> >) >::type

◆ Thisclass

template<typename T , typename ArrayHandleType >

using vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::Thisclass = typename vtkm::cont::detail::GetTypeInParentheses<void (ArrayHandleCast<T, ArrayHandleType>) >::type

◆ ValueType

template<typename T , typename ArrayHandleType >

using vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ValueType = typename Superclass::ValueType

◆ WritePortalType

template<typename T , typename ArrayHandleType >

using vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::WritePortalType = typename Superclass::WritePortalType

Constructor & Destructor Documentation

◆ ArrayHandleCast() [1/8]

template<typename T , typename ArrayHandleType >

vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ArrayHandleCast ( )

inline

◆ ArrayHandleCast() [2/8]

template<typename T , typename ArrayHandleType >

VTKM_CONT vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ArrayHandleCast ( const Thisclass & src )

inline

◆ ArrayHandleCast() [3/8]

template<typename T , typename ArrayHandleType >

VTKM_CONT vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ArrayHandleCast ( Thisclass && src )

inlinenoexcept

◆ ArrayHandleCast() [4/8]

template<typename T , typename ArrayHandleType >

VTKM_CONT vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ArrayHandleCast ( const vtkm::cont::ArrayHandle< typename Superclass::ValueType, typename Superclass::StorageTag > & src )

inline

◆ ArrayHandleCast() [5/8]

template<typename T , typename ArrayHandleType >

VTKM_CONT vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ArrayHandleCast ( vtkm::cont::ArrayHandle< typename Superclass::ValueType, typename Superclass::StorageTag > && src )

inlinenoexcept

◆ ArrayHandleCast() [6/8]

template<typename T , typename ArrayHandleType >

VTKM_CONT vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ArrayHandleCast ( const std::vector< vtkm::cont::internal::Buffer > & buffers )

inlineexplicit

◆ ArrayHandleCast() [7/8]

template<typename T , typename ArrayHandleType >

VTKM_CONT vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ArrayHandleCast ( std::vector< vtkm::cont::internal::Buffer > && buffers )

inlineexplicitnoexcept

◆ ArrayHandleCast() [8/8]

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.

◆ operator=() [1/2]

template<typename T , typename ArrayHandleType >

VTKM_CONT Thisclass& vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::operator= ( const Thisclass & src )

inline

◆ operator=() [2/2]

template<typename T , typename ArrayHandleType >

VTKM_CONT Thisclass& vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::operator= ( Thisclass && src )

inlinenoexcept

◆ ValidateTypeCast() [1/2]

template<typename T , typename ArrayHandleType >

template<typename SrcValueType >

static 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 std::enable_if<std::is_same<T, SrcValueType>::value>::type vtkm::cont::ArrayHandleCast< T, ArrayHandleType >::ValidateTypeCast ( )

inlinestaticprivate

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

ArrayHandleCast.h

Public Types

Public Member Functions

Static Private Member Functions

Additional Inherited Members

Detailed Description

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

Member Typedef Documentation

◆ ReadPortalType

◆ StorageTag

◆ StorageType

◆ Superclass

◆ Thisclass

◆ ValueType

◆ WritePortalType

Constructor & Destructor Documentation

◆ ArrayHandleCast() [1/8]

◆ ArrayHandleCast() [2/8]

◆ ArrayHandleCast() [3/8]

◆ ArrayHandleCast() [4/8]

◆ ArrayHandleCast() [5/8]

◆ ArrayHandleCast() [6/8]

◆ ArrayHandleCast() [7/8]

◆ ArrayHandleCast() [8/8]

◆ ~ArrayHandleCast()

Member Function Documentation

◆ GetSourceArray()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ ValidateTypeCast() [1/2]

◆ ValidateTypeCast() [2/2]

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