/*
*
* Title: README
* Product: 3dfile v0.1.9.1
* Author: Mircea Mitu
* Date: January 7, 2002
*
*/
1. Introduction
This is 3dfile v0.1.9.1, an OpenGL based (*) file browser.
It isn't a file manager! At least not yet. It's just a simple
"walk-through directories" & "executable launcher" program.
It's far to be perfect, but it can be a good start for something better.
Originally was based on 3dmenu a QT application, but now,
the only common thing is some color code.
2. Requirements
It should work (compile&run) on any Unix/X11 system or
under Win9x/NT (with some modifications I'll discuss later **).
What do you need for? Let's see:
-OpenGL libs&headers, or Mesa;
-glut;
-ANSI C compiler.
The only systems I can guarantee it works under, are:
-x86 systems
-Linux 2.2.*/2.4.* (Mandrake 8.1)
-XFree 3.3.6 / 4.0.3 (or better, 4.1 series recommended)
-Mesa 3.2 / 3.4.2 / 4.0
-glut 3.7
-egcs-2.1.1 / egcs-2.91.66 (kgcc) / gcc 2.96 / gcc 3.0.1
but I don't see why it shouldn't work on any other *nix(like) system.
It was previously testes/developed on systems with:
1. RedHat 4.2 - Mesa 3.0, Mesa 3.1 - gcc 2.7.2.1
2. RedHat 6.0 - Mesa 3.1, Mesa 3.2 - egcs-2.1.1
3. Slackware 7.1
4. Mandrake 7.1 / 8.0
The only minor problem on other systems could be the
code of reading directories. If you can't fix it, please ask someone with
some experience in programming and using files.
If want to use the new configure script (recommended), you'll need:
-aclocal
-autoheader
-autoconf
-automake
For download see ftp://ftp.gnu.org/ [packages: Automake, Autoconf]
3. Compilation & installation
a) Using the new GNU/autoconf script
./autogen.sh
./configure
make
su
make install
-or-
make install-strip
autogen.sh runs:
aclocal && autoheader && autoconf && automake
to save some download time (the tarball is about 25k smaller)
Also, see:
./configure --help
for some options, like using GL or MesaGL.
Note that since v0.1.8 this script was renamed from autoscript.sh to
autogen.sh to conform with GNU standards.
b) Using the old Makefile.orig
make -f Makefile.orig
If you have problems with Makefile, check it for libs, directories and
defines. Also, 3dfile links with -lGL -lGLU. So, you people with older Mesa
could change it to -lMesaGL, or, better, create symlinks from
libMesaGL[U].so to libGL[U].so.
4. Using
Use the mouse.
Clicking on executables -> execute them (only when releasing the mouse button).
Clicking on directories -> chdir.
Clicking on other files -> let your favourite $BROWSER handle them.
Use arrows (and th e mouse wheel) to scroll up & down,
left&right, page_up & page_down, home & end.
Right click shows a popup menu, for navigation and file operations, like:
-view as text / hex / image
Use the bottom menu buttons.
When possible, space bar switches from windowed mode to fullscreen mode,
and vice versa (it works only with some 3d[fx] cards).
You may drag items over WindowMaker dock or KDE apps.
Press ESC, q, Q to exit, and H for a help pane.
5. Where to find it
Look for future versions at the official site:
http://turma.sourceforge.net/software/3dfile/
Send comments to: Mircea Mitu
Please set the subject field to 3dfile or appropriate so I could
take extra attention to the message. If you want to make a link
to 3dfile in your page, I'll be glad to hear about this.
So, please drop me a line if you intend to.
(*) Trademark issue:
SGI asked to not using OpenGL name abusively.
So, this 3dfile use the OpenGL API to ...
(**) Initially, my thoughts were that 3dfile should compile just fine
under Win9x/NT or like. But Siigron warned me that is a BSD standard,
so a unix one. He's right. To make it work under windoze, the disc-op.[ch]
must be modified with an appropriate Windows version. More likely
3dfile will compile & run under plain DOS (isn't funny?) using djgpp & allegro
(now, glut has a version for djgpp), or under windoze, using Cygnus tools
or like. I'm not very sure about that (I don't have anymore DOS/Win,
so I can't test my assertions) but it should work. If anyone could port
3dfile to other systems (like DOS, win, MacOS or any non-unix OS)
please send me an email.
-----------------------------------------------
Please ignore spelling and punctuation - I did.