mirror of
https://gitlab.kitware.com/vtk/vtk-m
synced 2024-09-16 17:22:55 +00:00
d1a4aecc59
We have made several improvements to adding data into an `ArrayHandle`. ## Moving data from an `std::vector` For numerous reasons, it is convenient to define data in a `std::vector` and then wrap that into an `ArrayHandle`. It is often the case that an `std::vector` is filled and then becomes unused once it is converted to an `ArrayHandle`. In this case, what we really want is to pass the data off to the `ArrayHandle` so that the `ArrayHandle` is now managing the data and not the `std::vector`. C++11 has a mechanism to do this: move semantics. You can now pass variables to functions as an "rvalue" (right-hand value). When something is passed as an rvalue, it can pull state out of that variable and move it somewhere else. `std::vector` implements this movement so that an rvalue can be moved to another `std::vector` without actually copying the data. `make_ArrayHandle` now also takes advantage of this feature to move rvalue `std::vector`s. There is a special form of `make_ArrayHandle` named `make_ArrayHandleMove` that takes an rvalue. There is also a special overload of `make_ArrayHandle` itself that handles an rvalue `vector`. (However, using the explicit move version is better if you want to make sure the data is actually moved.) ## Make `ArrayHandle` from initalizer list A common use case for using `std::vector` (particularly in our unit tests) is to quickly add an initalizer list into an `ArrayHandle`. Now you can by simply passing an initializer list to `make_ArrayHandle`. ## Deprecated `make_ArrayHandle` with default shallow copy For historical reasons, passing an `std::vector` or a pointer to `make_ArrayHandle` does a shallow copy (i.e. `CopyFlag` defaults to `Off`). Although more efficient, this mode is inherintly unsafe, and making it the default is asking for trouble. To combat this, calling `make_ArrayHandle` without a copy flag is deprecated. In this way, if you wish to do the faster but more unsafe creation of an `ArrayHandle` you should explicitly express that. This requried quite a few changes through the VTK-m source (particularly in the tests). ## Similar changes to `Field` `vtkm::cont::Field` has a `make_Field` helper function that is similar to `make_ArrayHandle`. It also features the ability to create fields from `std::vector`s and C arrays. It also likewise had the same unsafe behavior by default of not copying from the source of the arrays. That behavior has similarly been depreciated. You now have to specify a copy flag. The ability to construct a `Field` from an initializer list of values has also been added. |
||
|---|---|---|
| .. | ||
| internal | ||
| raytracing | ||
| testing | ||
| Actor.cxx | ||
| Actor.h | ||
| AxisAnnotation2D.cxx | ||
| AxisAnnotation2D.h | ||
| AxisAnnotation3D.cxx | ||
| AxisAnnotation3D.h | ||
| AxisAnnotation.cxx | ||
| AxisAnnotation.h | ||
| BitmapFont.cxx | ||
| BitmapFont.h | ||
| BitmapFontFactory.cxx | ||
| BitmapFontFactory.h | ||
| BoundingBoxAnnotation.cxx | ||
| BoundingBoxAnnotation.h | ||
| Camera.cxx | ||
| Camera.h | ||
| Canvas.cxx | ||
| Canvas.h | ||
| CanvasRayTracer.cxx | ||
| CanvasRayTracer.h | ||
| CMakeLists.txt | ||
| Color.cxx | ||
| Color.h | ||
| ColorBarAnnotation.cxx | ||
| ColorBarAnnotation.h | ||
| ColorLegendAnnotation.cxx | ||
| ColorLegendAnnotation.h | ||
| ConnectivityProxy.cxx | ||
| ConnectivityProxy.h | ||
| Cylinderizer.h | ||
| DecodePNG.h | ||
| EncodePNG.h | ||
| LineRenderer.cxx | ||
| LineRenderer.h | ||
| Mapper.cxx | ||
| Mapper.h | ||
| MapperConnectivity.cxx | ||
| MapperConnectivity.h | ||
| MapperCylinder.cxx | ||
| MapperCylinder.h | ||
| MapperPoint.cxx | ||
| MapperPoint.h | ||
| MapperQuad.cxx | ||
| MapperQuad.h | ||
| MapperRayTracer.cxx | ||
| MapperRayTracer.h | ||
| MapperVolume.cxx | ||
| MapperVolume.h | ||
| MapperWireframer.cxx | ||
| MapperWireframer.h | ||
| MatrixHelpers.h | ||
| Quadralizer.h | ||
| ScalarRenderer.cxx | ||
| ScalarRenderer.h | ||
| Scene.cxx | ||
| Scene.h | ||
| TextAnnotation.cxx | ||
| TextAnnotation.h | ||
| TextAnnotationBillboard.cxx | ||
| TextAnnotationBillboard.h | ||
| TextAnnotationScreen.cxx | ||
| TextAnnotationScreen.h | ||
| TextRenderer.cxx | ||
| TextRenderer.h | ||
| Texture2D.h | ||
| Triangulator.h | ||
| View1D.cxx | ||
| View1D.h | ||
| View2D.cxx | ||
| View2D.h | ||
| View3D.cxx | ||
| View3D.h | ||
| View.cxx | ||
| View.h | ||
| Wireframer.h | ||
| WorldAnnotator.cxx | ||
| WorldAnnotator.h | ||