volumeexplorer.h 5.8 KB
Newer Older
schultezub's avatar
schultezub committed
1
2
3
4
5
6
7
// ================================================================================================
// 
// This file is part of the CAMPVis Software Framework.
// 
// If not explicitly stated otherwise: Copyright (C) 2012, all rights reserved,
//      Christian Schulte zu Berge <christian.szb@in.tum.de>
//      Chair for Computer Aided Medical Procedures
8
9
//      Technische Universität München
//      Boltzmannstr. 3, 85748 Garching b. München, Germany
schultezub's avatar
schultezub committed
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// For a full list of authors and contributors, please refer to the file "AUTHORS.txt".
// 
// The licensing of this softare is not yet resolved. Until then, redistribution in source or
// binary forms outside the CAMP chair is not permitted, unless explicitly stated in legal form.
// However, the names of the original authors and the above copyright notice must retain in its
// original state in any case.
// 
// Legal disclaimer provided by the BSD license:
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
// IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY 
// AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR 
// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 
// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
// 
// ================================================================================================

#ifndef VOLUMEEXPLORER_H__
#define VOLUMEEXPLORER_H__

33
34
35
36
37
#include "tgt/event/eventlistener.h"

#include "core/eventhandlers/mwheeltonumericpropertyeventlistener.h"
#include "core/eventhandlers/trackballnavigationeventlistener.h"
#include "core/eventhandlers/transfuncwindowingeventlistener.h"
38

schultezub's avatar
schultezub committed
39
40
41
#include "core/pipeline/visualizationprocessor.h"
#include "core/properties/datanameproperty.h"
#include "core/properties/numericproperty.h"
42
#include "core/properties/metaproperty.h"
schultezub's avatar
schultezub committed
43
44
45
46
47
48
49
50

#include "modules/vis/processors/volumerenderer.h"
#include "modules/vis/processors/sliceextractor.h"

namespace tgt {
    class Shader;
}

schultezub's avatar
schultezub committed
51
52
class FaceGeometry;

schultezub's avatar
schultezub committed
53
54
55
56
namespace campvis {
    /**
     * Combines a volume raycaster and 3 slice views for explorative volume visualization.
     */
57
    class VolumeExplorer : public VisualizationProcessor, public tgt::EventListener {
schultezub's avatar
schultezub committed
58
59
60
61
    public:
        /**
         * Constructs a new VolumeExplorer Processor
         **/
62
        VolumeExplorer(IVec2Property* viewportSizeProp);
schultezub's avatar
schultezub committed
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

        /**
         * Destructor
         **/
        virtual ~VolumeExplorer();

        /// \see AbstractProcessor::init
        virtual void init();

        /// \see AbstractProcessor::deinit
        virtual void deinit();

        /// \see AbstractProcessor::getName()
        virtual const std::string getName() const { return "VolumeExplorer"; };
        /// \see AbstractProcessor::getDescription()
        virtual const std::string getDescription() const { return "Combines a volume raycaster and 3 slice views for explorative volume visualization."; };
79
80
81
        /// \see AbstractProcessor::getAuthor()
        virtual const std::string getAuthor() const { return "Christian Schulte zu Berge <christian.szb@in.tum.de>"; };
        /// \see AbstractProcessor::getProcessorState()
82
        virtual ProcessorState getProcessorState() const { return AbstractProcessor::EXPERIMENTAL; };
83
        
84
85
        /// \see tgt::EventListener::onEvent()
        virtual void onEvent(tgt::Event* e);
86

schultezub's avatar
schultezub committed
87
88
89
        virtual void process(DataContainer& data);

        DataNameProperty p_inputVolume;              ///< image ID for first input image
90
        DataNameProperty p_outputImage;              ///< image ID for output image
schultezub's avatar
schultezub committed
91

92
93
        MetaProperty p_seProperties;        ///< MetaProperty for SliceExtractor properties
        MetaProperty p_vrProperties;        ///< MetaProperty for Raycaster properties
schultezub's avatar
schultezub committed
94
95
96
97
98
99
100


    protected:
        /// Additional invalidation levels for this processor.
        /// Not the most beautiful design though.
        enum ProcessorInvalidationLevel {
            VR_INVALID = 1 << 4,
schultezub's avatar
schultezub committed
101
            SLICES_INVALID = 1 << 5,
schultezub's avatar
schultezub committed
102
103
104
105
106
107
108
109
110
111
112
113
114
115
        };

        /**
         * Slot getting called when one of the observed processors got invalidated.
         * Invalidates this meta-processor with the corresponding level.
         * \param   processor   The processor that emitted the signal
         */
        virtual void onProcessorInvalidated(AbstractProcessor* processor);

        /**
         * \see VisualizationProcessor::onPropertyChanged
         */
        virtual void onPropertyChanged(const AbstractProperty* prop);

schultezub's avatar
schultezub committed
116
117
        void composeFinalRendering(DataContainer& data);

118
119
        /// \see    AbstractProcessor::updateProperties
        void updateProperties(DataContainer& dc);
schultezub's avatar
schultezub committed
120
121
122
123

        tgt::Shader* _shader;                           ///< Shader for slice rendering
        FaceGeometry* _quad;

schultezub's avatar
schultezub committed
124
125
126
        VolumeRenderer _raycaster;
        SliceExtractor _sliceExtractor;

schultezub's avatar
schultezub committed
127
128
129
        IVec2Property p_sliceRenderSize;
        IVec2Property p_volumeRenderSize;

130

131
132
133
134
135
        MWheelToNumericPropertyEventListener _xSliceHandler;
        MWheelToNumericPropertyEventListener _ySliceHandler;
        MWheelToNumericPropertyEventListener _zSliceHandler;
        TransFuncWindowingEventListener _windowingHandler;
        TrackballNavigationEventListener* _trackballEH;
136
        bool _mousePressed;
137

schultezub's avatar
schultezub committed
138
139
140
141
142
143
        static const std::string loggerCat_;
    };

}

#endif // VOLUMEEXPLORER_H__