scalarBar.H 4.8 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     |
    \\  /    A nd           | Copyright (C) 2019 OpenCFD Ltd.
     \\/     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::functionObjects::runTimePostPro::scalarBar

Description
    Handling of scalar bar setup.

    Dictionary controls - scalar-bar entries (when \c visible is true)
    \table
        Property    | Description                           | Required | Default
        visible     | Display scalar bar                    | no  | true
        title       | The title for the scalar bar          | yes |
        position    | Viewport position (x y) of scalar bar | yes |
        vertical    | Vertical scalar bar                   | no  | true
        size        | Viewport size (x y) of scalar bar     | no  | auto
38
        fontSize    | Label size                            | no  | 0 == auto
39 40 41 42 43 44
        titleSize   | Title font size                       | no  | 0 == auto
        labelFormat | Label format string (eg, "%f")        | no  | "%f"
        numberOfLabels | Total number of labels             | no  | 5
        bold        | Title in bold                         | no  | yes
        italic      | Title in italic font                  | no  | no
        shadow      | Title with shadowont                  | no  | no
45
        titleHack   | Alternative placement strategy        | no  | no
46 47
    \endtable

48 49 50 51 52 53 54 55 56 57 58 59 60
Note
    The \c titleHack option is a leftover from much older VTK versions
    that had poor handling of the scalar bar text. When this is active,
    the normal scalar bar title is suppressed and placed manually
    (with a predefined ratio of the base font-size).

    When the titleHack is off, the label and title font sizes are
    automatically defined by the scalar bar size but can be overridden with
    provided values.

    The effect of fontSize and titleSize is unfortunately not consistent
    between titleHack on/off.

61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92
SourceFiles
    scalarBar.C

\*---------------------------------------------------------------------------*/

#ifndef functionObjects_runTimePostPro_scalarBar_H
#define functionObjects_runTimePostPro_scalarBar_H

#include "dictionary.H"
#include "Tuple2.H"
#include "vector.H"

// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

// Forward Declarations
class vtkLookupTable;
class vtkRenderer;


namespace Foam
{
namespace functionObjects
{
namespace runTimePostPro
{

/*---------------------------------------------------------------------------*\
                          Class scalarBar Declaration
\*---------------------------------------------------------------------------*/

class scalarBar
{
93 94 95 96 97 98
    //- The default font size when titleHack is on
    static constexpr const label defaultFontSize = 18;

    //- The auto title/label ratio when titleHack is on
    static constexpr const float defaultTitleSizeFactor = 1.5;

99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157
    bool visible_;
    bool vertical_;
    bool bold_;
    bool italic_;
    bool shadow_;
    bool titleHack_;

    Tuple2<scalar, scalar> position_;

    Tuple2<scalar, scalar> size_;

    string title_;

    label fontSize_;

    label titleSize_;

    label nLabels_;

    string labelFormat_;


public:

    //- Construct with sensible defaults
    scalarBar();

    //- Reset to sensible defaults
    void clear();

    //- Make non-visible
    void hide();

    //- Read dictionary settings
    void read(const dictionary& dict);

    //- Add colour bar, when visible.
    bool add
    (
        const vector& textColour,
        vtkRenderer* renderer,
        vtkLookupTable* lut
    ) const;
};


// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

} // End namespace runTimePostPro
} // End namespace functionObjects
} // End namespace Foam

// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

#endif

// ************************************************************************* //