README                                                      27.Jul.95
                                                       Keith Andrews

Harmony is Copyright (c) by IICM, see the full COPYRIGHT notice for
conditions of use.




             Harmony -- The Unix/X11 Client for Hyper-G
             ------------------------------------------


 Thank you for your interest in Harmony. Harmony is the Unix/X11
client for Hyper-G, the first "second generation", publicly available,
networked hypermedia information system running over the
Internet. Hyper-G integrates hyperlinking, hierarchical structuring,
sophisticated search, and access control facilities into one single
system, and is interoperable with other network information tools like
Gopher and WWW. Hyper-G is being developed jointly by the Institute
for Information Processing and Computer Supported New Media (IICM) of
Graz University of Technology, Austria and the Institute for
HyperMedia Systems (IHM) of JOANNEUM RESEARCH, Graz, Austria.


The latest release of Harmony is available by anonymous ftp from:

 ftp://ftp.iicm.tu-graz.ac.at/pub/Hyper-G/Harmony


The Harmony FAQ (Frequently Answered Questions) contains pointers to
further information about Harmony and Hyper-G and an up-to-date list
of FTP mirror sites. It is available at:

 ftp://ftp.iicm.tu-graz.ac.at/pub/Hyper-G/Harmony/harmony.faq




Harmony Features
----------------


o Hierarchical Browsing

 Harmony's Collection Browser displays the hierarchical membership
 structure of Hyper-G data, like a graphical file browser.


o Search

 Harmony supports both attribute (keyword, title, author, creation
 time, etc.) and content (full text) searches; search results are
 presented as a ranked list. The scope of searches is user-definable,
 ranging from individual collections to all collections on all
 Hyper-G servers world-wide.


o Hyperlinks

 Harmony supports hyperlinks between arbitrary document types,
 including text, image, film, PostScript, and 3D models. Source and
 destination anchors can be defined interactively.


o Local Map

 Harmony's Local Map presents a dynamically generated graphical
 overview of the link relationships of a chosen document: *both*
 incoming and outgoing hyperlinks are represented. Selecting an
 object toward the edge of the map and generating a new display
 offers a new means of associative browsing.


o Location Feedback

 Selecting a document or collection in the local map, in the search
 result list, or following a hyperlink, causes the location of the
 corresponding object to be *automatically* displayed in the
 collection browser, providing a powerful aid to orientation.


o History

 The History Browser offers a timeline of past interactive waypoints,
 including previous search panels.


o 3D Information Landscape

 The Information Landscape is a three-dimensional graphical overview
 map of the collection structure. Users can "fly" over the hyperspace
 landscape looking for salient features, select interesting
 documents, etc. This feature requires platform support for IrisGL,
 OpenGL or Mesa and is currently available for SGI, DEC Alpha, Solaris,
 Linux, HPUX machines.


o Multilinguality

 Harmony's user interface adjusts dynamically to the language of
 first choice, documents available in multiple languages are selected
 in order of language preference, and searches are optionally
 language-dependent.





Document Viewers
----------------

 Documents in Harmony are displayed by separate viewer processes in
windows of their own:


o Text

 A generic SGML parser is used to display Hyper-G (HTF) and WWW
 (HTML) texts. Inline images in GIF, JPEG, XPM, XBM and TIFF formats
 are supported.


o Image

 GIF, JPEG, and TIFF images are supported and may be zoomed, panned,
 etc. A special feature is live display -- when turned on, images are
 built up progressively on-screen as they are loaded. The autofit
 option automatically scales images to fit the current image viewer
 window.


o Film

 MPEG-1 video streams are supported. Options include live display
 while loading, double size display, alternative dithering methods,
 and gamma correction. After loading, selective portions of the film
 may be replayed, the frame rate altered, etc.


o Audio

 The Audio Player supports both the Network Audio System (NAS) and
 local audio commands provided on your system.


o PostScript

 PostScript files can be displayed page by page, zoomed, printed,
 etc.


o 3D Scene

 3D model descriptions are displayed and can be manipulated or
 traversed in three dimensions. Hyperlinks are attached to objects in
 the model. This feature requires platform support for IrisGL,
 OpenGL or Mesa and is currently available for SGI, DEC Alpha
 Solaris, Linux, PMAX, HPUX machines.



 *All* native Harmony viewers support both activation and interactive
definition of incoming and outgoing hyperlinks. Harmony can be
configured to use external programs to display any document type (but
without linking capabilities).





User Configuration
------------------

 Most features of Harmony can be configured by X resources, and many
of them interactively as well. We are working on a mechanism for
writing interactive configurations to a file and hence saving them
between Harmony sessions automatically (currently you have to enter
them into your ~/.Xdefaults file by hand).





Upcoming Features
-----------------

o Annotations.

o Better link manipulation and editing for existing links.

o A drag-and-drop file browser facility for uploading documents.

o Drag-and-drop manipulation of the collection hierarchy.

o Image editing via the Image Viewer.

o Integrated electronic mail facilities.

o 3D visualisation of link relationships and search results.

o Interactive forms.

o A Vector Graphics viewer.

o Online help.