129 lines
3.6 KiB
Groff
129 lines
3.6 KiB
Groff
|
.TH threed 6 "8 April 1998" "Svgalib 1.3.0" "Svgalib User Manual"
|
||
|
.SH NAME
|
||
|
threed \- The svgalib 3d demo
|
||
|
.SH SYNOPSIS
|
||
|
|
||
|
.B 3d
|
||
|
|
||
|
.SH DESCRIPTION
|
||
|
Well, the 3d demo...
|
||
|
|
||
|
I, Michael, the current svgalib maintainer, do not have any source for it.
|
||
|
|
||
|
Thus, you may experience weird problems with new svgalib versions
|
||
|
and you need installed a.out libc and svgalib versions.
|
||
|
Also the demo is known to be buggy in several aspects. Thus, do not
|
||
|
panic if it appears not to work for you.
|
||
|
|
||
|
If it works in a certain mode for you be happy and
|
||
|
play around with it. For example, with recent svgalibs,
|
||
|
.B 3d
|
||
|
is
|
||
|
unable to initialize the mouse if not started directly in a linux
|
||
|
console for unknown reasons.
|
||
|
|
||
|
Otherwise:
|
||
|
.B "Don't worry at all."
|
||
|
|
||
|
.SS "Here's the author's (Harm's) info about it:"
|
||
|
|
||
|
There's also a
|
||
|
.B 3d
|
||
|
demo binary included in this directory. It has been
|
||
|
in a similar state for several months now, but I'm planning to get
|
||
|
some work done (although it probably won't be the amazing multi-player
|
||
|
networked 3D lightsource-shaded real-time VGA virtual reality
|
||
|
simulation). I'll release the source code at some point (when it has
|
||
|
some degree of flexibility). I'm sorry that there's no scene
|
||
|
description file; it will come. So now you know you can do this kind
|
||
|
of thing in Linux. And it's practically 100% C code.
|
||
|
|
||
|
You can set the graphics mode to be used with the
|
||
|
.B SVGALIB_DEFAULT_MODE
|
||
|
environment
|
||
|
variable (e.g. G640x480x256). All linear 256 color, 32K color and 16M
|
||
|
color modes are supported, with page flipping used if available. Planar
|
||
|
256 color VGA modes also work. This should do 800x600 full screen 3D
|
||
|
animation at near 10 fps with a good system.
|
||
|
Request: Please report if page flipping goes wrong on a particular
|
||
|
chipset (e.g. ET4000, Trident) in 320x200x256. Also 32-bit pixel
|
||
|
truecolor modes don't work correctly, this will be fixed.
|
||
|
The user interface is somewhat primitive at this point:
|
||
|
|
||
|
- Use the mouse to rotate.
|
||
|
.br
|
||
|
- Left button accelerates, right decelerates.
|
||
|
.br
|
||
|
- Press
|
||
|
.B <W>
|
||
|
to move upwards,
|
||
|
.B <S>
|
||
|
to go down again.
|
||
|
.br
|
||
|
- Use
|
||
|
.B <R>
|
||
|
and
|
||
|
.B <F>
|
||
|
to control the zoom factor.
|
||
|
.br
|
||
|
-
|
||
|
.BR <q> " or " <Ctrl>-C
|
||
|
exits.
|
||
|
|
||
|
Note that the light source rotates quickly at an infinite distance.
|
||
|
This is not something that will easily occur naturally (as far as I
|
||
|
know)...
|
||
|
|
||
|
This demo is part of svgalib and can be found in the
|
||
|
.I demos/
|
||
|
subdirectory of the original svgalib distribution. However, it is not installed in the system
|
||
|
by default, s.t. it is unclear where you can find it if your svgalib was installed by some
|
||
|
linux distribution. Even then, when you have the demo on your system, you probably won't have
|
||
|
the sources s.t. it is only of limited use for you.
|
||
|
|
||
|
In case of any such problem, simply get an svgalib distribution from the net. You even
|
||
|
don't need to install it. Just
|
||
|
.B make
|
||
|
in the
|
||
|
.I demos/
|
||
|
subdirecty. As of this writing,
|
||
|
.I svgalib-1.2.12.tar.gz
|
||
|
is the latest version and can be retrieved by ftp from
|
||
|
.IR "sunsite.unc.edu" " at " "/pub/Linux/libs/graphics"
|
||
|
and
|
||
|
.IR "tsx-11.mit.edu" " at " "/pub/linux/sources/libs"
|
||
|
which will most probably be mirrored by a site close to you.
|
||
|
|
||
|
.SH BUGS
|
||
|
Countless.
|
||
|
.br
|
||
|
In addition, source is still not available. Sorry, I just don't have it.
|
||
|
|
||
|
.SH SEE ALSO
|
||
|
|
||
|
.BR svgalib (7),
|
||
|
.BR vgagl (7),
|
||
|
.BR libvga.config (5),
|
||
|
.BR accel (6),
|
||
|
.BR bg_test (6),
|
||
|
.BR eventtest (6),
|
||
|
.BR forktest (6),
|
||
|
.BR fun (6),
|
||
|
.BR keytest (6),
|
||
|
.BR mousetest (6),
|
||
|
.BR scrolltest (6),
|
||
|
.BR speedtest (6),
|
||
|
.BR spin (6),
|
||
|
.BR testaccel (6),
|
||
|
.BR testgl (6),
|
||
|
.BR testlinear (6),
|
||
|
.BR vgatest (6),
|
||
|
.BR plane (6),
|
||
|
.BR wrapdemo (6)
|
||
|
|
||
|
.SH AUTHOR
|
||
|
|
||
|
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||
|
demo and most of it's documentation is due to
|
||
|
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|