[Gridflow-cvs] [svn] commit: r4731 - /trunk/README

gridflow-cvs at artengine.ca gridflow-cvs at artengine.ca
Tue Nov 3 21:53:31 EST 2009


Author: matju
Date: Tue Nov  3 21:53:31 2009
New Revision: 4731

Log:
déschteumeule.

Modified:
    trunk/README

Modified: trunk/README
==============================================================================
--- trunk/README (original)
+++ trunk/README Tue Nov  3 21:53:31 2009
@@ -3,111 +3,102 @@
 `-o--------------o-'
   |
 .-o--------------------------------------------------------------
-|
+| Hardware and Software you Probably Need
 
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html><head><title>GridFlow 1.0</title></head>
-<body>
-<table border="0" cellspacing="5" width="100%">
+Computer/Processor: GridFlow is mainly made on PC. This includes AMD K6/K7/K8 (Athlon/Opteron/etc), Intel P2/P3/P4 and other Pentiums, Intel CoreDuo, etc.; the absolute minimum is 386. However, it has also been built recently for Macintosh PowerPC (G3/G4/G5) recently.
+
+Operating System: GridFlow is mainly made on Ubuntu. We have also used Debian, SuSE, Mandrake, OSX. Microsoft Windows is not supported, but if you do want to try to add support for that, try CygWin and/or MinGW.
+
+Required Software:
+	Ruby 1.8 or 1.9
+	PureData 0.40 or later, or DesireData
+	GNU C++ Compiler (g++) version 3.x or 4.x
+	GNU Make
+	SVN
+	Developer CD (XCODE) (if using OSX)
+	FINK (if using OSX)
+
+Multimedia Components (optional):
+	libSDL (Simple Directmedia Layer)
+	libjpeg
+	libpng
+	libmpeg3 (.mpg reader, HeroineWarrior's)
+	libquicktime (.mov reader/writer, Burkhard Plaum's or HeroineWarrior's) 
+	libmpeg (.mpg reader, Greg Ward's, old)
+	Apple QuickTime (.mov reader/writer and camera interface)
+	Ascii Art Library (aalib)
+	PCI video digitizer card  (and Video4linux 1 driver)
+	USB camera (and Video4linux 1 driver)
+	FFTW3
+	OpenCV
+	NetPBM
+	OpenGL
+	Apple X11 (for 10.3: http://www.apple.com/support/downloads/x11formacosx.html
+		   for 10.4: http://www.apple.com/support/downloads/x11update2006113.html )
+
+.-o--------------------------------------------------------------
+| Downloading from SVN
+
+The SVN has the absolute latest version of GridFlow, but it's not guaranteed to be working, whereas 
+the actual releases are more tested.
+However you may have various reasons to use the SVN edition, so here's how:
+Make sure you have the <kbd>svn</kbd> program installed.
+
+<kbd>cd pd/extra</kbd>
+<kbd>svn checkout http://gridflow.ca/svn/trunk</kbd>
+<kbd>mv trunk gridflow</kbd>
+And the subsequent times, you only do this:
+<kbd>cd pd/extra/gridflow</kbd>
+<kbd>svn update</kbd></td></tr>
 
 <tr><td bgcolor="black"><img src="images/black.png" height="2" width="1"></td></tr>
-<tr><td><h4><a name="Hardware_and_Software_you_Probably_Need">Hardware and Software you Probably Need</a></h4>
 
-<p><b>Computer/Processor:</b> GridFlow is mainly made on PC. This includes AMD K6/K7/K8 (Athlon/Opteron/etc), Intel P2/P3/P4 and other Pentiums, Intel CoreDuo, etc.; the absolute minimum is 386. However, it has also been built recently for Macintosh PowerPC (G3/G4/G5) recently.</p>
+.-o--------------------------------------------------------------
+| Installation instructions (incl. compilation)
+	 Install Ruby.
+	Download GridFlow from the website and uncompress it, or get it from the SVN server.
+	Run <kbd>./configure</kbd> from the <kbd>gridflow</kbd> directory. Make sure it detects all the components
+	you want to use with GridFlow. In MacOS you would normally use FINK to install those extra components: <kbd>ruby libjpeg libjpeg-shlibs libpng-shlibs libpng3 libpng3-shlibs libmpeg libmpeg-shlibs</kbd> 
 
-<p><b>Operating System:</b> GridFlow is mainly made on Ubuntu. We have also used Debian, SuSE, Mandrake, OSX. Microsoft Windows is not supported, but if you do want to try to add support for that, try CygWin and/or MinGW.</p>
-
-<p><b>Required Software:</b><ul>
-	<li>Ruby 1.8 or 1.9</li>
-	<li>PureData 0.40 or later, or DesireData</li>
-	<li>GNU C++ Compiler (g++) version 3.x or 4.x</li>
-	<li>GNU Make</li>
-	<li>SVN</li>
-s	<li>Developer CD (XCODE) (if using OSX)</li>
-	<li>FINK (if using OSX)</li></ul>
-
-<p><b>Multimedia Components (optional):</b><ul>
-	<li>libSDL (Simple Directmedia Layer)</li>
-	<li>libjpeg</li>
-	<li>libpng</li>
-	<li>libmpeg3 (.mpg reader, HeroineWarrior's)</li>
-	<li>libquicktime (.mov reader/writer, Burkhard Plaum's or HeroineWarrior's) </li>
-	<li>libmpeg (.mpg reader, Greg Ward's, old)</li>
-	<li>Apple QuickTime (.mov reader/writer and camera interface)</li>
-	<li>Ascii Art Library (aalib)</li>
-	<li>PCI video digitizer card  (and Video4linux 1 driver)</li>
-	<li>USB camera (and Video4linux 1 driver)</li>
-	<li>FFTW3</li>
-	<li>OpenCV</li>
-	<li>NetPBM</li>
-	<li>OpenGL</li>
-	<li>Apple X11 (<a href="http://www.apple.com/support/downloads/x11formacosx.html">for OSX 10.3</a> or
-		       <a href="http://www.apple.com/support/downloads/x11update2006113.html">for OSX 10.4</a>, etc)</li>
-</ul>
-
-<tr><td bgcolor="black"><img src="images/black.png" height="2" width="1"></td></tr>
-<tr><td><h4><a name="Downloading_from_SVN">Downloading from SVN</a></h4>
-<p>The SVN has the absolute latest version of GridFlow, but it's not guaranteed to be working, whereas 
-the actual releases are more tested.</p>
-<p>However you may have various reasons to use the SVN edition, so here's how:</p>
-<p>Make sure you have the <kbd>svn</kbd> program installed.</p>
-<ul>
-<li><kbd>cd pd/extra</kbd>
-<li><kbd>svn checkout http://gridflow.ca/svn/trunk</kbd>
-<li><kbd>mv trunk gridflow</kbd></ul>
-<p>And the subsequent times, you only do this:<ul>
-<li><kbd>cd pd/extra/gridflow</kbd></p>
-<li><kbd>svn update</kbd></ul></p></td></tr>
-
-<tr><td bgcolor="black"><img src="images/black.png" height="2" width="1"></td></tr>
-<tr><td><h4><a name="Installation_instructions_(incl._compilation)">Installation instructions (incl. compilation)</a></h4>
-<ol>
-	<ul><li> Install Ruby.</li>
-	<li>Download GridFlow from the website and uncompress it, or get it from the SVN server.</li>
-	<li>Run <kbd>./configure</kbd> from the <kbd>gridflow</kbd> directory. Make sure it detects all the components
-	you want to use with GridFlow. In MacOS you would normally use FINK to install those extra components: <kbd>ruby libjpeg libjpeg-shlibs libpng-shlibs libpng3 libpng3-shlibs libmpeg libmpeg-shlibs</kbd> </li>
-
-	<li>In Debian (lenny) or Ubuntu (8.04), do <kbd><pre>
+	In Debian (lenny) or Ubuntu (8.04), do <kbd><pre>
 		apt-get install libjpeg62-dev libpng12-dev libmpeg3-dev libquicktime-dev fftw3-dev \
 				libaa1-dev libsdl1.2-dev libnetpbm10-dev libx11-dev libxt-dev g++ \
 				ruby nasm libglib1.2-dev
 		</pre></kbd>
 	At least with Ubuntu you can add those, but haven't tried with Debian yet:<kbd><pre>
 		apt-get install libcv-dev libdc1394-13-dev
-	</pre></kbd></li>
+	</pre></kbd>
 
-	<li>Note: you may have to set <kbd>CPLUS_INCLUDE_PATH</kbd> and <kbd>C_INCLUDE_PATH</kbd>
+	Note: you may have to set <kbd>CPLUS_INCLUDE_PATH</kbd> and <kbd>C_INCLUDE_PATH</kbd>
 to indicate where to find *.h files, and you 
 may have to set both <kbd>LIBRARY_PATH</kbd> and <kbd>LD_LIBRARY_PATH</kbd> to indicate where to find 
-*.so or *.a or *.dylib or *.bundle or *.dll or *.lib files.</li>
-	<li>Note: you can do <kbd>./configure --help</kbd> to get a list of supported 
+*.so or *.a or *.dylib or *.bundle or *.dll or *.lib files.
+	Note: you can do <kbd>./configure --help</kbd> to get a list of supported 
 options. You can use them to ignore the presence of troublesome libraries 
 and select debugging level. With <kbd>--use-compiler</kbd> you should use a version of <kbd>g++</kbd>, not 
 directly a version of <kbd>gcc</kbd>, else you get <kbd>undefined symbol</kbd> problems. Some versions of gcc/g++ 
-are troublesome.</li>
-	<li>Run <kbd>make</kbd> to produce the executables <kbd>gridflow.so</kbd> and <kbd>gridflow.pd_linux</kbd> or similar</li> <ul>
-	<li>Loading GridFlow:<ul>
-		<li>PureData : With a text editor, modify or create <kbd>~/.pdrc</kbd> and write <kbd>-lib gridflow</kbd>. </li> 
-		<li>DesireData : In "Server Preferences", add <kbd>gridflow</kbd> to the list of libraries.</li> </ul>
+are troublesome.
+	Run <kbd>make</kbd> to produce the executables <kbd>gridflow.so</kbd> and <kbd>gridflow.pd_linux</kbd> or similar 
+	Loading GridFlow:
+		PureData : With a text editor, modify or create <kbd>~/.pdrc</kbd> and write <kbd>-lib gridflow</kbd>.  
+		DesireData : In "Server Preferences", add <kbd>gridflow</kbd> to the list of libraries. 
 Note that on MacOS the dot-files are invisible in the Finder but you do <kbd>cd ~/Desktop; ln -s ../.pdrc "PureData Configuration"</kbd> to make an alias on the Desktop. 
-Note also that on Windows the dot-files are even more trouble.</li> </ul></td></tr>
+Note also that on Windows the dot-files are even more trouble. </td></tr>
 
-<tr><td bgcolor="black"><img src="images/black.png" height="2" width="1"></td></tr>
-<tr><td><h4><a name="Other_Tips">Other Tips</a></h4>
-<ul>
-	<li>you just did a SVN update and now the program does not compile, or 
-crashes, or changes didn't go through. <ul>
-		<li>When some kinds of changes have happened, you may have to rerun the <kbd>configure</kbd> 
+.-o--------------------------------------------------------------
+| Other Tips
+
+	you just did a SVN update and now the program does not compile, or 
+crashes, or changes didn't go through. 
+		When some kinds of changes have happened, you may have to rerun the <kbd>configure</kbd> 
 	program before redoing <kbd>make</kbd>. If you had previously reconfigured with specific options, 
-	don't forget to use them again in this case.</li>
-		<li>Maybe matju forgot to upload part of an important change. Tell him.</li> </ul></li>
-	<li>PureData Crashing: <ul>
-		<li>run start Pd from within the debugger using <kbd>gdb $(which pd)</kbd> then <kbd>run</kbd> then cause the crash.</li>
-		<li>In GDB, after a crash, you can use the <kbd>where</kbd> to find out what Pd was doing at the moment 
-			of the crash. If instead Pd is frozen, you can force it to crash using Ctrl+C in the terminal.</li>
-		<li>To quit GDB use the <kbd>quit</kbd> command.</li> </ul></li> </ul></td></tr>
-</table>
-</body></html>
+	don't forget to use them again in this case.
+		Maybe matju forgot to upload part of an important change. Tell him. 
+	PureData Crashing: 
+		run start Pd from within the debugger using <kbd>gdb $(which pd)</kbd> then <kbd>run</kbd> then cause the crash.
+		In GDB, after a crash, you can use the <kbd>where</kbd> to find out what Pd was doing at the moment 
+			of the crash. If instead Pd is frozen, you can force it to crash using Ctrl+C in the terminal.
+		To quit GDB use the <kbd>quit</kbd> command.  </td></tr>
 
 .-o--------------------------------------------------------------
 | Directory layout
@@ -126,7 +117,8 @@
   ./tests ............ will contain Pd programs that test GridFlow itself.
                        (see also: the PureUnity project)
 
-Legalese
+.-o--------------------------------------------------------------
+| License Info
 
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of



More information about the Gridflow-cvs mailing list