
OF linux CB: 



1) -------------------------------------------------------- installation

	to install CB there are a variety of insturctions on the forum, see here: 

	http://www.openframeworks.cc/forum/viewtopic.php?t=136
	http://www.openframeworks.cc/forum/viewtopic.php?t=326
	http://www.openframeworks.cc/forum/viewtopic.php?t=394

	we need to at least install: freeglut3-dev, libasound2-dev, libxmu-dex, g++ (or build essentials), libgl1-mesa-dev...

	in addition to these installs, we now need raw1394 dev to link against:

	sudo apt-get install libraw1394-dev

	please let us know if you have problems getting CB up and running -- 
	there may be issues with the new CB version (8.02), please post to the forum if you have any advice, etc...
	openframeworks.cc/forum  

	in the OF / Porto workshop pedro crafted this clever install script - arturo has tested it and added
	some changes that auto detect the right libs for the ubuntu version. the script can be found in the
	scripts/ folder and needs to be run as root

	sudo ./install_codeblocks.sh


	(but we don't know if this good for 8.02, anyone have a good 8.02 steps list)

	(the version from that workshop is located here): http://www.doublemv.com/files/of-0.04-cb-ofp.7z
	info: http://www.openframeworks.cc/forum/viewtopic.php?t=496

	//------------------------------------------------ install cb and depencies: 
	
	#!/bin/bash

	WX_DEB="deb http://apt.wxwidgets.org/ feisty-wx main"
	CB_DEB="deb http://lgp203.free.fr/ubuntu/ feisty universe"

	echo $WX_DEB > /etc/apt/sources.list.d/wx.list
	echo $CB_DEB > /etc/apt/sources.list.d/cb-nightly.list

	wget -q http://apt.wxwidgets.org/key.asc -O- | sudo apt-key add -
	wget -q http://lgp203.free.fr/public.key -O- | sudo apt-key add -

	apt-get update

	sudo apt-get install libcodeblocks0 codeblocks libwxsmithlib0 codeblocks-contrib

	#cd /var/cache/apt/archives && dpkg -i \
	#codeblocks_1.0svn4893-0ubuntu1_i386.deb \
	#libwxsmithlib0_1.0svn4893-0ubuntu1_i386.deb \
	#codeblocks-contrib_1.0svn4893-0ubuntu1_i386.deb \
	#libcodeblocks0_1.0svn4893-0ubuntu1_i386.deb \
	#libwxgtk2.8-0_2.8.7.1-0_i386.deb \
	#libwxbase2.8-0_2.8.7.1-0_i386.deb

	apt-get install freeglut3-dev
	apt-get install libasound2-dev
	apt-get install libxmu-dev libxxf86vm-dev
	apt-get install g++
	apt-get install libgl1-mesa-dev libglu1-mesa-dev
	# zach I'm adding this, needed for 05:
	sudo apt-get install libraw1394-dev

2) -------------------------------------------------------- post build steps:
	
	some folks have mentioned trouble with post-build step which copies the export directory into the bin folder.
	if you have issues, please let us know, and esp what linux you are running, what version of CB, etc...
	(please read the readme in export to understand the post build step).
	
	We've modified in this release the script to use "$(PROJECT_DIR)bin" instead of "$(TARGET_OUTPUT_DIR)bin/"
	since this lead to bin/bin on some versions of CB.  It should work now on all versions (fingers crossed).

	one problem occurs if you try to compile OF from a folder you got to in nautilus via a symbolic link:

	error will look like this:

	"cp -r ../../../export/libs /home/zach/Desktop/Link to openframeworks/0.05/0.05b_fat/apps/addonsExamples/allTestExample/bin/
	cp: target `openframeworks/0.05/0.05b_fat/apps/addonsExamples/allTestExample/bin/' is not a directory: No such file or directory
	Process terminated with status 1 (0 minutes, 1 seconds)
	0 errors, 0 warnings"

	so don't open up the project via a symbolic link.  we will report this to CB forum. 


3) -------------------------------------------------------- running app from within CB: 

	because of the issue w/ codeblock not being able to run a shell script when you click run, we have a hack :)

	in the post build step, we call a shell script (of_build_runner.sh) and tell it to either
	CD into the directory of the exe and run it, or to launch nautilus file browser to that 
	directory so you can click on the shell scripts.  essentially, we are making build do one of three things:
	
	build = build
	build = build + launch nautilus to the folder where the script/exe is
	build = build + run the exe
	
	this feature is turned off by default.  if you want to turn it on, just try either: 

	a) changing the custom variables in project->build options->custom variables  (make sure you have selected both targets,
	not just debug or release). set either (not both, I think it wont be worth it) to true.

	b) opening up the .cbp file and altering the xml: 
			
			<Environment>
				<Variable name="nautilusOnBuild" value="false" />
				<Variable name="runOnBuild" value="false" />
			</Environment> 

	setting to true.
	
	nautilusOnBuild - pops up the file explorer to the folder where the app is
	runOnBuild - runs the binary with the correct LD_LIBRARY_PATH set, so the app will run

	no more searching around to run apps we hope !!

	in "scripts" we have scripts that can turn these features on or off in all .cbp files in the folder structure. word

4) -------------------------------------------------------- unicap

	thanks to arturo - we now have unicap up and running.  should allow alot more cameras to work.
	setting dialog is uncompleted, but besides that is should allow a much larger range of cameras to work.
	try ucview to test your camera's capability.  and please report any bugs on the forum!

	if you have any issues with cameras (we've noticed a couple) you can go back to V4L by commenting out a line in ofConstants.h:

	#define OF_SWITCH_TO_UNICAP_FOR_LINUX_VIDCAP

        #ifdef OF_SWITCH_TO_UNICAP_FOR_LINUX_VIDCAP
                #define OF_VIDEO_CAPTURE_UNICAP
         #else
                #define OF_VIDEO_CAPTURE_V4L
        #endif

	just make the first line commented out, like:
	//#define OF_SWITCH_TO_UNICAP_FOR_LINUX_VIDCA


5) -------------------------------------------------------- 64 bit 
	
	sorry we don't have access to 64 bit machine at the moment, but other folks have compiled all the other libs for 64 bit. 
	we should be able to get that up soon.  otherwise, you can run OF in a 32 bit chroot.  full 64 bit support as soon as we can.

5) -------------------------------------------------------- scripts

	we've created a scripts directory to make everyone life easier, and to get a hang of building / cleaning multiple projects at once.
	also, you can enable or diable running app from within CB via our hacked out build = build + run system.  
	we are hoping that crafty folk will get into scripting, esp. as it relates to addons, etc.  please share any helpful scripts on the forum.


6) -------------------------------------------------------- linux info, advice, etc

	if you've got advice, please feel free to jump in. we are super new to linux, and trying to fully support it: 
	openframeworks.cc/forum



many thanks!! OFteam




