COPA EXAMPLES

Before using any of the examples, the environment
variable COPA_HOME needs to be set to hold the
path name of the main copa directory (where the
files gui.def and presets.pan are located).

Also, as with any X application, the DISPLAY
environment variable may need to be set, and
display permissions set using xhost.


hello.sh      - simple shell script example taken from the man 
		page copa(1).  To invoke, type:  sh hello.sh

hello.perl    - same as above but written in perl.
		To invoke, type:  perl hello.perl

The above will at least let you know if interprocess 
communication is working properly.


demo	      - an interactive introduction to copa which invokes
	  	just about all of its commands/functions.
	  	Compiled from demo.c when copa is installed.
		To invoke, type:  demo

demo.sh       - same as above, but written in Bourne shell.
		To invoke, type:  sh demo.sh

preview.sh    - a utility for viewing .pan files and generating
		Postscript dumps.  Written in Bourne shell.  
		To invoke, type:  sh preview.sh

preview.perl  - same as above, but written in perl.
		To invoke, type:  perl preview.perl

preview       - same as above, but written in C.  
	  	It will need to be compiled; edit the Makefile
	  	then do a make prev.
		To invoke, type:  preview
	  
alarm         - a simple "alarm clock" utility.
	  	It will need to be compiled; edit the Makefile
	  	then do a make alarm.  To invoke, type:  alarm &

browser.sh    - a simple man page browser utility to demonstrate
		the use of copa commands in an application.
		To invoke, type:  sh browser.sh

page.sh	      - for previewing pan files containing plots for 
		display on a standard sized sheet of paper,
		and generating Encapsulated PostScript dumps.
		To invoke type: sh page.sh

form.sh	      - a data entry example (uses files named *.dta)


As for real-life production examples, copa has successfully been 
used to implement gui control for a forms imaging/ocr application.
The application is written in C, and controls SwiftView (a nice,
flexible, fast viewer for tiff and other images) via piped commands.
If you have SwiftView (tech@ndg.com   tel: 503-620-0196), I would
be glad to send you a demo of this application.  

Steve G. (stevegru@welchlink.welch.jhu.edu)

