Appendix A: Include and Library Files A








The Parallax Graphics include files are important tools for Video Development Environment users. This appendix describes the include files and how they are used, and describes the library files and how to set them up:
Descriptions of the Include Files
Descriptions of the Library Files
Linking and Compiling Libraries

Descriptions of the Include Files


The include files provided for your Parallax video program development are located in /opt/parallax/include. Brief descriptions of these include files are provided in the following table:
Include File Name Description Use
XPlxExt.h, extutil.h Xlib extension include file Include in all programs developed with Parallax video Xlib extension and Xt widgets
shmstr.h Shared memory include file Included in all programs that make use of shared memory compressed and decompressed functions.
qtab.h JPEG definition include file Includes all programs that use JPEG compression and decompression features
XVideoIn.h, XVideoOut.h, JPEG.h, XVideoInP.h, XVideoOutP.h Xt widget include files Include in all programs developed with Parallax video Xt widgets
Video.h, rasterfile.h XView objects and API include file Include in programs developed with Parallax video XView objects and APIs
jpeg.h, alert.h, audio.h JPEG Movie API library include file Include in programs developed with Parallax video JPEG Movie API
player.h, jvc.h, file.h, live.h, sony.h, panasonic.h, pc-vcr.h, pioneer.h, pod.h, visca.h, icon/*.h Device control API library include file and device-specific include files. Include in programs developed with Parallax video Device Control API: Please review these include files for application-specific information before supplying them.
vaa.h VideoTool include file Include if rebuilding videotool
MAEstro.h, Receiver.h, Sender.h MAEstro include file Include in any programs that you want to run in the MAEstro Inter-application messaging environment

Descriptions of the Library Files


Parallax library files are located in /opt/parallax/lib. A brief description of each library file is provided in the following table.

Library File Name Description
libXviewPlx.a Library for applications that use our XView-based objects
libXtPlx.a Library for applications that use our Xt-based widgets
libXPlx.a Library for applications that use our X11-based extension
libXv.a Library for all applications
libPlxApi.a Library for applications that use our API functions
libMAEstro.a Libraries for applications that you want to run in the MAEstro inter-application messaging environment. (MAEstro is available from Stanford University. To request more information on MAEstro, pelase send e-mail to maestro@sioux.stanford.edu)

Note: There is another important file you should know about. It is the applications default file, app_defaults, which is a directory of application-specific information used by Parallax applications. It includes application parameters and titles. This file is in /opt/parallax/install.

Linking and Compiling Libraries


To link and compile with any of these libraries, enter the library file name in your C-compile command, along withthe names of other library files that you might be using.

For the Xt-based Widget and X Extension

Or, to link libraries for our Xt-based widget and our X extension, enter the following (in the order shown):
For the Sun Platform: 
host:  cc sourcefile -L$(PARALLAX_HOME)/lib -L$(OPENWINHOME)/lib -lXtPlx -lXPlx \
       -lXv -lXt -lXext -lX11 -lm

For the HP Platform: 
host:  cc sourcefile -L$(PARALLAX_HOME)/lib -lXtPlx -lXPlx \
       -lXv -lXt -lXext -lX11 -lm

For the XView-based Objects and X Extension:

For example, to link libraries for our XView-based objects and our X extension, enter the following (libraries must be linked in the order shown): 
host:  cc sourcefile -L$(PARALLAX_HOME)/lib -L$(OPENWINHOME)/lib -lXviewPlx -lXPlx \
       -lXv -lpixrect -lolgx -lxview -lXext -lX11 -lm

For the X Extension:

Or to link libraries for just our X extension, enter the following (libraries must be linked in the order shown):

For the Sun Platform: 
host:  cc sourcefile -L$(PARALLAX_HOME)/lib -L$(OPENWINHOME)/lib -lXPlx \
       -lXv -lXt -lXext -lX11 -lm

For the HP Platform: 
host:  cc sourcefile -L$(PARALLAX_HOME)/lib -lXPlx \
       -lXv -lXt -lXext -lX11 -lm

For Parallax APIs:

Or to link libraries for our APIs, enter the following (in the order shown): 
host:  cc sourcefile -L$(PARALLAX_HOME)/lib -L$(OPENWINHOME)/lib -lPlxApi -lXviewPlx \
       -laudio -lXPlx -lpixrect -lxview -lolgx -lXext -lX11 -lm