User:Dzonatas Sol/Communicator

Please feel free to update this page as needed.

Documentation

Notes related to SNOW-375 on how to download, compile, install, and run the viewer with detached windows.

Use git to download the repository:

$ git clone http://gitweb.dzonux.net/project/communicator.git

There are a few branches:

master              - source branch of current version
communicator        - latest development branch (merges into master, tagged into X.X.X)
communicator.X.X.X  - tagged branches of specific version X

Refer to my notes on my compilation experience of Snowglobe on Linux.

Before you extract the artwork and libraries archives, create a symbolic link called 'linden' that points to the existing 'communicator/' directory. Put it in the same directory as 'communicator/'.

Start Communicator after you start Snowglobe:

$ cd indra/viewer-*/communicator
$ LD_LIBRARY_PATH=. ./communicator.exe

You can restart Communicator anytime.

Use the "Communicator" toolbar button to popup the individual windows. You can touch the button or use the selection menu.

Issues

• Need to automatically spawn Communicator when Snowglobe starts. Currently have to spawn separately.
• Need a preference panel option to set address of Web/REST server port. (Used to connect from communicator to viewer asynchronously.)
• Need a preference panel option to set address of default TCP dial-out port. (Used to connect from viewer to communicator synchronously.)
• Update cmake build-package to include communicator and extra libs if specified on cmake config or make command, but not to include by default.
• Need a debug option to Hide/Show built-in communicator windows when detached windows are shown.