|
||
* Main * License intent * Screenshots * News * Download * Links * FreeWRL manpages     * freewrl     * VRML::Browser     * VRML::Viewer * FreeWRL docs     * README     * CONFORMANCE     * INSTALL     * ARCHITECTURE     * GOALS     * CREDITS     * TODO |
freewrl Manual Pagefreewrl -- run the FreeWRL VRML97 browser on the command line
NAMEfreewrl -- run the FreeWRL VRML97 browser on the command line
SYNOPSISfreewrl [options] url [debugcode ...]
DESCRIPTIONSee the bottom of this text for the copyright and license.This command runs the FreeWRL VRML browser. See the VRML::Viewer manpage for details on the user interface and the VRML::Browser manpage for some other things. This manual page explains how to use the browser, how to start it on the command line, and how to use it with XSwallow..
KEYS/MOUSEFreeWRL supports, as per VRML97 spec, several different navigation modes. In each mode, the meanings of mouse movements and keystrokes are different.Mouse button 2 + motion is usually unbound so if you want to click and drag something in the scene, use it. In addition to the keys described below, there are some keys which work in all the modes:
WalkDrag the mouse while mouse button 1 is pressed to move forwards/backwards or turn. For translation in the x-y plane press mouse button 3 and drag.
FlyThis mode is fun if you have ever played the game Descent using the keyboard (definitely worth doing ;).There is currently no mouse control, rather, all motion is controlled by 12 keys, two for each of your 6 degrees of freedom (3 translations, 3 rotations). The default keymap in this mode is
ExamineThe examine navigation mode is analogous to holding an object in your hand and rotating it to see it from various sides: your line of view always goes through the same point but you can rotate the object and translate yourself closer and farther away.Currently, dragging with mouse button 1 pressed rotates the scene and dragging up or down mouse button 3 pressed translates you towards and away from the scene. There are no other controls. The center around which you rotate is determined by taking the initial position and orientation of the viewpoint given in the VRML file. A ray is cast along your line of view and the closest that ray comes to the origin of the local coordinate system is defined as the origin of the rotations.
NoneAs the name says, there is nothing you can do in the NONE navigation mode.
OPTIONS
USING FREEWRL WITH XSWALLOWAdd the following, all on one line, to your xswallow.conf. Of course, replace the directories with where your copy of freewrl is located.
x-world/x-vrml; vr,wrl; /usr/bin/perl -Mblib=/home/tjl/c/VRML /home/tjl/c/VRML/freewrl -url %u -log /tmp/VRMLlog -save /tmp -fontdir /home/tjl/c/VRML/fonts %s ; "FreeWRL Scene Viewer" "FreeWRL" ; Embedded Vrml after this, you need to do Edit/Preferences/Navigator/Applications (in Netscape 4.05) to enable displaying Embedded VRML with FreeWRL.
FreeWRL doesn't currently support EAI inside Netscape - it would probably
not be too difficult to make this happen, all that is necessary is to let
Netscape use the EAI classes, and make Xswallow contact FreeWRL with the
correct
AUTHORProject started by Tuomas J. Lukka, with contributions of code from Bernhard Reiter, John Breen and Robin Williams. VRML::Browser also uses the mozilla javascript code.
Please send bug reports to There is absolutely no warranty, express or implied for this software. For details on the conditions of use, see the FreeWRL distribution. FreeWRL is Copyright (C) 1998 Tuomas J. Lukka and others. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|