Functionality for creating movies (AVIs) More...

#include <QmitkMovieMaker.h>

Inheritance diagram for QmitkMovieMaker:

Collaboration diagram for QmitkMovieMaker:

Public Slots
void	StartPlaying ()
	Start playing the animation by restarting the timer.
void	PausePlaying ()
	Pauses playing the animation by stopping the timer.
void	StopPlaying ()
	Stops playing the animation and resets the stepper.
void	SetLooping (bool looping)
	Sets animation looping ON/OFF.
void	SetDirection (int direction)
	Sets the direction: 0 = forward, 1 = backward, 2 = pingpong.
void	SetAspect (int aspect)
	Sets the animation aspect: 0 = spatial, 1 = temporal, 2 = combined.
void	SetStepperWindow (int window)
	Sets a specified stepper window, which is moving.
void	SetRecordingWindow (int window)
	Sets a specified recording window, from which the movie is generated.
void	AdvanceAnimation ()
	Advances the animation by one frame. Exactly how much the stepper advances depends on the time elapsed since the last call to this function.
Signals
void	StartBlockControls ()
void	EndBlockControls ()
void	EndBlockControlsMovieDeactive ()
void	SwitchDirection (int)
void	SwitchAspect (int)
void	SwitchSelectedStepperWindow (int)
void	SwitchSelectedRecordingWindow (int)
Public Member Functions
	QmitkMovieMaker (QObject parent=0, const char name=0)
	Constructor.
virtual	~QmitkMovieMaker ()
	Destructor.
void	CreateQtPartControl (QWidget *parent)
	Method for creating the widget containing the application controls, like sliders, buttons etc.
virtual void	CreateConnections ()
	Method for creating the connections of main and control widget.
virtual void	Activated ()
	Method for creating an QAction object, i.e. button & menu entry.
virtual void	Deactivated ()
void	FocusChange ()
	Called when another window receives the focus.
virtual void	DataStorageChanged ()
virtual void	StdMultiWidgetAvailable (QmitkStdMultiWidget &stdMultiWidget)
virtual void	StdMultiWidgetNotAvailable ()
Protected Slots
void	RenderSlot ()
void	GenerateMovie ()
void	GenerateScreenshot ()
void	GenerateHR3DScreenshot ()
void	RBTNForward ()
void	RBTNBackward ()
void	RBTNPingPong ()
void	RBTNSpatial ()
void	RBTNTemporal ()
void	RBTNCombined ()
void	BlockControls ()
void	UnBlockControls ()
void	UnBlockControlsMovieDeactive ()
void	BlockControls (bool blocked)
void	DeleteMStepper ()
Protected Attributes
QObject *	parentWidget
QVTKWidget *	widget
QmitkStdMultiWidget *	m_MultiWidget
vtkEventQtSlotConnect *	connections
vtkRenderWindow *	renderWindow
mitk::VtkPropRenderer::Pointer	m_PropRenderer
Ui::QmitkMovieMakerControls *	m_Controls

Detailed Description

Functionality for creating movies (AVIs)

Overview

The MovieMaker functionality extends existing modes of data visualization with animation capabilities. The animation aspect determines which aspect of a visualization gets animated. This aspect can be spatial (i.e. the camera position and orientation in a 3D view, or the selected slice in a 2D view), temporal (the time step in a time-based dataset), or something more sophisticated (for example, volume rendering transfer functions might be changed dynamically as part of an animation to produce interesting effects). Currently, the following animation modes are supported:

Rotation of the camera around the dataset (3D views)
Stepping through the dataset slice by slice (2D views)
Stepping through a time-based dataset (2D and 3D views)

As can be seen in the screenshot below, the functionality provides cine controls to start, pause and stop the animation. The direction of the animation can be selected (forward, backward or ping-pong). The animation can be set to either the spatial or the temporal aspect, or to both aspects combined. The cycle time determines the duration of one animation loop.

In a multi-view scenario, the animation is applied to the currently focussed view. Other views which display the same data may be affected as well.

Animations can be written on disk; the corresponding button creates an animation consisting of one single loop and writes every animation frame into an AVI file.

Implementation

The following diagram provides an overview over the classes collaborating with QmitkMovieMaker.

The respective roles of these classes are:

