forked from openframeworks/openFrameworks
-
Notifications
You must be signed in to change notification settings - Fork 4
/
readme.linux
152 lines (106 loc) · 5.26 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
OpenFrameworks on Linux (with Code::Blocks):
a) Installation
---------------
Inside the scripts folder you'll find some scripts in the ubuntu, debian, fedora
and archlinux folders which will install everything you need to use openFrameworks.
Inside those folders there's a file called `install_codeblocks.sh` that will install
a current Code::Blocks version. Please use this script to install Code::Blocks,
it will avoid problems with some old Code::Blocks versions, but typically your
distribution's current version will be installed.
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 from a console:
for ubuntu:
cd your_oF_directory/scripts/linux/ubuntu
sudo ./install_codeblocks.sh
sudo ./install_dependencies.sh
if you want to have support for mp3 and some video codecs:
sudo ./install_codecs.sh
for debian:
su -
cd your_oF_directory/scripts/linux/debian
./install_codeblocks.sh
./install_dependencies.sh
if you want to have support for mp3 and some video codecs:
sudo ./install_codecs.sh
for fedora
su -
cd your_oF_directory/scripts/linux/fedora
./install_codeblocks.sh
./install_dependencies.sh
if you want to have support for mp3 and some video codecs:
sudo ./install_codecs.sh
for archlinux
su -
cd your_oF_directory/scripts/linux/archlinux
./install_codeblocks.sh
./install_dependencies.sh
if you want to have support for mp3 and some video codecs:
sudo ./install_codecs.sh
That's all, now go to the your_oF_directory/examples folder, where you will find
the examples, and have fun!
b) Other distributions
----------------------
If you are using a different distribution than ubuntu, debian, fedora or arch,
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.
c) projectGenerator
-------------------
This is an openFrameworks application that will make your life easier when
creating projects or adding addons to existing ones. It will be compiled when
you run the install_dependencies.sh script.
To use it open the executable in OF_ROOT/projectGenerator. You can find more
instructions in that folder too.
d) Code::Blocks Wizard
----------------------
You can also install a Code::Blocks wizard to create new projects, check the
instructions in scripts/linux/codeblocks_wizard.
e) Code::Blocks projects
------------------------
Code::Blocks projects are now using Makefiles to make the configuration easier.
Take a look at the next section to see how it works, to add search paths or
libraries you need to edit config.make, if you want to add addons, edit addons.make.
f) Makefile
-----------
Every example has a Makefile you can configure using the files config.make
and addons.make.
config.make: This file has options to add search paths, libraries, etc., the
syntax is the usual syntax in makefiles, there's help comments inside the file.
addons.make: if you want to use an addon which is inside the addons folder, just
add its name in a new line in this file.
g) 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 especially what Linux you are running, what version of Code::Blocks, etc...
(please read the readme in export to understand the post build step).
In a previous release, we've modified 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 reached in nautilus
via a symbolic link:
The 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.
h) Other 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.
i) Linux info, advice, etc
--------------------------
The linux version of openFrameworks is in some way different to Windows and MacOS,
mainly the video support provided by quicktime doesn't exist here. From OF 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 possible.
many thanks!! OFteam