This is the Interface to control the DWARF 3D Viewer automatic layout settings.
consists of the following interface
boolean add(in string id, in ViewerLayoutControlStringSequence? parents, in ViewerLayoutControlObjectConstraints? objectConstraints, in ViewerLayoutControlLayoutSettings? layoutSettings, in ViewerLayoutControlPosition25D? initialPosition, in ViewerLayoutControlSize25D? initialSize); Adds a new object to the automatic layout.
boolean remove(in string id); Removes an object from the automatic layout.
boolean update(in string id, in ViewerLayoutControlStringSequence? parents, in ViewerLayoutControlObjectConstraints? objectConstraints, in ViewerLayoutControlLayoutSettings? layoutSettings); Updates the constraints and settings of an object.
boolean clear(in string id); Clears all children of an object, so none of them is automatically placed any more.
The interface exists as two variants. One is to use Corba Object Method calls and the other is to send an Event of type ViewerLayoutControl
to the Viewer.
The benefit of the event based invocation is that several different Viewers can receive the event at the same time while the method call
gives limited feedback about the success of the invocation.
The usage of the interface should, hopefully, be very intuitive. Look into the ViewerLayoutController Python script or the simplelabel demo, in the DWARF distribution, for reference how to call the different methods.
The known issues right now are:
- remove and clear is not implemeted yet
- 09 Nov 2004