Camera and Property Linking: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
No edit summary
Line 16: Line 16:
Object links can be created from the Manage Links dialog (Tools -> Manage Links ...). Simply select the name of the link and the two objects and press OK.
Object links can be created from the Manage Links dialog (Tools -> Manage Links ...). Simply select the name of the link and the two objects and press OK.


'''Property Linking'''
[[Image:Objectlink.png|400px|center]]
* Two properties of the same type can be linked.
** For example:
*** A sphere's Phi Resolution and Theta Resolution can be linked.
*** A cylinder's radius and a sphere's radius can be linked.
*** A cylinder's radius cannot be linked with a sphere's center.


'''Creating links in ParaView'''
==Property Linking==
* Quick view links can be created by right clicking in a view and selecting "Link Views..."  A popup window is presented with the ability to name the link, and cancel.  The link is created when the user clicks on another view.
Property linking allows the linking of individual properties of pipeline objects together. For example:
* Tools -> Manage Links... is a place to manage all types of links.
* A sphere's Phi Resolution and Theta Resolution can be linked.
** Links can be added/edited/removed.
* A cylinder's radius and a sphere's radius can be linked.
** When adding/editing a link, property or object types can be chosen.  Views can be selected under the object type.
* A cylinder's radius cannot be linked with a sphere's center (different number of elements)
Property links can be created from the Manage Links dialog (Tools -> Manage Links ...). First choose "Property link" as the Mode then select the objects and their properties to link and press OK.


'''Implementation Overview'''
[[Image:Propertylink.png|400px|center]]
* Server Manager
 
==Editing and Deleting Links==
Links can be edited and deleted using the Manage Links dialog (Tools -> Manage Links ...). Select the link you want to edit and them press Edit... or Remove.
 
 
==Implementation Overview for Developeres==
* Implemented in server manager:
** vtkSMCameraLink, vtkSMPropertyLink, vtkSMProxyLink share a common vtkSMLink base class.
** vtkSMCameraLink, vtkSMPropertyLink, vtkSMProxyLink share a common vtkSMLink base class.
** vtkSM*Link classes support bi-directional links, with multiple "inputs" and multiple "outputs".
** vtkSM*Link classes support bi-directional links, with multiple "inputs" and multiple "outputs".

Revision as of 21:34, 9 September 2008

During a visualization session, it is sometimes necessary to keep the values of two properties synchronized. For example, you may have two slice filters applied to two separate data sources and you may want the two slice planes to be always the same. This can be accomplished by "linking" the plane of the two filters. There are a few types of links.

  • Camera
  • Proxy
  • Property

Camera Linking

A camera link links cameras from two views together. A change in one, propagates to the other, and vice versa. Camera linking can be quickly established by right clicking in a view and selecting "Link Views..." (make sure not the move the mouse after right clicking as this would zoom instead of bringing the context menu). A popup window is presented with the ability to name the link, and cancel. The link is created when the user clicks on another view.

Cameralink.png

Object (proxy) Linking

Object linking allows the linking of two pipeline or view object together. If an object has any property with the same name as the other object, those properties will be linked. For example:

  • Two sphere sources will have all of their properties linked.
  • A sphere source and a cylinder source will have only Radius and Center linked.
  • The planes of two clip filters can be linked.

Object links can be created from the Manage Links dialog (Tools -> Manage Links ...). Simply select the name of the link and the two objects and press OK.

Objectlink.png

Property Linking

Property linking allows the linking of individual properties of pipeline objects together. For example:

  • A sphere's Phi Resolution and Theta Resolution can be linked.
  • A cylinder's radius and a sphere's radius can be linked.
  • A cylinder's radius cannot be linked with a sphere's center (different number of elements)

Property links can be created from the Manage Links dialog (Tools -> Manage Links ...). First choose "Property link" as the Mode then select the objects and their properties to link and press OK.

Propertylink.png

Editing and Deleting Links

Links can be edited and deleted using the Manage Links dialog (Tools -> Manage Links ...). Select the link you want to edit and them press Edit... or Remove.


Implementation Overview for Developeres

  • Implemented in server manager:
    • vtkSMCameraLink, vtkSMPropertyLink, vtkSMProxyLink share a common vtkSMLink base class.
    • vtkSM*Link classes support bi-directional links, with multiple "inputs" and multiple "outputs".
    • If an "input" changes, the values are copied to the "outputs."
  • GUI side
    • All links are bi-directional.
    • All links are between only two objects. In other words, the vtkSM*Link objects have two inputs and two outputs. If it were not bi-directional, it would be one input and one output.
    • Camera linking is called View linking.