/
readme.linux
170 lines (102 loc) · 7.07 KB
/
readme.linux
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
OF linux CB:
1) -------------------------------------------------------- installation
inside the scripts folder you'll find under ubuntu, debian or fedora some scripts to install everything
you need to use openframeworks. inside that folders there's a file called install_codeblocks.sh that will
install Code::Blocks svn version, please use this script to install codeblocks as some libraries in the
new project format used in 006 won't work with codeblocks 8.02, the last stable version present in most
linux distributions. there's also a script called install_dependencies.sh that will install all the libraries
needed to use openFrameworks under linux.
you will need to run it from a console:
for ubuntu:
cd your_oF_directory/scripts/ubuntu
sudo ./install_codeblocks.sh
sudo ./install_dependencies.sh
for debian:
su -
cd your_oF_directory/scripts/debian
./install_codeblocks.sh
./install_dependencies.sh
for fedora
su -
cd your_oF_directory/scripts/fedora
./install_codeblocks_svn.sh
./install_dependencies.sh
that's all, now go to the apps folder where you will find the examples and have fun!
2) -------------------------------------------------------- ofProjectManager
this is a set of python scripts that will make your life easier when creating projects
or adding addons to existing ones.
in the scripts folder you will find an install_project_manager.sh file. double click on it
to install the project manager.
this will install python and copy the project manager to /usr/local/ofProjectManager.
at the end of then of the process you will be presented with a text file were you need
to change the directory where your openFrameworks install is.
once it's installed, to create a new openFrameworks project, from a console do:
ofProject create project_name
or to add an addon to an existing project:
ofProject add project_name ofxAddonName
a) -------------------------------------------------------- manual install
if you are using a different distribution than ubuntu, debian or fedora, please take a look at one of the
install_dependencies.sh scripts from one of the supported distributions to know what libraries you need to
install. Also if you have problems or manage to install oF in any other distribution please post in the
forums so we can add it to the next release.
b) -------------------------------------------------------- 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.
c) -------------------------------------------------------- running app from within CB:
from 0.06 this only applies to codeblocks 8.02. if you used the install script or installed the svn version
manually you shouldn-t need to do this
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
d) -------------------------------------------------------- unicap
from 0.05 we have unicap up and running
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
e) -------------------------------------------------------- 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.
e) -------------------------------------------------------- Makefile
as so many linux guys have asked for, we've included a Makefile for each example, the makefiles are autogenerated with a script
to convert codeblocks projects to Makefiles, done by pix, you can find more info and download the latest version of that script
here: http://pix.test.at/wiki/cbp2makefile
f) -------------------------------------------------------- linux info, advice, etc
linux version of openFrameworks is in some way different to windows and mac, mainly the video support provided by quicktime doesn-t exist
here. in 0.06 this is provided with gStreamer for video files and unicap for cameras. although it has been tested, some cameras and video
formats can pose some issues, if you have some problem please post in the forum as much info as posible.
many thanks!! OFteam