Module display

---

Detailed Description

Version:

0.2

Author:

matthieu@laas.fr, thomas.lemaire@laas.fr

This modules allows you to use Tcl/Tk display features in a simpler way.

In deed, it provides macros for displaying JfrImage objects (display) and showing some stuff on them (overlay), such as:

• text
• lines
• squares
• dots

For better display features have a look at viewer3d or qdisplay modules but if your aim is just to display images and show some interest zones on them - and you are a Tcl user, it is quite sufficient.

History

• 0.2 (2006-03-31) - This version conforms to the (u,v):(column,row) convention
• 0.1 (2005-02-08) - Initial version

Bugs and Todos

• When dumping a display with dumpEps, there are the following problems:
  • a white border of several pixels (about 3) can appear on the right and bottom of the image,
  • the dumped image can have a lower resolution,
  • the font in the dump is smaller than on the real display

• When playing with the zoom, there is no scrollbar if the window exceeds screen size and then the window is not properly resized.

GUI

Use macros show, refresh, zoom and destroy.

The gui of the display window is very limited, it offers the following functions :

• q close the display
• r refresh the display
• z zoom-out with scale 0.5
• Z zoom-in with scale 2

The zoom operations are transparents with respect to the overlay: the current overlay is properly scaled, and the objects which are drawned after the zoom operation will also be properly scaled.

Warning:

Tk photo supports only integer zoom or reduction factor (scale = 3, 2, 1/2, 1/3,...).

Macro

Overlay

All the macro named drawXxx add an object over the specified image. They make use of functions from the tk canvas. We use (u=column,v=row) image coordinate. These macros are defined in overlay.tcl.

Tcl interface (generated by swig)

The interface of the module is generated from the following files:

• display.i defines the wrapped classes and functions,
• displayException.i defines the try { } catch block for this module.

Classes
class	jafar::display::DisplayException
	Base class for all exceptions defined in the module display. More...