Kompuutteri Kaikille K-CD 2002 #1/K-CD_2002-01.iso/DALiworld/data1.cab/Miscellaneous/README.txt

Text File | 2001-08-06 | 30KB | 516 lines

DocumentationDocumentation
The DALiWorld Screensaver - Friends & Family Edition
User's Manual
Copyright ⌐ 2000-2001 by DALi, Inc. All rights reserved.
  Introduction
  Feedback Notes
  Installation
  Using DALiWorld
  Advanced User Information
  Known Issues



1 Introduction
Welcome to DALiWorld! DALiWorld is an online virtual aquarium sitting on your
desktop. Fish swim around for your viewing pleasure, darting on and off your
screen. If you enable networking, fish can also swim over the Internet from your
aquarium to other users' aquariums, or from their aquariums to yours!
You can control the general number of fish you have in your aquarium, add fish
to your aquarium, and find out where fish that enter your aquarium have been in
the real world. Each fish keeps a history of everywhere it has been, so you can
find out what other cities, states, or even countries that your fish have been
to!
While most of the fish in DALiWorld can be created in anyone's aquarium, there
are a number of "special fish" that are not generally available. You are able to
create only one kind of special fish on your computer (you can have multiple
fish of that kind). However, you can still see the other kinds of special fish
if they swim from someone else's aquarium to your own! So, if you want to see
all of the special fish, you can turn on the networking features in DALiWorld
and watch for other special fish to come into your aquarium!
DALiWorld is meant to operate as something you watch and interact with directly,
as well as something that runs in the background while you use your computer for
other things. You can also set up DALiWorld to run as your screensaver when
you're not using your computer.
Back to the Top



2 Feedback notes
This version of DALiWorld is beta software, so you might find a few bugs as you
use it. Bugs and suggestions can be reported on our feedback form. The first
time you submit feedback to us, be sure to fill out all the System Setup
information you can-- this is necessary for us so that we can replicate any bugs
you report. When you enter your feedback in the Comments box, please be as
detailed as possible so that we can successfully reproduce and fix the problem.
Before reporting a bug, you might consider checking in the Known Issues section
of the manual to see if the problem is already known, and whether there is a
workaround for it.
Back to the Top



3 Installation
There are several options for installing DALiWorld. If you are using Microsoft
Windows, you can download our installer, which will install Java, Java3D for
DirectX, and DALiWorld. If you want to install these things separately, or if
you're not running Windows, you will have to install all of these components
separately. The following sections have all the details of how to get DALiWorld
installed.
NOTE: If you have already installed an earlier version of DALiWorld, you must
uninstall it before installing the current version.
3.1 Using the DALiWorld Installer (Microsoft Windows Only)
NOTE: DirectX 7.0+ is required for the version of Java3D installed by the
installer. If you need to install DirectX, go to
http://www.microsoft.com/directx/ and install the latest version.
Using the DALiWorld installer is the easiest way to set up DALiWorld, since it
sets up Java and Java3D as well as DALiWorld. Follow these steps to use the
installer:
  Download the DALiWorld installer from The DALiWorld downloads page.
  Run the installer. It will extract the DALiWorld setup program into
  C:\DWSetup.
  Run the setup program. You can do this by selecting Start -> Run... and then
  typing C:\DWSetup\setup.exe into the Run window.
  Once you have successfully completed the setup program, DALiWorld will be
  installed.
The DALiWorld installer creates shortcuts in your Start menu and on your
desktop, so that DALiWorld can be started easily. Once the installer has
completed, you can try out DALiWorld! Just go to Start -> Programs -> DALiWorld,
and select "DALiWorld" to start DALiWorld. Or, you can double-click the
DALiWorld icon on your desktop to start DALiWorld.
NOTE: The Java and Java3D installation is local to DALiWorld - if you have
already installed a version of Java or Java3D, this installer will not overwrite
those installations.
3.2 Installing Components Separately
If you wish to install only the DALiWorld program, or you are setting up
DALiWorld on a non-Windows platform, you will have to install the various
components separately. These include the following:
  Java
  Java3D
  The DALiWorld Program
