Gaia4D 1.0
Users' Manual

  1. Introduction

  2. Installation
    1. System Requirements
    2. Install
    3. dwTerm

  3. How To Use

  4. License Agreement

  1. Introduction

    Gaia4D shows local times on the earth, with the following features.

    • Intuitive: 24 time zones with world clocks are rotating around the North Pole, with the colors indicating day or night.

    • The names of zones can be edited (e.g. into city names)

    Note that dwTerm 1.0 or higher is needed. The free trial version of dwTerm is enough for usual cases.

  2. Installation

    1. System Requirements

      • CPU: Intel 80486 or higher

      • OS: Windows 95, Windows NT 4.0 or higher

    2. Install

      Gaia4D is distributed as a compressed file, *.zip. The installation process is simple. Just extract all of the files contained in it into a folder. Now you can load and run gaia4d.dll (or scripts *.dsc) by dwTerm.

    3. dwTerm

      dwTerm provides a minimal user interface and scripting to a dll program, so that the programmer does not have to know how to make a window, does not have to devise codes for option-file, and can concentrate on programming the core of the program. Any programmer can easily make such "dwTerm dlls", that can be loaded and run by dwTerm. Gaia4D is one of them.

      Go to http://www.softbattery.net/dwterm for dwTerm 1.0 or higher.

  3. How To Use

    To run Gaia4D, run dwTerm and use the [File]->[Load...] menu to find the Gaia4D.dsc in Gaia4D's folder and load it. The result is depicted in the following screenshot.

    Adjust the main window size to see the entire dark blue area (called the "canvas"). The largest part of the main window is called the display or output window (containing the canvas). The "command window", an edit box is located below the display window.

    In the canvas there are 24 clocks, whick check the system clock every second to show hours and minutes. Some clocks have names and you will see how to modify them or specify names for empty clocks in the next paragraphs. You may want to see how, since some cities use summer times, for example. The left 12 clocks are white, while the right 12 clocks are black. What does this configuration mean? The whole rectangle within which are the clocks is the earth, and at the far left is the sun, so that the left clocks are at day-time while the right are at night. The 24 clocks correspond to the time zones and rotate around the North Pole (the center of the rectangle). Earth rotates from the west to the east, so that the clocks (zones) rotate anticlockwise in this picture.

    As depicted below the clocks, you should enter "s 5" in the "command" window, to modify the name of the zone with the "zone number" 5 for example. The zone number is defined to be an integer n such that the local time of a time zone is GMT (UTC) + n. After entering the command the screen shows a text telling you to enter the name. Enter a city name or any string you want as the name, with or without blanks. Then the clock (zone) gets updated (Actually this "World Clocks" stage gets updated including all the clocks), and note that successive blanks reduce to one blank in the zone name updated.

    The "q" command lets you go to the Main stage, as in the following screenshot. There are two commands. The "c" command leads to the World Clocks stage and the "h" command opens this manual. Later versions can include more stages.

    The number after "#" shows up in the title of the Main stage and the title of the "World Clock" stage, just to indicate that an input is processed and the content in the stage are renewed. That is, it is a trivial number, just increasing by one when the kind of stage is changed or the stage is renewed.

    Now, let's see what is in the file Gaia4D.dsc, by using the [File]->[Edit...] menu. Then your text editor opens the file. The following screenshot shows a part of the content.

    Many commands are included, which are familiar to you in previous paragraphs. dwTerm lets Gaia4D process the commands specified after a line "dwTerm Script Commands", automatically right after Gaia4D is loaded. The first line specifies the (path of) dll to load. You can load the dll directly, not by way of *.dsc. Use the [File]->[Load...] menu to load gaia4d.dll. Then you will see the main stage, and there will be no name for the time zones (clocks) if you go to the World Clock stage.

    We call text files like Gaia4D.dsc as dwTerm scripts. You can modify it to make other script with other file name, to add more zone names or any other commands for example. A script also can be loaded by double-clicking it if you associate the extension "dsc" with dwTerm in your system. Refer to dwTerm manual for more information about scripting. The trial version of dwTerm can run upto 20 commands in a script.

  4. License Agreement

    Gaia4D is Copyright(C) 2008 http://www.softbattery.net.

    The compressed form of Gaia4D, which is a file with "zip" extension and in which this file (manual.htm) is contained as one of the components, can be freely copied and distributed as far as it is not modified.

    A copy of the compressed form can be freely extracted into the component files to run gaia4d.dll or scripts, or to read the manual. Any files except the scripts (*.dsc) are NOT permitted to be de-assembled, de-compiled, reverse-engineered, or modified.

    Gaia4D is provided as is, without warranties of any kind. The copyright holder shall NOT be liable for damages of any kind.