QmitkMovieMaker
- Provides a class interface for configuring and controlling the animation
- Is associated with the user interface
- As a Functionality, controls initialization and maintainance of the involved components
mitk::BaseController
- Controls an animation aspect (slice selection, camera angle, ...)
- Subclass mitk::SliceNavigationController: Transfers the animation requests to the associated Renderer for selecting a slice in a 3D dataset
- Subclass mitk::CameraRotationController: Modifies the camera angle
mitk::Stepper
- Link between MovieMaker and Controller
- Holds the current step position of the associated animation aspect (e.g. the camera rotation angle, or the slice number)
mitk::FocusManager
- Determines which of the available RenderWindows (and thereby which Renderers) the animation shall be applied to
mitk::BaseRenderer
- Controls the rendering of a dataset
- Target class of the animation
mitk::MovieGenerator
- Writes an AVI file

Future plans

The basic animation capabilities of this functionality could be extended to allow the creation of more sophisticated animations. Potentially useful features include:

Camera paths: Allow the definition of complex camera paths along which the camera can then be moved during an animation. This might be done by defining camera keyframes between which camera movements are interpolated (as in standard 3D animation applications). Paths derived from anatomical features (e.g. vessel graphs) could also serve as a basis for camera movements.
Color / transfer function animation: Choosing suitable color and transfer functions is critical to the quality and benefit of volume rendering. Dynamically changing transfer functions could visually enrich an animation. One way of achieving this could be to define transfer function keyframes between which an animation interpolates.

Definition at line 138 of file QmitkMovieMaker.h.

Constructor & Destructor Documentation

QmitkMovieMaker::QmitkMovieMaker	(	QObject *	parent = `0`,
		const char *	name = `0`
	)

Constructor.

Definition at line 79 of file QmitkMovieMaker.cpp.

References FocusChange(), MITK_ERROR, mitk::MovieGenerator::New(), and parentWidget.

:
  QmitkFunctionality(), m_Controls(NULL),
  m_StepperAdapter(NULL),
  m_FocusManagerCallback(0), m_Looping(true), m_Direction(0), m_Aspect(0)
{

  parentWidget = parent;

  m_Timer = new QTimer(this);
  m_Time = new QTime();

  m_FocusManagerCallback = MemberCommand::New();
  m_FocusManagerCallback->SetCallbackFunction(this, &QmitkMovieMaker::FocusChange);

  m_movieGenerator = mitk::MovieGenerator::New();

  if (m_movieGenerator.IsNull())
  {
    MITK_ERROR << "Either mitk::MovieGenerator is not implemented for your";
    MITK_ERROR << " platform or an error occurred during";
    MITK_ERROR << " mitk::MovieGenerator::New()" ;
  }

}

QmitkMovieMaker::~QmitkMovieMaker ( ) [virtual]

Destructor.

Definition at line 106 of file QmitkMovieMaker.cpp.

{
  delete m_StepperAdapter;
  delete m_Timer;
  delete m_Time;
  //delete m_RecordingRenderer;

}

Member Function Documentation

void QmitkMovieMaker::Activated ( ) [virtual]

Method for creating an QAction object, i.e. button & menu entry.

Parameters:

parent the parent QWidget

Reimplemented from QmitkFunctionality.

Definition at line 204 of file QmitkMovieMaker.cpp.

References FocusChange(), mitk::GlobalInteraction::GetInstance(), mitk::BaseController::GetTime(), and MITK_INFO.

{
  QmitkFunctionality::Activated();

  // create a member command that will be executed from the observer
  itk::SimpleMemberCommand<QmitkMovieMaker>::Pointer stepperChangedCommand;
  stepperChangedCommand = itk::SimpleMemberCommand<QmitkMovieMaker>::New();
  // set the callback function of the member command
  stepperChangedCommand->SetCallbackFunction(this, &QmitkMovieMaker::UpdateGUI);
  // add an observer to the data tree node pointer connected to the above member command
  MITK_INFO << "Add observer on insertion point node in NavigationPathController::AddObservers";
  m_StepperObserverTag = this->GetTemporalController()->GetTime()->AddObserver(
      itk::ModifiedEvent(), stepperChangedCommand);

  m_FocusManagerObserverTag
      = mitk::GlobalInteraction::GetInstance()->GetFocusManager()->AddObserver(mitk::FocusEvent(),
          m_FocusManagerCallback);
  this->UpdateGUI();
  // Initialize steppers etc.
  this->FocusChange();
}

void QmitkMovieMaker::AdvanceAnimation ( ) [slot]

Advances the animation by one frame. Exactly how much the stepper advances depends on the time elapsed since the last call to this function.

Definition at line 270 of file QmitkMovieMaker.cpp.

References mitk::Stepper::GetSteps(), m_Controls, mitk::Stepper::Next(), QmitkStepperAdapter::SetStepper(), and Ui_QmitkMovieMakerControls::spnDuration.

QmitkMovieMaker Class Reference [Functionalities]

Public Slots

Signals

Public Member Functions

Protected Slots

Protected Attributes