From ba994f4404b6eadcab4e0ead46ef4d3ffeceb024 Mon Sep 17 00:00:00 2001 From: Antoine Villeret Date: Thu, 10 Jul 2014 14:39:22 +0000 Subject: lots of changes ! 1. switch to a new build system based on automake (because we need to check for some lib on ./configure before make) 2. sort files in different directory 3. add some new features (some of them need OpenCV >= 2.4.5) svn path=/trunk/externals/pix_opencv/; revision=17324 --- README.txt | 56 ++++++++++---------------------------------------------- 1 file changed, 10 insertions(+), 46 deletions(-) (limited to 'README.txt') diff --git a/README.txt b/README.txt index c0360c5..ffb1b40 100644 --- a/README.txt +++ b/README.txt @@ -1,51 +1,15 @@ -1. Prepare you machine -You need to have puredata and Gem installed on your system. -And you need to know where they are… +`pix_opencv` is a Puredata library for real-time video processing : blob tracking, contours extracting, motion flow computation... It is based on work by Yves Degoyon and Lluis Gomez i Bigorda and uses `OpenCV` and `Gem` -You also need a compiling toolchain, e.g. GCC on Linux/Mac or Microsoft Visual C++ on Windows. +I'm trying to improve `pix_opencv` library since 2012. I add new objects as needed in my projects. -2. Get the sources : -Download the pix_opencv sources from Puredata external repository : -svn co svn://svn.code.sf.net/p/pure-data/svn/trunk/externals/pix_opencv -or if you don't have svnl, can get a "snapshot",i.e. a zip file with the current code, here : -https://sourceforge.net/p/pure-data/svn/HEAD/tree/trunk/externals/pix_opencv/ +`pix_opencv` is open and you can find the sources here : https://github.com/avilleret/pix_opencv -3. Get opencv : -Ubuntu/Linux -The easiest way to get it is to install it from the repository : -sudo apt-get install libopencv-* +You can also find binaries for Windows, Ubuntu and Mac OS X here : https://github.com/avilleret/pix_opencv/releases +For more informations, please check the Wiki : https://github.com/avilleret/pix_opencv/wiki +Please report bugs through Github interface : https://github.com/avilleret/pix_opencv/issues -Mac OSX : -The easiest way is to get from some packaging repository like Macports, fink or homebrew. -with fink : -sudo fink install opencv-dev -with macport : -sudo port install opencv +Also you can start with `pix_opencv-overview.pd` which shows all availalbe objects. +Each external has also its own help file. +There are severals examples also the `examples` folder. -Windows : -Download the binary release on opencv.org -You can follow the quickstart guide on opencv.org to setup environment variables. - -4. Build the Sources : - -Ubuntu/Linux & MacOSX -Go to the fresh created folder, i.e. « pix_opencv » and build the things : -cd pix_opencv -make - -If you see something like « can’t find m_pd.h », you need to tweak pd’s path with this command : -make CFLAGS=-I/path/to/pd -If you see something like « can’t find Base/GemPixObj.h », you need to tweak Gem’s path with this command : -make CFLAGS=-I/path/to/gem -You can combine options like : -make CFLAGS=-I/path/to/pd CFLAGS=-I/path/to/gem - -Windows -You need Visual C++ (at least the free express edition) to build pix_opencv on Windows. -There is a solution in build/vs2010 folder. -It was made with Visual C++ Express 2010 and surely need some tweaks before producing any DLL. -You need to change the include and the library paths. -The include must contain the following : - - puredata include (pd-extended) or src (vanilla) folder : path\to\pd\src or path\to\pd-extended\include - - Gem include folder : path\to\Gem - - OpenCV include path, wich is ususally $(OPENCV_DIR)\..\..\include if you setup OPENCV_DIR according to Windows quickstart guide on opencv.org. +To use `pix_opencv` in your project, add the folder to the pd search path. \ No newline at end of file -- cgit v1.2.1