Shuenhoy/vtk-m
1
0
Fork 0
mirror of https://gitlab.kitware.com/vtk/vtk-m synced 2024-09-16 17:22:55 +00:00
Code Issues 2 Actions Packages Projects Releases Wiki Activity
627b757733
vtk-m/docs/changelog/runtime-vec-array.md
Kenneth Moreland 331a277fe3 Automatically convert between ArrayHandleBasic and ArrayHandleRuntimeVec 
The `UnknownArrayHandle` has been updated to allow
`ArrayHandleRuntimeVec` to work interchangeably with basic
`ArrayHandle`. If an `ArrayHandleRuntimeVec` is put into an
`UnknownArrayHandle`, it can be later retrieved as an `ArrayHandleBasic`
as long as the base component type matches and it has the correct amount
of components. This means that an array can be created as an
`ArrayHandleRuntimeVec` and be used with any filters or most other
features designed to operate on basic `ArrayHandle`s. Likewise, an array
added as a basic `ArrayHandle` can be retrieved in an
`ArrayHandleRuntimeVec`. This makes it easier to pull arrays from VTK-m
and place them in external structures (such as `vtkDataArray`).
2023-02-20 07:39:49 -07:00

1.4 KiB
Raw Blame History

Added ArrayHandleRuntimeVec to specify vector sizes at runtime.

The new ArrayHandleRuntimeVec is a fancy ArrayHandle allows you to specify a basic array of Vecs where the number of components of the Vec are not known until runtime. (It can also optionally specify scalars.) The behavior is much like that of ArrayHandleGroupVecVariable except that its representation is much more constrained. This constrained representation allows it to be automatically converted to an ArrayHandleBasic with the proper Vec value type. This allows one part of code (such as a file reader) to create an array with any Vec size, and then that array can be fed to an algorithm that expects an ArrayHandleBasic of a certain value type.

The UnknownArrayHandle has also been updated to allow ArrayHandleRuntimeVec to work interchangeably with basic ArrayHandle. If an ArrayHandleRuntimeVec is put into an UnknownArrayHandle, it can be later retrieved as an ArrayHandleBasic as long as the base component type matches and it has the correct amount of components. This means that an array can be created as an ArrayHandleRuntimeVec and be used with any filters or most other features designed to operate on basic ArrayHandles. Likewise, an array added as a basic ArrayHandle can be retrieved in an ArrayHandleRuntimeVec. This makes it easier to pull arrays from VTK-m and place them in external structures (such as vtkDataArray).