The following sections explain how to install each of these components.
3.2.1 Installing Java
We recommend that Java version 1.3.1 should be used with DALiWorld. The Sun
Microsystems website currently provides three versions of Java, for Windows,
Linux, and Solaris platforms.
  Go to Sun Microsystems' Java 1.3 site. It is not necessary to install the
  entire Java Development Kit (JDK); DALiWorld only requires the installation of
  the Java Runtime Environment (JRE).
  Choose the appropriate platform for your machine.
  Follow the download and installation instructions.
3.2.2 Installing Java3D
We recommend that Java3D version 1.2.1 should be used with DALiWorld. There are
several places to go to get this software, depending on the operating system on
your computer. Only the Java3D runtime is necessary for DALiWorld - you don't
have to install the entire development kit.
If you are running Windows or Solaris on your computer, you can go to Sun
Microsystems' Java 3D Install Notes site to find information on how to download
and install Java3D onto those platforms.
If you are running Linux on your computer, you can go to blackdown.org's Java3D
for Linux site to find information on how to download and install Java3D onto
Linux.
3.2.3 Installing DALiWorld from a ZIP or TAR File
The archive containing just the DALiWorld program is very small because it
doesn't include the Java VM or Java3D. The following instructions explain how to
download and unpack the DALiWorld program.
  Go to the Download page and download either the TAR file or the ZIP file. We
  recommend downloading the ZIP file if you are using Windows, or the TAR file
  if you are using a UNIX operating system.
  Uncompress the file you downloaded.
  If you are on a Windows machine, you can use WinZip (http://www.winzip.com) or
  PKZip (http://www.pkware.com) to uncompress the file. Each of these programs
  has an easy-to-use UI.
  If you are on a UNIX machine and you downloaded the TAR file, you can use the
  "gunzip" and "tar" commands to uncompress the file. Or, if you downloaded the
  ZIP file onto your UNIX system, you can use the "unzip" command.
The installation of DALiWorld should now be complete. Because DALiWorld is
manually installed, it must be invoked from the command-line. The following
sections explain how to do this.
3.2.4 Running DALiWorld
To run DALiWorld from the command-line, you may do so by typing:
  % daliworld   [UNIX]
  -or-
  C:\DALiWorld>DALiWorld.bat   [WINDOWS]
Note: if you get a message like "Command not found" this probably means that
Java is not in your PATH. Read the Java installation documentation for your
particular platform.
Back to the Top



4 Using DALiWorld
This section explains how to use the DALiWorld user interface.
4.1 DALiWorld Preferences
The first time that DALiWorld is run, the program will display the Preferences
UI, allowing you to specify your preferences and any optional identification
information that you would like to provide.
It is also possible to configure your preferences at other times, either by
selecting the Preferences option from the Start menu (Start -> Programs ->
DALiWorld -> Preferences), or from the command-line by typing "prefs" (you must
be in the directory that DALiWorld is installed into to do this).
The Preferences UI has several tabs that allow control over various aspects of
the DALiWorld program. Each of these tabs is described below:
The "General" Tab
  This tab gives you control over several basic features of DALiWorld. The
  Aquarium group allows you to set the most basic features of your DALiWorld
  aquarium. You can set the number of fish to simulate in your aquarium with the
  first slider. (Note that the actual number of fish will vary as they move to
  and from your aquarium - DALiWorld simply uses this number as a guide.) If you
  have enabled networking, you can control how often your fish will migrate to
  other computers with the second slider.
  If you want to be able to connect your aquarium to other users' aquariums, you
  should turn on the "Enable Networking" checkbox. If you do this, your fish can
  swim from your aquarium to other users' aquariums, and they can swim from
  other aquariums to yours as well.
  Before you can use the DALiWorld networking features to their fullest, you
  will have to create a DALiWorld account. This operation is performed through
  the "Account" tab, described later.
  Since fish swim onto your computer, you might be rightly concerned about
  viruses and privacy. Our entities are completely safe. They are unable to look
  at or modify your system - they are unable to do anything but swim in your
  virtual ocean for your enjoyment. They don't even know what a computer is!
  If you are behind a firewall that is running a SOCKS proxy server, you will
  have to turn on the "Enable SOCKS Proxy Support" and fill in the associated
  information. Most users will not have to do this, so if you aren't sure
  whether you need this, you probably don't.
The "Graphics" Tab
  This tab gives you control over the graphics system used to display DALiWorld.
  Depending on your computer's capabilities, you may want to modify the graphics
  settings to make DALiWorld perform well on your computer system. By decreasing
  the realism of DALiWorld's appearance, the program may run faster on certain
  computers.
  The top part of the graphics tab allows you to select from various graphics
  profiles for high-performance, medium-performance, and low-performance
  computer systems. These predefined options will likely be sufficient for most
  people, but if you cannot achieve sufficient performance on your computer, you
  can select the Custom profile and enable or disable the various graphics
  switches in the panel. The meaning of these switches are as follows:
    Enable the World
    This checkbox causes the environment of DALiWorld to be shown or hidden.
    Disabling the world will greatly improve the performance of DALiWorld on non
    graphics-accelerated systems.
    Enable Fogging
    This checkbox enables or disables the appearance of fog in DALiWorld.
    Disabling fog can improve the performance of DALiWorld on non graphics
    accelerated systems.
    Enable Lighting
    This checkbox enables or disables the lights in DALiWorld. The lights
    increase the realism of DALiWorld's appearance. Disabling lighting can
    improve the performance of DALiWorld on non graphics accelerated systems.
    Enable Fish Texturing
    This checkbox enables or disables the use of texture images in DALiWorld.
    Disabling textures can yeild significant performance improvements on non
    graphics-accelerated systems, but the fish will look quite different with
    texturing off!
    Use Fast Texture Filtering
    When fish-texturing is enabled, this checkbox changes the method by which
    textures are mapped to objects within DALiWorld. Enabling fast texture
    filtering will speed up non graphics-acclerated systems, but the graphics
    will appear grainy, especially when the camera is close to certain objects.
    When fish-texturing is disabled, this checkbox has no effect.
    Use Shaded Polygons
    When fish-texturing is disabled, this checkbox changes whether polygon
    colors are blended across the polygons, or whether each polygon only has a
    single color. Disabling this feature can cause a small performance increase
    on non graphics-accelerated systems, but the fish will look very strange!
    When fish-texturing is enabled, this checkbox has no effect.
  Before you can use the DALiWorld networking features to their fullest, you
  will have to create a DALiWorld account. This operation is performed through
  the "Account" tab, described later.
  Since fish swim onto your computer, you might be rightly concerned about
  viruses and privacy. Our entities are completely safe. They are unable to look
  at or modify your system - they are unable to do anything but swim in your
  virtual ocean for your enjoyment. They don't even know what a computer is!
  If you are behind a firewall that is running a SOCKS proxy server, you will
  have to turn on the "Enable SOCKS Proxy Support" and fill in the associated
  information. Most users will not have to do this, so if you aren't sure
  whether you need this, you probably don't.
The "Account" Tab
  If you want to be able to network your DALiWorld aquarium with other users
  online, you will have to create your own DALiWorld account. This is done in
  the "Registration" group. You will note that the "DALi ID" field contains "Not
  Yet Assigned" if you have not created an account yet.
  If you would like to create an account, simply enter the nickname that you
  wish to be known by in DALiWorld in the "Nickname" field. Then, press the "New
  Account" button. You will be prompted for a password, and if the new account
  was successfully created, you will receive a DALi ID that uniquely identifies
  you.
  If you already have a DALiWorld account, you may select the "Import
  Account..." button. You will be prompted for your DALi ID and password, and if
  you are verified by the server, the Preferences UI will retrieve the account
  information that you entered previously.
  NOTE: The only information required by the DALiWorld networking features are
  the DALi ID and your nickname. If you do not wish to share any other
  information, you do not need to enter anything else to use the networking
  features.
  Once you have set up your DALiWorld account, you can configure the set of
  users that are neighbors to your aquarium. Fish will be able to migrate from
  your aquarium to those of your neighbors. If other users have you as a
  neighbor, fish will migrate from their aquarium to yours as well.
  There are several different ways to set up neighbors.

    If you know the DALi IDs of specific people you want to exchange fish with,
    you can enter them in your Neighbors List. Click the "Add" button, and type
    in your neighbor's DALi ID. If you are online, the neighbor's nickname will
    be automatically retrieved from the DALiWorld server.
    If you want to be able to send and receive fish with random DALiWorld users
    that are also online, you can enable the "Allow Migration to Random Hosts"
    checkbox. Then, fish will be able to migrate to and from other DALiWorld
    users that have also enabled this feature.
    If you happen to be on a subnet with other users running DALiWorld, you can
    turn on the "Allow Migration To All Hosts on Local Network" checkbox. When
    you run DALiWorld, it will discover other hosts that are also online, and
    will exchange fish with them.
  NOTE: If you are using a dial-up modem to access the Internet, you must be
  online to utilize these features.
The "User Information" Tab
  If you would like to expose more information about yourself than just your
  nickname and DALi ID, you can use this tab to enter your information. All
  fields are optional, and there are no restrictions on the information you
  enter.
  Keep in mind that other DALiWorld users will be able to view this information,
  so only enter information that you don't mind sharing.
  NOTE: The only information required by the DALiWorld networking features are
  the DALi ID and your nickname. If you do not wish to share any other
  information, you do not need to enter anything else to use the networking
  features.
Resetting DALiWorld
  When you first run DALiWorld, an aquarium is generated for you which is saved
  to your working directory. In addition, when you quit DALiWorld you are given
  the option to save the state of your current world. This will save all the
  fish and entities in your world, so that the next time you start DALiWorld it
  returns to the same state as before.
  If for any reason you wish to reset the aquarium or remove a saved world, you
  can use the reset world program. If you are running Windows and have used the
  DALiWorld installer, you can reset the world from the Start menu (Start ->
  Programs -> DALiWorld -> Reset World).
  NOTE: The reset-world script is very short and simple, so you may only see a
  brief flash on the screen as the script runs. This is normal.
  To reset DALiWorld from the command-line, you may do so by running reset_world
  (on UNIX machines) or ResetWorld.bat (on Windows machines). You must be in the
  correct directory for these scripts to work.
Interacting with DALiWorld
  DALiWorld can be run as an application or as a screensaver. In both modes, the
  user-interface contains a control-panel along the bottom of the application.
  However, the control-panel is different in appearance between the two versions
  of DALiWorld, although all of the same functionality is exposed. First, the
  application control panel is described, and then the screensaver control panel
  is explained.
  The DALiWorld Application Control Panel
    When DALiWorld is run as an application, a tabbed control panel with several
    options for controlling the DALiWorld application is displayed at the bottom
    of the window. The controls are as follows:
    The "General" Tab

      Press the "Save World" button to save a snapshot of the current
      configuration of your aquarium. The next time you start DALiWorld, the
      state of the aquarium will be loaded from the snapshot.
      Press the "Exit World" button to exit the DALiWorld application. You will
      be prompted to save the current state of your aquarium. If you don't want
      to, that is okay - the next time DALiWorld is run, you will see all new
      fish in your aquarium.
    The "Info" Tab

      This tab shows the details of your DALiWorld aquarium. It includes
      information about where your last fish went to and came from, as well as
      details of how many other DALiWorld peers you can exchange fish with.
      Also, this tab contains the number of fish in your local aquarium.
      The fish icon on the left of this tab will change every time a new fish
      enters your aquarium. If you don't want to wait for fish to come from
      another DALiWorld user, you can press the "New Fish" button on the right
      side of the tab to add a new fish into your aquarium. The fish is randomly
      chosen from a library of possible fish, so you're never sure exactly which
      one you'll get to see next!
      If you are currently following a fish, you can click on the "Following"
      button to stop following that fish. The camera will coast to a stop at
      that location, and if the fish swims off, the camera will no longer follow
      it. This button is only active when you are currently following a fish.
    The "About" Tab

      This tab contains a few details about the DALiWorld program.
    The "Help" Tab

      This tab displays reminders of the Camera controls. In depth information
      can be found in the section entitled Manipulating the Camera, below.
  The DALiWorld Screensaver Control Panel
    When DALiWorld is run as a screensaver, a graphical control panel with
    several options for controlling the DALiWorld application is displayed at
    the bottom. The controls are as follows:
    Expand and Collapse Panel Button

      The arrows at the left of the control panel can be used to expand and
      collapse the panel. When the panel is opened, the arrows point to the
      right, and pressing them will collapse the control panel. When the panel
      is closed, the arrows point to the left, and pressing them will expand the
      panel.
    Save and Exit Buttons

      The save and exit buttons are on the rightmost part of the control panel,
      and are visible whether the panel is expanded or collapsed.
      The save button is the top button, and has a green plus (+) on it.
      Pressing it will cause a snapshot of the aquarium's current state to be
      saved to disk.
      The exit button is the bottom button, and has a red X (X) on it. Pressing
      it will cause DALiWorld to exit.
      NOTE: Unlike the application-mode version of DALiWorld, the
      screensaver-mode version will not prompt the user to save the world at
      exit; the screensaver will simply exit.
      NOTE: In screensaver-mode, the Esc key can also be pressed to exit
      DALiWorld.
    The Camera Button

      When the control panel is expanded, a camera button both indicates and
      controls the current state of the camera within your aquarium. When the
      camera button is inactive (black and white), the camera is currently not
      following any fish within the aquarium. When the camera button is active
      (colored green), the camera is currently tracking a fish.
        Clicking on a fish will cause the camera button to become active.
        Clicking on something other than a fish will cause the camera button to
        become inactive.
        If you are currently following a fish and wish to stop, clicking on the
        active camera button will deactivate it and cause the camera to come to
        a stop.
        If the camera isn't following any fish at the moment, clicking on the
        inactive camera button will activate it and cause the camera to take a
        tour of the aquarium, periodically choosing and following a new fish.
    The New Fish Button

      When the control panel is expanded, a fish button indicates when new fish
      enter your aquarium. When a fish enters your aquarium, the button becomes
      active (turns yellow) for several seconds, and then reverts to an inactive
      black-and-white.
      This fish button also allows you to add new fish to your aquarium.
      Clicking the button adds a single new fish to your aquarium. As with fish
      coming across the network, the fish button will remain active for several
      seconds to signal that a new fish has entered your aquarium, and then it
      will deactivate.
    The Info Display

      When the control panel is expanded, pressing the "Info" button on the left
      of the display area will show information about your aquarium, including
      the last place that a fish was sent to or came from, the total number of
      fish in your aquarium, and the total number of other DALiWorld peers that
      your machine can detect.
    The About Display

      When the control panel is expanded, pressing the "About" button on the
      left of the display area will show information about the DALiWorld
      program.
    The Help Display

      When the control panel is expanded, pressing the "Help" button on the left
      of the display area will show useful information about how to interact
      with the DALiWorld user-interface. There are several pages of help
      information available, accessible through the page-up and page-down
      buttons.
  Looking At Fish and Fish Information
    If you want to get a closer look at a fish in your aquarium, you can simply
    left-click on the fish with the mouse cursor. The camera will move to the
    fish, enabling you to get a closeup view of all its splendor.
    If you want to view other details about a fish, you can right-click on the
    fish and DALiWorld will display the fish's passport. This passport includes
    the fish's species, the nickname and ID of the fish's creator, the date and
    place of the fish's creation, and a list of the five most recently visited
    locations.
    So, if a fish suddenly appears in your aquarium from one of your neighbors,
    you can see who the fish came from and where the fish has been!
    When you are done looking at a fish's passport, you can dismiss the passport
    simply by clicking the mouse cursor on it.
  Special Fish
    While the majority of the fish available in DALiWorld can be created in
    anyone's aquarium, there are a small number of "special fish" that are not
    generally available.
    When you create your user preferences for the first time, you are assigned
    one of the special fish species for your aquarium. This is the only species
    of the special fish that you will ever be able to create (by clicking the
    "New Fish" button). However, you may get to see other types of special fish
    if they swim from someone else's aquarium to your own.
  Manipulating the Camera
    The camera in DAliWorld is your viewer into this aquatic world. You can
    control it with the following controls:

      Arrow Keys: Forward/Backward/Left/Right
      Alt + L/R arrow: Pan left or right
      Page Up/Down: Pitch down/up
      = : Reset the camera position to the default
      Left click on a fish to follow
      Left click on background to stop following
      Right click a fish to see its passport
    When a new fish arrives into your aquarium from another DALiWorld peer, the
    camera will automatically track to the new fish. This makes it very easy to
    find out where the newest fish has been before entering your aquarium!
Back to the Top



5 Advanced User Information
Command-Line Arguments
The DALiWorld program understands several command-line arguments that you can
use to modify the way that it works. This section contains a list of those
command-line arguments.
  -prefs <filename>
  Cause DALiWorld to load the user-preferences stored in <filename> instead of
  the default myprefs.dat.
  -fish <number>
  By default, DALiWorld uses the number of fish specified in your user
  preferences. If you want to override that number then you can use this
  argument.
  -nonetwork
  By default, DALiWorld will enable or disable its networking functionality
  based on your preferences. However, if you want to force DALiWorld to not use
  any networking, you can use this argument to do that.
  -noworld
  Specify this argument if you want to cause DALiWorld to not load or display
  the world, so that only the fish show up. This is a useful option on computers
  that only support software-rendered graphics.
  -novis
  Specify this argument if you want to cause DALiWorld to display no graphical
  displays at all. The program will simulate the aquarium, and will still send
  and receive fish (if enabled), but none of the graphics will be displayed.
  -nofog
  If you think the water is a bit too murky for you, or if you want your
  graphics to go a bit faster, you can use this argument to turn off the fog in
  DALiWorld.
  -logging
  This option causes DALiWorld to output many messages that give more detail
  about what is going on within the program. If you happen to find a repeatable
  bug or problem, you can specify this argument to provide us with a better
  bug-report.
  -verbose
  This option is like the -logging option, but it outputs even more details
  about the functioning of the program!
  -fps
  This command-line argument will cause DALiWorld to periodically output the
  graphics-speed in frames-per-second.
  -fullscreen
  This command causes DALiWorld to run in fullscreen-mode as a screensaver,
  instead of as an application which is the default.
Back to the Top



6 Known Issues
There are several known issues in the current version of DALiWorld. We hope to
fix all of them in the next release, but for the meantime please read the
following:
Fullscreen Control Panel
  Sometimes the fullscreen-mode control panel is covered up by the environment
  or a fish, which makes it a challenge to actually exit DALiWorld. Pressing the
  Esc key will cause DALiWorld to exit when in fullscreen mode.
  There is a button on the fullscreen-mode control panel that doesn't do
  anything. The functionality behind this button has not yet been implemented.
Fullscreen Passport
  When running DALiWorld in fullscreen mode on a machine using DirectX,
  attempting to display a fish's passport does not work. This is because the
  DirectX graphics window must remain in front of all other windows, and
  therefore it covers the fish's passport.
Saved World is Corrupted
  Occasionally, if the saving process is interrupted or unsuccessful, the saved
  world can be corrupted. The only workaround for this problem is to run the
  reset world script.
Back to the Top
      D A L i W o r l d
      Why search for life when you can create it?
      Copyright ⌐ 2000-2001 by DALi, Inc. All rights reserved.