GridFlow 0.5.0 - reference index

       

Software (and Hardware) you Probably Need

Installation process (for jMax 2.5)

Installation process (without jMax)



Software (and Hardware) you Probably Need

Required Hardware (One of...):

  • 1 : i386 : "old" IBM PC, or "new" IBM PC with old compiler
  • 2 : i686 : "new" IBM PC with recent compiler
  • 3 : ppc : "new" Macintosh (IS NOT SUPPORTED YET - HELP US)
  • 4 : armv4l : Corel Netwinder (but jMax does not run on this)
  • 5 : mips : Silicon Graphics, non-PC (only tested without jMax)

Required Software:

  • 1 : Ruby 1.6 (language interpreter)
  • 2 : GNU C Compiler (gcc)
  • 3 : GNU Make (gmake)
  • 4 : GNU Bash
  • 5 : X11 Display Server
  • 6 : X11 Display Library (Xlib)

Very Recommended:

  • 1 : jMax 2.5
  • 2 : jMax 3.0 support coming soon
  • 3 : jMax 2.4 support removed

Optional:

  • 1 : HeroineWarrior's libmpeg3.so
  • 2 : Greg Ward's libmpeg.so ("Berkeley/MNI")
  • 3 : a digitizer card with a Video4linux 1.x driver (videodev.h)
  • 4 : Ruby 1.6 with package "xmlparser" (for editing documentation)

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)

NOTE: There are several different incompatible libmpeg's from different authors; I found four of them, some numbered 2 and 3 as if they were version numbers (but it seems they are not).

NOTE: if one of your libraries are only available in .a format, you will not be able to compile GridFlow. All libraries GridFlow uses must be in .so format.

 

Installation process (for jMax 2.5)

  • 1 : Download the latest version of GridFlow and download the images pack (gridflow-images-0.5.tar.gz). The download site is artengine.ca. Unpack Gridflow in /usr/local/jmax/packages (or the path of your choice), which will create a directory called 'gridflow'; unpack the images pack into that directory, which will create another one called 'images'.
  • 2 : 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)
  • 3 : Run ./configure --jmax25 --arch your-system-type from the gridflow directory. note: if you didn't install GridFlow in the packages directory, then you have to add the option --jmax-dist-dir your-jmax-source-directory-goes-here
  • 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 all
    • 2 : make install
    but if the first one stops because of "Error" you shouldn't try the second one.
  • 6 : 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
  • 7 : (Re)start jMax.

Note: If there's a problem with libmpeg anywhere in the process, you can add the option --no-mpeg to the configurator.

Note: If you want more speed, you can configure with the --fast switch, which turns off many error-detection mechanisms; if you want more speed, you could configure with --no-profiling too, but if you do that, you can no longer find out which of the objects consume the most time.

 

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.5.0 Documentation
by Mathieu Bouchard matju@sympatico.ca and
Alexandre Castonguay acastonguay@artengine.ca