KWWidgets/Projects/3DWidgets/Widgets/ChangingArchitecture: Difference between revisions
From KitwarePublic
Jump to navigationJump to search
No edit summary |
No edit summary |
||
Line 1: | Line 1: | ||
==Analysis and overview of existing architecture== | ==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. | |||
<center>[[Image:Class_Diagram_vtKSliderWidget.png]]</center> | |||
'''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? | |||
==Analysis and overview of new architecture== | ==Analysis and overview of new architecture== | ||
==Comparing the two architectures== | ==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<br>* added<br>* removed<br>* edited | |||
* example code<br>*changes to original | |||
==Changing Architecture=== | ==Changing Architecture=== | ||
Line 13: | Line 34: | ||
'''Change Overview''' | '''Change Overview''' | ||
'''Modified Widgets''' | '''Modified Widgets''' | ||
Line 30: | Line 43: | ||
==Widgets== | ==Widgets== | ||
<center>[[Image:Class_Diagram_vtkMyWidget.jpg]]</center> | <center>[[Image:Class_Diagram_vtkMyWidget.jpg]]</center> |
Revision as of 08:31, 23 May 2006
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.
![Class Diagram vtKSliderWidget.png](/Wiki/images/6/6d/Class_Diagram_vtKSliderWidget.png)
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?
Analysis and overview of new architecture
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
![Class Diagram vtkMyWidget.jpg](/Wiki/images/4/49/Class_Diagram_vtkMyWidget.jpg)