GitLab

- using ENABLE_BY_DEFAULT=ON eliminates much of the declaration cruft

- when enabled, this removes various bits of cutting planes.
  Can re-enable on a case-by-case basis (eg, when dealing with baffles)

ENH: support nColours for colourMap (default: 256)

- can be useful when creating distinct contours

- struck by the old dash bug, but also has some remnants of building
  into the project directory by default. It should be the user
  directory for consistency with other modules.

  This can be overriden with the "-prefix" option.

- now derived CMAKE_INSTALL_PREFIX from FOAM_MODULE_PREFIX since this
  improves consistency between the wmake rules and the cmake ones.

- defaults to user locations

- uses updated cmake/paraview scripts (1912, patch=200506)
  to support a user-specified installation prefix.

  Reworked the wmake Make/{files,options} files to respect the use
  of CMAKE_INSTALL_PREFIX, or default to FOAM_LIBBIN.

  Similarly the CMakeLists files have been updated to add install
  targets that respect the value of CMAKE_INSTALL_PREFIX.

  For building with paraview-5.7 and 5.8 a "staged" install is used
  to retain the expected output directory structure and to silently
  discard the unneeded static libraries.

- building paraview-5.7 and later requires cmake >= 3.10 itself
  but cmake-3.8 appears to work adequately for building dependent
  components

- use VERSION_GREATER_EQUAL instead of GREATER_EQUAL

Note
    For paraview-5.7 (and later?) plugins are built into their own subdirs.
    It also is not possible to suppress creation of static libraries in
    the process.

The current solution is still a bit ugly
  - install into a local "staged" location (within the build directory)
  - use rsync to relocate to the .so files to the plugin directory

- OpenFOAM reader:
     (vtkPVFoam, PVFoamReader_SM)
  => (vtkPVFoamReader, ParaFoamReader)

- blockMesh reader:
     (vtkPVblockMesh, PVblockMeshReader_SM)
  => (vtkPVblockReader, ParaFoamBlockReader)

* provides better correspondence between library and module names

- disable only for old versions

- when using VTK from ParaView sources it can better to tag them as
  such, but simultaneously not mask the ParaView with hardware
  rendering.

  The additional ParaView_MESA_DIR variable allows this.
  The balance of library and path setup is unaffected by this.

STYLE: cleanup of Allwclean, Allwmake

CONFIG: remove local version of cmakeVersionedInstall

- silently deprecate 'startsWith', 'endsWith' methods
  (added in 2016: 2b1436066221), in favour of
  'starts_with', 'ends_with' methods, corresponding to C++20 and
  allowing us to cull then in a few years.

- handle single character versions of starts_with, ends_with.

- add single character version of removeEnd and silently deprecate
  removeTrailing which did the same thing.

- drop the const versions of removeRepeated, removeTrailing.
  Unused and with potential confusion.

STYLE: use shrink_to_fit(), erase()

- similar prefixing as the dependent readers, making it easier to
  identify

- add FOAM_API information as server module version

COMP: provide separate get_pvplugin_api function

- building plugins with paraview-5.7 is quite different

- we don't need the GUI sort order of the values.

- drop plugin support for Qt4 (old paraview)

- handle upcoming changes in VTK version naming in CMake files
  * VTK_MAJOR_VERSION becomes VTK_VERSION_MAJOR etc.

- a top-level cloud::nParcels() virtual, which is overloaded by the
  first level of Cloud inheritance. This permits quick determination of
  cloud sizes, even when retrieved from registry with the base level.
  Eg,
      cloud* cldPtr = mesh.cfindObject<cloud>("myCloud");
      label nParcels = (cldPtr ? cldPtr->nParcels() : 0);

- make writeLagrangianPositions on by default unless explicitly
  disabled in the InfoSwitches.

  Flag output errors (where neither coordinates nor positions are
  written) with Fatal.

- additional IOField helper functions in cloud

STYLE: simplify iterator inheritance

- a leftover from much older VTK versions that had poor handling of
  the scalar bar text.

- in case an individual geometry element has render issues in parallel

- additional debug information

- make parallelProjection default (was previously mandatory)

- incorrectly uses paraview include dirs instead of the more universal
  vtk include dirs for the MPI test.

- Extended runTimePostProcessing to include access to "live"
  simulation objects such a geometry patches and sampled surfaces
  stored on the "functionObjectObjects" registry.

- Add 'live' runTimePostProcessing of cloud data.
  Extracts position and fields from the cloud via its objectRegistry writer

- For the "live" simulation objects, there are two new volume filters
  that work directly with the OpenFOAM volume fields:
      * iso-surface
      * cutting planes
  Both use the VTK algorithms directly and support multiple values.
  Eg, can make multiple iso-levels or multiple planes parallel to each
  other.

- When VTK has been compiled with MPI-support, parallel rendering will
  be used.

- Additional title text properties (shadow, italic etc)

- Simplified handling of scalar-bar and visibility switches

- Support multiple text positions. Eg, for adding watermark text.

- includes initial relocation of low-level vtu handling.
  Extracted, refactored from the Catalyst function object.

STYLE: adjust style of HashTable iterator pointer dereference

- allows localized extension of functionality

- reduced clutter when iterating over containers