-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.txt.orig
234 lines (161 loc) · 9.37 KB
/
README.txt.orig
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
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
COINDESIGNER 2.0
Written by Jose M. Espadero and Tomas Aguado (2004-2008).
This set or programs is licensed under the GPL, please read the
file GPL.txt for more details about the license.
Please, note that executable files are also affected by the licenses
of QT and Coin3D. Please, refer to their respectives licenses for
more details.
Just for those who have not read the previous licenses: You can not create a
commercial application that uses Coin3D or Qt without purchasing a commercial
license of each library. This includes you can not sell coindesigner without
purchasing those licenses.
Please, note that the coin3D reference documentation is covered by the
coin3D license. Visit http://coin3d.org for more details.
Please, don't forget to read the Acknowledges section at the end of
this document. This program is based in the efford of many else people
other than the authors.
DESCRIPTION
Coindesigner is a RAD (rapid application development) system to build 3D
applications using openInventor. It allows to write simple 3D scenarios
just using drag&drop, so users require no programming acknoledges at all
to use it.
coindesigner is a system equivalent to glade or Qt-designer, where we can
choose components from the openInventor toolkit, add them somewhere in our
scene and configure them in a very easy way... and all changes are applied
to the scene on the fly!
The project includes cdsview, a multiplatform external viewer that allows
to distribute the scenarios without need of the RAD in most modern OS.
Some characteristics of the tool are:
* Reads and write scenes in native openInventor file format (.iv)
* Can import geometry from VRML, 3DS, OFF (from geomview), SMF,
alias/wavefront(.obj), sphereTree (.sph) and XYZ point clouds file formats.
* Can save in openInventor format (.iv) and export to VRML2, SMF,
OBJ, STL, OFF and XYZ file formats
* It includes cdsview, an minimalistic external viewer that allows
you to view and distribute scenes without need of coindesigner.
* Allows to use manips to configure SpotLights, PointLights and
Transform nodes. Just use the right mouse button to interchange
between those nodes and his manip!
* GUI has been translated to English and Spanish, if you want to help
us to translate to your languaje write the author. A translation work
takes just about 90 minutes using Qt-Linguist.
* Includes the complete coin reference and several step by step
tutorials directly brownsables from the application.
* Allow some operations as mesh reduction (with QSLIM), scene
simplification (ivfix), mesh triangulation and convex hull
computation.
* Support for volume rendering using SIM Voleon.
* It's open source released under GPL license.
COIN3D REFERENCE AND TUTORIALS
The coin3d reference and the step by step tutorials of coindesigner
are now packed in separate files. You can download them from the
downloads section in http://coindesigner.sourceforge.net and
unpack in the same directory where the executable of coindesigner is.
BINARIES FOR WINDOWS
If this package contains the binaries for windows, then you can directly
execute coindesigner.exe. The source code can be downloaded from the
http://coindesigner.sf.net website.
Default languaje is english. If you want to see coindesigner in your own
languaje then you have to define the LANG enviroment variable to be one of
EN (for English), ES (for Spanish) or PT (for Portuguese) and then run
coindesigner. Please, ensure that the translation files (*.qs) are found
in the current directory.
Please, note that this package contains some .dll files distributed with coin
(simage1.dll , coin2.dll and soqt1.dll). You can download its source code or
upgrade those files in http://www.coin3d.org. Note that those files are covered
by the coin3d license, which you can read in the above website.
Please, note that this package contains several .dll files distributed with Qt 4.3
(qt*.dll). You can download source code and upgrade those files in the page
http://www.trolltech.com. Note that those files are covered by the GPL and the
Qt license, you can obtain inside this package.
BUILDING FROM THE SOURCES (LINUX)
You will need this libraries installed and working
* Qt version 4.3.2 or newer. Usually shipped with most Linux distributions
today. Visit http://www.trolltech.com if you need to install it.
* Simage, Coin3D and SoQt. Please visit http://coin3d.org to read how to
download and install these libraries.
* Optionally, you can use SIM Voleon to visualice volumetric data. Visit
http://coin3d.org to read how to download and install these libraries.
Please, ensure that the "soqt-config" command is in the path. This is
usually installed by SoQt library.
To build coindesigner and cdsview
1) Uncompress the coindesigner-x.x.tgz package
tar xvfz coindesigner-x.x.tgz
2) Go to the new directory
cd coindesigner-x.x
3) Run the make comand
make -f coindesigner.make
This will create two executable files:
* Coindesigner: The RAD system
* cdsview: The standalone multiplatform viewer
To use the translation files, you must run coindesigner in the
same directory that the coindesigner_your_language.qm file. Please
ensure that the LANG enviroment variable is adecuate to your language.
BUILDING FROM THE SOURCES (WIN32)
You will need this libraries installed and working
* Qt version 4.3.2 or newer. Visit http://www.trolltech.com to purchase a
license of QT, or download and compile the openSource version of qt.
* Simage, Coin3D and SoQt. Please visit http://coin3d.org to read how to
download and install these libraries.
* Optionally, you can use SIM Voleon to visualice volumetric data. Visit
http://coin3d.org to read how to download and install these libraries.
* A C++ compiler, which could be Visual Studio Express, Visual Studio .net
CYGWIN, or any other compiler. Please refer to QT documentation to see
what compilers are supported.
To build coindesigner from sources
1) Uncompress the coindesigner-x.x.tgz package
2) Open a command shell and go to the new directory
3) Ensure you have working values for the enviroment variables QTDIR
(where you installed Qt), COIN3DDIR (where you installed Coin3d)
4) Ensure you have defined the QMAKESPEC variable. This variable tells
qmake which C++ compiler you are going to use. Valid values are
"win32-msvc2005", "win32-msvc.net", "win32-g++", etc... refer to QT
documentation to assign the value to this variable.
Note: If you are using MS Visual C++, you can try at this point one
of the .vcproj files provided with the package, and try to build coindesigner
from the IDE instead of using qmake and nmake.
5) Ensure that qmake and your compiler are in the path.
6) Execute "qmake -win32"
7) Execute make (or nmake, or gmake)
QSLIM
The mesh reduction tool is based in qslim, an algorithm designed and
coded by Michael Garland. To use qslim, you must download it from the web
http://graphics.cs.uiuc.edu/~garland/software/qslim.html and put the
executable of QSLIM in the same directory of coindesigner or elsewhere
in the path. You will see if QSLIM is available in the "help->about" menu.
Note: If you don't want to compile qslim, can download binaries from here:
http://graphics.cs.uiuc.edu/~garland/software/qslim20.html
ACKNOWLEDGES
"If I have seen further, it is by standing upon the shoulders of giants"
(Isaac Newton, but I found it in Oscar Robles PhD)
Well, most of my giants are working on the Modelling and Virtual Reality
Group of the Rey Juan Carlos university. Their names are Marcos, Sofía, Oscar,
Susana, Pablo, Luis, Angel, Luismi, Cesar, Carolina, and many more people that
work in the group.
The 3ds importer is part of coin3d package and was developed by PC John.
This piece of code is usually available when you compile coin3D with
the "--enable-3ds" flags, which is not the default. To avoid everybody
to have to recompile coin3d, we decided to incorporate those file to
our project
Most icons used in coindesigner UI are part of Crystal Icons. This icon
theme was created by Everaldo and is now developed by him in association
with the Crystal Artists Staff. See http://linuxcult.com/node/10
Svg icons are from the tango project
Icons for sceneGraph nodes are based on "Dia Shapes for Open Inventor Scenegraphs",
package, compiled by Alejandro Sierra.
The ivfix code used inside of coindesigner was originally written by
the SGI crew, and released as GPL code in 2000.
The qslim program was written by Michael Garland and released under the
GPL. The web of the author is http://graphics.cs.uiuc.edu/~garland/
The convex hull calculator is based in QHullLib, which was writen by
John W. Ratcliff. It is an adaptation of the qhull program to allow
an easy way to use qhull routines using C++, without need to call any
external program. It's not easy to find the standalone qhulllib code
(due broken links :-( ), but it can be found inside ODFRocket, an open
framework which has Copyright (c) 2004 Open Dynamics Framework Group.
Please, read README_qhulllib.txt and README_qhull.txt for more details.
Last but not least, many fragment of coindesigner are based on examples found in
the Coin3D and Qt documentation. We would like to acknowledge that work and
the help received from Lars J. Aas, Morten Eriksen and Peder Blekken from
Kongsberg SIM (aka System in Motion) through the coin-discuss mail list.
They are the Coin on Coindesigner.