JVM (Java Virtual Machine) version - IMPORTANT - PLEASE READ
Since v0.10.0, ZVTM no longer runs on JVM version 1.4.x. It requires a JVM 1.5.0 or later.
Since v0.9.1, ZVTM no longer runs on JVM version 1.3.x. It requires a JVM 1.4.0 or later.
Documentation
Developer's Guide
We have started working on a Developer's Guide (PDF). The latest version (2012-01-25) is available from SVN, as LaTeX files.
JavaDoc
The most detailed documentation is the API Documentation in Javadoc (HTML) format. This online version is synchronized at least weekly with the latest ZVTM source code (as found in the SVN repository). The documentation matching a specific version of ZVTM is located in directory apidocs/ of each release.
A list of API changes between versions is available.
ZVTM-PDF documentation.
ZVTM-SVG documentation.
Research Papers
A research paper entitled A Toolkit for Addressing HCI Issues in Visual Language Environments, describing ZVTM's foundational concepts and main features, has been published in the proceedings of the IEEE Symposium on Visual Languages and Human-Centric Computing (VL/HCC '05), which took place in Dallas, TX in September 2005. The paper has been presented during Session 6: Interaction and User Interface Design, and is now available online through the IEEE Digital Library. It is also possible to obtain it freely upon request. This is the publication to cite if you want to make a reference to ZVTM (see Citing ZVTM for more details).
The following papers are about interaction techniques and visualizations available in ZVTM:
- E. Pietriga, O. Bau, C. Appert, Representation-Independent In-Place Magnification with Sigma Lenses, IEEE Transactions on Visualization and Computer Graphics (TVCG), 14 pages (available as pre-print)
- O. Chapuis, J.-B. Labrune, E. Pietriga, DynaSpot: Speed-Dependent Area Cursor, CHI '09: Proceedings of the SIGCHI conference on Human Factors in computing systems, pages 1391-1400, April 2009, Boston, USA
- T. Moscovich, F. Chevalier, N. Henry, E. Pietriga, J.-D. Fekete, Topology-Aware Navigation in Large Networks, CHI '09: Proceedings of the SIGCHI conference on Human Factors in computing systems, pages 2319-2328, April 2009, Boston, USA
- E. Pietriga, C. Appert, Sigma Lenses: Focus-Context Transitions Combining Space, Time and Translucence, CHI '08: Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, pages 1343-1352, April 2008, Florence, Italy
- E. Pietriga, C. Appert, M. Beaudouin-Lafon, Pointing and Beyond: an Operationalization and Preliminary Evaluation of Multi-scale Searching, CHI '07: Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, pages 1215-1224, April 2007, San Jose, CA, USA
- E. Pietriga, Semantic Web Data Visualization with Graph Style Sheets, ACM Symposium on Software Visualization (SoftVis '06), pages 177-178, September 2006, Brighton, UK
For French speakers, a description of the basic concepts underlying the ZVTM is available in chapter 5 of my PhD thesis (the library was then called XVTM, for Xerox Visual Transformation Machine). Note that it only covers concepts and features implemented before september 2002. So it is missing many features.
Examples
If you want examples of code using ZVTM, you can read source files in the fr/inria/zvtm/demo/ directory (the main class is Introduction.java) in package zvtm-demos. This demo does not use all ZVTM features but should help you get started. For more advanced features, you can take a look at the source code of IsaViz and ZGRViewer.
Mailing list, forum, trackers
Technical questions can be posted to the zvtm-devel mailing list (subscribe). We try to answer them in a timely and precise manner.
Build
ZVTM build instructions are available.
mini-HOWTOs
- Focus+Context representations: magnification lenses, distortion lenses and Sigma lenses
- DynaSpot - Speed-Dependent Area Cursor
- Multiple Pointing Devices
- Glyph Animations
- Scroll Bars in Views
Optimizing performances
- ZVTM works well under Windows and Mac OS X. There can be some performance issues under Linux/Xorg, especially when making use of translucency.
- I recommend running ZVTM applications using a JVM 1.4.0 or later, as Java2D performances have been significantly improved.
- SUN's JVM is available at http://www.javasoft.com/j2se/1.4/
- When running ZVTM in a Linux or Solaris environment, it is worth reading Sun's white paper on Graphics Performance Improvements.
License Information
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. For full terms see the file COPYING in the releases.
