GridFlow 0.7.3 - index of this page:

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
• 4 : armv4l : Corel Netwinder
• 5 : mips : Silicon Graphics, non-PC
• 6 : sparc : Sun SparcStation

Required Software:

• 1 : Ruby 1.6.2 or more recent (language interpreter)
• 2 : GNU C Compiler (gcc)
• 3 : GNU Make (gmake)

Very Recommended:

• 1 : jMax 2.5
• 2 : jMax 4.0 support in the works
• 3 : X11 Display Server and MIT-Xlib (already in linux)

Optional:

• 1 : PureData 0.35 or 0.36 (support is experimental)
• 2 : Simple Directmedia Layer (sdl)
• 3 : Ascii Art Library (aalib)
• 4 : HeroineWarrior's libmpeg3.so
• 5 : HeroineWarrior's libquicktime.so
• 6 : Greg Ward's libmpeg.so ("Berkeley/MNI")
• 7 : a digitizer card with a Video4linux 1.x driver (videodev.h)
• 8 : Ruby add-on "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 : if you don't have jMax, get it at jMax's site . If have only the RPM, you will need to install this: jmax headers in whichever directory as long as you tell it to GridFlow's configurator.
• 2 : Install Ruby 1.6.6 or any version released in 2002 or later (the latest from the 1.7/1.8 series work and are faster) You will need either libruby.so or libruby.a or libruby-static.a If you're using an installer and you're missing those files, then look for another package of a similar name that may contain extra files (eg: "ruby-dev"). If you're installing from source code you have to configure with the --enable-shared option. If you install into a system directory, you have to recreate the library index using the ldconfig command too (auto-installers normally do this for you).
• 3 : 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'.
• 4 : Run ./configure from the gridflow directory. You must have jMax's include files in /usr/include (or anywhere covered by C_INCLUDE_PATH). ./configure will try to detect some optional components (libmpeg, pentium clock, etc). In the end, the files config.make, config.h and Makefile will be generated.
• 5 : If you are not running Linux on a PentiumPro-compatible computer, you will have to specify a jMax Makefile using the --jmax-arch option. This is the one you use when installing jMax (or other jMax plugins other than GridFlow) manually. On MacOS 10, this would be ppc-macosx.
• 6 : Stay in the same directory and do:
  • 1 : make
  • 2 : make install
  • 3 : make test
  but if one stops because of "Error" you shouldn't try the next one.
• 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.

Note: you can do ./configure --help to get a list of supported options. You can use them to ignore the presence of troublesome libraries and select debugging level.

--use-compiler compiler normally would be one of: g++ g++-2.95 g++-3.2 g++-3.3. Do not use something with gcc in the name, as it results in undefined symbol problems.

Installation process (with PureData 0.35 and compatible)

• 1 : make sure m_pd.h is installed and can be seen by the compiler. you may have to change the C_INCLUDE_PATH environment variable.
• 2 : go in GridFlow's source directory.
• 3 : run ./configure
• 4 : run make
• 5 : run make install
• 6 : run make test
• 7 : run pd with the -path to the extras directory and -lib gridflow, or put those options in your ~/.pdrc file. (this part is essentially the same as GEM's and PDP's)

Installation process (without jMax)

• 1 : If you don't have jMax installed it won't be detected. Installation will proceed normally except that the Ruby-for-jMax bridge won't be installed. Try running 'make test'. Look at 'tests/test.rb' for an example of how you may use GridFlow without jMax.

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