GridFlow 0.4.1 - reference index

       

Software (and Hardware) you Probably Need

Installation process (for jMax 2.5)

Installation process (for jMax 2.4)

Installation process (without jMax)



Software (and Hardware) you Probably Need

Required:

  • 1 : GNU C Compiler (gcc)
  • 2 : GNU Make (gmake)
  • 3 : GNU Bash
  • 4 : X11 Window System (Xserver and Xlib)

Recommended:

  • 1 : jMax 2.4 or 2.5 (we test using 2.5)
  • 2 : libmpeg
  • 3 : a digitizer card with Video4linux 1.x (videodev.h)

NOTE: for help on installing and compiling jMax, please see Christian Klippel's extensive help file at nil as well as the jMax docs.

Also Useful:

  • 1 : Pentium-compatible CPU (for profiling)
  • 2 : CVS (for live update)
  • 3 : Ruby (for regenerating documentation)

 

Installation process (for jMax 2.5)

  • 1 : Find your system type (for AMD K6 and Pentium Pro and compatibles, on Linux, this is i686-linux; if you have a recent Macintosh, this is ppc-macosx or ppc-linux)
  • 2 : Untar the archive with tar -xvtf gridflow_current_version.tgz in your packages directory (or elsewhere). This will create the gridflow directory and place all the files within.
  • 3 : Run ./configure --jmax25 from the gridflow directory. note: if you didn't install GridFlow in the packages directory, then you have to do something like ./configure --jmax25 --jmax-dist-dir your-jmax-source-directory-goes-here
    • if there's a problem with libmpeg anywhere in the process, you can add the option --no-mpeg to compile without mpeg.
  • 4 : ./configure will try to detect some optional components (libmpeg, pentium clock, etc); error messages may appear in case of a no. usually a yes will not show anything else. In the end, the files config.make, c/src/Sources and c/src/config.h will be generated.
  • 5 : Stay in the same directory and do:
    • 1 : make ARCH=your-system-type all
    • 2 : make ARCH=your-system-type install
    but if the first one stops because of "Error" you shouldn't try the second one.
  • 6 : Get the images for the examples from artengine.ca or hostname.2y.net. Place the archive in /usr/local/jmax/packages/gridflow (or the path of your choice) and untar with tar -xvzf video4jmax-images-0.2.tar.gz.
  • 7 : Load ~/.jmaxrc (text). Go to the when start section. Add a line that says package require gridflow. Add this line that says dataDirectory gridflow-directory/images
  • 8 : (Re)start jMax.
 

Installation process (for jMax 2.4)

Mostly the same as when installing with jMax 2.5; however: you must unpack the sources in the packages directory (this is optional with 2.5). When running the configuration script you must say --jmax24 instead of --jmax25. Don't forget to modify packages/Makefile so that the C_PACKAGES contains gridflow. Then do a regular jMax 2.4 compile/install.
 

Installation process (without jMax)

If you are not a C programmer you probably shouldn't do this.
  • 1 : Use the --nojmax option instead of --jmax25. Don't do the regular make all; you can only do a make standalone. (note: You can also do make standalone when installing with jMax. in any case that command creates c/lib2/libgridflow.so which can be used without jMax).
 

GridFlow 0.4.1 Documentation
by Mathieu Bouchard matju@sympatico.ca and
Alexandre Castonguay acastonguay@artengine.ca