Notes on using the titling effect on vic
----------------------------------------

by José María González, 8/6/02


-------------
- Screenshots
-------------

stream: http://www.openmash.org/resources/notes/titled-stream.png
UI: http://www.openmash.org/resources/notes/titling-ui.png



---------------------------------------
- Installing the special effects engine
---------------------------------------

The process is very similar to the long way one described here: 

http://www.openmash.org/developers/code.html

The steps are the following: 

a.1) checkout mash source code from OpenMash CVS archive
> cvs checkout mash-code

a.2) checkout Dali source code from OpenMash CVS archive
> cd mash-code
> cvs checkout dali

a.3) set some environment variables (tcsh). We're assumming mash-code 
	was installed in /data 
> setenv TCLCL_IMPORT_DIRS /data/mash-code/mash
> setenv TCLLIBPATH /data/mash-code/tcl8.3/
> setenv LD_LIBRARY_PATH /data/mash-code/lib:/data/mash-code/dali/unix/lib:$LD_LIBRARY_PATH
> setenv PATH /data/mash-code/mash/bin:$PATH


Then follow the instructions under "To compile the long way:" . The only 
differences are the addition of step 1.5, "Compile Dali", and a small 
modification in step 4, "Compile Mash."

1.5. Compile Dali

cd mash-code/dali/unix
./configure --with-tcl=/data/mash-code/tcl8.3/unix
make
cd mash-code/dali/unix/lib
ln -s tclDvmBasic.so libtclDvmBasic.so
ln -s tclDvmByteGeom.so libtclDvmByteGeom.so
ln -s tclDvmColor.so libtclDvmColor.so 
ln -s tclDvmPnm.so libtclDvmPnm.so
ln -s tclDvmVision.so libtclDvmVision.so

I've added a Dali troubleshooting for Linux (RedHat 7.2) below.



4. Compile Mash
cd mash-code/mash
./configure --enable-fx --with-dali=/data/mash-code/dali
make



----------------------------------
- Using the special effects engine
----------------------------------

Run vic with the "-fx" option

> vic -fx 222.2.2.2/22222

You'll find new options under the control menu. 



---------------------------------------------
- Dali troubleshooting for Linux (RedHat 7.2)
---------------------------------------------

- file mash-code/dali/unix/Makefile
	on line 7:
		before: TCL_LIB=tcl80
		after: TCL_LIB=tcl8.3

	line 9:
		before: EXTRA_LIBS= -lsocket -lnsl -lm
		after: EXTRA_LIBS= -lnsl -lm

- file mash-code/dali/include/macro.h
	comment out lines 188 and 189