mirror of
https://gitlab.kitware.com/vtk/vtk-m
synced 2024-10-06 02:18:58 +00:00
a2c280993c
The UserPortal in ArrayHandle was used to copy a pointer the user created into an ArrayHandle to use in VTK-m algorithms. However, this is only really valid for a basic storage, so the functionality has been moved there, and you have to construct an ArrayHandle with a storage instead of an array portal.
250 lines
7.1 KiB
C++
250 lines
7.1 KiB
C++
//============================================================================
|
|
// Copyright (c) Kitware, Inc.
|
|
// All rights reserved.
|
|
// See LICENSE.txt for details.
|
|
// This software is distributed WITHOUT ANY WARRANTY; without even
|
|
// the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
// PURPOSE. See the above copyright notice for more information.
|
|
//
|
|
// Copyright 2014 Sandia Corporation.
|
|
// Copyright 2014 UT-Battelle, LLC.
|
|
// Copyright 2014. Los Alamos National Security
|
|
//
|
|
// Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
|
|
// the U.S. Government retains certain rights in this software.
|
|
//
|
|
// Under the terms of Contract DE-AC52-06NA25396 with Los Alamos National
|
|
// Laboratory (LANL), the U.S. Government retains certain rights in
|
|
// this software.
|
|
//============================================================================
|
|
#ifndef vtk_m_cont_StorageBasic_h
|
|
#define vtk_m_cont_StorageBasic_h
|
|
|
|
#include <vtkm/Types.h>
|
|
#include <vtkm/cont/Assert.h>
|
|
#include <vtkm/cont/ErrorControlBadValue.h>
|
|
#include <vtkm/cont/ErrorControlOutOfMemory.h>
|
|
#include <vtkm/cont/Storage.h>
|
|
|
|
#include <vtkm/cont/internal/ArrayPortalFromIterators.h>
|
|
|
|
namespace vtkm {
|
|
namespace cont {
|
|
|
|
/// A tag for the basic implementation of a Storage object.
|
|
struct StorageTagBasic { };
|
|
|
|
namespace internal {
|
|
|
|
/// A basic implementation of an Storage object.
|
|
///
|
|
/// \todo This storage does \em not construct the values within the array.
|
|
/// Thus, it is important to not use this class with any type that will fail if
|
|
/// not constructed. These are things like basic types (int, float, etc.) and
|
|
/// the VTKm Tuple classes. In the future it would be nice to have a compile
|
|
/// time check to enforce this.
|
|
///
|
|
template <typename ValueT>
|
|
class Storage<ValueT, vtkm::cont::StorageTagBasic>
|
|
{
|
|
public:
|
|
typedef ValueT ValueType;
|
|
typedef vtkm::cont::internal::ArrayPortalFromIterators<ValueType*> PortalType;
|
|
typedef vtkm::cont::internal::ArrayPortalFromIterators<const ValueType*> PortalConstType;
|
|
|
|
/// The original design of this class provided an allocator as a template
|
|
/// parameters. That messed things up, though, because other templated
|
|
/// classes assume that the \c Storage has one template parameter. There are
|
|
/// other ways to allow you to specify the allocator, but it is uncertain
|
|
/// whether that would ever be useful. So, instead of jumping through hoops
|
|
/// implementing them, just fix the allocator for now.
|
|
///
|
|
typedef std::allocator<ValueType> AllocatorType;
|
|
|
|
public:
|
|
|
|
VTKM_CONT_EXPORT
|
|
Storage(const ValueType *array = NULL, vtkm::Id numberOfValues = 0)
|
|
: Array(const_cast<ValueType *>(array)),
|
|
NumberOfValues(numberOfValues),
|
|
AllocatedSize(numberOfValues),
|
|
DeallocateOnRelease(false),
|
|
ReadOnly(true) { }
|
|
|
|
VTKM_CONT_EXPORT
|
|
~Storage()
|
|
{
|
|
this->ReleaseResources();
|
|
}
|
|
|
|
VTKM_CONT_EXPORT
|
|
Storage(const Storage<ValueType, StorageTagBasic> &src)
|
|
: Array(src.Array),
|
|
NumberOfValues(src.NumberOfValues),
|
|
AllocatedSize(src.AllocatedSize),
|
|
DeallocateOnRelease(false),
|
|
ReadOnly(src.ReadOnly)
|
|
{
|
|
if (src.DeallocateOnRelease)
|
|
{
|
|
throw vtkm::cont::ErrorControlBadValue(
|
|
"Attempted to copy a storage array that needs deallocation. "
|
|
"This is disallowed to prevent complications with deallocation.");
|
|
}
|
|
}
|
|
|
|
VTKM_CONT_EXPORT
|
|
Storage &operator=(const Storage<ValueType, StorageTagBasic> &src)
|
|
{
|
|
if (src.DeallocateOnRelease)
|
|
{
|
|
throw vtkm::cont::ErrorControlBadValue(
|
|
"Attempted to copy a storage array that needs deallocation. "
|
|
"This is disallowed to prevent complications with deallocation.");
|
|
}
|
|
|
|
this->ReleaseResources();
|
|
this->Array = src.Array;
|
|
this->NumberOfValues = src.NumberOfValues;
|
|
this->AllocatedSize = src.AllocatedSize;
|
|
this->DeallocateOnRelease = src.DeallocateOnRelease;
|
|
this->ReadOnly = src.ReadOnly;
|
|
|
|
return *this;
|
|
}
|
|
|
|
VTKM_CONT_EXPORT
|
|
void ReleaseResources()
|
|
{
|
|
if (this->NumberOfValues > 0)
|
|
{
|
|
VTKM_ASSERT_CONT(this->Array != NULL);
|
|
if (this->DeallocateOnRelease)
|
|
{
|
|
AllocatorType allocator;
|
|
allocator.deallocate(this->Array, this->AllocatedSize);
|
|
}
|
|
this->Array = NULL;
|
|
this->NumberOfValues = 0;
|
|
this->AllocatedSize = 0;
|
|
}
|
|
else
|
|
{
|
|
VTKM_ASSERT_CONT(this->Array == NULL);
|
|
}
|
|
}
|
|
|
|
VTKM_CONT_EXPORT
|
|
void Allocate(vtkm::Id numberOfValues)
|
|
{
|
|
if ((numberOfValues <= this->AllocatedSize)
|
|
&& !this->ReadOnly)
|
|
{
|
|
this->NumberOfValues = numberOfValues;
|
|
return;
|
|
}
|
|
|
|
this->ReleaseResources();
|
|
try
|
|
{
|
|
if (numberOfValues > 0)
|
|
{
|
|
AllocatorType allocator;
|
|
this->Array = allocator.allocate(numberOfValues);
|
|
this->AllocatedSize = numberOfValues;
|
|
this->NumberOfValues = numberOfValues;
|
|
}
|
|
else
|
|
{
|
|
// ReleaseResources should have already set AllocatedSize to 0.
|
|
VTKM_ASSERT_CONT(this->AllocatedSize == 0);
|
|
}
|
|
}
|
|
catch (std::bad_alloc err)
|
|
{
|
|
// Make sureour state is OK.
|
|
this->Array = NULL;
|
|
this->NumberOfValues = 0;
|
|
this->AllocatedSize = 0;
|
|
throw vtkm::cont::ErrorControlOutOfMemory(
|
|
"Could not allocate basic control array.");
|
|
}
|
|
|
|
this->DeallocateOnRelease = true;
|
|
this->ReadOnly = false;
|
|
}
|
|
|
|
VTKM_CONT_EXPORT
|
|
vtkm::Id GetNumberOfValues() const
|
|
{
|
|
return this->NumberOfValues;
|
|
}
|
|
|
|
VTKM_CONT_EXPORT
|
|
void Shrink(vtkm::Id numberOfValues)
|
|
{
|
|
if (this->ReadOnly)
|
|
{
|
|
throw vtkm::cont::ErrorControlBadValue("Cannot shrink read-only array.");
|
|
}
|
|
|
|
if (numberOfValues > this->GetNumberOfValues())
|
|
{
|
|
throw vtkm::cont::ErrorControlBadValue(
|
|
"Shrink method cannot be used to grow array.");
|
|
}
|
|
|
|
this->NumberOfValues = numberOfValues;
|
|
}
|
|
|
|
VTKM_CONT_EXPORT
|
|
PortalType GetPortal()
|
|
{
|
|
if (this->ReadOnly)
|
|
{
|
|
throw vtkm::cont::ErrorControlBadValue(
|
|
"Tried to access read-only array as read-write.");
|
|
}
|
|
return PortalType(this->Array, this->Array + this->NumberOfValues);
|
|
}
|
|
|
|
VTKM_CONT_EXPORT
|
|
PortalConstType GetPortalConst() const
|
|
{
|
|
return PortalConstType(this->Array, this->Array + this->NumberOfValues);
|
|
}
|
|
|
|
/// \brief Take the reference away from this object.
|
|
///
|
|
/// This method returns the pointer to the array held by this array. It then
|
|
/// clears the internal array pointer to NULL, thereby ensuring that the
|
|
/// Storage will never deallocate the array. This is helpful for taking a
|
|
/// reference for an array created internally by VTK-m and not having to keep
|
|
/// a VTK-m object around. Obviously the caller becomes responsible for
|
|
/// destroying the memory.
|
|
///
|
|
VTKM_CONT_EXPORT
|
|
ValueType *StealArray()
|
|
{
|
|
ValueType *saveArray = this->Array;
|
|
this->Array = NULL;
|
|
this->NumberOfValues = 0;
|
|
this->AllocatedSize = 0;
|
|
return saveArray;
|
|
}
|
|
|
|
private:
|
|
ValueType *Array;
|
|
vtkm::Id NumberOfValues;
|
|
vtkm::Id AllocatedSize;
|
|
bool DeallocateOnRelease;
|
|
bool ReadOnly;
|
|
};
|
|
|
|
} // namespace internal
|
|
|
|
}
|
|
} // namespace vtkm::cont
|
|
|
|
#endif //vtk_m_cont_StorageBasic_h
|