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 Cause DALiWorld to load the user-preferences stored in instead of the default myprefs.dat. -fish 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.