ENH: Initial commit of new runTimePostProcessing function object

- Allows generation of images (currently PNG files) during the run
- ... or afterwards by invoking the execFlowFunctionObjects utility
- Wrapper around VTK functionality
- Support for objects:
  - text
  - points (glyphs: sphere, arrow)
  - lines (tubes)
  - surfaces (wireframe, shaded, combination)
- Colour using:
  - user-defined
  - field values (several colour maps availale)
- For image sequences:
  - dynamic views (camera movement)
  - objects can appear/disappear using opacity
- Building
  - VTK dependency v6+
  - satisfied using ParaView from ThirdParty directory
  - or separate VTK installation

src/postProcessing/functionObjects/graphics/runTimePostProcessing/geometryBase.H

@@ -0,0 +1,171 @@
+/*---------------------------------------------------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     |
+    \\  /    A nd           | Copyright (C) 2015 OpenFOAM Foundation
+     \\/     M anipulation  |
+-------------------------------------------------------------------------------
+License
+    This file is part of OpenFOAM.
+
+    OpenFOAM is free software: you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+    for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
+
+Class
+    Foam::geometryBase
+
+Description
+
+SourceFiles
+    geometryBase.C
+
+\*---------------------------------------------------------------------------*/
+
+#ifndef geometryBase_H
+#define geometryBase_H
+
+#include "dictionary.H"
+#include "vector.H"
+#include "DataEntry.H"
+#include "HashPtrTable.H"
+#include "NamedEnum.H"
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+class vtkRenderer;
+class vtkActor;
+
+namespace Foam
+{
+
+class runTimePostProcessing;
+
+/*---------------------------------------------------------------------------*\
+                        Class geometryBase Declaration
+\*---------------------------------------------------------------------------*/
+
+class geometryBase
+{
+
+public:
+
+    // Public enumerations
+
+        enum renderModeType
+        {
+            rmFlat,
+            rmGouraud,
+            rmPhong
+        };
+
+        static const NamedEnum<renderModeType, 3> renderModeTypeNames;
+
+
+private:
+
+    // Private Member Functions
+
+        //- Disallow default bitwise copy construct
+        geometryBase(const geometryBase&);
+
+        //- Disallow default bitwise assignment
+        void operator=(const geometryBase&);
+
+
+protected:
+
+    // Protected data
+
+        //- Reference to the parent function object
+        const runTimePostProcessing& parent_;
+
+        //- Name
+        word name_;
+
+        //- Visible flag
+        bool visible_;
+
+        //- Render mode
+        renderModeType renderMode_;
+
+        //- Opacity
+        autoPtr<DataEntry<scalar> > opacity_;
+
+        //- Reference to the colours
+        const HashPtrTable<DataEntry<vector>, word>& colours_;
+
+
+    // Protected functions
+
+        //- Initialse actor
+        void initialiseActor(vtkActor* actor) const;
+
+
+public:
+
+    // Constructors
+
+        //- Construct from dictionary
+        geometryBase
+        (
+            const runTimePostProcessing& parent_,
+            const dictionary& dict,
+            const HashPtrTable<DataEntry<vector>, word>& colours
+        );
+
+
+    //- Destructor
+    virtual ~geometryBase();
+
+
+    // Member Functions
+
+        // Access
+
+            //- Return the reference to the parent function object
+            const runTimePostProcessing& parent() const;
+
+            //- Return the name
+            const word& name() const;
+
+            //- Return the visible flag
+            bool visible() const;
+
+            //- Return the opacity
+            scalar opacity(const scalar position) const;
+
+            //- Return reference to the colours
+            const HashPtrTable<DataEntry<vector>, word>& colours() const;
+
+
+        //- Add geometry to scene
+        virtual void addGeometryToScene
+        (
+            const scalar position,
+            vtkRenderer* renderer
+        ) = 0;
+
+        //- Update the actors
+        virtual void updateActors(const scalar position) = 0;
+};
+
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+} // End namespace Foam
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+#endif
+
+// ************************************************************************* //