[artoolkit-commits] artoolkit README.txt,1.6,1.7
Optical marker tracking and overlay for augmented reality.
Brought to you by:
philip_lamb
Menu
▾
▴
[artoolkit-commits] artoolkit README.txt,1.6,1.7
|
From: Philip L. <phi...@us...> - 2004-12-02 02:52:31
|
Update of /cvsroot/artoolkit/artoolkit In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv16428 Modified Files: README.txt Log Message: Overhaul build notes for 2.70 release. Index: README.txt =================================================================== RCS file: /cvsroot/artoolkit/artoolkit/README.txt,v retrieving revision 1.6 retrieving revision 1.7 diff -C2 -d -r1.6 -r1.7 *** README.txt 1 Dec 2004 20:58:15 -0000 1.6 --- README.txt 2 Dec 2004 02:52:20 -0000 1.7 *************** *** 1,3 **** ! Read me for ARToolKit-2.69. =========================== --- 1,3 ---- ! Read me for ARToolKit-2.70. =========================== *************** *** 9,31 **** Building on Linux / SGI Irix. Building on Mac OS X. ! Latest changes. ! Previous changes. About this archive. ------------------- ! This archive contains the ARToolKit libraries, utilities and examples, version 2.69. ARToolKit is released under the GNU General Public License (GPL). Please read the file COPYING.txt. ! ARToolKit is designed to build on Windows, Linux, SGI Irix, and Macintosh OS X platforms, and is available in either a compressed archive (.tar.gz) source-only distribution, or as a compiled binary distribution for the individual supported platforms. ! As at 2004-11-04, this package does not include support for the ARToolKit VRML renderer. Support will be forthcoming as a separate package at a later date. This archive was assembled by: ! Philip Lamb ! HIT Lab NZ ! http://www.hitlabnz.org ! 2004-11-04 --- 9,31 ---- Building on Linux / SGI Irix. Building on Mac OS X. ! Changes in this release. ! Changes in earlier releases. About this archive. ------------------- ! This archive contains the ARToolKit libraries, utilities and examples, version 2.70. ARToolKit is released under the GNU General Public License (GPL). Please read the file COPYING.txt. ! The latest version of ARToolKit is available from http://sf.net/projects/artoolkit. ! ARToolKit is designed to build on Windows, Linux, SGI Irix, and Macintosh OS X platforms. This archive was assembled by: ! Philip Lamb ! HIT Lab NZ ! http://www.hitlabnz.org ! 2004-12-02 *************** *** 33,77 **** -------------------- ! Building ARToolKit from source on Windows proceeds by the following steps: ! (1) Unpack the ARToolKit zip file to a convenient location. This location will be referred to below as {ARToolKit}. ! (2) (Source-only distributions only). Download the DSVideoLib0.0.4.zip package and unpack it into {ARToolKit}. ! (3) (Source-only distributions only). Open the folder {ARToolKit}\DSVideoLib\bin.vc60 (Visual Studio 6.0) or {ARToolKit}\DSVideoLib\bin.vc70 (Visual Studio .NET 2003) and copy the files DSVideoLib.dll and DSVideoLibd.dll into {ARToolKit}\bin. ! (4) Open the folder {ARToolKit}\DSVideoLib\bin.vc60 (VS6) or {ARToolKit}\DSVideoLib\bin.vc70 (VS.NET) and run the script register_filter.bat. ! (5) Install the GLUT DLL into the Windows System32 folder, and the library and headers into the VS platform SDK folders. (http://www.opengl.org/developers/documentation/glut/) ! (6) Install the DirectX 9.0b or later SDK (http://msdn.microsoft.com/library/default.asp?url=/downloads/list/directx.asp). If you are using VS6, you must use 9.0b as DirectX 9.0c no longer includes support for VS6. ! (7) (DirectX 9.0c October 2004 or later only). Download the DirectX SDK Extras package , and mov the DirectShow\Samples folder into the top-level of the installed SDK path. ! (8) Run the batch file {ARToolKit}\Configure.win32.bat to create include/AR/config.h. ! (9) Open the ARToolKit.sln file (Visual Studio .NET 2003) or ARToolkit.dsw file (Visual Studio 6). ! (10) Open the Visual Studio search paths settings (Tools->Options->Directories for VS.6, or Tools->Options->Projects->VC++ Directories for VS.NET) and add the DirectX SDK Includes\ path and the DirectX Samples\C++\DirectShow\BaseClasses\ path to the top of the search path for headers, and the DirectX SDK Lib\ path to the top of the search path for libraries. ! (11) (Optional, if rebuilding DSVideoLib only). Build the DirectShow base classes strmbase.lib and strmbasd.lib. (More information can be found at Thomas Pintarics homepage for DSVideoLib (http://www.ims.tuwien.ac.at/~thomas/dsvideolib.php)). ! (12) Build the toolkit. Building on Linux / SGI Irix. ----------------------------- ! Assuming the ARToolKit-2.69.tar.gz file is in your home directory, open a terminal window and type the following commands: ! cd ~ ! tar zxvf ARToolKit-2.69.tar.gz ! cd ARToolKit-2.69 ! ./Configure make ! Following a successful build, to run a binary such as simpleTest, add these commands: ! cd bin ./simpleTest ! ! You will be prompted as to which of the three Linux video drivers you wish to use at the Configure step. Building on Mac OS X. --------------------------- - You will need to have Apple's Developer Tools installed in order to build ARToolKit. These can be downloaded freely from http://developer.apple.com. The library can either be built using (a) the XCode IDE or (b) from the command line: ! (a) Unpack the archive to a convenient location using StuffIt Expander, and open the ARToolKit.xproj file in XCode. (The Configure target selects accelerated and rectangular texturing by default. If you wish to change these defaults, run the ./Configure script as in option (b) below.) ! XCode will build the binaries in ARToolKit/bin. This must also be the working directory when the binaries are run, but by default XCode runs executables with the working directory set to Build/. In order for the binaries to be able to be run from within XCode you will need to edit the "Working directory path" of the executable to point the installed ARToolKit/bin directory on your system. ! (b) Drop the ARToolKit-2.69.tar.gz file onto the Desktop and then open a Terminal window and type the following commands: cd ~/Desktop ! tar zxvf ARToolKit-2.69.tar.gz ! cd ARToolKit-2.69 ./Configure make --- 33,110 ---- -------------------- ! Prerequisites: ! * Microsoft Visual Studio .NET 2003 or Visual Studio 6. ! * DSVideoLib-0.0.4-win32. Download from http://sf.net/projects/artoolkit. ! * GLUT. Download from http://www.opengl.org/resources/libraries/glut.html. ! * DirectX 9.0b or later SDK. If you are using VS6, you must use 9.0b as DirectX 9.0c no longer includes support for VS6. Download from http://msdn.microsoft.com/library/default.asp?url=/downloads/list/directx.asp. ! * (DirectX 9.0c October 2004 or later only) DirectX SDK Extras package. Once downloaded and unzipped, move the "Samples" folder into the top-level of the installed SDK path. ! * (Optional, for VRML renderer only) OpenVRML-0.14.3-win32. Download from http://sf.net/projects/artoolkit. ! ! Build steps: ! (1) Unpack the ARToolKit zip to a convenient location. This location will be referred to below as {ARToolKit}. ! (2) Unpack the DSVideoLib zip into {ARToolKit}. ! (3) Copy the files DSVideoLib.dll and DSVideoLibd.dll from {ARToolKit}\DSVideoLib\bin.vc70 into {ARToolKit}\bin. ! (4) Run the script {ARToolKit}\DSVideoLib\bin.vc70\register_filter.bat. ! (5) Install the GLUT DLL into the Windows System32 folder, and the library and headers into the VS platform SDK folders. ! (6) Run the script {ARToolKit}\Configure.win32.bat to create include/AR/config.h. ! (7) Open the ARToolKit.sln file (VS.NET) or ARToolkit.dsw file (VS6). ! (8) Open the Visual Studio search paths settings (Tools->Options->Directories for VS6, or Tools->Options->Projects->VC++ Directories for VS.NET) and add the DirectX SDK Includes\ path and the DirectX Samples\C++\DirectShow\BaseClasses\ path to the top of the search path for headers, and the DirectX SDK Lib\ path to the top of the search path for libraries. ! (9) (Optional, only if rebuilding DSVideoLib). Build the DirectShow base classes strmbase.lib and strmbasd.lib. (More information can be found at Thomas Pintarics homepage for DSVideoLib (http://www.ims.tuwien.ac.at/~thomas/dsvideolib.php)). ! (10) Build the toolkit. ! ! The VRML renderering library and example (libARvrml & simpleVRML) are optional builds: ! (11) Unpack the OpenVRML zip into {ARToolKit}. ! (12) Copy js32.dll from {ARToolKit}\OpenVRML\bin into {ARToolKit}\bin. ! (13) Enable the libARvrml and simpleVRML projects in the VS configuration manager and build. Building on Linux / SGI Irix. ----------------------------- ! ! Prerequisites: ! * (Optional, for VRML renderer only) openvrml-0.14.3 and dependencies. Download from http://sf.net/projects/openvrml. ! ! Unpack the ARToolKit to a convenient location. The root of this location will be referred to below as {ARToolKit}: ! tar zxvf ARToolKit-2.70.tgz ! Configure and build. The Linux builds support video input using either Video4Linux, an IIDC-compliant or DV camera connected via IEEE-1394, or a Sony EyeToy camera connected via USB. You will be prompted as to which of the four Linux video drivers you wish to use at the Configure step. ! cd {ARToolKit} ! ./Configure make ! Following a successful build, to run a binary such as simpleTest: ! cd {ARToolKit}/bin ./simpleTest ! ! The VRML renderering library and example (libARvrml & simpleVRML) are optional builds: ! cd {ARToolKit}/lib/SRC/ARvrml ! make ! cd {ARToolKit}/examples/simpleVRML ! make ! cd {ARToolKit}/bin ! ./simpleVRML Building on Mac OS X. --------------------------- ! Prerequisites: ! * Apple's Developer Tools. http://developer.apple.com ! * Camera driver. Mac OS X 10.3 and later include an inbuilt IIDC and DV FireWire camera driver. USB camera drivers, and Firewire camera drivers for pre-10.3 systems can be obtained from ioXperts at http://www.ioxperts.com. ! * (Optional, for VRML renderer only) Apple X11 and Fink. Download X11 from http://www.apple.com/downloads/macosx/apple/x11formacosx.html. Download Fink (and optionally, FinkCommander) from http://fink.sf.net. ! Building using the XCode IDE: ! (1) Unpack the archive to a convenient location using StuffIt Expander, and open the ARToolKit.xproj. ! (2) Builds include a script target "Configure" which enables accelerated and rectangular texturing by default. If you wish to change these defaults, manually run the ./Configure script from Terminal as for a command-line build. ! (3) XCode will build the binaries in ARToolKit/bin. This must also be the working directory when the binaries are run, but by default XCode runs executables with the working directory set to Build/. In order for the binaries to be able to be run from within XCode you will need to edit the "Working directory path" of the executable to point the installed ARToolKit/bin directory on your system. ! ! The VRML renderering library and example (libARvrml & simpleVRML) are optional builds: ! (4) Using FinkCommander, do a binary install of mozilla-dev, followed by an install of openvrml4-dev and openvrml-gl5-dev. ! (5) Select the ARToolKit extensions target, and build. ! ! Alternately, ARToolKit can be built from the Terminal, using the Unix makefiles. ! Drop the ARToolKit into a convenient location, e.g. your Desktop, then open a Terminal window and type: cd ~/Desktop ! tar zxvf ARToolKit-2.70.tgz ! Configure and build ! cd ~/ARToolKit ./Configure make *************** *** 79,92 **** cd bin ./simpleTest ! ! Mac OS X 10.3 and later include an inbuilt IIDC FireWire camera driver. USB camera drivers and Firewire camera drivers for pre-10.3 systems can be obtained from ioXperts at http://www.ioxperts.com. ! Latest changes. ! --------------- ! - Added libARvrml and simpleVRML example. Build instructions are in the works. - Turn off texturing in gsub/gsub_lite when argDrawMode/arglDrawmode is AR_DRAW_BY_GL_DRAW_PIXELS. ! - Added new examples collide, loadMultiple, paddle, paddleDemo, paddleInteraction, range and twoView. ! - Added new utilities for testing graphics and video without marker recognition, graphicsTest and videoTest. - VideoLinuxV4L patch by Uwe Woessner for YUV support (at last!) - VideoLinuxV4L patches by Raphael Grasset for improved camera parameter control and compressed jpeg video stream to support Sony Eyetoy camera. --- 112,135 ---- cd bin ./simpleTest ! ! The VRML renderering library and example (libARvrml & simpleVRML) are optional builds: ! fink -b install mozilla-dev ! fink install openvrml4-dev openvrml-gl5-dev ! cd ~/Desktop/ARToolKit/lib/SRC/ARvrml ! make ! cd ~/Desktop/ARToolKit/examples/simpleVRML ! make ! cd ~/Desktop/ARToolKit/bin ! ./simpleVRML ! Changes in this release. ! ------------------------ ! - Added libARvrml and simpleVRML example. - Turn off texturing in gsub/gsub_lite when argDrawMode/arglDrawmode is AR_DRAW_BY_GL_DRAW_PIXELS. ! - Added examples loadMultiple, demonstrating basic usage. ! - Added examples rangeTest, collideTest, paddleTest, paddleDemo, paddleInteractionTest, demonstrating interaction techniques. ! - Added example twoView, demonstrating input, processing and output from two (or more) cameras. ! - Added utilities graphicsTest and videoTest, for testing graphics and video without marker recognition. - VideoLinuxV4L patch by Uwe Woessner for YUV support (at last!) - VideoLinuxV4L patches by Raphael Grasset for improved camera parameter control and compressed jpeg video stream to support Sony Eyetoy camera. *************** *** 95,100 **** ! Previous changes. ! ----------------- Please see the file ChangeLog.txt. --- 138,143 ---- ! Changes in earlier releases. ! ---------------------------- Please see the file ChangeLog.txt. |
