Applet and Command Line Parameters for JavaView
Applet Parameters:
Applets based on javaview.class allow the following parameters to
control the visible geometry, adjust camera settings or configure the display.
Some parameters are understood by jvLite.class applets too. Applet
parameters must be included within the applet tag in an Html page like
<applet ....
<param name=model value="doc/models/sampleTorus.jvx">
<param name=boundingBox value=show>
</applet>
Command line arguments:
Most parameters are valid both as applet parameters and as command line
arguments. Command line arguments can be given as arguments of javaview:
bin\javaview model=doc/models/sampleTorus.jvx boundingBox=show
respectively when using the batch file:
bin\javaview.bat model=doc/models/sampleTorus.jvx boundingBox=show
or permanently written into both launch files.
General
| Name |
Value |
Comment |
| codebase |
c:/JavaView
for example:
"codebase=c:/JavaView" |
The JavaView codebase is the default root location on a local file system
to search for images and models. Use menu Help->System Props to check
the current codebase setting. |
| language |
[en] | de | sr
for example:
"language=de" |
The language of JavaView
menus and dialogs. Default language is Englisch. Use menu Help->Language to
change the current language interactively. |
| jv-lic |
rsrc/jv-lic.lic
for example:
"jv-lic=rsrc/jv-lic.lic" |
Location of the license file. By
default, JavaView searches for the file
<JavaView-codebase>/rsrc/jv-lic.lic |
| jv-rsrc |
rsrc/jv-rsrc.jvr
for example:
"jv-rsrc=rsrc/jv-rsrc.jvr" |
Location of the JavaView resource file
which contains global preference settings of JavaView. Not publicly
documented yet.
<JavaView-codebase>/rsrc/jv-rsrc.jvr |
| project |
classname for example:
project=vgp.game.mines.PjMinesweeper |
Launch a built-in project of
JavaView. The built-in JavaView projects are found in the package vgp.*
available in the archive vgpapp.jar. All projects are included in
the JavaView executable. Some projects require geometric models or
images to be available.
Most projects have a project panel, and it
often makes sense to show this panel. Use menu Inspector->Project or
<ctrl-p> to show the panel, or command line arguments:
panel=project control=show
Some projects allow to changes initial settings using
applet parameters.
Currently not usable in conjunction with the parameter model. |
| vgp.curve.surface.PjSurfCurve,
vgp.curve.geodesic.PjGeodesic, vgp.tutor.torusknot.PjTorusKnot,
vgp.curve.cycloid.PjCycloid, vgp.curve.elastic.PjElasticCurve,
vgp.tutor.parmCurve.PjParmCurve, vgp.game.life.PjLife,
vgp.game.mines.PjMinesweeper, vgp.tutor.fractal.PjFractalImage,
vgp.tutor.texture.PjTextureCube, vgp.discrete.harmonic.PjHarmonic,
jv.loader.PjImportModel, vgp.tutor.model.PjModel,
vgp.tutor.key.PjKeyframe, vgp.tutor.ode.PjExprOde,
vgp.discrete.harmonic.PjHarmonic, vgp.tutor.rootFinder.PjRootFinder,
vgp.surface.common.PjSurface, vgp.discrete.catenoid.PjCatenoid,
vgp.minimal.weier.PjWeierstrass, vgp.tutor.parm.PjParmSurface,
vgp.discrete.platonic.PjPlatonic,
vgp.tutor.lsystem.PjLSystem, vgp.tutor.height.PjHeight,
vgp.vector.lic.PjLIC |
Animations
See animation.html.
Geometry
Specify an initial geometry with using one and only one of the following
parameters. The geometry may either be loaded from a file, or in a few cases
supplied as string in the value section.
| Name |
Value |
Comment |
| model |
"doc/models/sampleTorus.jvx" |
Load a geometry from the given file in any of
the supported file formats. The path must be relative to the codebase of
the applet. |
| mathematica |
"Graphics3D[...]" |
Full Mathematica graphics object as ASCII
string. |
| maple |
"Plot3D(...)" |
Full Maple plot geometry as ASCII string. |
|
|
|
Note, if the geometry is supplied as value string then this string must be
enclosed with "bracket" and it may not contain any bracket " in its interior.
Otherwise, the value will be terminated at the first interior bracket by the
browser. As a workaround one may try to replace interior brackets with
'brackets', for example, Maple plots need this workaround.
Loading Camera and Display Settings from a File
The camera and display may be positioned either with the individual
parameters (see below) or by loading a display configuration file JVD. Note,
camera and display settings specified in a JVD file may be overwritten by
individual applet or command line parameters. A JVD file is usually created by
saving the current camera and display settings using FILE->SAVE->DISPLAY
SETTINGS (JVD), or a file may be edited by hand.
| Name |
Value |
Comment |
| displayFile |
"doc/models/sampleTorus.jvd" |
Load a display configuration file to configure the camera
projection and other display parameters. |
Interaction Modes (Left-Mouse Functionality)
By default, the left-mouse is initially either in
rotation-orbit mode (3D geometries, perspective cameras) or in translation
mode (2D geometries). Note, the initial transformation mode may be configured with a JVD file, but explicit setting will overwrite a JVD
setting.
| majorMode |
rotate |
rotate-xy |
scale |
translate
|
translate-z |
initial
|
pick
|
- free 3D rotation
mode
- rotation keeps vertical z-axis
- uniform scaling
-
translation in xy-directions of display
- translation in z-direction
of display (only visible if perspective!=
0)
- initial pick mode to select
initial conditions
- picking and dragging vertices of a
geometry |
| directSelect |
Show | [Hide] |
enable direct selection
of geometries when clicking on them (shortcut
<shift-o>). |
Camera
Default settings are marked with brackets like [option]. Do not type these
brackets.
| interest |
3 doubles |
Target point of the camera in world
coordinates, the point of interest. The default interest is the origin
"0 0 0". |
| viewDir |
3 doubles |
Viewing direction of the camera, need not be
normalized but orthogonal to the upward direction upDir. The
default viewing direction of the perspective camera is "0.137 0.824
-0.549". |
| upDir |
3 doubles |
The upward pointing direction of the camera.
Must be orthogonal to the viewing direction viewDir. In the display
the upDir becomes the vertical direction in the display if roll is
zero. |
| roll |
double |
Rotates the camera around the viewing
direction such that in the display the projected upDir has an angle
roll with the vertical direction of the display. The angle roll is
given in (-Pi, Pi) and default value 0. |
| distance |
double |
The distance of the camera from the interest.
By default the distance is adjusted to fit the initial geometry to fill
the display to about 80%. |
| perspective |
double |
The perspective distortion of the
scene. Default value is 0.5 |
|
|
|
| autoRotate |
Show | [Hide] |
Enable the continuous rotation of the camera
around the rotation direction rotDir. Rotation of the model in
local coordinates will be available later. |
| rotDir |
3 doubles |
The axis of rotation of the camera during
autoRotate. By default rotDir is "0 1 0", that is the
vertical axis of the display. |
Display
Default settings are marked with brackets like [option]. Do not type these
brackets.
| antiAlias |
Show | [Hide] |
Smooth drawing of edges, no jagging. Leads to
slower rendering. |
| axes |
Show | [Hide] |
Show axes around the currently selected
geometry. |
| background |
3 integers |
Background color of the display, for example,
"255 0 0" is red. |
| backgroundImage |
URL or
filename |
File name of a background image whose name
must be relative to the codebase of the applet. GIF (including
transparency) and JPG formats are supported. |
| backgroundImageFit |
Center | Fit |
Resize |
[Tesselate] |
Positioning and tiling of the background
image in the display. |
| border |
[Show] | Hide |
Border around the display to provide a sunken
effect. |
| boundingBox |
Show | [Hide] |
Bounding box around the scene. Currently, the
bounding box is shown around the selected geometry. |
| copyright |
Show | [Hide] |
Show copyright information at the bottom of
the display. |
| depthcue |
[Show] | Hide |
Show parts of the geometry darker the farther
they are away from the observer. Gives an impression of depth. |
| edgeAura |
Show | [Hide] |
Show a halo effect around edges. This effect
is visible only if edges are visible, but faces are not shown. |
| foregroundImage |
URL or
filename |
File name of a foreground image whose name
must be relative to the codebase of the applet. GIF (including
transparency) and JPG formats are supported. |
| foregroundImageFit |
Center | Fit |
[Resize] |
Tesselate |
Positioning and tiling of the foreground
image in the display. |
| frame |
Show | [Hide] |
Show a coordinate frame in the lower left
corner of the display. Very helpful if transformations in the local or
ambient coordinate system are preformed. |
| sorting |
[Show] | Hide |
Use a depth-sort of all geometry items to
generate a cheap hidden surface effect. This method is known as Painter's
algorithm. See zBuffer for a more accurate but slower method. |
| zBuffer |
Show | [Hide] |
Hidden surface method used for
self-intersecting geometries where the cheap sorting algorithm
fails. This algorithm works on a raster image. |
| fastZBuffer |
Show | [Hide] |
(beta) Disable the antiAliasing method
temporarily during interaction with a geometry. Available only if
antiAliasing is active. |
Note, display settings specified in a JVD file may be overwritten by applet
parameters.
Control Windows and Dialogs
Default settings are marked with brackets like [option]. Do not type these
brackets.
| panel |
Project | Info | [Material] | Config | Texture
| Camera | Display |
Select initial panel in the control window if
the control window is opened. Some panels like Info, Material,
Config and Texture require that a geometry is available which supplies
these inspector panels. Otherwise, a default panel is selected which
depends on the current applet and project. |
| console |
Show | [Hide] |
Show console window of JavaView with messages
or warning information. A warning is indicated by a beep. Note, this
console is additional to the Java console windows supplied by some
browsers. |
| control |
Show | [Hide] |
Show control window with inspector panels,
see parameter panel. |
Application Only Command Line Arguments
When running JavaView as application then a few extra command line arguments
are available. Default settings are marked with brackets like [option]. Do not type these
brackets.
| size |
widthxheight for example:
size=300x400 |
Width and height of the JavaView display
measured in pixels. Note, very small numbers might be automatically
enlarged by the operating system to allow inclusion of border controls. |
| position |
widthxheight for example:
position=50x100 |
Position of the upper left corner of the
JavaView display measured in pixel coordinates. The upper left corner of
the computer screen usually is (0,0). |
| menubar |
[Show] | Hide |
Visibility of the menu bar of the JavaView
display. |
|
