KWWidgets/Projects/3DWidgets/Widgets/ChangingArchitecture

Analysis and overview of existing architecture

Architecture

In order to apply the redesigned architecture regarding the vtk 3D Widgets, I started by learning how it had been applied to vtkSliderWidget and how I could use this as a basis for comparison with the designated widgets, specifically vtkBoxWidget.

This I commenced by looking at the vtkSliderWidget and how it interacts with the main classes regarding the restructuring project - the vtkAbstractWidget and vtkWidgetRepresentation classes and their derivatives.

Comparing Structure

How to structure the callback?

After looking at vtkSliderWidget and vtkDistanceWidget, I have come across parts of two methods of dealing with callbacks. One (above) defines the required callback methods in the widget (vtkSliderWidget) whereas the other (below, based on vtkDistanceWidget) provides the possiblity to create CallbackMapper classes inheriting from vtkCallbackMapper to provide preset callback methods.

I feel that the second method is more inline with the 3DWidget reauthoring - separating events from representation. Also, it provides the possiblity to have different callbacks depending on widget use.

For example, a program may have a "View" and "Interact" modes. In "View" mode, CallbackMapperA is used where left-clicking will update a window with data XYZ. In "Interact" mode, CallbackMapperB is used where left-clicking selects the object for manipulation.

Which of these methods is better for the reauthoring?

Comparing the two architectures

Methodology

• study both architectures
• study source code; vtkBoxWidget (Old) and vtkSliderWidget (new)
• separate source code into new classes
• study events
• compare vtkBoxWidget Old and New
• methods
  * added
  * removed
  * edited
• example code
  *changes to original

Changing Architecture=

Previous Architecture

Redefined Architecture

Change Overview

Modified Widgets

• vtkBoxWidget
  vtkBoxWidget.h
  vtkBoxWidget.cxx
  vtkBoxRepresentation.h
  vtkBoxRepresentation.cxx
  

vtkBoxRepresentation2D.h
vtkBoxRepresentation2D.cxx
vtkBoxRepresentation3D.h
vtkBoxRepresentation3D.cxx
example code

Widgets